Windows
桌面端優先選擇 v2rayN。新一代桌面介面適合一般安裝，經典 WPF 版適合需要傳統操作配置的使用者。兩種版本都能管理訂閱、路由與系統代理。
前往下載CLIENT WORKBENCH
客戶端工作台：從訂閱到核心日誌
常見操作集中在五個位置：訂閱群組、路由模式、系統代理、核心選型和日誌視窗。先確認設定所在的層級，再修改具體參數，比反覆匯入設定更容易找出問題。
- 群組名稱常用訂閱
- 自動更新
- 更新入口訂閱群組
分開管理訂閱網址與節點
訂閱是由服務端維護的一組設定入口，客戶端更新訂閱後，才會將其中的節點、協定與傳輸參數寫入本機。實際使用時，應先建立名稱清楚的群組，再貼上完整訂閱網址並執行更新。更新失敗時不要連續重複點擊，應先確認提示屬於網路存取失敗、回傳內容格式不符，還是網址已失效。群組管理的價值在於保留來源界線：多個訂閱互不覆蓋，停用某一組也不會影響其他設定。手動新增的單一節點適合臨時測試，不應與長期維護的訂閱放在同一個群組中。
- 網域策略IPIfNonMatch
- 區域網路位址direct
- 未符合規則proxy
路由規則決定每個請求的出口
路由分流不是簡單的開關，而是一組依序比對的規則。客戶端可根據網域、IP、連接埠或協定類型，將請求交給代理出口、直連出口或阻擋出口。規則越具體，越應放在清單前面；範圍較大的兜底規則則放在最後。修改後也要觀察網域解析方式，因為只設定 IP 規則而沒有合適的網域策略，可能導致規則始終無法命中。日常設定建議先使用客戶端內建的穩定規則集，再逐條加入確實需要的自訂項目，比一次匯入大量來源不明的規則更容易維護與排錯。
- 代理模式自動設定
- 允許區域網路連線
- 本機監聽127.0.0.1
系統代理與核心執行是兩種狀態
核心成功啟動只代表本機代理連接埠已開始監聽；系統中的應用程式是否使用該連接埠，還取決於系統代理設定或應用程式本身的代理選項。瀏覽器可以連線，但某個獨立程式無法連線時，應檢查該程式是否讀取系統代理；所有程式都無法連線時，再檢查核心日誌、本機連接埠與目前節點。允許區域網路連線會改變監聽範圍，只有確實需要讓同一網路中的其他裝置接入時才應啟用，並同步確認作業系統的防火牆規則。理解這兩個層級，可以避免把系統代理未啟用誤判成節點或協定設定錯誤。
- 目前核心Xray
- 設定檢查啟動前執行
- 執行日誌info
客戶端負責介面，核心負責協定執行
v2rayN、v2rayNG 與 v2flyNG 提供訂閱、節點和系統代理等圖形化操作，真正讀取設定並建立連線的是底層核心。Xray 與 V2Fly 具有共同的生態來源，但維護方向、協定擴充和部分欄位支援並不完全相同。選擇核心時應以節點設定要求為準，而不是只比較名稱。若設定包含特定流控、傳輸或安全欄位，客戶端必須搭配支援這些欄位的核心；一般設定則應更重視客戶端與核心組合是否穩定。切換核心後需要重新啟動連線，並從啟動日誌確認實際載入的是目標核心。
loading config: config.json
routing: domainStrategy=IPIfNonMatch
inbound: socks / http
outbound: proxy / direct先查看第一個明確錯誤，再處理後續連鎖提示
設定解析失敗、連接埠被占用、網域解析異常和 TLS 交握失敗，會留下不同的日誌線索。排查時應從一次全新啟動開始，找出最早出現的 error 或 failed 行，並結合前後的設定欄位判斷原因。JSON 語法錯誤通常會指出行列位置；連接埠被占用會出現監聽失敗；憑證與交握問題則要檢查系統時間、serverName、SNI 和傳輸參數。後續大量重複日誌往往只是第一處故障造成的連鎖結果。保留原始錯誤文字並逐項修改，比同時調整節點、DNS、路由和核心更容易確認是哪一步恢復了連線。
PLATFORM ENTRY
依作業系統選擇客戶端與安裝套件
平台頁面集中展示適用客戶端、安裝格式與架構選擇。首頁不直接提供檔案，進入對應平台後，再依裝置類型選擇具體安裝套件。
macOS
macOS 使用 v2rayN 桌面客戶端。下載前先在系統資訊中確認處理器類型，再選擇 Apple Silicon 或 Intel 對應的安裝套件，避免安裝格式與裝置架構不相容。
前往下載Android
Android 可在 v2rayNG 與 v2flyNG 之間選擇。前者採用 Xray 核心路線，後者採用 V2Fly 核心路線；近年多數裝置可選 arm64，無法確認架構時則使用通用安裝套件。
前往下載Linux
Linux 桌面端使用 v2rayN，可依發行版的套件體系選擇 deb 或 rpm，並依處理器架構選擇 x64 或 arm64。安裝後仍需在桌面工作階段中設定系統代理。
前往下載OPEN SOURCE ECOSYSTEM
Project V、V2Fly 與 Xray 的關係
客戶端、核心、協定與訂閱並不屬於同一個層級。理解各自職責後，才能判斷故障時應檢查圖形介面、設定檔，還是底層協定實作。
從 Project V 生態系到兩條核心路線
Project V 建立了一套以設定驅動的網路工具生態系。早期 V2Ray 專案確立了入站、出站、路由、DNS、策略和傳輸層等核心設定結構，之後社群維護逐漸形成 V2Fly 與 Xray 兩條常見的核心路線。兩者在許多基礎概念上相通，例如都以 JSON 設定描述監聽入口、遠端出口與比對規則，但在新增協定、傳輸特性、欄位擴充和版本演進節奏上各有側重。
因此，「V2Ray 客戶端」通常是指管理這類核心與設定的圖形化工具，而不是單一程式名稱。v2rayN 負責桌面端的訂閱、節點、路由、系統代理和核心啟動；v2rayNG 與 v2flyNG 負責 Android 端的設定管理。圖形化客戶端會將使用者操作轉換成核心可讀取的設定，再啟動本機監聽連接埠。連線是否成功，最終取決於訂閱內容、協定參數、傳輸層設定、網域解析、系統時間和本機網路環境共同作用。
開源協定與社群維護代表什麼
程式碼開源讓協定實作、設定結構與客戶端行為能夠被公開討論並持續改進，但不同專案的發布節奏並不一致。客戶端升級可能帶來新的介面或設定產生邏輯，核心升級則可能增加協定欄位、修正相容性問題或調整預設行為。更新前應先閱讀變更說明、保留可用設定，並確認現有訂閱是否依賴特定核心功能。穩定使用不等於追逐每一次更新；出現明確的相容需求、錯誤修正或系統適配變化時再升級，通常更容易控制變數。
開源授權也規定了程式碼複製、修改與再發布的界線。一般使用者更需要注意專案名稱與安裝套件來源是否相符、客戶端實際呼叫哪一種核心，以及設定中是否包含該核心支援的欄位。本網站的教學將客戶端操作與核心概念分開說明：入門步驟聚焦可見介面，設定大全解釋 JSON 各段含義，術語表用於查找協定與網路基礎概念，故障文章則從日誌表現回溯到具體設定。
桌面客戶端
涵蓋 Windows、macOS 與 Linux，集中處理訂閱群組、節點選擇、系統代理、路由規則與核心管理。適合需要以圖形化方式維護多組設定的桌面環境。
Android · Xray 路線
採用 Xray 核心路線，提供訂閱更新、設定匯入、路由設定與連線日誌。包含特定 Xray 擴充欄位的設定，通常優先使用這個組合。
Android · V2Fly 路線
採用 V2Fly 核心路線，介面操作與常見訂閱流程相近。選擇時應以設定要求和核心相容範圍為依據，不需要同時安裝兩種客戶端。
訂閱更新失敗時先檢查什麼？
先確認網址完整且仍可存取，再查看回傳內容是否為客戶端能辨識的訂閱格式。網路錯誤、網址失效與格式錯誤應分別處理，不要直接刪除所有本機設定。
查看訂閱匯入步驟 →為什麼 DNS 與路由要一起檢查？
網域規則是否命中，可能受到解析位置與網域策略影響。只調整 DNS 或只調整路由，都可能掩蓋真正原因；應從請求網域、解析結果和最終出口三個環節逐一核對。
查看 DNS 與 routing 設定 →Xray 與 V2Fly 要怎麼選？
先確認訂閱或手動設定使用了哪些協定、流控與傳輸欄位，再選擇能完整解析這些欄位的核心。基礎設定通常都能理解，擴充功能則需要逐項確認。
查看核心與協定術語 →連線失敗為什麼要先看日誌？
日誌能區分設定解析、連接埠監聽、DNS、連線逾時與交握錯誤。每次只修改一個變數，並從一次全新啟動記錄第一個錯誤，排查路徑會更清楚。
查看設定排錯參考 →LATEST NOTES
設定與故障排查文章
圍繞核心啟動、協定原理和 TLS 錯誤整理可重複使用的檢查順序。文章中的設定片段用於解釋欄位關係，實際參數應以自己的訂閱或服務設定為準。
V2Ray 核心啟動失敗怎麼辦：透過日誌找出 config.json 設定錯誤
從客戶端日誌視窗著手，按照 JSON 語法錯誤、連接埠被占用、欄位拼寫錯誤與協定參數缺失四類常見原因，解讀典型錯誤行，並提供逐項修正與重新啟動的判斷標準。
閱讀全文 →REALITY 協定與 XTLS Vision 科普：交握原理與效能優勢解析
說明 REALITY 的交握特徵與 XTLS Vision 降低重複加密負擔的流控思路，並解釋客戶端、核心與節點設定之間必須相互對應的關鍵欄位。
閱讀全文 →V2Ray TLS 憑證錯誤排查清單：系統時間不同步與 SNI 設定詳解
針對 certificate invalid、handshake failed 等常見提示，依系統時間偏差、serverName 不相符與憑證鏈問題整理檢查順序。
閱讀全文 →