Windows
桌面端優先推薦 v2rayN。Desktop 採用新一代跨平台介面，經典 WPF 版則保留傳統桌面介面，可依操作習慣選擇。兩者版面可能不同，但匯入、選擇伺服器與設定系統代理的基本流程相近。
安裝前查看作業系統類型，確認下載套件適用的架構。首次啟動後先檢查核心是否正常運作；若視窗能開啟但連線失敗，應繼續查看記錄檔，不能直接判定伺服器參數有誤。
前往下載 Windows 用戶端 →SECTION 01 / 剖面檔案
用戶端設定。從介面看懂流量處理路徑。
圖形用戶端負責管理連線參數，核心則負責處理流量。匯入連結只是設定的起點：協定欄位決定如何連線至伺服器，代理模式決定應用程式流量能否進入用戶端，路由規則則決定流量從哪個出口送出。分開檢查這三個層次，比一次修改多個開關更容易找出問題。
協定、傳輸與核心分層
v2rayN 透過圖形介面管理伺服器參數，再交由所選核心執行。VMess、VLESS、Trojan 與 Shadowsocks 的欄位不能互換；傳輸方式與 TLS 設定也必須和伺服器端一致。匯入後先核對協定類型、位址、連接埠及安全設定，再確認核心是否支援該組合。圖形介面方便管理多組連線，卻不會消除欄位間的相依限制。REALITY 是與安全傳輸相關的設定，不應視為可任意替換的獨立代理協定。
inboundsoutboundsstreamSettings
分開管理訂閱網址與分享連結
訂閱網址用來取得一組連線設定，分享連結通常描述單一連線。在「訂閱群組」中儲存網址並更新，適合持續維護的設定來源；從剪貼簿匯入則適用於單一連結。base64 只是編碼格式，不代表用戶端一定能辨識其中內容。原生 JSON 和分享連結也不相同，轉換時可能遺失路由或 DNS 設定。更新前確認目標群組，更新後檢查項目是否仍可選取，避免把單次網路請求失敗誤判為所有連線都失效。
訂閱群組更新訂閱從剪貼簿匯入
規則順序決定比對結果
路由分流會將不同目的地交給不同出口，常見結果包括代理、直連或封鎖。規則通常由上而下比對，特定網域規則應排在範圍較廣的規則之前。geosite 用於網域集合，geoip 用於 IP 位址集合，兩者都需要對應的資料檔。domainStrategy 控制比對時是否解析網域的 IP，並非系統 DNS 的總開關。先採用能清楚理解的預設設定，再逐條新增例外，通常比複製一大堆不明規則更容易維護與排查。
routing.rulesdomainStrategygeosite
先確認流量如何進入用戶端
系統代理會將本機代理位址寫入作業系統設定，只有會讀取這些設定的應用程式才會使用。TUN 模式則透過虛擬網路介面接管流量，涵蓋範圍更廣，也牽涉權限、路由與 DNS。初次設定建議先測試系統代理，再視需求啟用 TUN，避免混淆連線參數錯誤與介面問題。其他代理工具、既有虛擬網卡或應用程式內建代理都可能影響結果。切換模式後，請重新測試目標應用程式，而非只看開關是否顯示為啟用。
自動設定系統代理啟用 TUN 模式DNS
依作業系統與處理器選擇安裝套件
桌面裝置可選擇 v2rayN，Android 裝置可先了解 v2rayNG；若需要 V2Fly 核心，再評估 v2flyNG。分享連結能否跨平台使用，取決於兩端核心是否支援相應的協定、傳輸與安全欄位，不能只看連結前綴。安裝前確認處理器架構與套件格式；移轉時，訂閱網址與自訂規則請分別備份。圖形介面名稱可能不同，但設定思路相同：先匯入連線，再選擇流量入口，最後檢查分流與解析行為。
v2rayNv2rayNGv2flyNG
SECTION 02 / 平台下載
用戶端下載。先選作業系統，再選架構。
安裝套件必須符合目前裝置。桌面平台的介面類型、處理器架構與發行套件格式是三個不同選項，不要只憑檔案大小判斷。下載頁整理了各用戶端下載入口與選擇說明；本頁的平台連結則會直接前往對應平台的區段。
macOS
選擇 v2rayN，並在「關於這台 Mac」中確認晶片資訊。Apple Silicon 與 Intel 適用不同安裝套件，建議選擇符合裝置原生架構的下載項目，不要把所有磁碟映像檔都當成通用套件。
系統代理主要供遵循系統網路設定的應用程式使用。若要接管更多流量，再參閱 TUN 設定需求。權限確認與連線設定是不同步驟，請先完成啟動與匯入，再測試應用程式連線。
前往下載 macOS 用戶端 →Android
優先選擇使用 Xray 核心的 v2rayNG；需要 V2Fly 核心設定時，可考慮 v2flyNG。多數較新的裝置適用 arm64 套件；若不確定架構，可查看裝置資訊，再參考下載頁的通用套件說明。
首次連線時需要確認系統 VPN 授權。背景執行也可能受裝置的電池管理策略影響；若只有鎖定螢幕後才中斷，應檢查背景執行限制，而非立刻更換協定。切換網路後也請重新測試連線。
前往下載 Android 用戶端 →Linux
桌面環境可選擇 v2rayN。先依發行版選擇 deb 或 rpm，再確認 x64 或 arm64 架構。套件格式須符合系統的套件管理方式，處理器架構則須符合執行環境，兩者都要正確。
應用程式是否讀取系統代理設定，取決於桌面環境及應用程式本身的實作。需要個別設定代理的程式，請填入用戶端實際監聽的位址與連接埠。啟用 TUN 前先了解權限需求，並避免與既有網路管理規則衝突。
前往下載 Linux 用戶端 →SECTION 03 / 首次連線
v2rayN 快速入門。匯入、接管、測試。
用戶端不會內建可用的遠端連線。開始前請準備有權使用的訂閱網址或分享連結，並確認目前網路能取得訂閱內容。初次設定時只執行一個用戶端，先建立可重複測試的基本連線，再新增自訂分流或 TUN 等設定。
-
STEP 01 / IMPORT
匯入訂閱或分享連結
在 v2rayN 的「訂閱群組」中儲存訂閱網址，再執行更新；單一分享連結則可從剪貼簿匯入。匯入後檢查協定、位址、連接埠與傳輸設定是否完整。項目出現在清單中，只代表用戶端辨識了內容，不代表已連上遠端服務。若更新結果為空，先檢查網址、網路請求與訂閱格式，不要反覆刪除所有群組。
訂閱網址可能包含存取權限資訊，請像帳戶憑證一樣妥善保管。提供他人協助排查問題的截圖時，請遮蔽完整網址、身分欄位與個人備註。移轉裝置前，分別備份訂閱來源與本機規則，避免誤以為複製伺服器清單就包含所有設定。
-
STEP 02 / PROXY
選擇伺服器與代理模式
將需要使用的伺服器設為目前連線項目，再選擇「自動設定系統代理」。初次測試可從清楚易懂的路由預設開始，確認哪些目標會直連、哪些會透過代理。瀏覽器代理擴充功能、手動代理設定或其他網路工具可能覆蓋系統設定，測試前請先檢查這些額外設定。
若某個應用程式不讀取系統代理，先確認它是否提供個別代理設定。確實需要接管更多流量時，再啟用 TUN 並處理權限與 DNS。每次只變更一個環節，並保留上一組可重現的設定，以便判斷問題從哪一步開始。
-
STEP 03 / VERIFY
驗證實際連線與應用程式行為
Tcping 主要反映目標連接埠的 TCP 可達性；真實連線測試則會進一步涉及代理交握與測試請求，兩者不能互相取代。測試結果也會受測試目標與當下網路狀況影響。選好伺服器後，使用瀏覽器造訪預期會透過代理處理的頁面，並對照用戶端記錄中的連線與路由資訊。
若測試通過但應用程式仍無法使用，請依序檢查「應用程式代理設定、本機監聽、路由比對、遠端交握」。不要只看工作列圖示或開關狀態就認定代理已生效。測試完成後記錄使用的模式與例外規則，下次切換網路時即可依相同步驟重新檢查。
SECTION 04 / 開源生態
Project V 與核心家族。分清專案、協定與用戶端。
從 V2Ray 到 V2Fly、Xray
Project V 是理解 V2Ray 生態系的起點。V2Ray 將入站、路由、出站與傳輸等功能組合起來，讓代理不只是單一協定的連線程式。使用者日常接觸的伺服器清單與開關，則通常來自外層的圖形用戶端。討論「V2Ray 用戶端」時，應先確認指的是介面程式、執行核心，還是連線使用的協定；三者彼此相關，卻分屬不同層次。
V2Fly 延續 V2Ray 的社群開發，Xray 則以相關程式碼為基礎，發展出自己的功能方向。兩者有共同的設定背景，也各自有不同的實作與演進。因此，部分基礎欄位看起來相似，不代表所有設定都能直接互換。使用 VLESS、REALITY、傳輸擴充或特定安全選項時，應確認實際核心的支援情況，而非只依用戶端名稱判斷。
三款用戶端的職責範圍
v2rayN 是開源桌面用戶端，提供伺服器管理、訂閱更新、代理模式與路由設定的圖形介面。v2rayNG 是 Android 平台的開源用戶端，採用 Xray 核心；v2flyNG 同樣適用於 Android 裝置，提供 V2Fly 核心作為另一種選擇。選擇用戶端時，先看作業系統，再確認現有連線所需的協定功能；能匯入不代表所有欄位都受到支援。
圖形用戶端會將介面設定轉換成核心執行設定，因此介面名稱不一定與原生 JSON 欄位一一對應。核心支援的選項，也未必都會提供圖形控制項。遇到進階設定時，應先閱讀目前用戶端的設定說明，再核對核心欄位的意義；直接套用其他用戶端的介面教學，容易誤把名稱相似的項目當成相同功能。
開源授權與設定責任
開源代表程式碼可依相關授權條款查閱、使用與再散布，不代表所有相關專案都採用相同授權。Xray-core 與 V2Fly 的 V2Ray-core 均採用 MPL-2.0；用戶端介面、核心及隨附元件的授權條款則應分別查閱。若要修改、散布或整合軟體，請以各專案的授權本文為準，不要只沿用整個生態系的概括稱呼。
開源也不代表可以忽略設定來源。訂閱發布者決定連線參數，遠端伺服器決定服務是否可用，本機用戶端則決定流量入口與分流方式。面對不熟悉的設定，先了解路由目標、DNS 設定與監聽範圍；尤其不要為了排錯，隨意將本機代理監聽位址開放給其他裝置存取。
用戶端、核心與規則應分別更新
用戶端介面、核心與規則資料的更新屬於不同層次。介面更新可能改變選單位置；核心更新可能調整欄位支援或執行行為；規則資料更新則可能影響網域與 IP 位址集合的比對結果。排查更新後的變化時，先記錄變更所在的層次，再比較連線參數與路由結果，避免把所有異常都歸咎於伺服器。
更新前保留必要的本機設定，更新後使用原先可重現的應用程式連線測試。自訂規則較多時，也要確認較具體的規則仍排在通用規則前面。下載頁提供用戶端下載入口，協定參考頁說明設計取捨；至於特定欄位的實際行為，則應搭配目前執行的核心與記錄檔判斷。
SECTION 05 / 使用心得
連線測試與協定選擇。依照問題繼續閱讀。
以下三篇文章分別探討協定取捨、路由優先順序與首次連線測試。建議先建立穩定且可重現的測試流程，再閱讀自訂規則；若要移轉既有連線，先釐清協定與傳輸的組合，避免在不同用戶端間轉換時遺漏欄位。
VMess、VLESS、Trojan、Shadowsocks 怎麼選？四種代理協定比較
從發展背景、加密方式、交握負擔與行動裝置耗電四個面向比較四種協定，並依使用情境提供選擇建議。
自訂路由規則教學：domain、ip、geosite 語法與比對優先順序
說明 domain、full、regexp、geosite、geoip 等規則前綴的寫法，並解析由上而下的規則比對順序，以及 domainStrategy 對結果的影響。
v2rayN 首次連線教學：選擇節點、真實連線測速與代理生效檢查
說明匯入訂閱後如何選擇節點、分辨 Tcping 與真實連線延遲測試，並透過系統代理狀態及瀏覽器連線結果確認代理是否生效。