Project V 用戶端與設定文件 程式碼開源

V2Ray官網
用戶端與路由分流

集中整理 v2rayN 與 v2rayNG 下載入口訂閱匯入步驟路由規則設定。依裝置選擇用戶端,再根據節點協定確認 Xray 或 V2Fly 核心,避免將用戶端、核心與訂閱服務混為一談。

永久免費 社群維護 Xray · V2Fly 中文設定文件
platform.outbounds

依裝置選擇用戶端

平台決定安裝套件類型,節點協定決定核心能力。先選擇裝置,再確認訂閱中的協定是否需要 Xray 或 V2Fly;下載頁會進一步說明架構、晶片與安裝格式的選擇。

桌面首選

Windows · v2rayN

適合需要完整系統代理、訂閱分組、路由規則與日誌排查的桌面使用者。下載頁提供新一代跨平台介面與經典 WPF 介面兩種入口;一般新裝置可先使用桌面版,已有成熟設定流程的使用者則可繼續選擇熟悉的介面。

前往下載
桌面用戶端

macOS · v2rayN

桌面版沿用 v2rayN 的設定邏輯,可管理訂閱、出站與分流規則。下載前需要確認裝置的晶片類型:Apple Silicon 裝置選擇 arm64 安裝套件,Intel 裝置選擇 x64 安裝套件。晶片類型可在系統資訊頁面確認,不應只依購買年份猜測。

前往下載
行動裝置首選

Android · v2rayNG

v2rayNG 採用 Xray 核心,適合包含 VLESS、REALITY 等 Xray 功能需求的訂閱,也是多數行動裝置的直接選擇。較新的裝置優先選擇 arm64 套件;若無法確認處理器架構,或需要更廣泛的架構相容性,可前往下載頁選擇通用套件。

前往下載
套件安裝

Linux · v2rayN

適合希望透過圖形介面管理訂閱、系統代理與路由規則的桌面版 Linux 使用者。安裝格式應依照發行版的套件體系選擇:Debian、Ubuntu 系通常使用 deb,Fedora、Rocky Linux 等系統通常使用 rpm,同時還要區分 x64 與 arm64 架構。

前往下載
routing.console

規則清單與設定面板

V2Ray 用戶端的關鍵能力不只在於連線節點。訂閱、核心、DNS 與路由共同決定連線結果;以下設定面板依問題類型拆分說明,並提供易於理解的設定片段。

JSON 設定檢視 config/routing
代理 · 直連 · 攔截

依序套用路由規則

路由設定會將不同流量交給不同出站:需要代理的網域進入代理出站,本地網路與指定位址範圍走直連,明確不需存取的類別則進入攔截出站。規則會由上到下檢查,命中後停止繼續比對,因此較具體的規則通常放在前面,範圍較廣的兜底規則放在後面。與只提供全域開關的簡易工具相比,V2Ray 的規則物件還能組合網域、位址、連接埠、網路類型與入站標籤,適合將使用情境整理成可維護的清單。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

調整規則後,應先確認標籤是否與 outbounds 中的出站名稱一致,再觀察用戶端日誌中的實際命中結果。

setup.sequence

三步完成基本連線

首次設定不要同時修改大量進階選項。先完成訂閱匯入與基本連線,再依實際需求增加路由與 DNS 規則;如此每次變更都能對應到明確結果。

查看完整教學 →
  1. 01

    匯入訂閱或分享連結

    複製完整訂閱位址,在用戶端的訂閱分組中新增來源並執行更新。若取得的是單條 vmess:// 或 vless:// 連結,應使用「從剪貼簿匯入」之類的入口。匯入完成後,先確認清單中出現節點名稱、協定與位址資訊;若清單為空,優先檢查複製內容是否完整、訂閱是否仍可存取,以及更新過程是否出現錯誤提示。

  2. 02

    選擇節點與代理模式

    從訂閱分組中選擇一個節點,再啟用用戶端提供的系統代理或相應連線模式。初次測試建議使用較簡單的規則集,避免自訂攔截、複雜 DNS 與多級出站同時影響結果。節點可用性與網路環境會變動,延遲數值只能作為參考;真正的判斷依據是目標連線能否建立,以及日誌是否出現握手、解析或路由錯誤。

  3. 03

    驗證連線並逐項加入規則

    建立基本連線後,分別測試常用網頁、直連位址與需要特定出站的目標,確認代理與直連路徑都符合預期。接著再加入私人位址直連、特定網域代理等規則,每次只修改一組設定,並保留可回復的設定。出現異常時依「節點、DNS、路由、系統代理」的順序檢查,比反覆重新安裝用戶端更容易找出原因。

project.v / ecosystem

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

理解生態系分層,比只記住一個用戶端名稱更重要。設定是否可用,取決於圖形化用戶端、核心、協定欄位與訂閱內容能否正確配合。

Project V 協定與代理工具生態系
核心家族

V2Fly

V2Fly 延續 Project V 的社群維護路線,負責解析設定、實作協定,以及處理入站、出站、DNS、路由等底層能力。設定檔中的 inbounds、outbounds、routing 與 dns 等物件屬於核心層概念,不等同於某個圖形化用戶端的介面選項。

核心家族

Xray

Xray 從相近的生態基礎上發展出獨立的維護路線,並擴充了 VLESS、REALITY 等能力。訂閱節點若包含特定擴充欄位,需要由支援這些欄位的核心解析。選擇 Xray 的核心理由應是協定與設定能力相符,而不是將所有用戶端名稱視為同一種實作。

生態系歷史:從核心能力到圖形介面

Project V 最初形成的是協定實作、設定結構與代理能力的集合。隨著桌面與行動裝置的使用需求增加,社群針對不同系統製作了圖形化用戶端。圖形化用戶端負責訂閱管理、節點選擇、系統代理、日誌顯示與設定編輯,核心則負責建立連線、執行路由並處理協定細節。兩者分層後,介面可以依平台習慣演進,底層能力也能沿各自的維護路線持續更新。

因此,「V2Ray 用戶端」通常是一種生態系稱呼,而不是單一安裝程式。v2rayN 面向桌面系統,v2rayNG 與 v2flyNG 面向 Android;它們的介面、核心路線與適用情境並不完全相同。下載前先確認裝置平台,再查看節點協定,可以減少因選錯架構或核心而造成的匯入失敗。

開源授權:程式碼、文件與變更可追蹤

Project V 相關核心與用戶端以開源方式維護,各專案依其聲明的開源授權條款發布程式碼。開源授權規定複製、修改、散布以及保留授權聲明時必須遵守的條件。對一般使用者而言,重要的是功能變更可透過發布紀錄、文件與社群討論持續檢視;對二次開發者而言,則應在散布前閱讀對應專案的授權條款全文。

開源屬性不代表所有用戶端都由同一團隊、以相同節奏發布。v2rayN、v2rayNG、v2flyNG 分別維護自己的介面適配與發布流程,底層核心也有獨立的變更週期。遇到設定差異時,應先確認用戶端名稱、核心家族與協定參數,再閱讀與目前組合相符的說明。

三款用戶端:依平台與核心路線分工

v2rayN 是桌面端的主要圖形化用戶端,支援 Windows、macOS 與 Linux,適合管理多個訂閱、編輯路由、切換系統代理並查看執行日誌。v2rayNG 是 Android 上常用的 Xray 路線用戶端,適合需要 Xray 協定擴充能力的節點。v2flyNG 採用 V2Fly 核心,可作為 V2Fly 路線的行動端選擇。

三者都圍繞相近的節點設定與訂閱使用情境,但不能只憑名稱推斷功能完全一致。部分欄位會受核心支援範圍影響,部分操作則取決於系統權限與圖形介面實作。最穩妥的選型順序是:裝置平台、節點協定、處理器架構、用戶端介面,依序確認。

更新機制:用戶端、核心與訂閱各自變更

更新通常分為三個層次。用戶端更新會改變介面、系統適配與設定管理方式;核心更新會調整協定實作、路由行為與底層相容性;訂閱更新則由訂閱來源回傳新的節點清單。這三類更新彼此獨立,訂閱重新整理失敗不代表必須重新安裝用戶端,用戶端介面更新也不代表節點設定會自動變更。

排查更新問題時,可以先記錄目前設定並查看日誌:訂閱失敗重點檢查位址與網路路徑,協定錯誤重點檢查核心支援,系統代理未生效則檢查用戶端模式與系統設定。將問題歸入正確層次,通常比一次替換全部設定更有效。

quick.checklist

常見問題精選

以下問題涵蓋首次使用時最容易混淆的環節。完整操作路徑與排查順序已整理在教學頁。

v2rayN 匯入訂閱後為什麼沒有節點?

先確認匯入的是完整訂閱位址,而不是遭截斷的文字;接著手動更新對應的訂閱分組,並查看更新提示或日誌。若位址可以存取但清單仍為空,需要確認回傳內容是否為用戶端支援的訂閱格式。不要急著刪除所有設定,保留分組更方便判斷問題來自位址、網路路徑還是解析流程。查看訂閱匯入步驟 →

vmess://、vless:// 連結與訂閱位址有什麼差別?

一條分享連結通常對應一個節點,包含位址、連接埠、識別資訊與傳輸參數;訂閱位址則回傳一份可更新的節點清單。分享連結適合匯入單一節點,訂閱則適合持續管理多個節點。兩者在用戶端中的入口可能不同,也不應將單一節點連結填入訂閱更新欄位後,期待它自動產生遠端清單。查看匯入方式 →

用戶端顯示已連線但網頁無法開啟,應先檢查什麼?

依節點、DNS、路由、系統代理的順序檢查。先更換已確認可用的節點,再查看網域解析是否報錯;接著暫時切換至簡單路由,排除規則誤攔;最後確認系統代理模式確實啟用。每次只變更一項設定,並觀察日誌變化,才能確認故障位於哪一層。查看連線驗證流程 →

v2rayNG 與 v2flyNG 應該如何選擇?

先查看訂閱節點的協定需求。需要 Xray 擴充能力時,選擇採用 Xray 核心的 v2rayNG;設定屬於 V2Fly 支援範圍,且希望沿用 V2Fly 核心路線時,則可選擇 v2flyNG。介面相似不代表底層能力相同,匯入前查看協定、安全參數與傳輸方式更可靠。查看用戶端選擇說明 →