Windows
推薦使用 v2rayN。桌面版採用跨平台介面，經典 WPF 版適合偏好傳統 Windows 操作方式的使用者。安裝後可從訂閱群組開始設定，再啟用系統代理驗證連線。
客戶端設定重點
從訂閱匯入到 路由與 DNS
圖形客戶端的核心操作不只是新增一筆訂閱。群組方式、代理入口、路由規則與 DNS 查詢路徑會共同決定連線是否穩定、哪些程式經過代理，以及區域網路與本機服務能否如預期存取。以下依實際設定順序拆分成四個關鍵環節。
清單管理
依來源整理訂閱與伺服器
訂閱群組適合同時維護多個設定來源。每個群組都能分別設定更新間隔、啟用狀態與伺服器篩選條件，更新時不會把不同來源混在同一批操作中。初次使用可先建立一個主要群組，匯入訂閱網址後手動更新一次，再確認伺服器項目是否出現。設定來源增加後，再依用途或提供者拆分群組，比依賴名稱前綴尋找項目更清楚。
伺服器清單過長時，可用包含或排除關鍵字縮小顯示範圍，然後針對目前群組執行實際連線測試。篩選只會改變清單整理方式，不會修改訂閱提供的原始設定；需要恢復時清除條件即可。
訂閱群組
已啟用
主要訂閱
自動更新 · 群組篩選
✓
備用設定
手動更新 · 獨立管理
○
篩選條件
包含關鍵字
連線方式
分別使用系統代理與 TUN 模式
系統代理適合瀏覽器與遵循作業系統代理設定的桌面程式，啟用後操作直觀，也方便在首次連線時排查問題。TUN 模式透過虛擬網路介面處理更多類型的應用程式流量，適合不讀取系統代理設定的軟體，但通常需要額外權限，也可能受到其他網路工具、虛擬網卡或防火牆規則影響。
建議先使用系統代理完成訂閱匯入、伺服器選擇與網頁存取驗證。確認基本連線正常後，再依應用程式需求切換至 TUN。若切換後出現本機服務無法存取或網路中斷，應先退出 TUN，再檢查權限、路由與 DNS 選項，而不是同時修改多項設定。
代理入口
GENERAL
系統代理
瀏覽器與桌面程式
TUN 模式
虛擬網路介面
區域網路連線
依需求個別啟用
規則優先順序
讓直連、代理與阻擋規則有明確順序
路由分流會依網域、IP、連接埠或網路類型決定連線出口。常見做法是讓區域網路位址與本機服務保持直連，將需要代理的目標交給目前伺服器，並把明確不需要存取的目標放入阻擋規則。規則通常會由上而下比對，因此範圍較窄的例外項目應放在通用規則之前，避免被更寬泛的條件提前命中。
調整分流時一次只修改一組規則，並以具體網站或應用程式驗證結果。若規則依據網域，而連線實際只呈現 IP，請同時檢查 DNS 解析與網域嗅探設定。複雜規則應保留簡短備註，方便日後理解設定目的。
路由規則
由上而下
private
直連
domain:example
代理
protocol:bittorrent
阻擋
拖曳規則可調整比對順序
解析路徑
讓 DNS 查詢與路由結果相互對應
DNS 設定會影響網域解析成哪個位址，也會間接影響路由規則能否正確辨識目標。基本使用時可以先保留客戶端建議設定，確認訂閱與系統代理正常運作後再調整。需要分別處理直連網域與代理網域時，可設定不同的解析伺服器，並讓查詢路徑與最終連線出口一致，減少解析結果與實際路由互相衝突。
遇到網頁能開啟但應用程式連線失敗、同一網域結果反覆變化，或切換模式後短暫異常時，可先清除系統 DNS 快取並重新啟動客戶端。不要大幅同時修改 DNS、TUN 與路由規則，否則很難判斷問題來自哪一層。
DNS 設定
DNS
直連查詢
跟隨本地網路
代理查詢
依路由規則處理
快取解析結果
減少重複查詢
依作業系統選擇
四個平台的 客戶端入口
桌面平台以 v2rayN 為主要選擇，Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。進入下載頁後，還能依處理器架構與安裝形式選擇對應檔案。
macOS
使用 v2rayN 的 macOS 版本。下載前先在系統資訊中確認 Apple Silicon 或 Intel 處理器，選擇對應安裝檔案，避免架構不相容。首次啟動後依系統提示完成必要授權。
Android
優先選擇採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時可使用 v2flyNG。多數近年裝置適合 arm64 版本，無法確認處理器架構時可選擇通用版本。
Linux
使用 v2rayN 的 Linux 版本，並依發行版的套件管理系統選擇 deb 或 rpm。還需要區分 x64 與 arm64 架構；安裝完成後，可從桌面入口啟動，並設定系統代理或 TUN。
快速上手
安裝後的 三個操作
第一次設定建議依固定順序操作：先匯入訂閱，再選擇伺服器並完成實際連線測試，最後啟用系統代理並檢查出口。如此每一步都有明確結果，發生問題時也能快速定位是訂閱、伺服器還是本機代理設定。
查看完整教學 →-
01
匯入訂閱並更新群組
在客戶端中開啟訂閱群組，建立新群組後貼上服務提供者給出的訂閱網址，儲存並執行更新。更新完成後應能看到設定項目；若清單為空，先檢查群組是否啟用、網址前後是否混入空格，以及目前網路能否存取訂閱來源。不要急著重複建立群組，先在記錄中確認更新請求的結果。
-
02
選擇伺服器並進行實際連線測試
從目前訂閱群組中選擇一個項目，執行實際連線測試或直接設為啟用中的伺服器。測試結果反映建立實際連線所需的時間，比只進行基本網路探測更接近日常使用情況。若多個項目都無法連線，應優先確認訂閱是否過期、系統時間是否準確，以及核心是否正常載入，而不是連續切換代理模式。
-
03
啟用系統代理並驗證出口
初次連線先啟用系統代理，再使用瀏覽器存取常用網頁，檢查出口位址是否如預期變更。瀏覽器正常而其他程式未生效，通常表示該程式不遵循系統代理設定，此時再考慮 TUN 模式或應用程式本身的代理選項。完成驗證後，可繼續設定路由規則、開機啟動與訂閱更新間隔。
開放原始碼生態說明
Project V、V2Fly 與 Xray 核心家族
理解客戶端與核心的關係，有助於判斷更新內容來自介面層、核心處理層，還是協議實作層。圖形客戶端負責訂閱、清單、規則與系統整合，核心負責協議處理、路由執行與網路連線；兩者分工不同，也可能採用不同的發布節奏。
Project V 的生態起點
Project V 是圍繞代理協議、路由能力與可組合網路工具形成的開放原始碼生態。早期 V2Ray 奠定了設定結構，以及多入站、多出站、路由比對等基礎概念，之後社群維護方向逐漸形成不同分支。如今常見的客戶端並非重新實作所有功能，而是透過呼叫核心，將複雜設定整理成適合桌面或行動裝置操作的圖形介面。
因此，看到「V2Ray 客戶端」時應區分三個層次：使用者操作的圖形客戶端、執行連線與規則的核心，以及由訂閱或手動設定描述的協議參數。排查故障時也應分層判斷：介面沒有匯入項目屬於訂閱管理問題，核心啟動失敗屬於核心問題，特定網域出口不符合預期則多半與路由或 DNS 有關。
V2Fly 與 Xray 的分工關係
V2Fly 延續 V2Ray 社群分支的維護方向，保留可組合的設定體系，並持續更新協議、傳輸與路由能力。Xray 則是生態中的另一套核心家族，在相容常見設定思路的基礎上發展自己的協議實作與功能組合。兩者不是圖形客戶端，也不直接等同於某個作業系統上的應用程式介面。
選擇核心時，重點應放在訂閱所需的協議、客戶端支援情況與現有設定相容性。多數使用者不需要頻繁手動切換核心；如果訂閱提供者明確要求某項核心能力，或記錄提示目前核心無法識別設定欄位，再依說明調整。核心更新後若出現行為變化，可先查看客戶端記錄與設定遷移提示，不宜同時重做所有訂閱與路由設定。
三款客戶端各自負責什麼
v2rayN 是桌面平台常用的圖形客戶端，支援 Windows、macOS 與 Linux，提供訂閱群組、伺服器清單、系統代理、TUN、路由、DNS 與核心管理等入口。相同功能在不同桌面系統上的授權方式與系統整合細節可能不同，但主要設定邏輯一致，適合需要跨桌面平台沿用相同操作習慣的使用者。
v2rayNG 面向 Android，通常搭配 Xray 核心使用，介面圍繞設定清單、訂閱更新、路由與連線開關組織。v2flyNG 同樣面向 Android，但使用 V2Fly 核心，適合作為有明確核心需求時的替代選擇。兩款行動客戶端都能匯入訂閱，也能維護獨立設定；遷移時應先確認訂閱支援的協議與欄位。
開放原始碼與更新機制
客戶端與核心採用開放原始碼方式維護，功能討論、錯誤修正與發布由各自專案社群推進。開放原始碼授權條款規定程式碼使用與再散布的界線，也讓實作細節能夠接受審閱。不同專案採用的具體授權條款可能不同，使用、修改或重新發布程式碼時，應以專案隨附的授權條款文字為準。
客戶端更新通常涉及介面、系統整合、訂閱處理與核心呼叫方式；核心更新則更集中於協議實作、傳輸、路由、DNS 與執行效率。兩類更新不一定同時發生。日常使用中，建議先閱讀發布說明，確認是否包含設定遷移或系統權限變更，再安排更新。遇到異常時保留記錄與目前設定，比只描述「無法連線」更有助於定位原因。
技術筆記
繼續了解客戶端與 開放原始碼生態
以下三篇文章涵蓋主介面結構、核心生態關係與多訂閱管理，適合完成首次連線後繼續閱讀。
v2rayN 主介面功能詳解：伺服器清單、訂閱群組、記錄與設定區
按區塊拆解伺服器清單各欄位的意義、訂閱群組標籤、記錄視窗與參數設定入口，建立清楚的介面操作順序。
閱讀全文 →Project V、V2Fly 與 Xray 是什麼關係：開放原始碼生態與客戶端對應整理
整理 Project V 的起源、V2Fly 社群分支與 Xray 核心家族，以及 v2rayN、v2rayNG、v2flyNG 各自對應的平台與核心。
閱讀全文 →v2rayN 訂閱群組設定：多來源訂閱管理與伺服器篩選實戰
用訂閱群組隔離不同來源，分別安排更新時間與關鍵字篩選條件，再依群組批次測試並整理伺服器清單。
閱讀全文 →常見問題精選
安裝、訂閱與連線的 判斷順序
多數首次使用問題可以依「安裝檔案—訂閱更新—伺服器連線—系統代理—路由與 DNS」的順序排查。不要在同一輪操作中修改多個層級，否則很難確認是哪項調整產生了結果。
桌面平台應該先選擇哪個客戶端？
Windows、macOS 與 Linux 可先選擇 v2rayN。它將訂閱群組、伺服器清單、系統代理、TUN、路由與 DNS 集中在同一套桌面介面中。下載前需要確認作業系統與處理器架構，安裝後先用系統代理完成基本連線驗證，再依具體應用程式需求決定是否啟用 TUN。
匯入訂閱後伺服器清單為空怎麼辦？
先確認訂閱群組處於啟用狀態，並手動執行一次更新。接著查看記錄中是否出現網址無法存取、內容格式無法辨識或網路請求失敗等提示。也應檢查訂閱網址前後是否帶有空格。若更新成功但篩選後的清單為空，清除群組篩選條件後重新查看原始項目。
系統代理和 TUN 模式應該同時啟用嗎？
初次使用不建議同時啟用。先使用系統代理驗證瀏覽器與常用桌面程式，確認訂閱、伺服器與核心正常運作。只有確實需要接管不讀取系統代理的應用程式時，再單獨測試 TUN。切換過程中若網路異常，先恢復原本模式，再逐項檢查權限、虛擬網卡、路由與 DNS。
為什麼測試正常，但某個應用程式仍然無法連線？
測試正常只代表客戶端能與目前伺服器建立連線，不代表所有應用程式都會自動使用系統代理。先確認該應用程式是否遵循系統代理，再檢查應用程式本身是否設定獨立代理、是否使用特殊網路介面，以及路由規則是否將目標設為直連或阻擋。若問題只發生在網域存取，還需要檢查 DNS 解析路徑。