Windows
v2rayN
提供 Desktop 桌面版與經典 WPF 版。前者採用新一代跨平台介面，後者保留經典操作方式。請先確認作業系統與處理器條件，再閱讀相應安裝說明；初次設定建議只啟動一個執行個體，避免本機監聽連接埠衝突。
前往下載 →先選平台桌面端可查看 v2rayN；Android 裝置可比較 v2rayNG 與 v2flyNG。客戶端負責管理設定，實際連線仍需要可用的節點參數或訂閱網址。
各平台下載入口
安裝包與處理器架構依裝置選擇
macOS
v2rayN
依晶片選擇 Apple Silicon 或 Intel 安裝包，可在「關於這台 Mac」確認。安裝後先完成系統允許啟動應用程式的流程，再匯入訂閱。啟用系統代理後，請確認瀏覽器是否使用系統設定；不能只憑客戶端正在執行，就判定連線已生效。
前往下載 →Android
v2rayNG / v2flyNG
v2rayNG 使用 Xray，v2flyNG 則提供 V2Fly 核心選項。安裝包分為 arm64 與通用版，建議依裝置架構選擇。初次連線須確認系統 VPN 授權；若已有其他 VPN 應用程式執行，請先排除介面占用，再測試節點。
前往下載 →Linux
v2rayN
依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。圖形介面的系統代理設定不一定會被所有應用程式讀取，終端機程式也可能使用獨立的環境變數。安裝完成後先測試瀏覽器，再逐一檢查其他需要代理的程式。
前往下載 →安裝包格式決定「能否安裝」，處理器架構決定「能否執行」，節點與核心的相容性則決定「能否連線」。分開確認這三項，比反覆更換客戶端更容易找出問題。升級前請保留訂閱群組、路由設定與自訂設定；升級後先用原有節點測試連線，再啟用新功能。
查看所有客戶端 →規格表式功能
訂閱、路由與日誌依設定項目查閱
"outbounds": [{ "protocol": "vless" }]訂閱網址與節點清單
訂閱可用來批次取得節點；分享連結通常描述單一節點，原生 JSON 則可能包含完整的入站、出站與路由設定。三款客戶端都提供訂閱匯入功能，但可解析的協定與欄位仍取決於客戶端及核心。匯入後先更新訂閱，確認群組中出現節點，再選取要使用的項目。上方片段是核心的出站鍵名，不是訂閱網址格式；匯入失敗時，請先確認來源格式並查看更新日誌，不要直接將完整設定貼到網址欄。
v2rayNv2rayNGv2flyNG
"routing": { "domainStrategy": "AsIs" }比對順序與預設出站
路由分流會依網域、目標 IP 等條件選擇出站，通常依規則順序處理。三款客戶端都能使用各自介面及核心支援的規則設定，但預設名稱與編輯方式不盡相同。先保留區域網路存取，再安排特定網域規則，最後確認未符合規則的流量會如何處理。規則引用 geosite 或 geoip 時，也請確認資料檔案存在。切換為全域代理有助縮小排查範圍，但無法取代日常分流；測試後應恢復預定模式並再次檢查日誌。
v2rayNv2rayNGv2flyNG
"inbounds": [{ "listen": "127.0.0.1", "protocol": "socks" }]應用程式流量如何進入核心
系統代理會為遵循系統設定的應用程式提供本機代理入口；TUN 則透過虛擬網路介面接收流量。v2rayN 的 TUN 可用性、權限與設定方式，應依平台及使用的核心確認，不能直接將某個作業系統的操作套用到另一個系統。v2rayNG 與 v2flyNG 使用 Android VPN 介面，並非桌面系統代理開關。初次測試建議只啟用一種流量接管方式；連線正常後，再檢查應用程式範圍、區域網路例外與權限，避免同時啟用多種方式而難以判斷路由。
v2rayN · 依平台而異v2rayNG · VPN 介面v2flyNG · VPN 介面
"outbounds": [{ "protocol": "vmess" }]客戶端介面與核心執行能力
客戶端負責管理設定，核心負責處理協定，兩者並非同一層。v2rayN 可管理多種核心，實際選擇取決於安裝內容、節點類型與客戶端設定。v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心，後兩者不應視為通用的多核心切換工具。更換核心前，請確認傳輸方式與欄位相容性，並保留可正常運作的設定。協定名稱相同，不代表所有擴充參數都能通用；遇到未知欄位時，請優先確認設定來源與核心支援範圍。
v2rayN · 多核心v2rayNG · Xrayv2flyNG · V2Fly
"dns": { "servers": ["localhost"] }網域解析與流量路由相互配合
DNS 設定決定如何解析網域，路由規則則決定連線如何送出，兩者需要一併檢查。先確認問題出在節點伺服器的網域，還是目標網站的網域，再檢查解析器的連線路徑。三款客戶端使用各自核心的 DNS 設定功能，介面開關與 JSON 欄位並不能完全對應。上方僅示範鍵名與本機解析寫法，並非通用的分流方案。瀏覽器加密 DNS、系統私人 DNS 與客戶端內建 DNS 可能同時參與解析；測試時請一次只調整一項，並記錄結果。
v2rayNv2rayNGv2flyNG
"log": { "loglevel": "warning" }從第一筆錯誤找出故障層
排查日誌時，先區分核心未啟動、節點連線失敗與應用程式未使用代理。核心未啟動時，優先查看第一筆錯誤，檢查連接埠占用、設定語法與資料檔案；連線逾時則繼續檢查節點位址與網路是否可連通。三款客戶端都能查看執行資訊，但日誌入口與詳細程度有所不同。必要時可暫時提高日誌層級，重現一次問題後再恢復。分享日誌前，請移除訂閱網址、身分資訊與節點憑證，只保留錯誤相關內容，避免公開完整設定。
v2rayNv2rayNGv2flyNG
這些設定分別作用於設定來源、比對規則、流量入口、執行核心與網域解析。排查時不要一次更動所有選項：先確認節點可以連線，再檢查應用程式是否透過代理，最後驗證分流與 DNS 是否符合預期。每完成一個階段就記錄測試結果，後續調整才有明確的比較基準。
查看各平台完整安裝與設定指南 →三步快速上手
從訂閱匯入到連線驗證依序操作，方便回頭檢查
01 / IMPORT
匯入訂閱，確認群組
安裝客戶端後，先準備可用的訂閱網址或節點分享連結。在訂閱管理中新增群組、填入網址並更新，確認節點數量與名稱確實有變化。從剪貼簿匯入適合處理分享連結；訂閱管理則適合日後持續更新，請勿混用兩種入口。
更新失敗時，先查看提示，判斷是網址無法存取、內容格式不符，還是訂閱已失效。客戶端安裝成功不代表已經有可連線的節點；清單為空時，應先處理設定來源，而不是反覆切換代理模式。
02 / CONNECT
選擇節點，啟用連線入口
選取一個節點作為目前設定，再使用客戶端提供的實際連線測試確認是否可連通。地區名稱只能協助整理清單，無法證明線路可用。測試成功後，在桌面端啟用系統代理，或在 Android 裝置上啟動連線並完成 VPN 授權。
初次連線建議使用容易理解的路由預設，並保留區域網路存取。不要同時啟用其他代理應用程式、瀏覽器手動代理與多個虛擬介面；入口越少，越容易判斷是哪項設定改變了應用程式的連線路徑。
03 / VERIFY
測試網頁，確認出口
使用瀏覽器開啟預期透過代理存取的頁面，再檢查出口 IP 與客戶端日誌。頁面能開啟只是其中一項訊號，還需確認請求確實使用指定的出站。若啟用了分流，直連網站與代理網站的出口可能不同，這是規則造成的結果，應分別測試。
若瀏覽器正常、其他應用程式卻無法連線，請檢查該應用程式是否使用系統代理，而不是立刻更換節點。若所有應用程式都無法連線，請先回頭檢查節點連線測試與核心日誌。每次只調整一項，再重複相同測試，才能找出明確的因果關係。
結束客戶端前，請先關閉系統代理或停止 VPN 連線，避免留下指向已停止服務的入口。重新啟動後，先確認目前使用的節點仍在清單中，再恢復連線。需要移轉至其他裝置時，優先移轉訂閱來源與必要規則；不要將包含本機路徑、監聽連接埠及平台權限的完整設定直接覆蓋到另一台裝置。
查看完整教學 →Project V · V2Fly · Xray
核心家族與圖形化客戶端區分專案、協定與設定
PROJECT V
V2Ray 是生態系關鍵字，不是單一介面
Project V 是以網路代理工具與模組化設定為核心的開放原始碼生態系，V2Ray 則是其中廣泛使用的專案名稱。搜尋「V2Ray 客戶端」時，通常想找的是能管理節點、產生設定並控制連線的圖形化程式，而不是獨立執行的核心檔案。v2rayN、v2rayNG 與 v2flyNG 都屬於這一使用層，負責訂閱管理、參數編輯及執行資訊顯示等工作。
理解這項區分後，也能分層排查故障：介面是否儲存設定、核心是否接受產生的設定，以及系統或應用程式是否將流量送入代理入口。這三種問題發生在不同位置，不必將所有故障都歸因於「客戶端不能用」。
CORE FAMILY
V2Fly 與 Xray 有共同的技術背景
V2Fly 延續 V2Ray 相關專案的社群維護與發展；Xray 則從相關程式碼基礎發展，形成自己的功能與協定實作。兩者有不少基礎設定概念相近，但隨著各自演進，支援的欄位、傳輸組合與擴充能力並不完全相同。節點設定必須符合實際執行的核心，不能只憑分享連結前綴就認定所有參數都相容。
v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心；v2rayN 的多核心管理則提供桌面端更多選擇。選擇時應以現有節點的需求為依據，不要將核心名稱當成速度排名。網路路徑、伺服器條件與本機流量接管方式也都會影響使用結果。
OPEN SOURCE
分別確認開源授權與元件界線
三款客戶端皆以開放原始碼方式提供程式碼，核心與圖形介面則屬於不同專案。V2Fly 的 V2Ray 核心與 Xray 核心採用 MPL 2.0 授權；客戶端本身及隨附元件則應分別遵循各自的授權條款。開放原始碼表示程式碼與授權可供查閱，不代表所有專案採用相同條款，也不表示任何設定檔都適合直接套用。
日常使用時，重點是理解設定內容；若涉及修改、再散布或整合，則應閱讀相關元件的授權條款。訂閱中的節點位址、身分參數與伺服器配置由設定來源決定，並非圖形化客戶端自動提供。安裝軟體與取得連線設定是兩個不同步驟。
UPDATE PATH
應用程式、核心與規則資料分別更新
客戶端更新可能調整介面、訂閱解析與設定產生方式；核心更新可能改變協定支援與參數要求；規則資料更新則會影響網域或 IP 清單的比對結果。這三者不一定會同步變動。更新前請記錄目前可用的節點、代理入口與自訂規則；更新後以相同目標重新測試，才能找出變化發生在哪個環節。
更新訂閱只會重新取得設定清單，並不等於升級應用程式，也不會自動解決本機權限或連接埠衝突。遇到問題時，先確認最近修改的是哪個部分，再決定要重新檢查訂閱、調整核心或還原規則。長期使用建議保留必要的設定紀錄，同時避免將含有憑證的設定放進公開文件。
桌面端需要集中管理多個節點與路由時，可先查看 v2rayN；Android 裝置已有 Xray 設定時，可先查看 v2rayNG；設定依賴 V2Fly 行為時，再確認 v2flyNG。選擇客戶端應考量平台、核心與維護方式；連線品質則須在實際網路環境中測試，兩者不可混為一談。
比較三款客戶端的平台與核心 →設定文章
DNS、路由與啟動錯誤最新三篇技術紀錄
V2Ray 核心無法啟動怎麼辦：看懂日誌，找出設定錯誤
整理連接埠被占用、JSON 語法錯誤、未知協定欄位、geo 檔案遺失等常見錯誤，教你從 v2rayN 與 v2rayNG 日誌找出錯誤位置並逐一修正。
閱讀文章 →v2rayN 路由規則實作：geosite 與 geoip 分流情境設定
從略過區域網路與中國大陸流量到全域代理，逐一說明 domain、ip、outboundTag 的組合寫法，並提供常見分流情境的規則順序與自訂規則集範例。
閱讀文章 →Xray DNS 模組詳解：境內外網域分流解析與防 DNS 污染設定
解析 dns servers、domains 比對與 queryStrategy 等欄位，示範如何讓中國大陸網域使用本機 DNS、境外網域使用遠端 DNS，避免常見的 DNS 污染與外洩問題。
閱讀文章 →剛完成訂閱匯入，可先依照上手教學測試節點與系統代理；若連線正常但分流結果不如預期，再參閱路由與 DNS 文章。核心尚未啟動時，應先處理日誌中的設定錯誤；調整解析器與路由無法取代基本啟動條件。
查看所有文章 →