客戶端下載與設定手冊

v2rayNG下載站
v2rayN 客戶端指南

集中整理 四大平台客戶端入口訂閱與路由設定Xray 與 V2Fly 核心說明。先依裝置選擇客戶端,再按照步驟完成匯入、連線與網路驗證。

依目前裝置開啟對應下載分類

PLATFORMS Windows · macOS · Android · Linux
CLIENTS v2rayN · v2rayNG · v2flyNG
CORES Xray · V2Fly
MODEL 程式碼開源 · 社群維護
01 / SUBSCRIPTION

用訂閱群組維護伺服器設定

訂閱連結適合集中維護服務提供方發布的伺服器設定。匯入時先為群組填寫清楚的名稱,再執行一次更新,讓客戶端解析連結內容並建立可選設定。之後服務端調整參數時,通常只要更新原有群組,不必逐項重新建立。

v2rayN 桌面版將訂閱管理、伺服器清單與更新操作分開放置,適合同時處理多個來源;v2rayNG Android 版則把相關入口收納在側邊選單中,操作路徑更精簡。無論使用哪一端,都應先確認訂閱位址完整,再檢查更新結果與目前選取的設定。清單為空時,不要反覆切換系統代理,應先排查連結存取、訂閱格式與更新流程。

02 / ROUTING

依網域與位址規則決定連線方向

路由分流會在建立連線後持續運作,依據網域、IP 位址、連接埠或規則集,決定流量使用代理、直接連線或阻擋存取。常見的「繞過區域網路及中國大陸位址」屬於預設路由模式,適合希望本地服務與常用直連資源維持原有路徑的情境。

預設模式能涵蓋多數日常需求,但規則越多不代表結果越準確。遇到某個網站存取異常時,應先確認命中的規則與解析結果,再決定是否新增自訂項目。自訂規則需留意順序,因為較早符合的規則可能提前結束判斷。相較於只提供單一全域開關的簡易工具,v2rayN 與 v2rayNG 能結合網域規則、位址規則與核心路由能力,方便依業務需求逐步調整。

03 / CORE

依協定能力選擇 Xray 或 V2Fly

圖形客戶端負責設定管理與互動,真正處理連線、傳輸與路由的是底層核心。Xray 與 V2Fly 都源自 Project V 技術體系,基本設定思路相近,但兩者在協定擴充、功能演進與部分欄位支援上有所差異。選擇核心時,應以現有設定所需的能力為準,而不是只看名稱。

v2rayN 可在桌面環境中管理不同核心設定,適合需要測試協定相容性或維護多套方案的使用者;v2rayNG 主要圍繞 Xray 核心打造 Android 端體驗;v2flyNG 則提供以 V2Fly 核心為基礎的替代方案。匯入設定後若提示不支援欄位,應先確認客戶端與核心類型是否相符,再核對協定、傳輸層與 TLS 參數,避免將核心相容性問題誤判為伺服器無法使用。

04 / ACCESS

區分系統代理與 TUN 模式

系統代理透過作業系統提供的代理設定,讓相容應用程式接入客戶端;設定清楚、影響範圍容易判斷,適合瀏覽器與遵循系統代理的桌面程式。啟用前需先選擇可用設定並啟動核心;關閉客戶端前也應恢復系統代理狀態,避免應用程式繼續指向已停止的本機連接埠。

TUN 模式透過虛擬網路介面接管更廣泛的流量,可涵蓋不讀取系統代理設定的程式,但同時涉及驅動程式權限、路由表、DNS 與其他網路工具的協作。首次設定建議先用系統代理驗證訂閱與節點是否正常,再依應用程式需求啟用 TUN。若啟用後無法存取網路,應依序檢查管理員權限、虛擬介面、DNS 策略與路由衝突,而不是同時修改所有參數。

依裝置選擇

四大平台的客戶端下載入口

桌面平台使用 v2rayN,Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。下載頁會繼續提供架構、安裝形式與系統需求說明。

Windows

Windows 使用者可選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面體系,經典版則延續熟悉的 Windows 操作方式。進入下載頁後,再依使用習慣選擇對應入口。

前往下載

macOS

macOS 使用 v2rayN 跨平台桌面版。下載前先在系統資訊中確認處理器類型,Apple Silicon 與 Intel 需選擇不同建置版本,安裝後再依系統提示授予網路相關權限。

前往下載

Android

Android 可優先選用採用 Xray 核心的 v2rayNG,也可依設定需求使用採用 V2Fly 核心的 v2flyNG。多數近年裝置適合 arm64 架構,不確定架構時可在下載頁查看通用版說明。

前往下載

Linux

Linux 使用 v2rayN 跨平台桌面版,可依發行版的套件體系選擇 deb 或 rpm,並區分 x64 與 arm64 架構。安裝前建議先確認桌面環境、架構與權限設定。

前往下載
快速入門

先匯入,再連線,最後驗證

將首次設定分成三個階段,每完成一步就檢查結果。這樣發生問題時,就能明確定位在訂閱、核心啟動或系統接入環節。

查看完整教學
  1. 01

    匯入訂閱或單一設定

    在客戶端中找到訂閱管理入口,填寫完整連結與易於識別的群組名稱,然後執行更新。若使用單一設定,可透過剪貼簿、QR Code 或手動表單匯入。完成後先查看伺服器清單是否出現有效項目,並確認協定與傳輸欄位沒有缺漏。此時先不要修改路由與 DNS,讓初始環境保持簡單。

  2. 02

    選擇設定並啟動核心

    從清單中選取要使用的設定,將其設為啟用項目,再啟動客戶端核心。桌面版通常還需要開啟系統代理,Android 版則需確認系統網路連線授權。若核心無法啟動,優先查看客戶端記錄中的設定解析資訊,並核對目前核心是否支援訂閱所使用的協定欄位。

  3. 03

    驗證存取並逐項調整

    先用瀏覽器開啟熟悉的網站,確認網域解析與基本存取正常,再測試需要代理的目標。只有基礎連線穩定後,才繼續啟用自訂路由、TUN 模式或更複雜的 DNS 設定。若調整後出現異常,可撤回最近一次變更並重新測試,避免多個變數同時改變而難以判斷。

開源生態

Project V、V2Fly 與 Xray 的關係

了解客戶端、核心與協定設定之間的分工,有助於正確選擇軟體,也能在訂閱匯入失敗或連線異常時更快找出問題。

技術體系 Project V

協定設定、傳輸能力與路由機制的共同技術來源

V2Fly

延續 V2Ray 核心能力與社群規範

Xray

在同源基礎上擴充協定與傳輸特性

生態歷史與元件分工

Project V 奠定了 V2Ray 設定模型與模組化網路處理思路。隨著社群發展,V2Fly 與 Xray 形成各自的維護路線,但兩者仍共用許多基本概念,例如入站、出站、路由、傳輸層與 DNS 設定。使用者日常接觸的 v2rayN、v2rayNG 與 v2flyNG 屬於圖形客戶端,負責呈現設定介面、儲存訂閱、整理伺服器清單並呼叫核心。實際的協定交握、流量轉送與規則比對則由核心完成。

因此,「客戶端能開啟」不代表「設定一定可用」。當記錄提示無法辨識協定欄位時,問題可能出在核心相容性;當只有部分應用程式無法連網時,問題更可能位於系統代理、TUN 接管或路由規則。將介面層與核心層分開判斷,比反覆安裝客戶端更有效。

三款客戶端的定位

v2rayN 面向 Windows、macOS 與 Linux 桌面環境,提供訂閱管理、伺服器清單、系統代理、路由設定與多核心設定功能,適合需要在桌面端集中維護連線方案的使用者。v2rayNG 面向 Android,圍繞觸控操作與系統網路連線流程組織功能,通常搭配 Xray 核心使用。v2flyNG 同樣面向 Android,但採用 V2Fly 核心路線,可作為特定設定或核心偏好的替代選項。

選擇客戶端時先看作業系統,再看核心需求。桌面裝置直接進入 v2rayN 分類;Android 設定若依賴 Xray 特性,可優先選擇 v2rayNG,若明確需要 V2Fly 行為,則選擇 v2flyNG。客戶端之間不必單純比較功能數量,符合目前平台與設定格式更重要。

開源授權與可審閱程式碼

三款客戶端與相關核心均採用公開原始碼的社群維護模式,專案的授權檔案、程式碼變更與發布記錄構成可追蹤的技術資料。開源授權明確規範複製、修改與再發佈的條件,也讓開發者能夠審閱網路請求、設定處理與核心呼叫方式。對一般使用者而言,實際價值在於軟體行為可持續接受技術社群檢視,問題修復與相容性討論都有明確依據。

開源特性不代表可以取代正確設定。訂閱內容、伺服器管理與本機裝置權限,仍取決於使用者自身的使用環境。安裝後應依最小必要範圍開啟系統權限,避免直接從來源不明的文字匯入無法解釋的複雜規則,並在調整網路設定前保留原有設定。

更新機制與相容性判斷

客戶端、核心與訂閱格式的更新節奏並不完全一致。客戶端更新可能帶來介面調整與系統相容性改善,核心更新通常涉及協定能力、傳輸實作與規則處理,訂閱服務則可能改變編碼方式或下發欄位。遇到「過去可用、更新後異常」的情況時,應先確認變化發生在哪一層,再閱讀對應的錯誤訊息。

合理的更新順序是先儲存現有設定,再更新客戶端或核心;啟動後使用原有設定完成基本測試,最後更新訂閱並檢查新增欄位。若連線失敗,可依序檢查系統時間、網域解析、TLS 參數、SNI、協定欄位與路由命中順序。一次只變更一個條件,能讓排查結果更可靠。