PROJECT V 生態系 · 圖形客戶端

V2Ray白話指南:
客戶端選型與設定教學

從選擇客戶端開始,依序掌握訂閱匯入系統代理與 TUN路由分流與 DNS。每一步先說明操作結論,再解釋設定理由。

永久免費 程式碼開源 中文文件 V2Fly · Xray
CONFIGURATION MAP

從連得上,到設定清楚

客戶端只是設定入口。真正影響使用結果的是訂閱更新、流量接管範圍、路由規則與 DNS 解析路徑。以下四項依實際設定順序排列。

SUBSCRIPTION

訂閱負責批次管理節點

訂閱連結可以理解為一份遠端設定清單。將連結加入客戶端後,還要執行一次更新,節點才會加入目前的分組。之後伺服器端內容有所變更,也需要重新更新訂閱;只重新啟動客戶端不會自動重新整理清單。建議先確認分組已啟用,再選擇其中一個節點進行連線測試。

手動匯入單個 VMess、VLESS 或 Trojan 連結適合臨時測試,長期使用則更適合透過訂閱分組管理。分組名稱只用於整理,不會改變協定本身。複製連結時請保留完整內容,避免通訊軟體換行或截斷參數。

subscription.json
{
  "remarks": "日常連線",
  "enabled": true,
  "updateInterval": 24
}
CLIENT ENTRY

依系統前往下載頁

桌面端優先使用 v2rayN,Android 可在 v2rayNG 與 v2flyNG 之間選擇。下載頁會進一步區分處理器架構與安裝套件格式。

查看所有客戶端 →

DESKTOP

Windows

Windows 桌面端使用 v2rayN。新一代桌面介面適合從頭安裝,經典 WPF 版則適合延續熟悉的選單結構。進入下載頁後依系統架構選擇檔案,安裝完成後再匯入訂閱。首次測試建議先啟用系統代理,確認瀏覽器連線正常後,再處理 TUN 與自訂分流。

前往下載

DESKTOP

macOS

macOS 使用 v2rayN 桌面版。下載前先在系統資訊中確認處理器類型:Apple 晶片選擇 arm64,Intel 處理器選擇 x64。首次開啟時依系統提示完成應用程式授權。若只需要瀏覽器與一般桌面程式,先從系統代理開始;需要涵蓋更多應用程式時,再閱讀 TUN 權限與路由說明。

前往下載

MOBILE

Android

Android 首選 v2rayNG,採用 Xray 核心並提供訂閱、掃描 QR Code、路由與 VPN 接管入口;需要 V2Fly 核心時可選擇 v2flyNG。多數較新的裝置優先選擇 arm64,無法確認架構時使用通用版。匯入訂閱後先更新分組,再選擇節點並允許系統建立本機 VPN 連線。

前往下載

DESKTOP

Linux

Linux 桌面端使用 v2rayN,可依發行版選擇 deb 或 rpm,並區分 x64 與 arm64。安裝後若介面能啟動但系統流量沒有變化,先檢查桌面環境是否接受代理設定,再查看權限與 TUN 設定。排查時將圖形客戶端、系統代理與應用程式自身代理分成三層,不要同時修改。

前往下載
QUICK START

三步完成首次連線

先建立最小可用設定,再逐項加入 TUN、DNS 與分流規則。一次只修改一個變數,連線異常時才能知道問題出在哪一層。

查看完整教學 →
  1. 01

    安裝與匯入

    桌面系統安裝 v2rayN,Android 安裝 v2rayNG,或依核心需求選擇 v2flyNG。開啟客戶端後找到訂閱設定,新增分組並貼上完整訂閱連結,然後執行更新。若清單仍為空,先檢查分組是否啟用、連結是否遭截斷,以及更新操作是否確實完成。

    只有單個節點連結時,可以使用從剪貼簿匯入或掃描 QR Code 的入口。訂閱與單節點最終都會產生本機設定,但訂閱更適合後續批次更新。匯入完成後先不要修改路由範本,保留預設設定有助於判斷節點本身能否建立連線。

  2. 02

    選擇節點與接管方式

    從訂閱分組中選擇一個節點,將它設為目前的活動設定。桌面端先啟用系統代理,讓會讀取系統設定的應用程式透過客戶端;Android 端啟動連線並確認系統授權。此時只驗證基本連線,不要同時啟用複雜分流、自訂 DNS 與多層代理。

    需要讓更多桌面程式進入客戶端時,再考慮 TUN。啟用前確認一般系統代理已經運作,並關閉可能佔用相同虛擬介面或代理連接埠的其他程式。TUN 失敗不代表節點失效,它更常與權限、路由表、虛擬介面或 DNS 接管方式有關。

  3. 03

    驗證並逐項最佳化

    基本連線建立後,分別測試一個應直連的目標與一個應走代理的目標,再觀察客戶端記錄是否出現相應的出站連線。若只有網域存取異常而直接連線位址正常,應優先檢查 DNS;若瀏覽器正常但特定程式無法連線,應檢查該程式是否讀取系統代理,或是否需要 TUN。

    最後再加入自訂路由。每次只增加一組規則,儲存後重新連線並再次測試。遇到問題時依「訂閱內容、節點連線、流量接管、路由命中、DNS 解析」的順序逐層排查,比反覆切換節點更容易找出根因。

OPEN SOURCE ECOSYSTEM

Project V、核心與客戶端的關係

將核心、圖形介面與訂閱服務分開理解,許多設定問題會簡單得多。它們處於不同層級,名稱相近,但職責並不相同。

PROJECT V

Project V 是生態背景

Project V 建立了一套可組合的網路代理工具與設定模型。常見設定由入站、出站、路由、DNS 與傳輸參數組成:入站接收本機應用程式流量,出站決定流量如何離開,路由負責將不同目標交給指定出口,DNS 則提供網域解析結果。圖形客戶端將這些結構轉換為選單、開關與訂閱分組,讓日常使用不必從空白設定檔開始。

理解這一層的意義在於:客戶端介面中的「系統代理」「路由模式」「遠端 DNS」並非彼此無關的獨立功能,它們最終都會轉換成核心能讀取的設定。連線失敗時,應確認問題發生在介面儲存、設定產生、核心啟動,還是網路出口,而不是把所有異常都歸咎於節點。

CORE FAMILIES

V2Fly 與 Xray 是兩個核心家族

V2Fly 延續 Project V 的社群實作與設定體系,Xray 則在相近的設定思路上維護自己的功能集合。兩者都能處理常見的入站、出站、路由與 DNS 任務,也都支援多種傳輸組合,但具體欄位、功能範圍與更新節奏可能不同。複製設定時應先確認目標客戶端使用哪個核心,不能只因節點名稱相同,就假定所有選項都能互換。

VMess、VLESS、Trojan 等名稱描述的是協定或設定方式;V2Fly、Xray 描述的是執行設定的核心家族;v2rayN、v2rayNG、v2flyNG 則是使用者直接操作的客戶端。將這三個層次分開,就能避免把協定能力、核心能力與介面功能混為一談。

CLIENT LAYER

三款客戶端負責不同平台入口

v2rayN 是桌面端圖形客戶端,涵蓋 Windows、macOS 與 Linux,負責訂閱管理、節點切換、系統代理、TUN、路由範本與記錄檢視。它不是一種新協定,而是將核心設定組織成桌面介面。不同桌面系統的權限模型與代理設定入口各不相同,因此同一個選項在各平台上的啟用流程可能有所差異。

v2rayNG 面向 Android,通常搭配 Xray 核心;v2flyNG 同樣面向 Android,但主要依核心家族差異作為選擇依據。兩者都能匯入訂閱與單節點設定,也都透過系統提供的本機 VPN 介面接管應用程式流量。選擇時先看訂閱內容與所需核心能力,不必只根據介面名稱判斷。

LICENSE & MAINTENANCE

開源協定與維護節奏要分開看

客戶端與核心由不同專案維護,各自有明確的開源授權、發布節奏與相容範圍。開源代表程式碼、授權界線與變更紀錄可公開檢視,但不代表所有元件會在同一天更新。客戶端發布通常還要完成介面適配、核心整合與平台打包,因此客戶端更新與核心更新存在時間差是正常現象。

日常使用不需要追逐每一次變更。遇到協定相容性、系統升級或明確故障時,再閱讀更新說明並升級會更穩妥。更新前記錄目前的訂閱分組、路由模式與 DNS 設定,升級後先驗證基本連線,再恢復自訂規則。如此即可分開判斷「程式更新造成的變化」與「原有設定問題」。