Project V 生態系 · 用戶端設定指南

V2Ray工具箱下載與設定

從開源用戶端到訂閱與路由設定,依平台選擇安裝套件,再參考中文設定教學完成首次連線。

  • Xray · V2Fly
  • 訂閱管理
  • 路由分流

v2rayN 常用設定

先釐清協定、路由與系統連線入口,再調整個別參數。

協定類型與傳輸參數

同一個用戶端可管理 VMess、VLESS、Trojan 與 Shadowsocks 等設定,但協定名稱不代表完整的連線方案。匯入後還要確認傳輸方式、TLS、伺服器名稱等欄位;REALITY 屬於傳輸安全相關功能,不能當成獨立的代理協定選項。相較於每種協定都安裝不同工具,集中管理更方便比對參數;不過,用戶端能否實際執行特定設定,仍取決於所選核心及其功能支援。初次使用時,建議先保留匯入的設定值,再依伺服器說明調整。

查看協定與傳輸方式差異 →
設定參數示意協定 / 安全性
VLESS協定類型
VMess另一種協定選項
securityreality
serverNameexample.com

畫面僅示意設定項目;實際名稱、可選參數與預設值請以使用中的用戶端為準。

依作業系統選擇用戶端

桌面平台使用 v2rayN;Android 建議先了解 v2rayNG,再依核心需求考慮 v2flyNG。

Windows

v2rayN 提供桌面版與經典 WPF 版。桌面版採用新一代跨平台介面,WPF 版則延續經典的桌面操作方式。初次安裝時,請依作業系統架構和下載頁說明選擇,不必因介面差異而同時執行兩個用戶端;若兩個程式使用相同的監聽連接埠,反而會增加排查難度。

安裝後先開啟參數設定,確認本機連線入口,再匯入自己的設定。既有使用者要移轉時,請保留原有資料目錄,並記錄訂閱群組、路由與 DNS 的自訂項目。不要直接用新目錄覆蓋舊目錄;先確認程式能正常啟動與連線,再處理舊版安裝與開機自動啟動設定。

前往下載 Windows 版

macOS

v2rayN 安裝套件依 Apple Silicon 與 Intel 晶片區分。可在系統的「關於這台 Mac」查看晶片或處理器資訊,再選擇對應的下載入口。用戶端名稱相同,不代表所有安裝套件都適用於同一台裝置;選對架構後再處理系統權限提示,能避免把啟動問題誤認為設定問題。

桌面教學中訂閱、路由與記錄檢查的概念同樣適用,但選單位置和系統代理入口可能不同。初次連線時,請留意系統網路設定是否已指向用戶端的本機連接埠;退出後若瀏覽器仍無法連線,請優先檢查是否留下指向已停止服務的代理設定。

前往下載 macOS 版

Android

v2rayNG 使用 Xray 核心,v2flyNG 則是 V2Fly 核心的替代選項。先依現有設定所需的核心功能選擇應用程式,再選擇 arm64 或通用安裝套件。較新的主流手機通常適合 arm64;若不確定裝置架構,可參考下載頁的選擇說明,不要只看安裝套件大小來判斷。

初次啟動連線時,須確認系統 VPN 授權;這與訂閱網址的存取權限是兩回事。連線後若只有部分應用程式異常,請檢查分應用代理與系統背景限制。耗電情況也會受訊號強度、應用程式請求頻率及重新建立連線的影響,不能只憑協定名稱判斷;建議搭配系統電池用量統計逐項排查。

前往下載 Android 版

Linux

v2rayN 桌面版提供 deb 與 rpm 安裝套件,並依處理器架構區分。先確認 Linux 發行版使用的套件格式,再查看裝置是 x64 還是 arm64。圖形用戶端適合在桌面工作階段中管理訂閱與參數;安裝套件格式、桌面環境相依項目和網路權限應分別檢查,不宜一概歸因於核心問題。

不同桌面環境對系統代理的支援程度不盡相同。若瀏覽器可以連線,其他應用程式卻不行,先確認該應用程式是否遵循桌面代理設定,必要時在應用程式中指定本機入口。修改監聽連接埠時,也要同步檢查環境變數與既有應用程式設定,避免仍在使用舊連接埠。

前往下載 Linux 版

Project V 生態系與核心的關係

釐清用戶端、核心與連線設定的差異,排查時才知道該檢查哪一層。

從 Project V 到圖形用戶端

Project V 是以代理通訊工具為核心的開源生態系,V2Ray 是其中的重要專案。日常所說的「安裝 V2Ray」,可能是指安裝圖形用戶端,也可能是部署實際處理連線的核心,兩者並不相同。圖形介面負責儲存伺服器參數、管理訂閱及產生執行設定;核心則讀取這些設定,處理入站、路由與出站連線。

因此,能開啟用戶端視窗,只能表示介面程式已經執行,不能證明核心已成功啟動,更不能證明某個應用程式已使用代理。完整檢查應從解析設定開始,接著確認本機監聽,最後檢查應用程式的連線入口。將這幾個環節分開檢查,比反覆重新安裝用戶端更容易找出原因,也能減少對現有訂閱與自訂規則的影響。

V2Fly 與 Xray 的發展脈絡

V2Fly 社群延續 V2Ray 的開發,Xray 則以相關程式碼為基礎,發展出自己的功能路線。兩者在設定組織方式與部分協定上有共同背景,但如今已是需要分別確認功能支援的核心專案。某份教學適用於一個核心,不代表其中每種安全選項、傳輸名稱與設定欄位都能直接套用到另一個核心。

選擇核心時,先確認伺服器端的要求,再確認用戶端是否能產生相應參數。若涉及 REALITY 等特定功能,更要確認核心與用戶端介面是否都支援。不要把核心差異簡化成固定的速度排名:實際連線體驗還會受到伺服器負載、網路路徑、傳輸組合與裝置資源限制等因素影響。

三款開源用戶端的用途

v2rayN 是適用於桌面平台的開源圖形用戶端,方便集中管理設定、訂閱、路由與系統代理。v2rayNG 是 Android 開源用戶端,使用 Xray 核心,並透過系統 VPN 介面接收應用程式流量。v2flyNG 同樣適用於 Android,但以 V2Fly 核心為基礎,適合現有設定明確依賴該核心行為的情況。

選擇用戶端時,平台與核心相容性通常比介面偏好更重要。桌面與手機可以使用同一來源提供的相容設定,但本機監聽、應用程式接入方式與背景執行規則不能直接照搬。手機的 VPN 授權與桌面的系統代理並非相同的開關;移轉設定時應重新檢查應用程式的涵蓋範圍,而不只是確認伺服器項目已經出現。

開源授權與使用範圍

開源表示專案依照相應授權公開原始碼,並約定使用、修改與再散布的條件;不代表所有相關專案都採用相同授權。V2Fly 與 Xray 核心通常採用 MPL 2.0,至於用戶端與附帶元件,則應分別查閱各自的授權說明。個人安裝使用與修改後再散布的要求不同,不能只憑「開源」標籤取代對具體條款的理解。

用戶端本身也不包含可直接使用的遠端連線資源。訂閱來源、伺服器設定與遠端服務的使用規則都需要另外確認。V2Ray工具箱整理下載入口與參數說明,不提供訂閱或帳號。公開討論問題時,請遮蔽訂閱網址中的存取憑證、使用者識別資訊與伺服器驗證欄位;分享記錄前也要先移除敏感內容。

更新時須區分四種項目

用戶端更新、核心更新、訂閱更新與規則資料更新,處理的是不同內容。用戶端更新可能調整介面與設定產生方式;核心更新會影響實際連線功能;訂閱更新會同步來源提供的伺服器項目;GeoIP 與 GeoSite 資料更新則會影響依 IP 和網域分類的路由結果。只更新訂閱,無法解決核心缺少功能的問題。

更新前先保存目前使用的設定與自訂規則。更新後確認核心能否啟動,再檢查常用目標的路由行為。若某個網站突然改走不同出口,除了規則資料變更,也要檢查規則順序與 DNS 策略。排查期間不宜同時更換核心、訂閱和路由範本,否則很難判斷是哪項變更影響結果。

比較協定時,先看連線條件

VMess、VLESS、Trojan 與 Shadowsocks 的驗證方式、設定結構及常見部署組合各不相同。VLESS 本身沒有提供與 VMess 相同的加密機制,通常須搭配合適的傳輸安全方案;Trojan 常搭配 TLS;Shadowsocks 則要求用戶端與伺服器端採用相符的加密方式。只比較協定名稱,容易忽略決定連線能否成功的關鍵欄位。

在行動裝置上,背景持續執行、連線保活、應用程式請求密度與訊號環境都可能影響電量。在桌面裝置上,應用程式是否正確連到本機監聽連接埠,通常比更換協定更值得優先檢查。協定指南會依據這些實際條件說明取捨,不會把任何一種協定說成適用於所有裝置與伺服器的預設選項。

設定前常見問題

匯入訂閱後,為什麼還要選擇設定?

訂閱更新只會取得並儲存設定集合,不一定會自動啟用其中某一項。請先確認訂閱群組中有可識別的項目,再選擇要使用的設定,並查看核心是否成功啟動。接著才檢查系統代理或 VPN 接入狀態;清單中出現項目,不代表應用程式的請求已經進入用戶端。

查看匯入與連線教學 →
所有用戶端都必須使用 10808 連接埠嗎?

不是。這是常見的本機監聽連接埠範例,實際連接埠以目前用戶端的設定為準。若連接埠已被占用,可以先找出衝突的程式,或在用戶端中改用其他可用連接埠。修改後必須同步更新瀏覽器、應用程式與相關系統代理入口,否則這些程式仍會向舊連接埠送出請求。

查看監聽連接埠檢查方法 →
瀏覽器可以連線,其他應用程式為什麼還是失敗?

先釐清是應用程式沒有使用代理,還是已經連上代理但目標連線失敗。有些程式會忽略系統代理,需要另外設定;另一些程式可能使用獨立 DNS、UDP 或不同的網路堆疊。先查看應用程式的連線入口與記錄,再判斷是否需要調整路由或接入方式,不要直接把所有問題都歸咎於訂閱。

查看應用程式接入與驗證步驟 →

設定記錄與故障排除

從規則檔案、連接埠衝突與 DNS 著手,依照具體問題縮小檢查範圍。