01 / CLIENTS
桌面端可選 v2rayN，Android 端建議先了解 v2rayNG。安裝套件架構、介面類型與核心支援度請分開確認。
用戶端負責儲存伺服器資料、更新訂閱並產生執行設定；核心則處理協定交握、路由比對與連線。下載並安裝後，仍須匯入服務提供者給的有效連線參數。軟體本身不附可用伺服器，訂閱網址也不是用戶端安裝套件。初次使用時，建議先保留預設監聽設定，使用一組確認可用的設定測試連線，再逐項調整分流與 DNS，方便判斷每次變更的影響。
下載頁分別提供 Desktop 桌面版與經典 WPF 版。Desktop 採用跨平台介面，WPF 則延續經典桌面操作方式；兩者都須搭配實際使用的核心與伺服器參數，介面不同不代表協定支援完全相同。請先確認作業系統架構，再選擇合適的安裝方式，不要只憑檔案大小判斷用途。
安裝並啟動後，先匯入訂閱或單一分享連結、選擇伺服器，再啟用系統代理。瀏覽器通常會使用系統代理設定，但命令列工具、遊戲和部分背景程式可能採用自己的網路設定。若瀏覽器能連線、其他應用程式卻不行，請先確認該程式是否遵循系統代理，不必急著反覆更換伺服器。可交叉查看記錄與設定，確認連接埠是否遭占用、核心是否運作，以及目前的代理模式。
先在「關於這台 Mac」確認處理器：Apple Silicon 對應 arm64，Intel 對應 x64。下載頁會分別列出兩種安裝套件。用戶端介面和系統網路設定屬於不同層次；能開啟主視窗只代表應用程式已啟動，還需確認核心正常執行、本機監聽連接埠已建立，以及目前使用的應用程式連到正確的代理入口。
匯入既有設定時，請特別確認傳輸方式、伺服器名稱與憑證相關選項是否保留。不要為了排除連線錯誤而任意關閉憑證驗證。使用系統代理前，可先記下原本的網路設定；切換網路、結束用戶端或更換監聽連接埠後，若應用程式仍連到舊位址，請一併檢查系統代理狀態。虛擬網卡相關功能也取決於目前用戶端的實作、系統權限與所選核心，不能只因選單名稱相似，就照搬其他系統的操作方式。
v2rayNG 使用 Xray 核心，v2flyNG 則是採用 V2Fly 核心的替代選擇。多數較新的手機適合使用 arm64 套件；不確定裝置架構時，可參考下載頁的通用套件入口與選擇說明。兩款應用採用不同的核心路線，匯入相同連結後仍須確認協定與傳輸選項是否支援，不要將其中一款的所有參數原封不動套用到另一款。
首次建立連線時，系統會要求授予 VPN 連線權限，這是 Android 用戶端接管應用程式流量的必要步驟。顯示已連線後，還要透過實際目標連線與執行記錄確認結果。分應用程式規則、電池限制與背景活動權限都會影響使用情況；若螢幕關閉後連線中斷，請先檢查系統是否限制背景執行。訂閱更新失敗與連線失敗也應分開排查：前者檢查網址、回應格式與更新路徑，後者檢查伺服器參數、交握與路由，兩者的處理順序不同。
依發行版的套件管理系統選擇 deb 或 rpm，再確認處理器架構是 x64 還是 arm64。下載頁分別列出常見桌面安裝入口與 arm64 入口。安裝套件格式不會決定協定支援度，實際可用欄位取決於執行核心。安裝後若介面無法正常開啟，請先查看系統顯示的相依套件或執行環境提示，再檢查桌面工作階段與權限。
桌面環境的系統代理設定不會自動套用至每個程序。終端機程式可能會讀取環境變數，也可能需要另外指定 SOCKS 或 HTTP 代理；應用程式設定的協定必須與本機監聽入口一致。排查時先確認核心記錄沒有啟動錯誤，再檢查監聽位址與連接埠，最後測試目標連線。若需要使用 TUN，請先了解虛擬介面、路由表與 DNS 的搭配方式，並記下原有網路設定，避免同時修改多個網路管理入口，難以判斷問題來源。
02 / CONFIGURATION
先分清入站與出站，再看規則如何選擇路徑。訂閱與 TUN 是用戶端功能，不是 V2Ray 頂層設定欄位。
以下範例用來辨識設定結構，並非可直接取代所有設定的完整檔案。用戶端產生的執行設定可能因核心與介面選項而異；修改前請先備份原設定，並確認目前查看的是持久設定還是暫時產生的檔案。直接編輯暫存檔後，下次啟動或切換伺服器時，內容可能會重新產生。需要長期保留的規則，應透過用戶端提供的設定入口或自訂設定入口維護。
入站設定決定在哪個位址與連接埠接收連線，以及使用哪種代理協定。範例只監聽本機迴路位址，應用程式應連至相應的 SOCKS 連接埠。修改連接埠後，須同步調整手動設定代理的程式；系統代理入口則由用戶端依自身設定管理。若將監聽位址改為所有介面，可存取範圍也會擴大，不應預設開放給區域網路。入站與路由規則不同，前者處理「連線如何進入核心」，不會直接決定最後使用哪台伺服器。
前往 JSON 手冊查看 →{ "inbounds": [{ "tag": "socks-in", "listen": "127.0.0.1", "port": 10808, "protocol": "socks" }]}出站設定包含協定與相應選項，可用於代理伺服器或直接連線。範例展示 V2Fly 與 Xray 常見的 freedom 直連出站；它只定義出口，不會自動補上遠端伺服器資料。供路由引用的每個出站都應有明確且不重複的 tag，規則中的 outboundTag 也必須能找到相應標記。匯入節點後，用戶端通常會產生代理出站；手動新增直連項目時，請一併檢查既有標記與預設出口，避免名稱相同卻指向不同設定。
前往 JSON 手冊查看 →{ "outbounds": [{ "tag": "direct", "protocol": "freedom", "settings": {} }]}路由會逐項比對連線目標與規則，符合條件後交由指定出站處理。範例將私有位址範圍交給 direct，前提是出站清單中已有相同標記，且執行環境提供所引用的地理資料。domainStrategy 控制路由比對所涉及的網域解析策略，不等於強制所有應用程式使用特定 DNS。規則有先後順序，過於寬泛的規則若排在前面，可能會遮蔽後續的精確規則。排查分流結果時，應一併核對目標網域、解析位址、規則順序與最後選取的出站。
前往 JSON 手冊查看 →{ "routing": { "domainStrategy": "IPIfNonMatch", "rules": [{ "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" }] }}DNS 設定描述核心使用的解析服務與靜態對應，不代表系統中的每次查詢都會經過核心。瀏覽器內建的加密 DNS、系統快取與應用程式自行解析，都可能得到不同結果。範例使用 hosts 將教學網域對應到文件範例位址，僅用來展示欄位結構，不可作為實際服務位址。排查時先確認網域由哪一層解析，再檢查解析結果是否符合路由規則；若只更換解析服務而不檢查請求路徑，通常無法解釋所有連線問題。
前往 JSON 手冊查看 →{ "dns": { "hosts": { "example.com": "192.0.2.1" }, "servers": ["localhost"] }}訂閱由用戶端取得、解析並寫入伺服器清單；V2Ray JSON 沒有通用的 subscription 頂層設定。更新成功只代表資料已接收，仍須選擇伺服器並啟動核心。右側展示記錄層級片段，說明解析後應觀察哪個執行階段，並非填寫訂閱網址的位置。更新失敗時，先分辨是網路請求失敗還是內容解析失敗，再檢查連結是否有效、回應內容與更新時使用的代理路徑；訂閱網址若含有存取憑證，不應貼到公開記錄中。
前往 JSON 手冊查看 →執行階段的記錄片段；訂閱網址儲存在用戶端設定中。
{ "log": { "loglevel": "warning" }}TUN 透過虛擬網卡，讓部分不讀取系統代理的程式進入代理處理流程；實際涵蓋範圍仍受路由、權限與用戶端實作影響。它不是在任意 V2Ray 設定中新增 tun 欄位。v2rayN 相關功能應依目前介面與搭配核心的說明設定，右側僅展示接管後可用的路由片段。初次啟用前，請先確認一般代理運作正常，再檢查管理員權限、其他虛擬網卡與 DNS 路徑；成功接管不代表所有目標都應走代理，區域網路存取仍需適當的分流規則。
前往 JSON 手冊查看 →V2Ray / Xray 路由片段，並非 TUN 網卡定義。
{ "routing": { "rules": [{ "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" }] }}先查看啟動錯誤，再檢查連線錯誤。連接埠遭占用、欄位不受支援與交握失敗分屬不同階段；暫時提高記錄詳細程度後，排查完成應恢復合適的層級，分享前也要移除伺服器位址與存取憑證。
分別確認訂閱更新、核心啟動、系統代理與目標連線。保留可正常運作的基準設定，並記錄本次變更；結果異常時，先還原這一步，比同時更換協定、DNS 與路由更容易找出可重現的原因。
03 / PROJECT V · V2FLY · XRAY
開源描述的是程式碼與授權公開方式；協定支援、設定相容性與連線結果仍須分別確認。
「V2Ray 用戶端」常被用來統稱這類圖形化工具，但介面程式、連線核心與伺服器並不是同一個元件。介面負責將使用者的選擇轉成設定，核心依設定處理連線，伺服器端也必須採用相容參數。了解這段流程後，下載、設定與排錯都能找到各自的切入點，不必把所有異常都歸咎於用戶端本身。
Project V 是一系列以網路代理功能為核心的開源專案，V2Ray 是其中廣泛使用的核心實作。入站、出站、路由與 DNS 等設定概念，因而成為理解相關工具的共通語言。這些概念描述連線處理流程，不代表任何特定服務商，也不等同於可直接使用的訂閱。本網站以這些結構編排手冊，協助讀者理解介面選項在設定層的意義。
學習時可沿著連線方向理解：應用程式先連入本機入站，核心取得目標資訊後，由路由規則選擇出站，再由出站發起遠端連線。DNS 可能參與目標解析與規則判斷，記錄則會留下執行結果。掌握這個順序，比逐一背熟所有欄位更實用，也能理解為什麼「本機連接埠已開啟」不代表遠端交握已成功。
V2Fly 社群延續 V2Ray 的開發；Xray 則從相關程式碼分支發展，逐步形成獨立的功能與發行路線。兩者保留許多相近的設定概念，但新增協定功能、傳輸選項、預設行為與欄位限制可能不同。使用 REALITY、XTLS 等功能時，應確認所用核心實際支援情況；不能只因檔名同為 config.json，就認定設定可以互換。
用戶端顯示的協定名稱只是初步資訊，還須核對傳輸方式、TLS 參數、伺服器名稱與伺服器端要求。其他核心路線支援某個欄位，不代表目前使用的核心也會接受。設定載入失敗時，優先查看記錄指出的欄位與層級；若能載入但無法連線，再檢查雙方參數與網路路徑，避免混淆語法錯誤與交握錯誤。
閱讀核心差異說明 →v2rayN 適用於桌面系統，提供伺服器清單、訂閱分組、系統代理與設定管理入口。v2rayNG 適用於 Android，使用 Xray 核心；v2flyNG 則提供採用 V2Fly 的 Android 替代方案。三者都是開源用戶端，但不是同一個程式換上不同外觀。選單位置、預設設定、可匯入格式與搭配核心的管理方式，都應依各自用戶端分別理解。
圖形化用戶端降低了編輯原始 JSON 的門檻，但不會改變伺服器要求的驗證與傳輸條件。複製分享連結時，請保留完整內容；匯入後仍須檢查協定、位址、連接埠與傳輸參數。切換用戶端前，可先匯出需要保留的資料，避免將介面選項的預設值誤認為服務端提供的值。從桌面端移轉至 Android 時，也要重新確認系統代理與 VPN 接管方式的差異。
開源授權規定程式碼使用、修改與再散布的條件，不能以單一授權名稱概括用戶端、核心與所有相依元件。V2Ray 核心採用 MIT 授權；Xray 核心採用 MPL 2.0 授權。圖形化用戶端與隨附元件也各有授權說明；若要再散布或修改程式碼，應逐一閱讀相應條款並保留必要聲明，不要把「免費使用」理解成完全沒有附帶條件。
公開原始碼讓實作細節得以閱讀與討論，但不會替使用者確認訂閱來源、伺服器端行為或本機設定。實際使用時，仍應妥善保管訂閱連結與驗證資料，只匯入可信來源的設定，並了解指令碼、憑證與網路權限的作用。本網站旨在整理下載入口與中文設定參考，不取代各元件的授權條文，也不以開源特性保證連線效果。
軟體更新會變更用戶端程式或搭配核心；訂閱更新則會變更伺服器清單與分組資料。前者可能調整介面入口、預設選項或設定相容性，後者可能更換位址與連線參數。排查更新後的異常時，先記下更新的是哪一層，再比較更新前後的差異。重新取得訂閱無法解決本機連接埠遭占用，也不能讓缺少特定功能的核心自動取得支援。
更新前先備份用戶端設定與必要的自訂規則；更新後先用原本可正常運作的單一設定測試。確認核心可啟動、基本連線正常後，再測試路由、DNS 與 TUN 等組合功能。用戶端與核心的發行時程未必一致，是否需要更換核心應依搭配關係與實際功能需求決定；不了解相容性時，不要一次替換所有元件。
查看匯入與連線步驟 →先確認能否取得訂閱，再確認伺服器資料是否正確解析；接著檢查核心能否啟動、本機監聽是否建立，最後測試目標連線。若只有部分網域異常，請檢查解析結果與路由比對；若所有請求都失敗，優先核對目前選取的伺服器與交握記錄。延遲測試不完全等同實際應用程式連線，測試結果只反映特定方法的一次探測，不能取代完整連線驗證。
記錄問題時，請保留錯誤文字、操作順序、代理模式與使用的核心名稱，並移除訂閱網址、驗證資料與可識別伺服器的資訊。若不熟悉術語，先查閱入站、出站、訂閱與分流的定義，再對照實際設定。這樣提供的資訊更容易重現，也能避免把「瀏覽器沒有使用代理」誤判為「協定不支援」。合併 JSON 範例前，仍須檢查括號、逗號、陣列層級與出站引用。
查閱設定與連線術語 →04 / NOTES
依照實際問題，從節點選擇到流量接管逐步閱讀。
完成首次連線後，再處理更細的需求：節點選擇著重測試方法與伺服器參數，核心選型著重功能支援，TUN 則著重應用程式流量如何進入處理流程。以下三篇文章依發布日期由新到舊排列；閱讀時先找出與目前問題相關的層次，避免只為處理單一應用程式的代理設定，就直接修改整套路由。
系統代理只適用於遵循代理設定的程式，TUN 模式則透過虛擬網卡擴大流量接管範圍。本文說明管理員權限、啟用步驟與路由搭配方式，並釐清「進入核心」和「最後透過代理連線」是兩種不同結果，方便排查區域網路與 DNS 相關問題。
閱讀全文 →整理 Project V 生態系中兩種核心路線的關係，比較 REALITY、XTLS 等功能支援情況。搭配 v2rayN、v2rayNG 與 v2flyNG 的使用方式，說明為何設定格式相似，仍須確認欄位、傳輸條件與伺服器端要求。
閱讀全文 →延遲低不代表所有連線都更快。本文區分實際連線測速與 TCPing，說明流量倍率與地區選擇的意義，並配合 VLESS、VMess、Trojan 的設定條件，介紹如何在測試結果之外確認實際應用程式的連線表現。
閱讀全文 →