客戶端負責整理設定，核心負責執行連線。先釐清訂閱、節點與代理模式，再處理路由及規則集。以下大綱依常見設定排列，選擇主題即可查看操作重點。
訂閱群組
備註：日常使用
網址：向訂閱服務提供者取得
操作：更新目前訂閱
節點清單
操作：設為作用中伺服器訂閱是更新節點資訊的管道，不是連線開關。在 v2rayN 的訂閱群組中填入網址與備註，儲存後更新該群組，再從節點清單選擇作用中伺服器。v2rayNG 也需要先新增訂閱，再執行更新。QR Code 適合暫時分享單一節點；若要長期管理，使用訂閱群組更合適。更新失敗時，先檢查網址、訂閱期限及更新時的網路連線，不要重複建立相同群組。分享截圖前請遮住完整訂閱網址，其中可能包含存取憑證。
訂閱更新後，仍須確認作用中的節點。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}路由會依網域、目標位址等條件選擇出口，規則通常由上往下比對。區域網路位址可直連，需要代理的目標則走代理；明確要拒絕的目標交由阻擋出口處理。先設定具體條件，再設定較廣泛的條件，避免某條規則過早攔截所有流量。示意中的 direct、proxy、block 是出口標籤，必須與實際設定一致。圖形客戶端可以產生這些設定；初次使用時，先選擇合適的路由預設，再查看連線記錄確認比對結果，並逐項調整。
遇到分流問題，先檢查順序，再檢查條件。
設定檢查順序
節點協定
傳輸方式
TLS / REALITY 參數
目前核心支援狀況
啟動記錄v2rayN 的圖形介面與代理核心負責不同工作；支援多種核心，讓桌面版能依節點需求選擇相容的實作。切換前先核對協定、傳輸方式與安全參數，不能只憑節點名稱判斷。v2rayNG 主要使用 Xray 核心，v2flyNG 則採用 V2Fly 核心，兩者並非只差在介面。成功匯入僅代表客戶端讀取了資訊，不表示目前的核心能執行所有參數。若啟動失敗，優先查看第一則設定錯誤，再考慮調整相容性。
依節點需求選擇核心，別只看名稱猜測。
應用程式連線路徑
使用系統代理 → 本機代理入口
手動設定代理 → 核對位址與連接埠
TUN 虛擬網卡 → 核對權限與路由
Android VPN → 檢查應用程式分流系統代理會提供代理位址給遵循此設定的應用程式，不會自動接管所有程式。若瀏覽器正常、其他應用程式卻無法連線，應先檢查應用程式本身的代理選項。TUN 透過虛擬網卡處理流量，涵蓋方式不同，也涉及權限、路由與 DNS。先以系統代理建立可用的基準，再依實際需求啟用 TUN，避免同時修改多個入口。Android 客戶端透過系統 VPN 介面接收流量，切換客戶端前應先停用另一個 VPN 連線。
代理入口與路由模式須分開確認。
規則引用與資料
geosite:cn 網域分類
geosite:category-ads-all 網域分類
geoip:private 位址分類
更新後
重新載入設定 → 檢查記錄geosite 與 geoip 代表資料分類，光是寫上名稱並不會自動產生完整規則。核心必須具備相應的資料檔，設定中引用的分類也必須實際存在。更新訂閱主要是更新節點；規則資料通常要透過客戶端提供的獨立入口更新。若記錄顯示分類不存在，先檢查資料來源是否與目前核心相符，再處理下載失敗。調整前先記下原本的路由設定，更新後重新載入並測試常用目標，以免把資料問題誤判成節點故障。
更新訂閱與更新規則是兩回事。
第一次開啟客戶端時，不必同時修改訂閱、路由、DNS 和 TUN。先匯入一個已知可用的節點，設為作用中伺服器，再透過系統代理測試瀏覽器連線。確認這條路徑正常後，再調整分流規則。如此一來，每次出現變化，都能對應到最近修改的設定；若一次改動多個選項，就很難判斷問題出在哪個環節。
測試時也要區分本機入口、遠端連線與目標網站。節點測試有結果，只能代表某個測試目標當時有回應，不能證明所有應用程式都已使用代理。瀏覽器能連上目標，也不代表規則中的每一類網域都走了預期出口。必要時查看記錄中的目標、出口標籤與錯誤類型，記下實際狀況，不要反覆重新安裝。完整步驟請見v2rayN 使用教學；依症狀檢查請參閱故障排除大全。
桌面裝置可選 v2rayN，Android 裝置建議先查看 v2rayNG；若有使用 V2Fly 設定的需求，再考慮 v2flyNG。安裝套件須符合作業系統與處理器架構；前往下載頁即可查看各版本下載入口與系統需求。
Windows 版 v2rayN 提供新一代跨平台桌面介面及經典 WPF 介面。兩種版本適合不同的操作習慣；選定其中一種後，先完成基本設定，不必因連線問題而來回切換。安裝前請查看系統資訊中的處理器類型，勿將其他架構的安裝套件當成通用版本。首次啟動若沒有出現主視窗，先檢查系統提示、執行環境與客戶端記錄，再進入代理設定。
macOS 使用者可先在系統的「關於這台 Mac」查看晶片資訊；Apple Silicon 與 Intel 的下載入口不同。安裝後先確認客戶端能正常啟動，再依系統提示授予所需權限。授權失敗、核心啟動失敗與節點連線失敗是不同問題，不要混為一談。切換系統代理時，也要留意瀏覽器是否使用自訂代理設定；自訂設定可能覆蓋系統設定，導致實際連線路徑與客戶端顯示的模式不同。
Android 裝置建議優先使用 v2rayNG。多數較新的裝置適用 arm64 套件；若不確定處理器架構，可查看通用版下載入口。首次連線時會出現系統 VPN 授權提示，授權後客戶端才能接收應用程式流量。若鎖定螢幕後連線中斷，請檢查系統的電池最佳化與背景執行限制；若只有個別應用程式連線異常，再檢查依應用程式設定的分流選項。v2flyNG 適合需要 V2Fly 核心的設定，不建議在同一次測試中讓兩個客戶端同時使用 VPN 連線。
Linux 版 v2rayN 安裝套件依發行版的套件管理系統區分；使用 deb 的系統與使用 rpm 的系統應選擇各自的下載入口，並核對 x64 或 arm64 架構。安裝完成不代表目前桌面環境中的所有應用程式都會讀取系統代理。先用支援代理設定的瀏覽器測試，確認本機入口正常後，再決定是否啟用 TUN。若涉及虛擬網卡與路由權限，請依介面說明處理，不要以重新安裝取代權限檢查。
先了解客戶端與核心各自負責什麼，再判斷設定是否相容。介面名稱、節點協定與核心專案是不同層次，不能混為一談。
代理工具生態與設定概念
延續 V2Ray 技術路線，提供代理協定、傳輸與路由功能。v2flyNG 是採用這條核心路線的 Android 圖形客戶端。
由相關技術生態發展而來，具備自身演進的協定與傳輸功能。v2rayNG 主要使用 Xray 核心，支援哪些參數須以實際核心為準。
桌面圖形客戶端負責管理節點、訂閱與路由設定，再呼叫相容的核心執行連線。它不是某一種代理協定的名稱。
Project V 是理解這類工具的重要背景。V2Ray 的設定概念將流量處理拆分為入口、路由與出口：入口接收本機應用程式的連線，路由依條件選擇處理方式，出口則負責直連、代理或阻擋。V2Fly 社群延續相關專案的維護，Xray 則以相關技術為基礎發展自己的實作。這些關係有助於理解設定為何相似，但不代表任意設定都能直接在兩種核心路線之間互換。
VMess、VLESS、Trojan 與 Shadowsocks 是協定名稱；TLS、REALITY 等涉及連線安全或交握機制；路由規則則屬於流量選擇層。檢視訂閱參數時，須逐層核對這些資訊。客戶端能顯示某個節點，不代表目前使用的核心支援該節點的所有傳輸與安全選項。遇到不相容提示時，先確認參數需求，再選擇合適的客戶端與核心，不要藉由停用安全檢查來規避問題。
v2rayN、v2rayNG、v2flyNG 都是開源圖形客戶端專案。v2rayN 與 v2rayNG 採用 GPL-3.0 授權，v2flyNG 也採用 GPL-3.0 授權；V2Fly 與 Xray 核心專案則採用 MPL-2.0 授權。開源授權說明程式碼的使用、修改與再散布規則，不代表任何節點服務的品質保證。客戶端可免費使用，也不表示訂閱提供者的服務一定免費；兩者的維護者與使用條件應分開看待。
圖形客戶端的優點，在於將訂閱更新、作用中節點選擇、規則預設與記錄檢視，整合在清楚的操作入口中。桌面版 v2rayN 適合持續整理多組設定；Android 版 v2rayNG 透過系統 VPN 介面處理行動應用程式流量；v2flyNG 則提供另一種 V2Fly 路線選擇。選擇客戶端不必追求全部安裝，只要目前方案支援節點參數、符合裝置使用方式，且記錄資訊足以協助排查問題即可。
客戶端更新、核心更新、訂閱更新與規則資料更新，處理的是不同問題。客戶端更新可能改變介面入口或產生設定的方式；核心更新可能調整協定支援；訂閱更新會刷新遠端節點資訊；規則資料更新則會改變網域或位址分類。分開執行這些操作，發生異常時才能縮小排查範圍。若已有可用設定，請先保留必要的本機備份；備份可能包含敏感參數，勿上傳至公開討論區。
更新後先確認核心能否啟動，再測試一個已知目標，最後測試常用應用程式與分流情境。若出現憑證錯誤，請檢查系統時間、伺服器名稱與安全參數；若發生網域解析錯誤，請檢查 DNS 路徑；若只有某個應用程式失敗，請確認它是否讀取系統代理。本網站的中文文件依操作步驟與問題症狀編排，實際按鈕名稱可能隨客戶端介面更新；理解連線路徑，比記住某張截圖的位置更容易套用。
從實際設定問題開始：電腦與手機如何共用節點、REALITY 與 Vision 如何搭配，以及 TLS 交握失敗時該從何處檢查。
整理憑證無效與交握失敗的常見原因，逐項檢查系統時間、SNI 與指紋參數。遇到錯誤時先保留錯誤訊息，不要將略過憑證驗證當成長期解決方式。
閱讀文章 →說明 Vision 如何處理重複加密的情況，以及 REALITY 的交握機制如何搭配 Xray。了解各層的用途後，再判斷目前節點需要哪些參數，避免只看名稱選擇設定。
閱讀文章 →比較訂閱連結、QR Code 與設定備份的適用情境。節點參數可以共用，但每台裝置的系統代理、應用程式分流與路由預設仍須個別檢查，匯入成功不代表設定完全一致。
閱讀文章 →更新訂閱只會取得節點資訊。還需要選擇作用中節點、確認核心已啟動，並讓瀏覽器使用正確的代理入口。先在客戶端確認目前使用的伺服器，再檢查系統代理模式，最後查看記錄中的錯誤。若顯示解析失敗，優先檢查 DNS；若連線逾時，再檢查遠端參數與網路路徑。訂閱、節點與出口的差異，請參閱概念速查。
不一定。系統代理設定決定應用程式是否將連線交給本機客戶端；路由模式則決定進入核心的流量要走哪個出口。即使應用程式使用系統代理，路由規則仍可能讓某些目標直連。反過來，選擇代理路由，也無法讓忽略系統代理的應用程式自動接入。排查時先確認入口，再確認出口。相關術語請參閱系統代理與路由分流概念。
是否允許多台裝置使用，取決於訂閱提供者的條件，客戶端無法取代這些限制。參數相容時，可以分別匯入兩台裝置；但代理入口與應用程式分流仍須各自設定。分享單一 QR Code 通常只會傳遞節點，不會一併移轉桌面端的路由習慣。在公開討論區求助時，只需提供錯誤類型與必要的去識別化參數。訂閱與節點的關係，請先閱讀訂閱與節點術語說明。
geosite 主要引用網域分類，geoip 主要引用位址分類。網域規則適合依網站分類；位址規則則適合處理區域網路或已知位址範圍。兩者不能直接互換，網域解析策略也會影響位址規則何時參與比對。先確認資料中包含所使用的分類，再檢查規則順序與出口標籤，避免將規則未命中誤判為節點故障。詳細說明請參閱路由與分流概念速查。