Windows
v2rayN · Desktop / WPF
桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式。首次安裝可先查看桌面版入口；已經習慣特定操作方式時，再依需求選擇 WPF 版。兩種介面都須先匯入有效設定，安裝完成本身不會自動建立伺服器。
下載前請在系統設定中確認處理器架構與系統需求。初次啟動時先保留預設監聽設定，避免尚未建立連線就同時更換連接埠、核心與路由。若要啟用 TUN，請另外檢查執行權限。
前往下載設定目錄 / 常用設定
v2rayN 設定的五個入口
用戶端負責管理設定，核心負責建立連線。先釐清訂閱、系統代理與路由各自控制的項目，再調整參數，才能避免同一個問題衍生出多處互相衝突的設定。以下依桌面用戶端常見的選單整理；Android 用戶端的入口名稱可能不同，但匯入、選擇設定與啟動服務的順序相同。
先儲存群組，再更新訂閱
訂閱網址不是單一伺服器設定，而是用戶端取得一組設定的入口。在 v2rayN 開啟訂閱群組設定，填入群組名稱與服務提供者給的網址，儲存後再執行更新訂閱。更新完成後，先檢查目前群組，確認清單中出現可用設定，再選取一項作為作用中的伺服器。相較於逐項手動填寫參數，透過群組更新更適合持續管理多筆設定；但更新失敗不一定代表節點故障，也可能是網址失效或連線路徑無法到達。訂閱網址可能包含存取憑證，請勿放進截圖、記錄檔或公開討論。
訂閱群組 → 訂閱群組設定 → 新增
填寫備註與訂閱網址 → 儲存
訂閱群組 → 更新訂閱（不透過代理）
選擇群組 → 設為作用中的伺服器依規則順序決定連線出口
路由分流決定已進入核心的連線要直連、代理還是封鎖，不負責將應用程式流量導入用戶端。初次設定可先使用「繞過中國大陸」預設，確認基本連線正常後再新增自訂規則。規則通常由上而下比對，特定網域的例外應排在較廣泛的分類之前；否則前面的規則一旦符合，後面的設定就不會生效。相較於只切換全域模式，依網域與位址分類更容易保留本地服務的連線。下方是 Xray 路由規則片段，需放入完整設定的規則陣列，並確認對應的資料檔與出站標籤均存在。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}接管不讀取系統代理設定的應用程式流量
TUN 透過虛擬網路介面接管流量，適合處理部分不遵循系統代理設定的應用程式。它與路由分流屬於不同層次：前者處理流量入口，後者決定連線出口。啟用前，先以一般代理確認所選設定能正常連線，再依平台要求授予網路或管理員權限。若啟動後所有連線都異常，應先檢查其他虛擬網卡、VPN 程式與 DNS 設定，而非一再更新訂閱。相較於逐一替每個應用程式填寫代理位址，TUN 的涵蓋範圍更廣，但也更需要留意區域網路存取、喚醒後恢復，以及結束時是否清除路由。
確認一般代理連線正常
→ 依平台要求授予權限
→ 主畫面：啟用 TUN
→ 檢查目標應用程式與區域網路存取依設定需求選擇核心
圖形用戶端與代理核心是不同的元件。v2rayN 提供設定管理介面，並可依安裝套件與版本支援情況使用不同核心；協定、傳輸方式與擴充欄位最終由實際執行的核心解析。匯入成功只代表用戶端辨識了設定，不代表目前的核心支援其中所有參數。若遇到不支援的欄位或啟動後立即退出，先從記錄檔確認核心名稱，再核對設定來源的要求。相較於直接修改產生的檔案，優先透過圖形介面調整核心設定更容易保留變更，也能減少下次切換伺服器時設定遭覆寫的情況。
設定 → 參數設定 → Core 類型相關設定
確認協定對應的核心 → 儲存
重新啟動服務 → 從記錄檔確認實際啟動的核心先確認應用程式是否讀取系統代理設定
「自動設定系統代理」會變更系統提供給應用程式的代理設定，但不代表接管裝置上的所有連線。瀏覽器通常會讀取這項設定，部分程式則需要另外填入本機代理位址，或改用 TUN。初次使用時先檢查本機監聽連接埠，再選擇自動設定系統代理；結束使用前若仍有連線異常，可檢查是否殘留指向本機的代理設定。相較於路由中的「全域代理」，這個選項控制的是流量是否進入用戶端，而非進入後如何轉送。排查時分開檢查兩者，能更快判斷是應用程式設定還是伺服器連線出了問題。
主畫面 → 系統代理 → 自動設定系統代理
停止使用時 → 清除系統代理
手動設定應用程式時 → 核對本機監聽位址、連接埠與代理類型下載入口 / 依作業系統選擇套件
V2Ray 用戶端平台選擇
桌面裝置建議優先查看 v2rayN，Android 裝置建議優先查看 v2rayNG；有 V2Fly 設定需求時再考慮 v2flyNG。安裝套件須符合作業系統與處理器架構；檔案能下載，不代表能在目前裝置上執行。下載中心集中列出安裝入口、架構說明與相關需求，首頁不固定顯示版本資訊。
macOS
v2rayN · Apple Silicon / Intel
先開啟「關於這台 Mac」，查看晶片或處理器資訊。Apple Silicon 裝置請選擇對應架構的下載入口，Intel 裝置則選擇 Intel 入口；不要只憑裝置外觀或購買年份判斷。下載中心並列兩種安裝入口，方便依裝置資訊選擇。
首次執行時，留意系統對應用程式與網路權限的提示。先確認用戶端能啟動、訂閱能匯入，再設定系統代理。若其他網路工具也在接管流量，先暫停其中一個，以減少路由與 DNS 設定互相影響。
前往下載Android
優先選擇 v2rayNG · v2flyNG 為備選
v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。先依設定需求選擇用戶端，再選擇 arm64 或通用安裝套件。較新的主流裝置通常使用 arm64；不確定架構時，請先查看裝置資訊，必要時選用通用套件。
啟動服務時須確認系統 VPN 授權。若鎖定螢幕後經常中斷，再檢查電池最佳化與背景執行限制。對照兩款用戶端時，請先停止原有連線，避免將系統只允許一個 VPN 同時運作的限制，誤判為設定故障。
前往下載Linux
v2rayN · deb / rpm
依發行版的套件管理系統選擇 deb 或 rpm，再確認裝置使用 x64 還是 arm64。下載中心也提供這兩種架構的下載入口。建議先透過發行版的圖形軟體安裝工具開啟套件；若出現相依性提示，請先記下具體名稱。
安裝完成後，檢查桌面環境的代理設定是否會被目標應用程式讀取。各應用程式對系統代理的支援程度不一；若瀏覽器能連線、其他程式卻不行，應先確認流量入口。TUN 還需要額外權限，不建議在初次匯入訂閱時一併調整。
前往下載快速入門 / 先建立基本可用的連線
匯入訂閱到連線驗證
建議一次只變更一類設定。先確認設定能夠連線，再調整分流與流量接管範圍；發生異常時，才能明確找出是哪個步驟造成變化。以下以 v2rayN 桌面版為主，v2rayNG Android 版則依序匯入、選取設定並啟動服務。
步驟 01 / 設定來源
匯入訂閱並選取伺服器
準備設定提供者提供的訂閱網址或單一分享連結。訂閱網址請填入「訂閱群組設定」，分享連結則使用從剪貼簿匯入的入口，勿將兩種內容填入同一個欄位。儲存群組後執行更新，檢查傳回的清單，再將其中一項設為作用中的伺服器。Android 版可在新增設定或訂閱設定中完成相應操作。
若更新後清單沒有項目，先切換至正確群組，並檢查網址是否完整、是否多了空格，以及服務提供者是否已更換網址。即使瀏覽器能開啟訂閱頁面，也不代表傳回內容是用戶端支援的訂閱格式。請勿連續重複更新，以免覆蓋現有狀況；先記下用戶端顯示的錯誤訊息。
訂閱匯入詳細步驟 →步驟 02 / 流量入口
設定代理與基本路由
桌面版先選擇「自動設定系統代理」，並使用合適的路由預設。系統代理決定支援此設定的應用程式是否將要求送至本機監聽連接埠；路由預設則決定進入核心的連線如何選擇出口。兩者不能互相取代，初次連線也不必立刻編寫複雜規則。
若目標應用程式有獨立的代理設定，請確認填入的代理類型、位址與連接埠是否和用戶端一致。暫時保持 TUN 關閉，先用瀏覽器驗證基本連線。Android 版啟動服務時請確認系統授權，再檢查是否設定了依應用程式代理；遭排除的應用程式不會依預期走這條連線路徑。
路由與模式設定 →步驟 03 / 連線檢查
驗證連線，再檢查記錄檔
啟動服務後，分別檢查一個預期直連的位址，以及一個預期透過代理連線的位址。只看到用戶端圖示變化，不足以證明實際要求已經經過代理；須搭配連線結果與記錄檔判斷。節點延遲測試不等於下載速度，單次測試結果也不適合直接用來判定穩定性。
若無法連線，請依序檢查「核心是否啟動、本機連接埠是否正在監聽、應用程式是否使用代理、遠端是否可連線」。先保留錯誤訊息中的關鍵字，不要一次重新安裝所有元件。準備分享排查資訊時，請隱藏訂閱網址、伺服器憑證與個人網路資訊，只保留操作步驟、錯誤類型及必要的環境說明。
依問題症狀進入診斷 →開放原始碼生態 / 用戶端與核心
Project V、V2Fly 與 Xray
V2Ray 常被用來泛指一類代理工具，但實際設定涉及圖形用戶端、代理核心、協定與伺服器四個層次。下載時查看用戶端名稱，判斷參數相容性時查看核心與協定，排查網路問題時則沿著實際連線路徑逐步定位。名稱相似，不代表所有設定都能直接互換。
設定層次
介面管理
核心執行
- 圖形用戶端管理訂閱、設定與啟動選項
- 代理核心解析規則並建立實際連線
- 協定與傳輸規範通訊方式與必要參數
- 遠端服務提供設定所對應的連線端點
Project V 是生態系背景，不是單一下載檔案
Project V 以模組化代理工具為核心發展，V2Ray 是其中廣為使用的核心專案。V2Fly 社群持續維護與 V2Ray 相關的實作，Xray 則由 V2Ray 專案分支發展而來，逐步形成自己的功能演進方向與參數支援範圍。了解這段關係，有助於理解用戶端中的核心選項：它們有共同的發展歷史，但不能因此假設設定欄位、協定擴充與路由行為永遠完全相同。
日常使用通常不必直接編輯完整的核心設定。圖形用戶端會依訂閱項目與介面設定產生執行設定，再啟動相應的核心。若手動修改產生的檔案，下次切換伺服器或儲存設定時可能會被覆寫。需要長期保留的變更，應優先透過用戶端提供的設定入口完成，並記錄修改前後的行為。
三款用戶端的開源授權與使用定位
v2rayN、v2rayNG 與 v2flyNG 都是由社群維護的開放原始碼圖形用戶端，可免費使用。v2rayN 採用 GPL-3.0 授權，適用於桌面設定管理；v2rayNG 同樣採用 GPL-3.0，面向 Android 並使用 Xray 核心；v2flyNG 採用 GPL-3.0，面向 Android 並使用 V2Fly 核心。授權規範的是軟體程式碼的使用與散布，不代表用戶端會附帶可連線的遠端服務。
桌面版建議從 v2rayN 開始，Android 版優先考慮 v2rayNG；若設定明確要求 V2Fly 的行為，再評估 v2flyNG。三者的設定介面、核心組合與平台權限各不相同，因此遷移時應重新確認路由、DNS 與應用程式代理範圍，而不只是確認伺服器項目已匯入。詳細選擇建議請參閱用戶端比較評測。
核心授權與協定支援須分別確認
V2Fly 與 Xray 的核心程式碼通常採用 MPL-2.0 授權，與圖形用戶端的授權屬於不同層次。開放原始碼代表可依授權條款檢視、修改及散布相關程式碼；要判斷某份設定能否執行，仍須確認特定核心支援哪些協定與傳輸欄位。VMess、VLESS、Trojan、Shadowsocks 是協定名稱，不是伺服器位址，也不能只憑協定名稱推斷速度。
例如，設定包含特定 TLS 或 REALITY 參數時，須完整符合伺服器提供的設定，並使用支援這些欄位的實作。請勿為了排除錯誤而任意關閉憑證驗證。先確認系統時間是否正確、網域是否相符、參數是否完整，再判斷是否需要更新用戶端或更換核心。若不清楚參數用途，先查閱術語說明，比逐一嘗試開關更容易重現問題。
分開處理軟體更新與訂閱更新
用戶端更新會影響介面、相依元件與設定產生邏輯；核心更新會影響協定實作與執行行為；訂閱更新則只會刷新伺服器設定。訂閱更新成功不代表軟體已更新；安裝新版用戶端也不會自動修復失效的訂閱。下載中心集中提供用戶端下載入口，訂閱網址與服務狀態仍須向設定提供者確認。
更新前請先備份現有設定，記下目前使用的核心、監聽連接埠與自訂規則。更新後先驗證基本連線，再逐項還原其他設定。若新環境出現異常，請保留記錄檔中的第一個錯誤與觸發步驟，不要只記下最後一行「啟動失敗」。遇到連線逾時、DNS 解析異常或系統代理殘留，可直接前往疑難排解；概念相關問題則先查看常見問題，避免不必要的重新安裝。
文章 / 設定與排查筆記
用戶端選擇與執行記錄
建立基本連線後，再依實際遇到的問題閱讀相關專題。用戶端選擇文章說明平台與核心差異；記錄檔文章依錯誤關鍵字定位問題；啟動失敗專題則分別處理連接埠占用、格式錯誤與欄位相容性問題。每次先確認現象屬於哪個層次，再決定要調整哪項設定。
Xray 核心啟動失敗怎麼辦：排查連接埠占用、JSON 格式與欄位錯誤
核心一啟動就退出時，可從連接埠衝突、設定檔格式、欄位拼寫與核心版本四個方向逐一排查，找出出錯行。先判斷是設定解析失敗還是連線失敗，再決定要修改設定或檢查網路。
閱讀啟動問題排查步驟 →v2rayN、v2rayNG、v2flyNG 怎麼選：核心、平台與功能差異比較
從適用平台、核心家族、協定支援範圍與日常操作習慣四個面向比較三款用戶端，提供桌面與 Android 的選擇建議。重點是確認設定需要哪些功能，而不是只因名稱相似就互換安裝套件。
閱讀用戶端選擇說明 →解讀 v2rayN 執行記錄：常見錯誤關鍵字與排查方向
依記錄檔層級與錯誤關鍵字分類，說明 connection refused、i/o timeout、TLS 握手失敗等訊息分別指向哪個環節。搭配問題發生時間與目標應用程式，保留最早出現且有效的錯誤資訊。
閱讀記錄檔排查方法 →