桌面客戶端
前往下載
Windows
Windows 使用者可選用 v2rayN，並在新一代桌面介面與經典 WPF 介面之間選擇。前者的介面結構更接近其他桌面平台，後者適合熟悉傳統選單與系統匣操作的使用者。安裝完成後先匯入訂閱，再設定系統代理，或依需求啟用 TUN 模式。
客戶端下載入口
依目前裝置選擇安裝包
桌面平台統一使用 v2rayN，Android 可在 v2rayNG 與 v2flyNG 之間選擇。下載頁會依處理器架構與安裝格式區分入口，先確認平台，避免將不適用的檔案帶入後續安裝流程。
桌面客戶端
前往下載
macOS
macOS 使用 v2rayN 桌面版，下載前需先確認裝置採用 Apple Silicon 或 Intel 處理器。處理器架構只會影響安裝包選擇，不會改變訂閱格式與路由設定。首次執行後，建議先完成系統權限確認，再匯入訂閱並驗證瀏覽器是否遵循系統代理。
行動客戶端
前往下載
Android
Android 首選 v2rayNG，其核心路線與介面操作適合常見訂閱設定；需要使用 V2Fly 核心時則可選擇 v2flyNG。多數較新的裝置可使用 arm64 安裝包，不確定架構時再使用通用安裝包。連線前也要允許客戶端建立本機網路連線。
桌面客戶端
前往下載
Linux
Linux 使用 v2rayN，並依發行版的套件體系選擇 deb 或 rpm，再按裝置架構區分 x64 與 arm64。安裝後若圖形介面能啟動，但應用程式流量沒有進入客戶端，應分別檢查桌面環境的代理設定、終端機環境變數，以及 TUN 所需的權限。
設定重點
從訂閱內容到實際流量路徑
客戶端顯示連線狀態，只能代表核心程序已進入執行階段。要判斷設定是否完整，還需繼續檢查訂閱內容、使用中的伺服器、代理接管方式、路由命中結果與執行記錄。以下四個主題對應最常見的設定流程。
先確認訂閱網址與群組，再將伺服器清單更新至本機。
規則依序比對，第一條命中的規則決定請求的出站方式。
先用系統代理完成基礎驗證，再依應用程式範圍決定是否啟用 TUN。
狀態列只會顯示結果，執行記錄才會記下連線失敗發生在哪個步驟。
先驗證基礎流程，再增加規則
首次設定時，建議只保留一台明確可用的伺服器，使用最簡單的系統代理方式完成連線驗證。確認瀏覽器請求已經透過客戶端後，再加入路由規則、DNS 策略與 TUN 等設定。若一開始就同時修改訂閱、核心、路由與接管方式，發生問題時很難判斷是哪一項造成影響。
將設定變更控制在可追蹤範圍內
每次只修改一組相關選項，並記錄修改前後的現象。例如更換伺服器後只觀察連線結果，調整路由後只檢查命中與出站，啟用 TUN 後則重點檢查權限與 DNS。這樣的操作節奏雖然多一步確認，卻能大幅減少重複安裝與無方向切換設定所耗費的時間。
快速上手
從安裝到驗證的三個步驟
以下是完整教學的精簡流程，適合已準備好訂閱連結的使用者。每一步都包含明確的檢查點：客戶端能啟動、伺服器清單能更新、實際請求能透過代理。檢查點確認無誤後，再進入下一步。
選擇平台並完成安裝
進入下載中心後，先依作業系統切換平台。Windows 可依介面習慣選擇桌面版或經典 WPF 版；macOS 需依處理器選擇安裝包；Android 可依核心路線選擇 v2rayNG 或 v2flyNG；Linux 則依發行版套件管理體系與處理器架構選擇檔案。安裝完成後先啟動客戶端，確認主介面、系統匣選單或連線權限都能正常使用。
若系統阻止首次執行，應從系統提供的應用程式權限入口確認檔案來源與執行權限，不要透過反覆解壓縮或重複安裝來繞過問題。Linux 環境還需確認桌面元件與安裝相依套件是否完整。此階段先不要修改複雜路由，目標只是讓客戶端穩定啟動並能進入設定介面。
匯入訂閱並選擇伺服器
在訂閱群組中新增連結，儲存後對該群組執行一次手動更新。更新成功後應能看到伺服器項目；若群組存在但清單為空，先檢查連結是否完整，再確認更新動作是否套用於正確群組。清單出現後，選擇一台伺服器作為使用中的項目，並使用實際連線測試或直接存取進行驗證，不要只依賴網路層的簡單回應結果。
訂閱內容可能包含多種協定與傳輸組合，客戶端會依設定呼叫對應核心能力。使用者通常不需要手動改寫每個欄位，但伺服器端與客戶端參數必須保持一致。若記錄提示驗證、位址或傳輸參數錯誤，應回到訂閱來源確認設定，而不是隨機切換本機選項來碰運氣。
啟用代理並確認流量生效
桌面端可先啟用系統代理，讓遵循系統設定的瀏覽器與應用程式使用客戶端。Android 端連線時需確認系統網路連線授權。接著開啟一個未快取的頁面進行驗證，同時觀察客戶端記錄是否出現對應請求。確認請求進入正確出站後，才代表應用程式、系統代理與客戶端核心之間的流程已經打通。
若瀏覽器可用但命令列工具無法使用，通常表示兩者讀取代理設定的機制不同；若啟用 TUN 後所有請求都異常，則應檢查權限、DNS 與路由衝突。不要只看客戶端的連線圖示，最終判斷應綜合實際存取、記錄與路由命中結果。
生態系與核心
Project V、V2Fly 與 Xray 的關係
客戶端名稱、核心名稱與協定名稱經常同時出現。了解三者的層級後，下載與排錯會更直接：圖形化客戶端負責互動與設定管理，核心負責網路處理，協定與傳輸參數則描述客戶端和伺服器如何通訊。
從 Project V 生態系理解客戶端結構
Project V 建立了一套圍繞代理協定、路由能力與網路傳輸的工具生態系。隨著專案演進，V2Fly 延續了 V2Ray 相關實作與社群維護，Xray 則沿著相同技術脈絡發展出不同的功能重點與更新節奏。兩條核心路線共享不少概念，但具體協定能力、設定欄位與實作進度可能不完全同步。
v2rayN、v2rayNG 與 v2flyNG 都屬於圖形化客戶端，並不等同於底層核心。它們負責訂閱管理、伺服器清單、系統代理、路由設定與記錄顯示，再將整理後的設定交給核心執行。因此，介面顯示正常不代表所有核心參數都有效；遇到連線問題時，需要同時核對客戶端設定、目前使用的核心與伺服器設定。
這種分層結構也說明了為什麼同一份訂閱在不同客戶端中的顯示可能略有差異。客戶端會依自身的介面模型讀取設定，核心再依支援範圍執行。選擇客戶端時，應優先考量目前的作業系統、所需核心路線與使用習慣，而不是把所有產品名稱視為完全相同的替代品。
v2rayN：桌面端設定入口
v2rayN 支援 Windows、macOS 與 Linux，提供訂閱群組、伺服器選擇、系統代理、TUN、路由與記錄等圖形化設定。不同桌面平台的安裝格式各異，但訂閱匯入與基礎設定邏輯一致，適合需要在多台桌面裝置上沿用操作流程的使用者。
v2rayNG：Android 與 Xray 路線
v2rayNG 專為 Android 設計，通常搭配 Xray 核心路線使用。介面以行動裝置的連線授權、伺服器切換、路由與依應用程式處理為主。行動網路切換頻繁，排錯時除了設定本身，也要留意 Wi-Fi 與行動網路的變化、背景限制及系統網路授權。
v2flyNG：Android 與 V2Fly 路線
v2flyNG 同樣面向 Android，主要差異在於採用 V2Fly 核心路線。若訂閱設定明確依賴 V2Fly 的實作方式，或希望維持該核心體系的一致性，可以選擇 v2flyNG。選型時應以伺服器設定與實際協定需求為準。
開源授權與程式碼審閱
這些專案以開源方式維護，授權條款會規範程式碼的使用、修改與再散布條件。開源特性的實際價值在於實作細節可以接受審閱，問題能針對具體程式碼與設定討論，衍生客戶端也必須遵守相應授權。使用者仍應從明確的下載入口取得適合自身平台的版本，並閱讀版本說明與設定變更。
社群維護與更新節奏
圖形化客戶端與底層核心由不同專案維護，發布節奏不必完全一致。客戶端更新可能調整介面、安裝方式或設定轉換邏輯，核心更新則可能改變協定實作、路由行為與參數支援。升級後出現行為差異時，應先判斷變化屬於客戶端層或核心層，再決定檢查設定、記錄或訂閱內容。
協定支援不只是單一標籤
協定名稱只是設定的一部分，位址、連接埠、身分參數、傳輸方式、TLS 相關設定與路由動作都可能影響連線。即使兩個客戶端都列出相同協定，也應確認它們呼叫的核心、參數支援範圍與設定格式。遇到相容性問題時，從完整設定流程檢查，比只比較協定名稱更有效。
常見問題精選
安裝後先檢查哪些地方
多數首次設定問題集中在訂閱未更新、未選擇使用中的伺服器、應用程式未讀取系統代理，以及路由或 DNS 修改過多。以下四個入口提供判斷方向，相關概念可在術語手冊中繼續查閱。
訂閱匯入後為什麼沒有伺服器？
先確認訂閱群組已儲存，再手動更新該群組並查看記錄。群組名稱存在只代表連結記錄已建立，不代表訂閱內容已成功下載與解析。若記錄出現請求錯誤，應檢查連結完整性與目前網路；若下載完成但解析失敗，則要核對訂閱格式。
查看訂閱與節點術語 →系統代理啟用後，為什麼部分程式沒有作用？
不同程式讀取代理設定的方式並不一致。瀏覽器通常會遵循系統代理，部分終端機工具、開發環境與獨立網路程式則需要自行設定代理參數，或改用 TUN 接管。應先區分是單一程式未接入，還是所有流量都未經過客戶端。
查看系統代理與 TUN →測試顯示可用，但網頁仍然打不開怎麼辦？
測試結果只能涵蓋某一段連線流程。請繼續檢查系統時間、DNS、路由命中、使用中的伺服器與應用程式代理設定，清除記錄後再重新發起一次存取。若記錄沒有對應請求，問題多半發生在應用程式與客戶端之間；若已有請求與錯誤，再依關鍵字定位核心或設定。
查看記錄與排錯術語 →什麼時候需要啟用 TUN 模式？
當目標應用程式不讀取系統代理，或需要統一處理更廣泛的網路流量時，可以考慮使用 TUN。啟用前應先透過系統代理驗證基礎連線，之後再處理權限、DNS 與區域網路路由。如此能將伺服器設定問題與流量接管問題分開判斷。
查看路由與分流術語 →
教學動態
近期設定與排錯文章
文章聚焦於實際操作中的單一問題，分別說明檢查順序、記錄依據與設定項目之間的關係。遇到具體故障時，可以先依標題選擇最接近的情境，再回到完整文件補充相關概念。
代理已連線但無法上網：v2rayN 與 v2rayNG 逐項排查清單
依序檢查伺服器可用性、系統時間、DNS、路由規則與系統代理五個環節，區分連線狀態與實際請求是否成功經過客戶端。
閱讀全文 →v2rayN 執行記錄怎麼看：常見錯誤訊息含義與定位思路
解釋 rejected、timeout、invalid user 等常見記錄關鍵字，並說明如何從錯誤時間、目標位址與出站標籤定位到具體設定項目。
閱讀全文 →Xray 與 V2Fly 核心差異詳解：版本關係與客戶端選擇
整理兩個核心在 Project V 技術脈絡中的關係，再對應到 v2rayN、v2rayNG 與 v2flyNG 的平台與核心選擇。
閱讀全文 →