Windows
Windows 桌面端首選 v2rayN。下載頁也會說明新一代桌面介面與經典 WPF 介面的差異。首次執行後，依照「新增訂閱—更新清單—選擇節點—設定系統代理」的順序操作，方便確認每個環節是否完成。
前往下載
核心設定
訂閱管理、路由分流與執行診斷
客戶端的關鍵差異不只在安裝介面，更在於如何整理訂閱、依規則匹配流量，以及發生異常後能否快速定位。以下依實際使用順序拆開說明。
01
訂閱分組與更新順序
訂閱網址用於批次下發節點參數，客戶端會負責解析並歸入對應分組。匯入前應確認連結完整，再為不同來源設定清楚的名稱；更新時先重新整理訂閱，再選取目前節點，避免仍在使用舊清單。v2rayN 適合將桌面端的多個訂閱拆分為獨立分組，v2rayNG 與 v2flyNG 則更適合保留簡潔的行動端清單。自動更新間隔應配合訂閱提供者的更新頻率設定，日常不必反覆手動匯入同一網址。
如果更新後原本的選擇失效，先重新選取節點並觀察狀態，再檢查訂閱內容是否調整了分組或節點名稱。這個順序比直接刪除所有設定更容易保留有效設定，也便於判斷問題來自訂閱回應還是本機選擇狀態。
訂閱分組
已同步
預設分組目前使用
訂閱 A自動更新
手動節點本機維護
02
系統代理與路由規則的分工
系統代理決定應用程式是否將請求交給客戶端，路由規則則決定請求進入客戶端後要走代理、直連還是阻斷。兩者處於不同層級，排查時不能混為一談。一般瀏覽器與遵循系統設定的桌面程式，可先使用自動設定的系統代理；需要更精細的目標匹配時，再選擇繞過區域網路與中國大陸或手動規則。修改規則後應建立新連線重新測試，舊連線可能仍沿用變更前的路徑。
手動規則適合處理網域、位址範圍與程序層級的特殊需求，但規則順序會影響最終結果。範圍更具體的規則通常放在前面，通用的兜底規則放在後面。先維持規則數量可控，再逐條增加，比一次匯入大量陌生規則更容易維護。
路由模式
依序匹配規則
繞過區域網路與中國大陸
全域
手動規則
domain:geosite-cn → direct
ip:geoip-private → direct
final → proxy
03
從日誌區分訂閱、節點與本機設定
連線異常時，日誌比反覆切換開關更有判斷價值。訂閱更新階段應關注網路請求、回應格式與解析結果；節點連線階段則關注網域解析、握手、傳輸參數與遠端回應；只有部分應用程式無法存取時，還要回到系統代理或 TUN 接管範圍檢查。將故障按階段拆開，可以避免把訂閱網址問題誤判為節點問題。
日誌中的時間順序同樣重要。先清除舊輸出，再執行一次明確操作，例如更新訂閱或開啟目標頁面，然後只觀察這段操作產生的紀錄。遇到連續重試時，應先處理最早出現的錯誤，而不是只看最後一行的概括資訊。
執行日誌
按階段查看
INFO load routing rules
INFO apply system proxy
INFO subscription parsed
INFO outbound configuration ready
平台入口
依裝置選擇 V2Ray 客戶端
桌面平台可統一查看 v2rayN，Android 裝置則可在 v2rayNG 與 v2flyNG 之間選擇。平台入口只會帶到對應的下載區段，具體安裝套件類型、處理器架構與安裝說明會在下載頁逐項列出。
macOS
macOS 使用 v2rayN 桌面端。選擇安裝套件前，先確認裝置採用 Apple Silicon 還是 Intel 處理器，兩種架構需要對應的檔案。安裝完成後再匯入訂閱，並依日常應用程式是否遵循系統代理，決定是否啟用 TUN 模式。
前往下載Android
Android 端首選 v2rayNG，也可依核心偏好選擇 v2flyNG。多數較新的裝置可優先查看 arm64 安裝套件，無法確認架構時再參考通用版說明。兩款客戶端都支援訂閱匯入與路由設定，但核心家族與介面編排方式不同。
前往下載Linux
Linux 桌面端使用 v2rayN，可依發行版的套件系統選擇 deb 或 rpm，並依處理器架構選擇對應檔案。安裝後建議先在客戶端內完成訂閱與代理設定，再考慮開機啟動、桌面環境代理同步等日常維護項目。
前往下載
快速上手
從訂閱網址到正常連線的三個步驟
首次設定最容易出現的問題，通常不是某個進階選項，而是操作順序被打亂。先完成訂閱匯入，再確認節點與代理模式，最後用新的網路請求驗證結果，就能快速縮小排查範圍。
-
匯入訂閱並更新清單
複製完整的訂閱網址，在客戶端的訂閱管理中新增記錄，並為它設定容易辨識的名稱。儲存後執行更新，確認清單出現可選節點。若更新沒有結果，先核對連結首尾是否被截斷，再查看日誌中的網路請求與解析提示。匯入失敗時不要直接修改路由或 TUN 設定，因為這些選項無法修復訂閱回應問題。
-
選擇節點與系統代理模式
從更新後的分組中選擇一個節點，再啟用適合目前應用程式的系統代理模式。瀏覽器與多數桌面應用程式通常會讀取系統代理；少數程式使用獨立網路堆疊，可能需要個別設定或啟用 TUN。第一次測試時先維持路由規則簡單，確認基本連線成立後，再逐步加入分流需求。
-
建立新連線並檢查日誌
設定變更後關閉舊頁面或舊連線，再發起一次新的存取請求。若無法連線，查看操作發生時產生的日誌，判斷錯誤位於網域解析、協定握手、傳輸參數還是系統代理接管階段。一次只調整一個變數，調整後立即重新測試，才能知道哪項設定真正影響結果。
常見操作問題
訂閱更新失敗時先檢查什麼？
先確認網址是否完整、裝置網路是否能請求該網址，再從客戶端日誌中區分網路錯誤與內容解析錯誤。訂閱問題處理完成前，不必反覆切換節點。
查看訂閱匯入步驟系統代理已開啟，但部分程式沒有流量？
先確認該程式是否遵循系統代理。若使用獨立網路堆疊，可查看程式本身的代理選項，或評估 TUN 模式是否適合目前的裝置環境。
查看連線設定更換路由模式後，為什麼結果沒有變化？
舊連線可能仍使用原本的路徑。關閉目標程式中的現有連線，重新發起請求，並確認新日誌已匹配調整後的規則。
閱讀路由分流章節桌面端和 Android 端應該選擇同一個客戶端嗎？
桌面端使用 v2rayN，Android 端可選擇 v2rayNG 或 v2flyNG。訂閱內容可以相同，但不同客戶端的介面位置與核心家族可能不同。
查看客戶端清單
生態背景
Project V、V2Fly、Xray 與圖形客戶端的關係
理解核心、客戶端與訂閱之間的界線，有助於正確判斷功能來源。圖形介面負責設定與管理，核心負責實際的網路處理，訂閱則提供一組可由客戶端轉換成本機設定的連線參數。
Project V 是協定與工具生態的起點
Project V 建立了一套圍繞代理協定、傳輸方式、路由規則與設定結構發展的開源生態。VMess、VLESS 等協定名稱屬於連線設定的一部分，TCP、WebSocket、gRPC 等傳輸方式負責承載資料，routing 規則則決定不同目標應交給哪個出站。客戶端會將這些欄位整理成可操作的介面，但底層概念仍來自同類設定模型。
因此，「客戶端名稱」與「協定名稱」不能互相取代。v2rayN、v2rayNG、v2flyNG 是使用者直接操作的圖形客戶端；VMess、VLESS、Trojan 是可能出現在節點參數中的協定類型；V2Fly 與 Xray 則屬於負責執行設定的核心家族。遇到連線問題時，先確認問題位於哪一層，往往比直接重新安裝更有效。
V2Fly 與 Xray 採用相近的設定思路
V2Fly 延續 Project V 的社群維護路線，持續推進協定實作、傳輸層、路由與出入站結構。Xray 則在相近的設定模型上發展出自己的功能集合。兩者都能處理常見的訂閱節點，但支援的協定欄位、傳輸選項與新增能力並非始終一致。訂閱提供者標明核心要求時，應依要求選擇客戶端與核心，避免將欄位不相容誤認為訂閱失效。
路由設定中的入站、出站與規則匹配，是理解兩個核心家族的共同基礎。入站描述本機應用程式如何將流量交給核心，出站描述流量透過哪種連線方式離開，routing 則在兩者之間完成選擇。圖形客戶端雖然隱藏了大量 JSON 欄位，但進階設定中的系統代理、TUN、分流規則與 DNS 選項，最終仍會對應到這些結構。
三款客戶端對應不同平台與核心取向
v2rayN 是 Windows、macOS、Linux 的桌面客戶端，適合管理多個訂閱、切換系統代理、編輯路由規則與查看詳細日誌。v2rayNG 面向 Android 裝置，通常搭配 Xray 核心使用，介面圍繞行動網路、VPN 接管與訂閱清單編排。v2flyNG 同樣面向 Android 裝置，但採用 V2Fly 核心路線，可作為有明確核心偏好或設定需求時的選擇。
客戶端之間不必追求介面完全一致。更重要的是維持訂閱來源、節點參數與路由目標一致，並理解各客戶端將相同功能放在什麼位置。例如桌面端常用「系統代理」描述應用程式的接入方式，Android 端則透過系統提供的 VPN 介面接管流量；操作入口不同，但目的都是將目標請求送入本機核心。
開源協定與社群維護代表功能會持續調整
這些客戶端與核心以開放原始碼方式維護，功能討論、錯誤修正與相容性調整由不同社群參與者共同推進。開放維護便於技術人員理解設定產生流程，也讓協定實作與平台適配持續演進。實際使用時仍應注意客戶端與核心之間的相容關係，尤其在新增協定欄位、傳輸方式與作業系統網路介面發生變化時。
更新客戶端前，可以先記錄目前的訂閱名稱、代理模式、路由選擇與 TUN 狀態。更新完成後依原順序核對設定，並透過一次明確的連線測試觀察日誌。若新舊介面調整了選單位置，應以功能名稱與設定含義為線索，而不是只依賴舊截圖尋找按鈕。這樣更適合長期維護，也能減少介面變動造成的誤操作。
技術筆記
查看所有文章
客戶端設定與排查文章
圍繞客戶端選型、首次設定與延遲測試，整理可重複使用的操作方法。