訂閱分組清單
將來源、篩選條件與更新動作放在同一分組
桌面端先在「訂閱分組」中儲存完整訂閱位址，再執行「更新目前訂閱」。家用、辦公或測試用途可分別建立分組，避免不同來源全部堆在同一份伺服器清單中。若更新後清單為空，應先檢查分組篩選關鍵字與位址是否完整，而不是反覆切換系統代理。
設定路徑：訂閱分組 → 新增訂閱 → 更新目前訂閱
桌面與 Android 客戶端中文說明
V2Ray中文站 · v2rayN 指南
集中整理 客戶端安裝、訂閱匯入 與 路由分流。設定名稱與客戶端介面保持一致，依照步驟即可完成基本設定。
永久免費
程式碼開源
Xray 與 V2Fly 生態系
中文設定文件
客戶端設定面板
訂閱、路由與系統接管
先選擇使用情境，再查看對應設定項目。範例名稱採用客戶端中的常見選單與規則語法。
規則由上到下比對
以明確條件決定 direct 與 proxy 出站
路由規則適合處理固定網域分類、私有位址與其餘連線。常見做法是讓 geosite:cn 與 geoip:private 使用 direct，再讓 geosite:geolocation-!cn 使用 proxy。規則命中後通常會停止繼續檢查，因此具體規則應放在寬泛規則之前。
修改後儲存路由設定，並確認目前執行模式使用規則分流
接管範圍選擇
系統代理處理一般應用程式，TUN 涵蓋更多連線
瀏覽器與遵循系統代理的桌面應用程式，通常啟用「系統代理」即可。遇到不讀取系統代理的程式，再評估啟用 TUN 模式。TUN 會擴大流量接管範圍，首次啟用可能需要系統授權；切換前應先確認路由與 DNS 設定，避免將本機服務錯誤送往代理出站。
先使用系統代理驗證設定，再依應用程式需求啟用 TUN
設定匯入
區分單一分享連結與持續更新的訂閱位址
單一設定可從剪貼簿或 QR Code 匯入，適合臨時新增。訂閱位址應儲存至分組，之後透過更新動作同步內容。匯入後先核對協定、位址、連接埠、傳輸方式與 TLS 相關欄位；QR Code 辨識失敗時，可改為複製完整連結，避免截圖壓縮影響辨識。
匯入完成後選擇設定，再啟動本機 VPN 接管
系統網路授權
本機 VPN 模式負責將應用程式連線交由客戶端處理
Android 客戶端啟動時會要求系統網路連線授權，這是建立本機接管通道的必要步驟。授權後，狀態列會顯示系統網路圖示。若啟動後應用程式仍無法連線，應依序檢查目前設定、路由模式、DNS、分應用程式範圍與省電限制，而不是只觀察主介面的啟動按鈕。
系統授權只需依照系統提示確認，設定內容仍由客戶端管理
應用程式範圍
納入模式與排除模式只能選擇其中一種邏輯
分應用程式代理適合讓部分程式使用目前設定，或讓本機服務維持原有連線。納入模式只處理勾選的應用程式，排除模式則處理未被排除的應用程式。設定前先確定目標範圍，再檢查新安裝的應用程式是否需要加入清單，避免同時使用相反邏輯造成判斷混亂。
修改應用程式範圍後重新啟動連線，讓系統重新建立接管關係
協定欄位
協定名稱相同，不代表傳輸參數可以互換
VMess、VLESS、Trojan 與 Shadowsocks 使用不同的身分欄位與連線方式。匯入設定時還要同時核對 TCP、WebSocket、gRPC、TLS、REALITY 等傳輸層參數。客戶端會將這些欄位交由對應核心處理，但不會自動修復缺少的伺服器名稱、路徑或公鑰設定。
先確認協定，再逐項核對傳輸、安全層與位址欄位
解析路徑
DNS 結果應與網域路由採用一致的判斷邏輯
網域規則依賴解析與嗅探結果。基本設定可先使用客戶端預設 DNS，再依分流需求設定本機與遠端解析。啟用 FakeDNS 或 TUN 後，需同步檢查 DNS 接管範圍、私有網域與區域網路位址；否則可能出現規則看似命中，實際連線卻走錯出站的情況。
DNS 調整應一次只修改一組設定，並透過日誌觀察實際查詢路徑
逐層排查
分開檢查訂閱、設定、核心啟動與系統接管
訂閱更新失敗不等於現有設定無法執行，伺服器測試失敗也不一定是系統代理問題。排查時先確認訂閱能否解析，再確認設定欄位與核心日誌，接著檢查系統代理或本機 VPN 是否已接管目標應用程式。依層次記錄結果，比連續更換多項設定更容易找到原因。
日誌中的第一個明確錯誤通常比後續連鎖提示更有參考價值
依平台選擇
V2Ray 客戶端下載入口
桌面端使用 v2rayN。Android 可在 v2rayNG 與 v2flyNG 之間依核心需求選擇。首頁只負責平台定位，具體安裝包類型與系統要求會列在下載頁。
Windows
選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面，WPF 版保留熟悉的 Windows 操作方式，兩者都能管理訂閱、路由與系統代理。
前往下載macOS
v2rayN 提供適用於不同晶片架構的安裝入口。下載前先在「關於本機」查看晶片類型，首次執行時再依系統提示處理應用程式與網路權限。
前往下載Android
v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。多數較新的裝置可優先選擇 arm64 架構；不確定裝置架構時，再使用通用安裝包。
前往下載Linux
v2rayN 提供 deb 與 rpm 兩類桌面安裝入口，並區分 x64 與 arm64。應依發行版的套件格式與處理器架構選擇對應檔案。
前往下載快速入門
從安裝到規則分流的三個步驟
先完成最小可用設定，再逐步加入路由、DNS 與 TUN 設定。一次修改太多選項，會增加故障定位難度。
-
1
安裝客戶端並匯入訂閱
依平台進入下載頁。Windows、macOS 與 Linux 使用 v2rayN；Android 可選擇 v2rayNG 或 v2flyNG。安裝完成後開啟「訂閱分組」，建立新分組並貼上完整訂閱位址，再執行更新。若使用單一分享連結，可從剪貼簿匯入，但單一連結不像訂閱一樣能集中更新。
更新後先查看伺服器清單是否出現內容。清單為空時，重點檢查位址是否在複製時被截斷、分組篩選條件是否過於嚴格，以及更新動作是否套用至目前分組。此時無須急著修改系統代理，因為訂閱解析發生在連線之前。
-
2
選擇設定並啟用系統接管
在伺服器清單中選取一筆設定並設為作用中項目。桌面端先啟用「系統代理」，讓瀏覽器與讀取系統代理的應用程式使用目前設定；Android 啟動連線後依系統提示授予本機 VPN 權限。完成後先造訪常用頁面，確認基本連線正常。
只有在目標程式不讀取系統代理，或確實需要涵蓋更多網路連線時，才考慮 TUN 模式。啟用後應檢查本機開發服務、區域網路裝置與 DNS 是否仍能依預期存取。基本連線尚未確認前，不建議同時啟用複雜路由與 FakeDNS。
-
3
新增路由規則並查看日誌
基本連線穩定後，再設定規則分流。規則依序比對，建議先放具體網域或私有位址條件，再放涵蓋範圍更廣的規則。常見寫法包括
geosite:cn、geoip:private與geosite:geolocation-!cn，對應出站可設定為 direct 或 proxy。儲存後重新載入設定，並透過日誌確認規則、DNS 與出站選擇。出現問題時回到上一步，逐項撤銷最近的修改，不要同時更換訂閱、協定、DNS 與系統接管方式。如此才能明確判斷是哪一層設定影響連線。
開源生態系
Project V、V2Fly 與 Xray 的關係
了解客戶端、核心與協定之間的分工，有助於判斷設定錯誤發生在哪一層。圖形客戶端負責匯入、編輯與啟停；核心負責解析協定、建立連線及執行路由；訂閱則是批次傳遞設定的載體。
Project V 與 V2Fly
Project V 建立了以 V2Ray 設定體系、協定實作與路由能力為核心的開源生態系。V2Fly 延續並維護相關核心元件，保留常見的入站、出站、路由、DNS 與傳輸設定結構。v2flyNG 採用 V2Fly 核心，適合希望維持此核心體系的 Android 使用者。
「V2Ray」在日常使用中常被同時用來指稱生態系、設定方式與客戶端類別，但這些概念並不完全相同。遇到錯誤時，應先確認提示來自圖形介面、訂閱解析還是核心執行日誌。區分不同層次，可以避免將客戶端介面問題誤判為協定問題。
Xray 核心家族
Xray 在相近的設定生態系上持續擴充協定與傳輸能力。v2rayN 可依具體功能與設定使用相應核心元件，v2rayNG 則以 Xray 核心作為 Android 端的主要執行層。VLESS、REALITY、gRPC 等欄位能否正常運作，不只取決於客戶端名稱，也取決於核心支援、伺服器設定與參數是否完整對應。
客戶端匯入連結後會將欄位轉換為內部設定，但轉換不代表所有組合都有效。例如伺服器名稱、流量控制、指紋、公鑰、短識別碼、路徑與主機欄位各有明確用途。出現握手錯誤時，應對照協定與傳輸層逐項檢查，而不是只在多個設定之間反覆切換。
三款客戶端的開源特性
v2rayN 是面向 Windows、macOS 與 Linux 的桌面圖形客戶端，提供伺服器清單、訂閱分組、路由設定、系統代理、TUN 與日誌等管理入口。v2rayNG 與 v2flyNG 面向 Android，操作方式相近，但使用的核心家族不同。三者皆由社群持續維護，發佈節奏與平台支援範圍不必完全同步。
開源授權讓社群能審閱程式碼、討論實作並持續改善相容性。對一般使用者而言，更直接的價值在於設定名稱、設定結構與問題討論都能公開理解。選擇客戶端時仍應以作業系統、核心需求、協定欄位與使用習慣為依據，而不是只比較介面外觀。
更新機制與設定相容性
客戶端更新、核心更新與訂閱更新是三種不同的動作。客戶端更新會改變圖形介面與功能整合；核心更新會影響協定實作與執行行為；訂閱更新只同步設定內容。排查更新問題時，應先確認是哪一層發生變化，並保留目前可用的設定以便比對。
舊設定通常仍可在新版本中匯入，但新增欄位可能需要重新儲存或手動補充。使用多個訂閱的使用者應為分組設定清楚名稱，避免更新錯誤來源。路由與 DNS 等本機設定也應獨立記錄，因為它們不一定包含在遠端訂閱中。
常見問題精選
安裝、訂閱與連線判斷
以下問題用於快速確定排查入口。完整原因、介面路徑與處理步驟收錄於 FAQ 與進階設定手冊中。
geosite 與 geoip 應如何排列
規則由上到下比對，具體條件應放在寬泛條件之前。網域使用 geosite 分類，目標位址使用 geoip 分類，私有位址通常應優先直連。
查看路由規則實戰 →教學動態