匯入訂閱 →
將服務提供者提供的訂閱網址新增至分組，再執行更新。訂閱是取得設定的管道，不等於客戶端本身；安裝完成後，仍須準備可用的連線資料。
設定主題
訂閱、代理與路由
代理模式 →
先使用系統代理確認瀏覽器能否連線，再判斷是否需要 TUN。接管方式決定哪些應用程式的流量會進入客戶端，路由規則則決定流量進入後的傳送路徑。
確認連線 →
先測試是否能建立連線，再檢查目標網頁與出口 IP。單次延遲不代表下載速度，也不能取代 DNS、規則命中與實際連線結果的檢查。
從一筆訂閱，整理出一套可用設定
訂閱分組設定
不同來源的伺服器若全放在同一份清單中，容易搞混更新範圍。先在「訂閱分組設定」中填寫容易辨識的備註，貼上完整訂閱網址，儲存後再更新。v2rayN 可依分組篩選伺服器，v2rayNG 也能透過訂閱分組管理入口維護來源。相較於逐筆貼上連線網址，訂閱更適合批次更新，但結果仍取決於服務提供者回傳的內容。若清單是空的，先確認網址、有效期限與網路連線，不要急著重裝客戶端。訂閱網址通常包含存取憑證，截圖或尋求協助時請遮住完整網址。
訂閱分組與篩選實作 →訂閱分組設定
備註日常訂閱
訂閱網址範例
https://example.com/sub?token=xxxx啟用更新 · 已開啟
設定畫面示意，請在客戶端中操作。
先用系統代理，再啟用 TUN
系統代理適合用來確認瀏覽器及遵循系統代理設定的應用程式是否正常；未遵循這項設定的程式，可能仍會直接連線。TUN 會透過虛擬網路介面接管流量，通常也涉及系統管理員權限、路由與 DNS。使用 v2rayN 時，應先確認一般代理連線可用，再視需要啟用 Tun 模式，避免一次變更多項設定。v2rayNG 首次連線則須確認已授予系統 VPN 權限。相較於只設定瀏覽器代理，TUN 的接管範圍較廣，但無法修復失效的訂閱或錯誤的伺服器參數。結束客戶端前，也請確認系統代理已還原。
查看各平台的權限需求 →參數設定示意
啟用 Tun 模式 · 已開啟
區域網路連線 · 已關閉
系統代理自動設定
依目標選擇直連或代理
路由分流負責決定進入客戶端的要求要從哪個出口送出，但不會讓應用程式自動使用代理。初次使用可先選擇內建的「繞過中國大陸」規則，了解連線結果後，再新增自訂網域或 IP 項目。相較於將所有要求都交給代理，分流能為本地服務、內網位址及特定網站保留獨立路徑。自訂規則通常會依序比對，應將範圍明確的例外規則放在較廣泛的規則之前，並確認 DNS 解析位置符合預期。修改後，請以同一目標重複測試並記錄變更，避免同時更換伺服器、規則與解析方式。
查看路由規則實作 →路由選擇示意
目前路由繞過中國大陸
區域網路目標直連
其他目標依規則比對
讓核心功能符合設定需求
圖形客戶端負責管理與操作，實際建立連線的是核心。v2rayN 可依客戶端提供的選項管理不同核心；v2rayNG 使用 Xray 核心，v2flyNG 則提供 V2Fly 核心的另一種選擇。相較於只看客戶端名稱，確認核心支援的協定、傳輸方式與安全選項，更能判斷設定是否可用。不同核心的參數並非完全通用，切換前應保留原設定、確認服務提供者的要求，再測試一筆已知可用的設定。不要只因某個核心更新就更換整套環境，應優先處理明確的相容性需求。
分清客戶端與核心 →設定檢查清單
協定類型與伺服器端一致
傳輸方式確認支援情況
核心選擇依設定需求選擇
分開檢視測速與連線結果
TCPing 主要反映與目標連接埠的連線狀況；實際連線測速則會經過代理鏈路連線至測試目標。相較於只查看連接埠是否可連通，實際連線測試更接近真實使用情境，但仍會受測試網址、網路壅塞與伺服器端策略影響。匯入訂閱後，先選擇一組伺服器進行測試，再設定目前使用的伺服器，並用瀏覽器開啟目標網頁、檢查出口 IP。若發生逾時，依序檢查本機連接埠、代理狀態、訂閱效期、系統時間與傳輸參數。不要因單次測試失敗就認定客戶端損壞，也別把較低延遲等同於較高頻寬。
首次連線與確認步驟 →測試流程示意
第一步實際連線測試
第二步設定使用中的伺服器
第三步確認網頁與出口 IP
安裝檔下載
依作業系統選擇客戶端
桌面裝置建議使用 v2rayN；Android 裝置建議使用 v2rayNG，需要 V2Fly 核心時再考慮 v2flyNG。安裝檔須同時符合作業系統、處理器架構與封裝格式，不能只看檔名中的客戶端名稱。下方連結會開啟下載頁並前往對應平台，安裝需求也集中說明於該頁。
客戶端負責讀取連線設定，不會附帶可用的訂閱服務。安裝前請備妥服務提供者交付的訂閱網址或連線網址，並確認裝置時間正確、網路連線正常。若已安裝其他代理工具，請先停止其流量接管，避免連接埠與系統網路設定互相影響。
Windows
v2rayN · 優先推薦下載頁提供桌面版與經典 WPF 版兩種選項。桌面版採用新一代跨平台介面，WPF 版則保留經典操作配置；請依系統需求與既有使用習慣選擇，不必為了體驗介面而同時執行兩套代理。
首次安裝請選擇有寫入權限且適合長期存放的資料夾，並依套件內的說明啟動。先匯入訂閱，確認核心運作正常後再啟用系統代理。若需要 TUN，請再確認權限與虛擬網卡狀態；不要把系統管理員權限當成解決所有連線問題的方法。
前往下載 →macOS
v2rayN · 桌面客戶端先在系統的「關於這台 Mac」查看晶片資訊，再選擇 Apple Silicon 或 Intel 安裝檔。選對架構可減少相容層帶來的不確定性；這兩種安裝檔並非功能等級不同，而是分別對應不同處理器平台。
將應用程式安裝至常用的應用程式資料夾。首次開啟若出現系統提示，請依安全性設定確認應用程式來源與允許選項，不要直接關閉整套安全機制。連線前檢查既有的網路代理設定，連線後再確認瀏覽器能否正常存取。TUN 相關步驟請依客戶端提示及目前系統的授權要求操作。
前往下載 →Android
v2rayNG · 優先推薦建議優先使用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時可選擇 v2flyNG。近年推出的主流手機通常適用 arm64 套件；若不確定裝置架構，可先查看下載頁的通用套件說明，再依裝置資訊選擇。
安裝時僅授予目前可信來源所需的權限。新增訂閱分組、更新設定並選取伺服器後，點選連線並確認系統 VPN 授權。同一時間通常只能由一個應用程式接管此通道；若背景連線中斷，請檢查省電策略與背景執行限制，不要反覆匯入相同訂閱。
前往下載 →Linux
v2rayN · 桌面客戶端依發行版的套件管理系統選擇 deb 或 rpm，並確認 x64、arm64 架構。deb 常用於 Debian、Ubuntu 等發行版，rpm 常用於 Fedora 等發行版；衍生發行版仍須查閱該系統的套件與相依性說明。
安裝後，先在桌面工作階段確認客戶端能否啟動及本機監聽是否正常，再檢查瀏覽器是否遵循桌面環境的系統代理設定。不同應用程式讀取代理的方式可能不同，因此瀏覽器能連線不代表所有程序都已接管。若需要 TUN，再處理額外權限與路由，避免長期以高權限執行所有桌面操作。
前往下載 →快速入門預覽
從匯入到首次連線
每次只變更一個環節。先將設定匯入客戶端，再確認流量接管範圍，最後檢查實際連線；如此一來，即使發生異常，也能知道該回到哪個步驟檢查。
-
新增訂閱並更新設定
在 v2rayN 中開啟訂閱分組設定，為來源填寫備註，貼上完整訂閱網址並儲存，再執行更新訂閱；在 v2rayNG 中則從訂閱分組入口完成相同設定。複製時請留意首尾空白、缺少的參數與換行；網頁登入網址通常不能直接當作訂閱網址使用。
更新後先確認目前分組確實列出伺服器。若清單是空的，請查看更新提示，確認服務是否有效、網路能否連上訂閱入口。已有的設定不必急著全部刪除，可先備份原設定，再單獨測試新分組，避免排查時失去原本可用的參考。
-
選擇伺服器與代理方式
先對預計使用的伺服器進行實際連線測試，再設為目前使用的伺服器。桌面版先選擇自動設定系統代理，並使用預設或內建路由方案完成基本測試；Android 裝置則選取設定後點選連線，閱讀並確認系統 VPN 授權提示。介面顯示已連線，只表示流量接管流程已啟動，仍須進行下一步的實際連線測試。
系統代理、TUN 與路由不是同一組開關。前兩者決定流量如何進入客戶端，路由則決定流量進入後的出口。一般瀏覽器連線正常後，再依應用程式需求啟用 TUN 或新增規則。若裝置上還有其他代理、網路加速或 VPN 工具，請先暫停其流量接管功能。
-
確認連線並記錄基準設定
開啟一個明確需要透過代理存取的目標，確認頁面能否完整載入，再使用可信賴的出口 IP 查詢服務確認連線路徑。測試前請留意瀏覽器快取與獨立代理擴充功能，必要時改用新的瀏覽器工作階段。實際連線測試成功但網頁無法開啟時，優先比較兩者的目標、DNS 與路由，不要只更換伺服器。
確認可用後，記下目前使用的分組、代理方式與路由選項，作為後續調整的基準。發生問題時先還原這組設定，再檢查訂閱是否過期、本機連接埠是否衝突，以及系統時間是否正確。尋求協助時，可提供遮蔽敏感資訊後的錯誤訊息與操作步驟，但不要公開訂閱網址或連線憑證。
連線前設定檢查
訂閱分組已新增並更新
使用中的伺服器手動選擇
系統代理自動設定
路由方案繞過中國大陸
啟用 Tun 模式 · 已關閉
靜態介面示意。網頁上的設定不會變更裝置網路，請在客戶端中操作。
連線失敗時，先檢查哪一層？
訂閱更新失敗，先檢查網址與連線條件；清單有伺服器但連線失敗，先檢查伺服器參數與核心記錄；只有特定應用程式連不上，則先檢查流量接管範圍與路由。先找出問題所在的層級，再決定是否調整設定。
依問題狀況查找常見解答 →開源生態與維護
客戶端與核心各司其職
V2Ray 並非某一款介面固定的軟體名稱。Project V 生態系圍繞代理協定、傳輸方式與路由功能發展，圖形客戶端則將這些功能整合為訂閱、伺服器、代理模式與記錄等操作項目。了解這些分工，比記住按鈕的位置更有幫助。
Project VV2FlyXray
本站整理三款客戶端的下載入口與中文設定說明。客戶端軟體、核心專案與提供訂閱的服務商各有分工：客戶端不會自動提供可用服務，核心支援某個協定也不代表伺服器端設定一定正確；訂閱是否有效仍由服務提供者決定。
Project V、V2Fly 與 Xray
Project V 提供了解 V2Ray 體系的背景。V2Fly 持續維護 V2Ray 相關專案；Xray 則是從相關技術體系發展出的另一種核心路線。兩者有部分共通概念，但功能演進、協定支援與設定細節並不完全相同。教學中提到的協定名稱、傳輸類型與安全選項，最終仍須由使用中的核心支援。
因此，遇到設定匯入成功卻無法執行時，應檢查協定與核心功能，而不只是確認客戶端是否顯示該項目。判斷時應一併參考服務提供者的設定說明、客戶端目前選用的核心與錯誤記錄。術語相近，不代表參數可以直接互換。
三款開源客戶端怎麼選
v2rayN 是適用於桌面系統的開源圖形客戶端，適合集中管理訂閱、系統代理與路由。v2rayNG 適用於 Android，採用 Xray 核心，方便在行動裝置上匯入設定與管理連線。v2flyNG 同樣適用於 Android，為需要 V2Fly 核心的使用者提供另一種選擇。這三者都是客戶端，不是銷售訂閱服務的入口。
選擇時先確認裝置平台，再查看服務提供者使用的協定與傳輸設定。若沒有明確的相容性需求，桌面裝置優先選用 v2rayN，Android 裝置優先選用 v2rayNG；已有穩定環境時，先保留原設定，不必只因名稱不同就反覆遷移。不同客戶端的介面與匯出格式可能不同，遷移前請先確認訂閱能否重新匯入。
開源授權與設定隱私
開源代表軟體原始碼依各專案的授權條款提供；使用、修改與重新散布時，須遵循相應條款。客戶端與核心是不同專案，不能將其中一個專案的授權直接套用到整個組合。開源也不能取代對安裝來源、系統權限與連線設定的審慎判斷。
訂閱網址、連線網址與匯出的設定檔可能包含存取憑證。分享問題截圖時，請遮住完整網址、帳戶識別資訊與驗證內容；公開記錄前，也要檢查是否包含這些資料。備份檔應存放在安全的位置；更換裝置或交出舊裝置前，請清除已儲存的設定與自動更新工作。
客戶端更新與訂閱更新
客戶端更新會變更程式介面、相容性或核心組合；訂閱更新則會向服務提供者重新取得伺服器設定。兩者解決的問題不同。伺服器過期通常應檢查訂閱狀態；若協定選項不受支援，則可能與客戶端或核心功能有關。不能把每次連線失敗都歸因於程式需要更新。
計畫更新前，先保存訂閱分組、路由與必要的自訂設定，並閱讀安裝需求與版本變更說明。更新後先用原本可用的設定測試，再逐項還原額外設定。若只有某個應用程式發生異常，請保留其他已確認的條件，檢查該應用程式使用代理的方式。穩定且可重現的操作記錄，比一次調整多項參數更容易找出問題。
技術筆記
安裝、測速與分流實作
基本連線正常後，再依需求閱讀專題筆記。首次安裝可參考執行環境與初始設定；選擇連線則可了解實際連線測試與存取確認；需要自訂流量路徑時，再深入了解網域、IP 與規則順序。每篇筆記聚焦一個操作問題，方便對照目前設定逐項確認。
v2rayN 首次安裝與初始設定：Windows／macOS 通用重點及常見問題
從解壓縮資料夾的選擇、執行環境、首次啟動時的核心設定，到系統代理與開機自動啟動，整理 v2rayN 在 Windows 與 macOS 初次設定時最常遇到的問題。
閱讀筆記 →首次連線 V2Ray 節點：實際連線測速挑選伺服器，確認代理是否生效
匯入訂閱後，了解如何區分 TCPing 與實際連線測速、依結果挑選伺服器，再透過瀏覽器連線與出口 IP 查詢確認流量確實經過代理。
閱讀筆記 →V2Ray 路由規則設定實作：domain 與 ip 規則寫法，以及中國大陸與海外分流方案
解析 v2rayN 路由設定中的網域規則、IP 規則與 geosite／geoip 用法，說明繞過中國大陸、全域代理與自訂直連三種分流情境的設定方式。
閱讀筆記 →