用戶端與設定文件

V2Ray文件中心與用戶端

集中整理 用戶端安裝訂閱匯入路由分流的操作方式,從選擇平台到完成連線驗證依序閱讀。

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

client workflow

從訂閱匯入到路由分流

用戶端設定不是單一開關。依照訂閱、代理、路由與驗證四個環節逐項處理,可以更快找出設定問題,也方便在不同裝置之間維持一致的使用方式。

subscription

訂閱匯入與更新順序

訂閱連結用於集中傳遞用戶端可識別的設定。首次使用時,先複製完整網址,再於訂閱群組中新增來源並執行更新。清單出現設定後,還要選取目前使用的項目,不能把「匯入成功」等同於「已經連線」。後續更新應在原有群組上執行,以免重複建立同名項目。若更新失敗,先檢查網址是否遭截斷、系統時間是否正確,再確認網路狀態與訂閱來源是否可用。

查看訂閱匯入步驟
訂閱群組 依來源管理
新增訂閱 填寫網址
更新訂閱 手動執行
選擇設定 設為使用中項目

platforms

依作業系統選擇用戶端

桌面平台使用 v2rayN,行動裝置可在 v2rayNG 與 v2flyNG 之間選擇。下載中心會依系統與處理器類型列出對應檔案,入口不會直接略過平台說明。

desktop

Windows

適合使用 v2rayN 圖形化用戶端。桌面版採用跨平台介面,經典 WPF 版保留熟悉的 Windows 操作方式;兩者都支援訂閱群組、系統代理、路由模式與連線測試。進入下載頁後,可依介面使用習慣選擇。

前往下載

desktop

macOS

使用 v2rayN 桌面用戶端。下載前先在系統資訊中確認晶片類型,再選擇 Apple Silicon 或 Intel 對應的安裝檔案。訂閱匯入與路由設定和其他桌面平台大致相同,遷移設定時更容易核對同名選項。

前往下載

mobile

Android

優先使用採用 Xray 核心的 v2rayNG,也可依設定來源與核心需求選擇 v2flyNG。多數較新的裝置適合 arm64 檔案;無法確定處理器架構時,可查看系統資訊,再決定是否使用通用安裝檔。

前往下載

desktop

Linux

v2rayN 提供適用於 Debian、Ubuntu、Fedora 等常見發行版的套件。下載時先確認套件管理系統與處理器架構,安裝後再處理桌面系統匣、系統代理與登入時自動啟動,避免將發行版差異誤判為用戶端故障。

前往下載

quickstart

三步完成基本設定

先建立一套可重現的基本流程,再調整路由與進階傳輸參數。遇到問題時,便能明確判斷是訂閱、用戶端還是系統代理環節出現偏差。

查看完整教學
  1. 01

    安裝對應用戶端

    桌面裝置進入 v2rayN 下載區,Android 裝置選擇 v2rayNG 或 v2flyNG。安裝前確認作業系統、處理器架構與套件格式。首次啟動後,先熟悉訂閱群組、伺服器清單、路由模式與系統代理的位置,不要急著修改進階選項。

  2. 02

    匯入並更新訂閱

    複製完整訂閱網址,在用戶端的訂閱管理中新增群組並執行更新。清單出現設定後選取一個可用項目,檢查協定、位址、連接埠、傳輸方式與 TLS 等欄位是否由訂閱正確提供。QR Code 適合裝置間臨時遷移,長期管理仍建議保留統一的訂閱來源。

  3. 03

    連線並逐層驗證

    啟動核心並開啟所需的代理模式,先確認記錄沒有連接埠衝突或設定解析錯誤,再進行實際連線測試,最後用瀏覽器驗證實際存取。基本連線穩定後,再加入自訂路由與 DNS 設定;一次只變更一類參數,方便回復與比較結果。

open ecosystem

Project V、V2Fly 與 Xray

用戶端、核心、協定與設定格式屬於不同層次。理解它們之間的關係,比記住某個介面按鈕更有助於遷移設定與處理相容性問題。

生態系關係

Project V 建立了圍繞代理協定、傳輸方式、路由規則與用戶端工具的開源生態系。V2Ray 常被用作這套技術體系的通稱,但實際使用時仍需區分圖形化用戶端與底層核心。圖形化用戶端負責匯入訂閱、產生設定、管理系統代理與顯示記錄;核心則負責解析設定、建立連線、執行路由,以及處理入站與出站流量。將兩個層次分開理解,可以說明為何同一份訂閱能被不同用戶端讀取,也能解釋為何某些參數只在特定核心中生效。

核心家族

V2Fly 延續 V2Ray 的社群維護方向,涵蓋 VMess、VLESS、路由、DNS 與多種傳輸組合。Xray 在相近的設定體系上持續發展,並加入更多傳輸與協定能力。兩者不是用戶端名稱,而是可由圖形化用戶端呼叫的核心程式。選擇用戶端時,應同時留意其預設使用的核心、訂閱提供的協定參數,以及伺服器端設定。只比較介面外觀,無法判斷一份設定能否完整載入。

三款用戶端的分工

v2rayN 面向 Windows、macOS 與 Linux 桌面環境,提供訂閱群組、路由設定、系統代理與記錄檢視等圖形化功能,適合需要統一桌面操作流程的使用者。v2rayNG 面向 Android,通常搭配 Xray 核心使用,重點處理行動網路切換、應用程式代理與 QR Code 匯入。v2flyNG 同樣面向 Android,以 V2Fly 核心為主要選擇,可作為需要對應核心行為時的替代方案。三者都屬於社群維護的開源用戶端,但平台定位與核心組合並不完全相同。

開源授權與更新方式

開源專案的程式碼、授權條款與發佈記錄,提供可追蹤的維護依據。用戶端更新通常包含介面修正、系統相容性調整、核心適配與設定格式變更;核心更新則可能涉及協定實作、路由能力與傳輸行為。更新前先閱讀變更內容,並保留目前可用的設定。若新安裝後出現異常,應分別核對用戶端設定與核心記錄,而不是把所有問題歸因於訂閱。下載中心依平台整理入口,文件則按操作環節說明變更帶來的影響。

common questions

常見問題精選

以下問題涵蓋首次設定中最容易混淆的環節。需要完整流程時,可繼續進入疑難解答,或依症狀查閱疑難手冊。

訂閱匯入後沒有顯示設定,先檢查什麼?

先確認複製的是完整訂閱網址,再於對應群組上手動執行更新。若仍然空白,檢查系統時間、本機網路,以及用戶端記錄中的回應資訊。不要連續建立多個相同群組,否則之後很難判斷實際更新的是哪個來源。更多處理順序請參閱疑難解答

用戶端執行後,為什麼瀏覽器仍然無法存取?

先確認核心是否成功啟動,再檢查系統代理是否已開啟。部分瀏覽器或應用程式使用自己的代理設定,需要個別填寫本機監聽位址與連接埠。若記錄提示連接埠衝突,應先處理佔用中的程序或修改監聽連接埠,具體步驟請參閱系統代理排查

全域模式與路由模式該如何選擇?

首次設定可先使用較直接的模式確認基本連線,再切換至預設路由。路由模式會依網域、位址或規則集決定流量出口,更適合長期使用。自訂規則應在基本連線穩定後加入,並注意由上而下的比對順序。完整操作請參閱設定教學

延遲測試通過,是否代表所有設定都正常?

測試通過只能表示相應的測試方法取得回應,不能取代實際存取驗證。還要檢查系統代理、DNS、路由規則,以及目標應用程式是否使用正確的出口。建議依「核心啟動、連線測試、實際存取」的順序逐層確認,失敗時只處理目前層級。