設定介面示意圖；實際選單名稱與位置可能因用戶端版本而異。
先確認作業系統，再確認處理器架構。桌面版與 Android 的流量接管方式不同；即使訂閱匯入成功，仍須分別完成本機設定。
v2rayN · 桌面版與經典 WPF 版
下載頁提供桌面版與經典 WPF 版。桌面版採用新一代跨平台介面，經典 WPF 版則保留熟悉的桌面操作方式。若已有設定，先記下訂閱群組、路由與監聽連接埠，再考慮切換介面版本；不同版本的選單位置可能不同，不能只憑截圖判斷設定是否存在。
首次連線建議先使用系統代理，確認瀏覽器能連上目標服務，再決定是否啟用 Tun 模式。系統代理只會影響讀取這項設定的應用程式，不能因此認定整台電腦的流量都已受到接管。離開用戶端前清除系統代理，可減少本機連接埠關閉後造成的連線問題。
前往下載 →v2rayN · 依晶片選擇安裝版本
前往系統選單 → 關於這台 Mac，確認顯示的是晶片名稱還是 Intel 處理器。Apple Silicon 與 Intel 對應不同的安裝版本；選好架構後，再處理啟動授權與網路權限。安裝完成不代表代理已啟用，還要確認目前使用的網路服務是否採用用戶端設定的本機代理。
切換 Wi-Fi、改用有線網路或從休眠恢復後，若只有瀏覽器無法連線，先檢查系統網路設定與用戶端是否正常執行。不要同時更動節點、路由和 DNS；保留一份已知可用的設定，再逐項調整，才能釐清問題出在網路切換、權限或代理連線。
前往下載 →v2rayNG 優先推薦 · v2flyNG 替代選擇
v2rayNG 使用 Xray 核心，適合依一般 Android 流程設定；需要 V2Fly 核心環境時，可考慮 v2flyNG。多數裝置可選 arm64，不確定時先查看系統資訊及下載頁的通用版說明。安裝檔架構與節點協定是兩回事，不能根據訂閱中的協定名稱判斷手機架構。
首次使用 VPN 模式時，先確認系統連線授權，再檢查省電設定是否限制背景執行。Android 通常一次只能使用一個這類 VPN 連線；若其他網路工具正在使用連線，須先排除衝突。建議先確認基本連線正常，再設定依應用程式代理，避免一開始就將測試用的應用程式排除在代理範圍外。
前往下載 →v2rayN · 依發行版與架構選擇
先確認發行版使用 deb 或 rpm 套件，再選擇 x64 或 arm64。桌面環境的代理設定與個別應用程式的代理設定可能彼此獨立；若瀏覽器能用、其他程式卻無法連線，優先確認程式是否讀取桌面代理，不必反覆重新匯入訂閱。
Tun 模式還涉及權限、虛擬網卡與既有網路規則，不是解決所有連線問題的萬用開關。建議先以一般代理方式建立可重現的連線，再依需求擴大接管範圍。若系統已安裝其他代理或虛擬網路工具，先記錄原有設定，再逐一停用測試，避免多個接管機制互相影響。
前往下載 →三款用戶端負責讀取設定、啟動核心並提供本機代理入口；伺服器位址與連線憑證仍須由實際使用的服務提供。安裝後請先確認訂閱來源，再繼續設定。
查看所有用戶端 →依設定用途尋找選項，不要把「啟用代理」和「選擇路由」當成同一個步驟。下方視窗僅示意操作位置，切換分類即可查看對應說明。
訂閱群組 → 新增或編輯訂閱。先確認網址來自可信來源，再執行更新。群組可將不同來源的設定分開管理，但不會自動切換目前使用的連線。更新後，請檢查是否出現協定解析錯誤，並再次確認目前啟用的設定。相較於把所有設定混在同一份清單中，分組更容易找出更新失敗的訂閱，也方便保留手動新增的設定。訂閱網址通常包含連線憑證，分享截圖時請遮住完整網址；若更新失敗，先確認網址是否失效，再判斷是否需要透過現有代理更新。
主畫面或系統匣選單 → 系統代理，選擇自動設定系統代理，讓讀取系統設定的應用程式連上本機監聽連接埠。這項設定處理的是應用程式如何連進用戶端，不會決定請求最後要直連還是走代理。相較於 Tun 模式，系統代理的接管範圍較小，適合用來驗證首次連線。若瀏覽器能用、某個程式卻無法連線，先檢查該程式自己的代理選項。準備結束用戶端時，請清除系統代理；「不變更系統代理」只會保留原值，不代表已啟用，也不等於清除。
路由設定 → 選擇規則集，再確認個別規則的順序。路由會決定進入核心的請求使用哪種輸出方式，不會替應用程式啟用代理。相較於單純切換系統代理，路由可依網域、位址等條件細分流量；前面的寬泛規則也可能優先於後面的精確規則。修改後重新連線，透過實際連線與記錄確認命中結果。若使用網域或位址集合，也須確認資源檔能正常讀取。單一網站能開啟，不足以證明所有目標都依預期分流；測試時應涵蓋直連與代理兩種請求。
主畫面 → Tun 模式，啟用前先確認用戶端所需權限與虛擬網卡元件。Tun 適合接管不讀取系統代理的應用程式，但無法修復失效的伺服器設定，也不保證所有協定都能通過伺服器。相較於一般系統代理，Tun 對本機網路的影響更深，還須一併檢查 DNS、路由及其他虛擬網路工具。啟用後若整台裝置連線異常，先關閉 Tun、恢復原本狀態，再檢查啟動記錄與權限提示。不要同時反覆切換多個網路選項；記下每一步變更，才能判斷衝突來源。
v2rayNG 設定 → 依應用程式代理。先確認清單代表「僅代理所選應用程式」還是「略過所選應用程式」，再勾選程式。這項設定決定哪些應用程式納入 VPN 接管範圍，與依網域分流的路由規則屬於不同層次。相較於桌面系統代理，這種方式可直接依應用程式劃定範圍，但仍須使用 Android VPN 模式。修改後請中斷連線並重新連線，讓新清單套用至連線；測試時確認瀏覽器沒有被排除。重新安裝應用程式或新增工作設定檔後，也應再次確認清單是否仍包含預期的程式。
請依相同順序驗證：先確認訂閱內容能正常解析，再確認核心已啟動，接著確認應用程式已連上本機代理，最後檢查路由結果。前一個步驟尚未成立時，後續就算切換再多選項，也很難判斷問題所在。教學會依這個順序說明；故障文件則依無法上網、訂閱失敗、DNS 異常等症狀反向排查。
閱讀 v2rayN 設定教學 →用戶端名稱、核心名稱與協定名稱代表不同層次。先釐清各自用途，再判斷設定是否能使用。
Project V 是認識 V2Ray 生態的起點。圖形化用戶端將訂閱、路由與本機代理選項整理成介面；核心則負責讀取設定並處理實際網路連線。日常所說的「安裝 V2Ray」，通常是指安裝可管理這些核心的用戶端，而不是直接編輯核心設定。
V2Fly 延續 V2Ray 社群的開發，Xray 則以相關技術為基礎，發展出自己的實作與功能。兩者有部分概念與設定習慣相通，但名稱相似不代表功能完全一致。特定傳輸方式、協定參數或擴充功能是否可用，應依用戶端實際呼叫的核心判斷。
v2rayN · v2rayNG · v2flyNG
Xray · V2Fly
協定、傳輸、路由與 DNS
v2rayN 適用於桌面環境，主要透過圖形介面管理連線、訂閱與路由。由於它可使用多種核心，「介面能新增某種設定」與「目前使用的核心能執行這份設定」必須分開確認。若啟動失敗，請查看錯誤訊息中的欄位與核心名稱，不要只比較用戶端視窗是否相同。也要留意桌面上的代理監聽位址：本機使用與分享給區域網路是不同情境；開放範圍越大，越要同步檢查防火牆與網路環境。
v2rayNG 是 Android 上的開源圖形化用戶端，使用 Xray 核心，透過系統提供的 VPN 介面或本機代理運作。v2flyNG 同樣適用於 Android，使用 V2Fly 核心，可作為需要該核心環境時的替代選擇。兩者的介面與操作習慣相近，但設定支援情況仍應以各自使用的核心為準。若現有設定可正常使用，不必只因名稱不同就遷移；確實需要切換時，先匯出必要資訊，並分別確認 VPN 授權、應用程式清單與背景執行限制。
這些用戶端以開源專案方式開發，相關用戶端專案採用 GPL 系列授權；V2Fly 與 Xray 核心專案則採用 MPL 2.0 授權。用戶端、核心及隨附相依元件的授權條款不應簡化成單一標籤；若要重新散布，請詳閱各元件的授權文字。對一般使用者而言，開源代表程式碼與實作有公開討論及檢視的基礎，不代表每一份外部訂閱都經過相同審查。
訂閱是執行設定，可能包含伺服器位址、使用者識別資訊、傳輸參數與連線憑證。軟體採用開源授權，不能取代對設定來源的判斷，也無法說明伺服器端如何處理資料。匯入前先確認來源；尋求協助時只提供必要的錯誤資訊，並遮住完整訂閱網址與使用者憑證。這比一次貼出全部設定更有助於排查，也能避免連同存取權限一併公開。
用戶端更新、核心更新與路由資源更新是三種不同操作。介面更新可能更動選單名稱，核心更新可能改變設定支援，規則資源更新則會影響分流結果。若行為出現變化，先回想實際更新的是哪一層。一次更新多個項目又同時修改多個選項，往往會失去可供比較的基準，讓原本簡單的問題變得難以重現。
較穩妥的做法是先記錄目前使用的設定、監聽連接埠與自訂路由，閱讀相應的更新說明，再進行安裝或替換。完成後確認訂閱是否保留、核心能否啟動、系統代理是否指向目前的連接埠，並分別測試應直連與應走代理的目標。若要保留還原方案，也要確認舊環境是否支援新設定欄位；備份檔可能含有敏感資訊，應存放在安全的位置。
真實連線測試有助於排除部分無法使用的設定，但測試成功只表示該測試目標在當時的條件下能完成連線。瀏覽器快取、應用程式自訂代理、DNS 解析及伺服器策略，都可能讓其他目標呈現不同結果。不要把單次測試結果視為整台裝置的代理狀態，也不要把一次逾時直接判定為用戶端故障。
排查時保留最精簡的測試情境：一個用戶端、一份已確認的設定，以及一個明確的測試應用程式。先比較關閉代理時的基本網路，再觀察啟用後的變化；若只有特定應用程式異常，就聚焦檢查該程式的代理入口與分流結果。記錄發生的操作與錯誤類別即可，不必為了提供完整資訊而公開整份設定。逐層檢查通常比反覆重新安裝更容易找到問題。
需要有效的伺服器設定或訂閱網址。用戶端提供設定管理與連線入口，不會在安裝後自動產生可用服務。先確認設定來源及協定支援，再依快速入門教學匯入並測試。
不需要預設同時啟用。先用系統代理確認會讀取這項設定的應用程式能正常連線，再依其他應用程式的接管需求判斷是否使用 Tun。兩種方式涉及不同網路層次，詳細排查方式請參閱故障排查文件。
若螢幕開啟時連線穩定、鎖定後卻反覆中斷，先檢查用戶端是否受到背景執行限制，再比對網路切換情況。若在前景執行時仍無法連線，再檢查設定與基本網路。更多說明請參閱常見問題。
不代表。匯入只完成解析與儲存；實際啟動時，仍可能遇到核心不支援的參數、欄位缺漏或伺服器端設定不符。請查看啟動結果與連線記錄，依照故障排查流程逐項定位。
從協定欄位到區域網路分享，補充首次連線流程不適合詳述的設定細節。需要調整設定時，先確認影響範圍是目前的應用程式、本機裝置，還是整個區域網路。
從適用平台、核心系列、訂閱與路由功能、入門難度四個面向比較三款用戶端，提供桌面與 Android 情境的選擇建議。先確認裝置與設定需求，再決定是否需要更換用戶端。
閱讀選型筆記 →介紹允許區域網路連線的設定位置與連接埠用途，說明防火牆放行方式，以及如何在其他裝置填入代理設定。分享前請先確認網路可信，並分清本機監聽連接埠與伺服器端連接埠。
閱讀設定筆記 →比較 VMess 與 VLESS 在加密方式、時間驗證及傳輸組合上的差異，協助理解訂閱中的協定欄位。協定名稱只是設定的一部分，還須與伺服器參數、傳輸層及核心支援相互配合。
閱讀協定筆記 →