Windows
v2rayN · Desktop / WPF
桌面版採用跨平台介面，經典 WPF 版則保留熟悉的 Windows 操作配置。首次安裝前請先確認系統需求，並將程式放在具有寫入權限的資料夾。匯入訂閱後選擇使用中的設定，啟用自動設定系統代理，再以瀏覽器測試連線。兩種介面的選單位置可能不同，但訂閱、路由和本機監聽連接埠的檢查順序相同。
前往下載 →依平台選擇 V2Ray 用戶端
桌面平台使用 v2rayN，Android 優先選擇 v2rayNG。先選擇作業系統與架構，再依教學匯入現有設定。
Android
v2rayNG · v2flyNG
優先選用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時再考慮 v2flyNG。多數裝置選擇 arm64 即可；若不確定裝置架構，請參閱通用套件說明。首次啟動並連線時，需確認系統 VPN 授權；依應用程式設定代理與背景電池限制也會影響實際接管的流量。更換用戶端前請先備份設定，兩款應用程式的設定不會自動同步。
前往下載 →macOS
v2rayN · Apple Silicon / Intel
先在「關於這台 Mac」查看晶片類型，再選擇 Apple Silicon 或 Intel 安裝套件。安裝後依系統提示允許開啟 App，確認用戶端已啟動核心後，再啟用系統代理。若瀏覽器能連線、其他應用程式卻不行，請先確認該應用程式是否使用系統代理；只有在確實需要接管更多流量時，才進一步了解 TUN 的權限與路由需求。
前往下載 →Linux
v2rayN · deb / rpm
依 Linux 發行版的套件格式選擇 deb 或 rpm，並確認裝置採用 x64 或 arm64 架構。圖形化用戶端負責管理設定，桌面環境是否使用系統代理則需另外確認。終端機程式也可能使用自己的代理參數，因此不能只根據瀏覽器的測試結果判斷所有連線都已接管。若程式無法啟動，先檢查相依套件與資料夾權限，再查看用戶端記錄。
前往下載 →訂閱、路由與代理設定
分別了解設定來源、連線去向與流量接管。每次只調整一類設定，確認結果後再繼續。
訂閱群組
依來源管理，更新後再選擇設定
訂閱連結用來取得一組連線設定，不是單一節點的位址。先在用戶端建立訂閱群組，再貼上完整連結並更新。將不同來源分開保存，方便辨識各組設定的來源，也能避免與手動新增的項目混在一起。更新完成後，確認群組中出現可選設定，再將其設為使用中的伺服器。相較於逐筆管理分享連結，群組更新更適合設定會定期變動的情況，但仍須確認來源有效。
訂閱匯入教學 →匯入分享連結
分清訂閱網址與單筆設定
單筆分享連結通常包含協定、位址、連接埠和傳輸參數，適合臨時新增或核對某筆設定。複製時請保留完整內容，避免換行、空格或通訊軟體自動截斷。匯入後確認協定與傳輸類型是否正確辨識，再確認目前使用的用戶端和核心支援這些選項。分享連結與訂閱網址的匯入入口可能不同；貼錯位置可能會出現空清單或解析提示，請勿因此直接判定為網路故障。
查看匯入步驟 →節點測試
先確認能否連線，再評估實際使用狀況
節點測試結果只反映特定測試方式及當下的網路狀況，不等同於瀏覽器或其他應用程式的實際體驗。先確認測試是否成功，再用目標應用程式連線至所需服務。若全部逾時，優先檢查本機網路、核心啟動狀態及訂閱是否有效；若只有少數設定失敗，再核對伺服器位址與傳輸參數。不同測試入口的結果不宜混在一起排序，更不應只憑單一數值反覆切換設定。
查看連線診斷 →訂閱更新失敗
從連結狀態追查更新流程
訂閱清單空白與既有節點連線失敗，發生在不同環節。先確認連結是否過期、是否完整複製，再查看用戶端提示的是請求失敗還是內容解析失敗。如果目前網路無法連上訂閱網址，可在已有可用連線的前提下，嘗試透過代理更新。若請求成功卻沒有產生設定，請核對回傳內容及格式是否受支援。訂閱連結可能包含存取權限，分享問題排除截圖時請遮住完整網址，切勿公開貼到討論區。
訂閱更新失敗自我檢查 →預設路由
先用預設設定確認連線去向
路由規則決定進入核心的連線要透過代理、直接連線或封鎖；系統代理負責接管流量，兩者並非同一件事。初次使用時先選擇符合需求的預設設定，測試常用網站與本機服務，再考慮自訂規則。「全域」通常表示將符合條件的連線送往代理伺服器，不代表所有應用程式都已經使用用戶端。排除分流問題時，先確認應用程式的連線已進入核心，再檢查命中的規則，避免在錯誤的環節反覆切換模式。
路由設定入門 →規則順序
具體規則在前，預設規則在後
多條路由規則可能同時符合同一個連線，規則順序會直接影響結果。新增自訂網域或位址規則前，先了解目前核心採用的比對方式，再確認是否有更前面的寬泛規則將其涵蓋。需要直連的本機資源應明確設定，不要靠頻繁切換全域模式來維持連線。修改前先備份原有設定，每次只新增少量規則，並以實際連線確認命中結果。規則愈多不代表分流愈精準，應適時整理長期未使用的重複項目。
了解路由分流 →網域與 DNS
同時檢查名稱解析與連線出口
網站無法開啟不一定代表節點失效，也可能是網域解析出了問題。網域規則、位址規則和網域策略都會影響比對結果；使用 IP 位址的連線與保留網域名稱的連線，可能得到不同結果。先查看記錄中的解析錯誤，再確認 DNS 請求是否有可用的連線路徑。請勿同時修改系統 DNS、瀏覽器的加密 DNS 與用戶端 DNS，否則難以判斷是哪項設定生效。保留一套可還原的基本設定，逐項測試更容易找出原因。
排除 DNS 問題 →本機資源直連
保留區域網路與本機服務的連線路徑
印表機、路由器管理頁面和區域網路檔案服務通常不需要透過遠端代理。啟用新路由或 TUN 後若無法存取這些資源，先確認位址屬於本機網路，再檢查相關的直連與排除設定。裝置探索使用的流量類型可能與一般網頁不同，因此網頁能開啟不代表區域網路功能全都正常。修改規則時不要盲目擴大位址範圍；先記下受影響的目標，再以最小範圍的規則測試，並保留還原方式。
查看網路診斷 →自動設定系統代理
先啟動核心，再讓應用程式使用代理
自動設定系統代理會讓支援此設定的應用程式，將連線送到用戶端的本機監聽位址。先選擇有效設定並確認核心已成功啟動，再啟用此選項。若瀏覽器有獨立的代理擴充功能，請確認它是否覆蓋系統設定。「清除系統代理」只會移除系統層的代理入口，不會刪除訂閱或節點；「不變更系統代理」則會保留原有的系統設定。離開用戶端後若網路異常，先檢查是否仍有代理設定指向已關閉的連接埠。
設定系統代理 →TUN 模式
接管不使用系統代理的應用程式流量
TUN 透過虛擬網路介面處理流量，適合一般系統代理無法涵蓋的應用程式，但需要額外設定權限、路由與 DNS。啟用前先確認相同節點在一般代理模式下可正常使用，再依用戶端提示授予必要權限。若連線異常，可暫時停用其他 VPN 或類似的流量接管工具進行比對。TUN 不能修復失效的訂閱，也無法保證所有流量都會依預期轉送；遇到問題時先退回已驗證的基本模式。
查看 TUN 問題排除 →本機監聽連接埠
用戶端與應用程式使用相同的連線參數
本機監聽連接埠是應用程式進入用戶端的入口，不是遠端伺服器的連接埠。圖中的 10808 僅供說明，實際值請以目前參數設定畫面為準。若連接埠遭其他程式占用，先找出衝突的程序，再決定要關閉重複執行的程式或變更監聽連接埠。修改後也要檢查系統代理、瀏覽器及手動設定的應用程式，並確認代理協定類型正確。不要只改一個數字就結束，否則即使核心已啟動，也可能沒有連線進入。
排除連接埠占用 →Android 依應用程式設定代理
明確指定哪些應用程式使用 VPN 介面
Android 的 VPN 模式與桌面系統代理入口不同，首次啟動時須確認系統授權。依應用程式設定代理可縮小接管範圍，但應先確認清單代表包含或排除，避免勾選結果與預期相反。若瀏覽器可用、其他應用程式卻無法連線，先檢查該應用程式是否在接管範圍內，再檢查路由。若鎖定螢幕後連線中斷，接著檢查背景執行與電池最佳化設定。測試時只啟用一個流量接管工具，較容易判斷是否有 VPN 介面衝突。
查看行動裝置設定步驟 →用戶端與核心
介面管理設定，核心負責連線
用戶端提供訂閱、設定與記錄介面；核心負責解讀設定並建立網路連線。兩者的更新時程與功能範圍不一定完全一致，因此介面能匯入某個欄位，不代表目前的核心一定支援該功能。遇到啟動錯誤時先查看記錄，判斷是產生設定失敗，還是核心拒絕參數。比起只看應用程式名稱，確認實際執行的核心更有助於排除協定相容性問題，也能避免將介面差異誤認為連線機制不同。
查看核心名詞 →Xray 與 V2Fly
依設定需求判斷相容範圍
Xray 與 V2Fly 是相關但各自獨立發展的核心專案，在協定實作、設定欄位與新功能支援方面可能有所不同。選擇核心時應以伺服器提供的設定需求為準，不要只憑名稱或發布時間判斷優劣。同一份訂閱也可能包含需求不同的設定，切換前請核對協定與傳輸組合。若某項設定只適用於特定核心，請保留已驗證的組合，再另外研究兩者差異；這比同時修改多個傳輸選項更容易得到可靠結論。
查看用戶端比較 →切換前先備份
保留設定，讓測試可以還原
切換核心或升級用戶端前，先保存訂閱群組、自訂路由與必要的參數設定。記下目前可用的設定，但不要在公開筆記中保存憑證。更新後先用原有設定確認基本連線，再測試需要的新功能。若啟動失敗，請比對記錄中的錯誤欄位，不要立刻覆蓋所有設定。設定格式可能隨專案演進而變更，備份可作為還原依據；還原時仍須確認目標版本能正確辨識相關設定。
查看啟動診斷 →三款用戶端怎麼選
先看平台，再看核心需求
桌面平台優先選擇 v2rayN，以統一的方式管理訂閱與代理設定。Android 優先選擇 v2rayNG；需要 V2Fly 核心時再考慮 v2flyNG。選擇用戶端時，先考慮裝置平台，再看設定需求與常用功能，不必因介面差異頻繁更換。轉換用戶端時可重新匯入有效訂閱，但路由、依應用程式設定代理的清單與權限通常需要重新確認；這些本機設定無法透過節點分享連結完整帶入。
依需求選擇用戶端 →Project V、V2Fly 與 Xray
區分開源專案、連線核心與圖形化用戶端，再決定要下載什麼、調整哪裡。
V2Ray 源自 Project V 的模組化網路代理設計，將入站、出站、路由與傳輸等部分分開組成，讓不同連線能依規則使用不同出口。如今搜尋 V2Ray，經常會同時看到 V2Fly、Xray、v2rayN 和 v2rayNG；這些名稱各自代表不同層次，不能簡單視為同一個安裝程式的不同名稱。先了解各自的用途，遇到問題時才能把檢查範圍縮小到正確環節。
日常使用時，圖形化用戶端是主要操作介面。訂閱提供連線設定，核心讀取設定並建立連線；系統代理或 VPN 介面決定哪些應用程式的連線能進入用戶端，路由則決定這些連線的去向。四個環節彼此相關，但不能互相取代：訂閱匯入成功不代表連線成功，連線成功也不代表所有應用程式都已使用代理。依照這個順序逐步確認，比反覆匯入訂閱或重新安裝應用程式更有效率。
從模組化設計了解設定
Project V 的設計理念不是用一個開關控制所有網路行為，而是將不同任務拆解成可組合的模組。入站接收應用程式的連線，出站負責連接目標或代理伺服器，路由負責選擇出口，傳輸層則定義連線的承載方式。這種分工也解釋了用戶端為何有訂閱、路由、DNS、監聽連接埠等不同設定入口。介面上的名稱雖多，但每項設定都有各自的作用範圍。
例如，本機監聽連接埠會改變應用程式連入用戶端的位置；遠端伺服器連接埠則會改變用戶端連接伺服器的位置。兩者都稱為連接埠，卻不能互相取代。同樣地，全域路由只會影響進入核心後的流量選擇，不會自動讓忽略系統代理的應用程式開始使用代理。了解這些界線後，可以先用基本設定建立連線，再逐步加入分流與流量接管功能。
查找技術資料時，請留意資料所對應的用戶端、核心與設定層級。文章討論的是核心設定檔，不代表其中每個欄位都能直接填入圖形介面的輸入框。先辨識概念，再對照目前使用的介面，可避免混用不同專案的說明而造成錯誤。
查閱專業名詞 →V2Fly 與 Xray 各自發展
V2Fly 社群持續維護 V2Ray 相關實作；Xray 則從相關程式碼基礎發展為獨立演進的核心專案。兩者有共同的技術背景，也有各自的實作選擇與功能發展時程。對使用者來說，重點不是比較兩者高下，而是確認目前節點所需的協定、傳輸方式與安全選項，是否受到正在執行的核心支援。
v2rayN 可依實際版本與設定使用相應核心；Android 版 v2rayNG 主要以 Xray 核心連線，v2flyNG 則提供採用 V2Fly 核心的選項。切換核心並非萬用的修復方式。如果問題來自訂閱連結失效、系統時間不正確或本機連接埠衝突，換用其他核心往往還是會遇到相同狀況。應先確認記錄指出的問題環節，再決定是否需要更換實作。
伺服器提供的參數應作為相容性檢查依據。不要只為了消除錯誤訊息就任意關閉憑證驗證，也不要把無法識別的欄位全部刪除後繼續使用。先保留原始設定，確認用戶端與核心是否相符；若無法確定參數的意義，再查閱相關名詞說明與問題排除指南。
依症狀排除問題 →三款用戶端及其授權條款
v2rayN、v2rayNG 和 v2flyNG 都是開源圖形化用戶端，應用程式本身可免費使用。開源表示專案程式碼與相關授權條款可供查閱，不代表用戶端會自動提供遠端伺服器、訂閱額度或連線設定。安裝應用程式後，仍需使用有權存取的訂閱，或自行管理伺服器設定，才能建立連線。
開源生態系中的元件不一定共用同一份授權條款。v2rayN 專案採用 GPL-3.0，v2rayNG 與 v2flyNG 專案採用 GPL-3.0，V2Fly 與 Xray 相關核心專案則採用 MPL-2.0；散佈套件中的其他元件也可能有各自的授權說明。一般使用與修改後再散佈所涉及的義務不同，若計畫修改或重新散佈，請詳閱所用專案及相關元件的完整授權條款。
設定管理與網路服務也應分開看待。用戶端能儲存與解析訂閱，不代表它能決定訂閱是否有效，更不能取代伺服器的營運維護。遇到連線問題時，先確認原因出在應用程式設定、設定內容還是遠端狀態，再採取相應的處理方式。這樣既能保留現有設定，也能向設定提供者清楚描述實際問題。
比較三款用戶端 →分別處理應用程式、核心與訂閱更新
應用程式更新可能調整介面與設定管理方式，核心更新可能改變協定功能與參數支援，訂閱更新則主要更新連線設定。這三種更新的影響不同，排除問題時不宜一次全部更新。若原本可以連線，先記下故障前做過的變更，再逐一檢查，才能判斷問題是否由更新造成。
準備升級前，請備份訂閱群組與自訂路由，並確認安裝套件符合目前的作業系統與處理器架構。升級後先用原有設定測試基本連線，再檢查系統代理與所需應用程式。TUN、依應用程式設定代理等進階設定，應在確認基本連線正常後再設定。若只有新增功能異常，先還原至已驗證的模式，再根據記錄檢查權限或相容性問題。
記錄有助於找出故障階段，但可能包含伺服器位址、訂閱連結或其他敏感參數。回報問題時，只保留必要的錯誤資訊並遮住憑證，同時說明裝置平台、執行模式和受影響的應用程式。清楚的重現步驟比未處理的完整設定截圖更有幫助，也能避免在討論過程中洩漏存取權限。
查看常見問題 →V2Ray 設定與問題排除文章
從具體症狀開始：連接埠占用、憑證錯誤、訂閱解析失敗。
v2rayN 本機連接埠遭占用：找出衝突程序並修改 10808 監聽連接埠
用戶端啟動時顯示連接埠遭占用，或系統代理無法運作時，可用系統指令找出占用 10808、10809 的程序，在參數設定中變更本機監聽連接埠，並同步調整瀏覽器與系統代理。
閱讀連接埠問題排除 →V2Ray TLS 交握失敗與憑證錯誤：檢查系統時間偏差與 SNI 設定
出現憑證無效、交握失敗或 x509 錯誤時，先校正系統時間，再核對 SNI、偽裝網域與 allowInsecure 設定，說明錯誤背後的原理與相應修復方法。
閱讀憑證問題排除 →V2Ray 訂閱更新失敗、解析後清單空白：檢查連結格式、編碼與更新方式
匯入訂閱後清單空白、顯示解析失敗或更新一直不成功時，逐項檢查連結是否過期、Base64 編碼、分享連結格式，以及透過代理更新訂閱的方法。
閱讀訂閱自我檢查指南 →