DESKTOP / WPF
Windows
Windows 使用者可選擇 v2rayN 新一代桌面介面或經典 WPF 介面。兩者都能管理訂閱、系統代理、路由規則與核心控制；新安裝可先從桌面版開始，已有穩定設定的使用者則可繼續採用熟悉的 WPF 操作路徑。
前往下載CLIENT OPERATIONS
訂閱、線路與本機流量處理
客戶端設定不只是填入一條連結。訂閱更新、伺服器篩選、路由比對、DNS 出站與 TUN 接管會共同決定連線結果。
MODULE / 01
訂閱匯入與伺服器整理
訂閱網址用於批次取得伺服器設定。匯入後應先執行一次更新，再依協定、地區或自訂備註整理伺服器，避免在冗長的名稱清單中反覆尋找。v2rayN 可建立訂閱群組並使用篩選條件，v2rayNG 則適合在行動裝置上維護少量常用群組。更新失敗時，先區分連結失效、更新請求需要經過代理、回應格式不相容與客戶端權限問題，不要直接刪除現有設定。完成更新後再選取伺服器並設為使用中項目；有訂閱不代表線路已經啟用。
查看訂閱匯入步驟 →MODULE / 02
路由規則與流量分流
路由規則會根據網域、IP、連接埠、網路類型與程序資訊決定流量走向。常見做法是先設定區域網路與必要的直連項目，再處理代理規則，最後保留明確的預設出口。規則順序會影響結果：前面的比對項目通常會優先採用，因此範圍較窄的規則應放在範圍較廣的集合之前。GeoIP 與 GeoSite 是比對資料，不是連線協定；更新資料後還要確認規則名稱與客戶端核心能夠識別。調整前先匯出目前設定，修改後使用具體網域逐項驗證。
閱讀路由規則實作 →MODULE / 03
DNS 查詢與網域判定
DNS 設定決定網域如何解析，也會影響依網域建立的路由規則。客戶端通常可分別指定本機 DNS、遠端 DNS、查詢策略與 DNS 出站。若系統解析結果與代理連線使用的解析結果不一致，可能出現網域規則比對異常、連線目標變更或應用程式反覆重試。設定時應明確哪些查詢走本機出口、哪些查詢交由代理端處理，並確認 IPv4、IPv6 策略符合目前網路。啟用 FakeDNS 前還要確認應用程式相容性及 TUN 模式的接管範圍。
查看 DNS 設定章節 →MODULE / 04
TUN 模式與系統流量接管
TUN 模式透過虛擬網路介面接管更多系統流量，適合無法讀取系統代理設定的應用程式，也適合需要統一套用路由規則的情境。它與一般系統代理的涵蓋範圍不同，啟用時通常需要額外權限，並可能與其他網路過濾工具、虛擬網卡或安全策略衝突。首次設定應保持規則簡潔，確認網頁、命令列工具與常用應用程式都能正常連線後，再逐步加入程序規則、DNS 劫持或 FakeDNS。停止客戶端前先還原相關網路設定，可降低下次啟動時的排查成本。
繼續閱讀 TUN 模式 →MODULE / 05
客戶端更新與故障定位
出現無法連線、訂閱更新失敗或規則未生效時，先將問題拆分為客戶端、訂閱、伺服器、核心、DNS 與本機網路六個層次。日誌中的時間、出站標籤、網域與錯誤類型，比單一測速結果更具判斷價值。更新客戶端前可匯出訂閱群組、路由與 DNS 設定，更新後先使用原設定驗證，再決定是否啟用新增選項。若只有某個應用程式異常，應比較系統代理與 TUN 模式的接管差異；若所有線路同時異常，則優先檢查本機網路、訂閱狀態與核心啟動日誌。
開啟進階排查手冊 →PLATFORM DOWNLOADS
四大平台的客戶端入口
桌面端以 v2rayN 為主，Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。具體安裝包類型、處理器架構與系統要求會在下載頁分組列出。
DESKTOP / DMG
macOS
macOS 使用 v2rayN 桌面客戶端，下載時需要依裝置處理器選擇 Apple Silicon 或 Intel 安裝包。安裝完成後可匯入訂閱、切換系統代理並編輯路由；若系統阻止首次執行，應在系統安全性設定中確認應用程式權限。
前往下載MOBILE / APK
Android
Android 首選 v2rayNG，它以 Xray 核心處理常見協定與路由設定；需要 V2Fly 核心時可選擇 v2flyNG。主流裝置通常使用 arm64 安裝包，無法確定處理器架構時再選擇通用安裝包，避免下載與裝置架構不相容的檔案。
前往下載DESKTOP / DEB · RPM
Linux
Linux 桌面可使用 v2rayN，依發行版的套件系統選擇 deb 或 rpm，並進一步區分 x64、arm64 架構。安裝後需要留意桌面環境、系統代理寫入方式與 TUN 權限；伺服器環境則應優先理解設定與服務管理，而不是照搬桌面操作。
前往下載-
STEP 01
匯入訂閱並執行更新
複製完整訂閱網址，在客戶端的訂閱群組中新增記錄，然後手動執行一次更新。更新完成後檢查伺服器清單是否出現、備註是否可讀、協定欄位是否正確識別。若清單為空，應先處理訂閱回應，而不是繼續調整系統代理。
-
STEP 02
選擇伺服器與代理模式
從伺服器清單中選擇一項設定並設為使用中項目，再依用途選擇系統代理或 TUN 模式。首次連線建議保持路由規則簡單，先驗證瀏覽器與常用應用程式；確認基礎連線成立後，再切換規則模式並加入自訂直連或代理條件。
-
STEP 03
連線後檢查日誌與出口
啟動連線後查看客戶端狀態與核心日誌，確認本機監聽連接埠已建立，接著分別測試網域存取與需要代理的應用程式。若連線按鈕已開啟但應用程式仍無法存取，應檢查應用程式是否讀取系統代理、DNS 是否依預期出站，以及規則是否將目標流量送往正確出口。
PROJECT V / CORE FAMILY
Project V、V2Fly 與 Xray 的關係
客戶端負責圖形介面與系統整合，核心負責協定、傳輸、路由與出站處理。理解這層分工，才能看懂客戶端更新說明與設定相容範圍。
從協定工具到客戶端生態系
Project V 是圍繞代理協定、傳輸層、路由與網路工具形成的開源技術生態系。它不等同於某一個圖形化客戶端：桌面或行動客戶端提供訂閱管理、連線按鈕、系統代理、日誌檢視與設定編輯，真正執行網路處理的是客戶端呼叫的核心。使用者在介面中看到的伺服器、路由規則與 DNS 選項，最後會被整理成核心能夠讀取的設定。
V2Fly 延續了 V2Ray 體系中的核心能力，強調開放的協定組合、傳輸設定與路由機制。Xray 則從同一技術家族發展出獨立核心，在 VLESS、XTLS、REALITY 等能力上形成自己的實作方向。兩類核心在不少基礎設定上有共同概念，但功能支援、欄位細節與更新節奏並不完全一致，因此不能只看設定檔外觀判斷相容性。
v2rayN 是桌面圖形化客戶端，可管理不同核心與多組訂閱；v2rayNG 主要在 Android 上搭配 Xray 核心使用；v2flyNG 則面向 V2Fly 核心。三款客戶端都以開放原始碼方式維護，介面專案與核心專案各自發布更新。遇到協定無法識別或新欄位無法儲存時，應同時檢查客戶端支援範圍與所選核心能力。
開源授權與程式碼審閱
v2rayN、v2rayNG、v2flyNG 及其常用核心都有明確的開源授權。開源授權規定程式碼使用、修改與再散布的條件，也讓功能變更能透過原始碼、提交記錄與發布說明接受技術社群審閱。站內以客戶端實際功能與公開文件為依據，不以下載量、評分或無法核實的測試數字取代技術說明。
客戶端與核心分別更新
客戶端更新通常涉及介面、訂閱管理、系統代理寫入與設定產生；核心更新則可能新增協定能力、調整設定欄位或修正網路處理問題。兩者版本節奏不同。排查連線異常時，應記錄客戶端名稱、目前核心家族、使用模式與日誌錯誤，而不是只描述連線按鈕是否亮起。
設定相容性需要逐項確認
VMess、VLESS、Trojan、WebSocket、gRPC、TLS、REALITY 等名詞分別位於協定、傳輸與安全層，不能互相取代。進行訂閱轉換或跨客戶端遷移時，需要確認目標客戶端是否識別所有欄位。若轉換過程遺失流控、傳輸參數或伺服器名稱，連線結果就可能與原客戶端不同。
COMMON QUESTIONS
常見設定問題精選
以下問題涵蓋首次匯入、客戶端選擇、更新失敗與連線後沒有流量四個高頻環節。完整操作步驟收錄於使用指南與進階手冊中。
為什麼匯入訂閱後沒有伺服器？
先確認新增的是訂閱群組，而不是單一伺服器，再執行手動更新。若更新提示回應為空或格式無法識別，應檢查網址是否完整、連結是否仍有效，以及是否需要啟用經代理更新。訂閱尚未取得內容前，不要繼續修改路由規則。
查看匯入步驟 →v2rayNG 與 v2flyNG 要如何選擇？
需要 Xray 核心相關能力時選擇 v2rayNG；明確需要 V2Fly 核心或已有相應設定時選擇 v2flyNG。兩者介面操作相近，但核心支援範圍與部分欄位不同。遷移訂閱後，應檢查協定、傳輸、安全層與路由設定是否完整保留。
查看 Android 客戶端 →連線已開啟但應用程式沒有流量，該怎麼辦？
先確認應用程式是否讀取系統代理；若不讀取，再考慮 TUN 模式。接著檢查使用中的伺服器、路由預設出口、DNS 解析方式與本機監聽狀態。若只有單一應用程式異常，重點比較該應用程式的代理能力與網路權限，不必立即重建所有訂閱。
按層次排查 →為什麼修改路由規則後沒有命中？
檢查規則順序、網域比對類型、出站標籤，以及 GeoIP、GeoSite 資料是否一致。既有連線可能繼續沿用舊路徑，修改後應重新建立連線再測試。若日誌能顯示目標網域與比對出的出站，即可直接判斷問題發生在規則條件，還是後續連線階段。
閱讀路由章節 →TECH NOTES
設定與排查文章
繼續深入 FakeDNS、DNS 洩漏與核心差異，內容包含適用邊界、操作路徑與排查順序。