PLATFORM / 01
Windows
選擇 v2rayN。桌面版採用跨平台介面，經典 WPF 版保留傳統操作方式，可依使用習慣決定。
V2Ray 用戶端設定檢查清單
V2Ray入門指南：v2rayN 下載與基礎代理設定
先依作業系統選擇用戶端，再逐項完成設定。指南涵蓋 訂閱匯入、系統代理與 連線確認，每個步驟都提供可核對的設定位置與判斷依據。
永久免費
開放原始碼
中文文件
Xray · V2Fly
04 支援平台
03 圖形化用戶端
CORE Xray · V2Fly
PROTO VMess · VLESS · Trojan
啟用清單
V2Ray 用戶端設定的四項關鍵檢查
先確認用戶端，再處理訂閱、系統代理與連線狀態。從左側選擇檢查項目，右側查看操作範圍與判斷標準。
檢查 01
先依作業系統選定用戶端，避免混用安裝說明
Windows、macOS 與 Linux 的桌面使用流程以 v2rayN 為主，Android 則先查看 v2rayNG；需要 V2Fly 核心時，再將 v2flyNG 作為對應平台的備選。用戶端介面、核心與安裝包架構是三個不同問題，應依序判斷。先選作業系統，再確認處理器架構，最後選擇用戶端，可避免將桌面操作步驟套用到行動裝置，也能減少匯入後找不到選單的情況。
下載頁會分開列出四個平台，並標示桌面版、經典介面、arm64、通用包、deb 與 rpm 等差異。無須先理解所有協定，完成平台選擇即可進入下一步。
platform=Windows → client=v2rayN
檢查 02
匯入訂閱後手動更新，確認節點清單
訂閱連結不是一般網頁網址，必須從用戶端的訂閱管理入口新增。貼上前先確認開頭與結尾完整，避免通訊軟體換行或複製到多餘空格。儲存後執行一次手動更新，再觀察用戶端是否顯示群組或節點。如果清單仍是空白，應先查看更新提示，而不是反覆切換系統代理；訂閱尚未解析時，代理開關不會補齊節點資料。
以 QR Code 匯入與從剪貼簿匯入的結果應一致。若出現重複群組，先整理舊訂閱，再保留一個來源清楚的訂閱，後續更新與故障定位會更容易。
subscription → save → update manually → select node
檢查 03
區分系統代理、TUN 模式與路由規則
系統代理會讓遵循作業系統代理設定的應用程式進入用戶端；TUN 模式涵蓋範圍較廣，但通常需要額外權限。兩者都不是節點協定本身，也不應在問題尚未定位前頻繁來回切換。首次設定建議先使用系統代理，確認瀏覽器能如預期運作，再根據應用程式是否讀取系統代理，決定是否評估 TUN 模式。
分流規則決定哪些請求直連、走代理或攔截。先使用用戶端提供的基本規則，再依網域、位址範圍與應用程式需求逐步新增規則。一次只修改一組條件，修改後立即驗證，避免多條規則互相覆蓋。
mode=system-proxy · route=rule-based
檢查 04
從程序、日誌與代理狀態三個層面確認連線
按下連線只代表用戶端開始執行設定，不表示所有應用程式都已使用代理。檢查時先確認核心程序是否正常啟動，再查看日誌中是否有連接埠占用、憑證名稱、DNS 解析或設定欄位錯誤。接著核對系統代理是否開啟，以及目標應用程式是否遵循該設定。分層排查能將「用戶端未啟動」與「應用程式未走代理」區分為兩類問題。
完成驗證後，記錄當時使用的節點、模式與規則。之後若出現變化，只需比較最近一次修改，不必重新安裝用戶端或同時重設所有設定。
core running → log clean → proxy enabled → app test
平台入口
依作業系統選擇 V2Ray 用戶端
分別核對平台、處理器架構與安裝包類型。首頁只負責分流，具體檔案入口統一放在下載頁。
-
01
新增訂閱並手動更新
在訂閱管理中貼上完整連結，儲存後執行更新。看到群組與節點清單，才代表匯入階段完成。如果用戶端提示格式錯誤，先重新複製原始連結，並檢查是否包含空格或換行。
-
02
選擇節點與代理方式
先選取一個節點，再啟動核心。桌面端首次使用可從系統代理開始；Android 連線時依系統提示授予網路連線權限。暫時維持預設路由規則，減少額外變數。
-
03
查看日誌並驗證目標應用程式
確認用戶端沒有連接埠、DNS、憑證名稱或設定欄位錯誤，再開啟目標應用程式測試。若只有個別應用程式無法運作，應檢查該應用程式是否讀取系統代理，而不是直接更換訂閱。
核心與生態系
Project V、V2Fly 與 Xray 的關係
用戶端負責介面與系統整合，核心負責協定、傳輸、路由與連線處理。區分這兩個層次，選型會更準確。
從 Project V 設定體系到兩個常見核心家族
Project V 建立了以設定驅動代理連線的技術生態系，常見概念包括入站、出站、路由、DNS、傳輸層與協定參數。V2Fly 延續 V2Ray 的社群維護路線，保留大量既有設定習慣與協定組合；Xray 在相同技術脈絡上擴充部分協定與傳輸能力，並形成獨立的更新節奏。兩者有共同來源，也各有支援範圍，不能只按名稱判斷優劣。
對一般用戶端使用者而言，首先要確認訂閱中的協定是否與用戶端核心相容。VMess、VLESS、Trojan、Shadowsocks 等類型在不同核心中可能有不同參數要求；REALITY 等能力也取決於具體核心與用戶端實作。訂閱能夠匯入，只代表文字格式已被識別，不表示目前核心能執行每個欄位。連線失敗時，應分開檢查「訂閱格式相容性」與「協定能力相容性」。
用戶端、核心與訂閱是三個獨立層次
v2rayN 是桌面圖形化用戶端，負責訂閱管理、系統代理、路由設定、日誌查看與核心呼叫。v2rayNG 面向 Android，通常採用 Xray 核心路線，並透過系統網路介面建立連線。v2flyNG 同樣面向 Android，但更適合需要 V2Fly 核心相容性的設定。三款用戶端都屬於開放原始碼軟體，功能變化由各自的維護週期、平台權限與底層核心共同決定。
訂閱是設定分發方式，不等同於用戶端或核心。同一份訂閱在不同用戶端中顯示的欄位可能略有差異，通常是因為介面命名、預設值與核心支援範圍不同。排查時先記錄用戶端名稱、核心類型、協定與代理模式，再討論具體錯誤，會比一句「連不上」更有用。
OPEN SOURCE
開放原始碼有助於理解實作邊界
公開程式碼讓協定處理、設定轉換與平台整合具備可檢視的基礎。使用者仍應依自己的系統權限、設定來源與使用情境做選擇，不要把「開源」簡單等同於所有設定天然正確。
UPDATE PATH
用戶端與核心可能分開更新
圖形介面更新不一定會同步改變核心能力，核心更新也可能影響協定參數與預設行為。遇到升級後的差異時，先閱讀用戶端提示，再核對目前的核心類型與設定欄位。
DOCUMENTATION
依問題層級查閱文件
安裝問題查看平台說明，匯入問題查看訂閱格式，連線問題查看日誌與核心，應用程式無法運作再檢查系統代理與分流。分層閱讀比反覆重裝更容易找到原因。
常見問題精選
設定前先確認的四個問題
這些問題通常出現在下載、匯入與首次連線階段。先了解判斷方法，再進入對應文件處理。
v2rayN 應該選擇哪個桌面版本？
想使用新一代跨平台介面時，選擇桌面版；習慣傳統 Windows 操作方式時，可查看經典 WPF 版。兩者都應先核對系統架構與執行環境。
查看相關問答 →匯入訂閱後沒有節點怎麼辦？
先確認連結完整並手動更新訂閱，再查看用戶端提示。在產生節點清單之前，不需要切換系統代理或修改分流規則。
查看相關問答 →系統代理與 TUN 模式該如何選擇？
首次設定先使用系統代理完成基礎驗證。只有目標應用程式不讀取系統代理，且已確認節點與核心正常時，再評估 TUN 模式。
查看操作步驟 →連線後仍無法使用，應先檢查哪裡？
依核心程序、用戶端日誌、系統代理、目標應用程式四個層面檢查。一次只改變一個條件，並保留最近一次能正常運作的設定紀錄。
進入故障排查 →使用心得
近期 V2Ray 設定與排查文章
針對憑證錯誤、Android 背景連線與桌面用戶端啟動問題，提供可執行的檢查順序。