客戶端下載 · 設定參考

V2Ray中文教學網 v2rayN 客戶端下載與協定設定

說明訂閱匯入、路由分流與協定選擇,以及客戶端設定與內核支援之間的對應關係。

v2rayN 設定功能訂閱、分流與連線模式

查看設定教學 →

客戶端設定可分為三個層面:訂閱與節點決定連線目標,系統代理或 TUN 模式決定哪些應用程式的流量交由客戶端處理,路由與 DNS 則決定流量進入後如何傳送。安裝完成不代表連線已生效。先匯入可用設定並選取節點,再設定流量入口,最後查看記錄與實際連線結果,便能在疑難排解時找出問題所在。

下方面板展示設定項目的結構示意,欄位名稱可能因客戶端介面更新而異,操作時請以目前介面為準。不要一次修改訂閱、傳輸、DNS 和路由這四類設定;保留一份可正常運作的設定,每次只調整一類並確認結果。如此既方便還原,也能避免把節點本身的問題誤判為應用程式代理問題。

訂閱群組設定介面示意
群組備註
工作裝置
訂閱網址
由訂閱服務提供者填寫
自動更新
關閉,先手動驗證
更新方式
依群組管理

訂閱可集中管理一組節點,適合網址或參數可能變動的設定。先在訂閱群組中新增名稱和完整網址,儲存後執行更新,再選取要使用的節點;新增網址本身不會自動建立連線。相較於逐一貼上分享連結,群組訂閱更方便批次管理,但更新時也可能覆寫手動修改的內容。建議將自建節點放在獨立群組。訂閱網址可能包含存取憑證,請勿公開分享;更新失敗時,先確認網址有效,再檢查更新請求使用的連線方式。

協定欄位:先確認組合,再調整模式

VMess、VLESS、Trojan 和 Shadowsocks 是代理協定;WebSocket 等是傳輸方式;TLS 與 REALITY 則屬於傳輸安全相關設定。它們並非同一層級的選項。看到 VLESS 節點時,還要確認傳輸類型、是否使用 TLS 或 REALITY,以及是否指定 flow,不能只選擇協定名稱就儲存。上方卡片展示的是欄位結構,並非可直接連線的完整節點設定。

VLESS 的 encryption 通常填寫 none,但這不代表可以省略連線安全層。Trojan 需要正確的密碼和伺服器身分驗證設定;遇到憑證錯誤時,應檢查系統時間、SNI 與伺服器憑證,而不是直接啟用略過憑證驗證。Shadowsocks 的加密方法必須與伺服器一致;名稱帶有年份前綴的方法還有特定的金鑰要求,不能將一般字串密碼任意套用到每一種方法。

選擇節點時,優先保留服務提供者給出的完整參數。若要手動輸入,請依序確認位址、連接埠、使用者憑證、傳輸和安全層,再測試連線。客戶端顯示節點名稱,只代表設定已儲存,不代表內核能解析所有欄位,也不代表遠端伺服器已可連線。若想進一步比較各協定的設計取捨、行動裝置耗電影響和設定相容性,請參閱協定與內核技術參考。

客戶端下載入口依系統與處理器架構選擇

查看所有客戶端 →

桌面平台可優先查看 v2rayN;Android 裝置可優先查看使用 Xray 內核的 v2rayNG;需要相容 V2Fly 設定時,再考慮 v2flyNG。這些客戶端名稱相近,但支援平台、內核和安裝套件格式各不相同。下載前先確認作業系統和處理器架構,安裝後再設定訂閱與節點,避免將安裝套件不相容的問題混入連線疑難排解。

下方入口會前往下載頁的對應平台區段,不會直接從首頁啟動安裝套件下載。下載頁集中說明各種套件的適用範圍,方便在同一處比較桌面版、經典介面、晶片架構和發行版套件格式。更換裝置時可以沿用訂閱來源,但原裝置的系統代理、權限和路由設定不會隨訂閱一併移轉,仍需重新檢查。

Windows

推薦 v2rayN

Windows 使用者可在 v2rayN 桌面版與經典 WPF 版之間選擇。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式;選擇安裝套件時,先確認系統架構,再依介面偏好和使用習慣決定。不同套件的設定目錄與移轉方式各有差異,不能只憑檔名判斷是否能直接覆蓋安裝。

首次使用時,先完成啟動和訂閱匯入,再啟用系統代理。部分應用程式不會讀取系統代理設定,這時再考慮應用程式內的代理設定或 TUN。若更換客戶端後瀏覽器仍連線到舊連接埠,請檢查系統設定是否留有其他代理程式的設定,並確認同一時間只有預期的程式負責管理流量入口。

macOS

v2rayN

macOS 安裝套件依 Apple Silicon 與 Intel 晶片區分。可在系統的「關於這台 Mac」查看晶片或處理器資訊;Apple Silicon 選擇 arm64,Intel 則選擇 x64。請優先選擇符合架構的套件,不要預設使用相容模式;安裝前也應確認下載頁列出的系統需求。

桌面客戶端的訂閱管理與系統網路權限是兩個不同步驟。成功匯入後,仍需確認目前選取的節點、代理入口和應用程式實際使用的連線路徑。需要啟用 TUN 時,請依介面和系統提示授予必要權限;若裝置受組織政策管理,應先遵守裝置管理規範,再調整網路設定。

Android

推薦 v2rayNG

Android 裝置優先選擇 v2rayNG,v2flyNG 則是 V2Fly 內核的替代選項。多數較新的主流裝置適用 arm64 套件;若不確定架構,請查看裝置資訊或考慮通用套件。兩款客戶端名稱和圖示容易混淆,安裝前請確認應用程式名稱;匯入後再核對協定支援,不要將兩者的設定方式視為完全相同。

啟動連線時的 VpnService 授權用於建立本機流量接管介面,不代表訂閱會自動變得可用。裝置長時間待機後斷線,除了檢查節點狀態,也應查看背景執行限制和省電策略。分應用程式代理適合控制流量接管範圍;設定時先確認清單代表包含還是排除,避免將所需的應用程式放錯位置。

Linux

v2rayN

Linux 使用者可查看 v2rayN 的 deb 與 rpm 安裝套件,並確認 x64 或 arm64 架構。套件格式須符合發行版使用的套件管理系統,架構則須符合處理器,兩者都要相符。檔案能下載不代表適用於目前系統;安裝相依套件、桌面環境與權限需求,都應依下載頁說明逐項確認。

Linux 的系統代理是否生效,也取決於桌面環境和應用程式本身。瀏覽器可用但其他程式無法連線時,先確認該程式是否會讀取代理設定,不要立即更換節點。啟用 TUN 前,請確認權限和路由接管範圍,尤其要留意區域網路、容器網路和現有虛擬介面;修改後請保留可還原的原始設定。

設定移轉只能沿用部分參數。新裝置仍須確認內核支援、流量入口和 DNS 路徑,操作方式請參閱 快速入門教學。

Project V 開源生態系分別選擇客戶端與內核

閱讀協定詳解 →
CLIENT

v2rayN · v2rayNG · v2flyNG

訂閱管理、介面操作、產生設定
CORE

Xray · V2Fly

建立連線、處理協定、執行路由

生態背景:Project V 與 V2Ray

Project V 是由代理與網路工具相關開源專案組成的體系,V2Ray 是其中廣為使用的核心名稱。它的價值不只在於某一種協定,而是將入站、出站、路由和傳輸設定整合到統一的設定結構中。客戶端介面顯示的「節點」,通常只是某個遠端出站的呈現方式;系統代理、本機監聽和 DNS 也屬於其他設定部分,不能只用節點名稱概括整個執行環境。

日常交流中,V2Ray 也常被用來泛指整個生態系,因此下載時更應留意實際的應用程式名稱。v2rayN 是圖形客戶端,並不等同於 V2Ray 內核本身;v2rayNG 與 v2flyNG 則是面向 Android 裝置的客戶端。釐清這層關係後,閱讀文件時便能分辨「介面新增了功能入口」和「內核新增了協定能力」,也能判斷問題該從客戶端記錄還是協定參數著手。

內核家族:V2Fly 與 Xray

V2Fly 延續 V2Ray 的社群開發;Xray 則從相關程式碼基礎發展出自己的功能方向。兩者有共同背景,但各自維護與演進,不能視為同一個程式的兩種外觀。即使部分設定欄位相似,新增的傳輸方式、安全機制、路由選項和預設行為也可能不同。選擇內核時,應依據目前節點需要的功能與實際相容性,而非只比較名稱或發布時間。

使用 VLESS、Vision 與 REALITY 組合時,應特別確認 Xray 的支援範圍,以及伺服器提供的 flow、伺服器名稱、公鑰和 shortId。REALITY 是傳輸安全機制,不能簡單視為與 VMess、Trojan 同一層級的獨立代理協定。現有 V2Fly 設定也不應直接批次移轉到另一個內核:先選一個節點確認欄位,再驗證路由和 DNS,最後才移轉完整設定。

三款客戶端:開源管理介面與平台差異

v2rayN、v2rayNG 和 v2flyNG 都是開源客戶端,提供節點編輯、訂閱管理和連線控制等圖形操作。開源代表可查閱原始碼與授權條款,但不能取代對執行權限和設定來源的判斷。訂閱服務提供者、遠端伺服器和客戶端各自扮演不同角色;安裝客戶端不會自動取得伺服器帳號,也不保證每個匯入的節點都能使用。

v2rayN 面向桌面平台,適合在同一介面管理訂閱與路由,並依支援範圍選擇內核。v2rayNG 主要採用 Xray 內核,適合 Android 使用者運用相應的協定功能;v2flyNG 則採用 V2Fly 內核,適合需要相容相關設定的情境。跨應用程式移轉時,優先重新匯入完整分享連結或訂閱,再確認連線模式,不要只複製介面中的備註名稱。

開源授權:確認散布與使用範圍

Project V 相關專案、圖形客戶端、內核及打包相依項目可能採用不同的開源授權,不能將生態系中某一份授權視為所有元件的通用規範。個人使用、重新散布和修改後發布的要求各不相同,請分別查看對應專案的授權檔案及附帶說明。頁面所述「程式碼開源」指的是開發與散布屬性,並非對訂閱內容或遠端服務的保證。

對一般使用者而言,較實用的做法是記錄應用程式名稱、平台架構和使用的內核,保留設定來源說明,並了解客戶端要求的權限。設定中的密碼、使用者識別資訊和訂閱網址應妥善保管;截圖詢問問題時請遮蔽這些內容。節點位址、SNI 與公鑰雖然用途不同,也不宜直接公開整份私人設定;通常只要說明欄位是否一致,就足以協助找出問題。

更新機制:分別管理客戶端、內核與訂閱

客戶端更新主要影響介面和設定管理;內核更新主要影響連線實作;訂閱更新則由設定提供者調整節點清單。這三類更新的來源和效果各不相同。訂閱更新後節點數量或參數有所變動,不一定是客戶端升級造成的;客戶端升級後無法啟動某項設定,也不一定代表訂閱網址失效。先確認最近變動的是哪一層,再決定要還原、重新匯入或調整欄位。

更新前請保留現有設定,記錄正在使用的節點與路由模式;更新後先測試一個常用節點,再檢查區域網路存取、網域解析和需要代理的應用程式。自動更新間隔應依訂閱服務提供者的限制設定,不必頻繁重新整理。若持續失敗,請暫停重複請求,依序檢查網址有效性、請求路徑、系統時間和錯誤記錄,避免反覆修改而難以追查原始原因。

連線驗證:由入口到遠端逐層檢查

成功匯入卻無法連線時,先確認已選取目前使用的節點且內核正常啟動,再檢查應用程式是否確實透過代理連線。瀏覽器可以連線但其他程式不行,通常應確認流量入口;只有網域無法存取,則優先檢查解析路徑;所有應用程式都無法連線,再回頭檢查節點參數和遠端可達性。延遲測試只反映某種測試請求的結果,不能單獨證明所有協定和應用程式流量都正常。

需要查詢詞彙時,請使用術語表區分訂閱、分享連結、入站和出站;要依症狀處理時,請查看常見問題。整理錯誤發生時間、最近修改的設定和記錄類型,比盲目切換協定更有效。選擇設定仍應配合伺服器支援與應用程式需求;維持參數一致,比追逐特定協定名稱更重要。

設定主題文章訂閱格式、更新與部署

查看所有文章 →

基本連線完成後,再依需求閱讀主題文章。訂閱格式會影響匯入方式,更新失敗時需要檢查請求路徑;路由器部署則涉及與桌面客戶端不同的網路角色。每篇文章聚焦處理一類問題,方便在修改前確認適用條件,也避免混用旁路由、Android 授權和桌面系統代理的操作方式。