Project V 生態系 · 用戶端指南

V2Ray開源網用戶端與分流教學

依作業系統選擇開源用戶端,從匯入訂閱到路由分流,逐步確認流量走向。

01 生態系概覽

圖形用戶端與核心

用戶端負責編輯及管理設定,核心則負責建立連線、處理請求與比對路由。介面能開啟,不代表核心已正常啟動。

  • Project VV2Ray 源自 Project V。入站、路由與出站各有不同設定,這也是查看核心記錄檔時判斷問題所在的依據。
  • V2Fly社群持續維護 V2Ray 核心。使用 v2flyNG 時,請依實際核心查閱協定與規則欄位。
  • Xray由 V2Ray 生態系衍生而來。設定 REALITY 等功能時,請依 Xray 文件核對參數。
  • MPL-2.0V2Fly 的 V2Ray 核心與 Xray-core 採用的開源授權。各用戶端另有自己的授權聲明。

02 設定流程

訂閱、代理模式與路由規則

從設定來源、流量接管到規則比對,逐一確認。發生異常時,先找出問題所在的層級,再調整設定。

先設定例外規則,再決定預設出站

在 v2rayN 的路由設定中,先確認目前使用的規則集,再依比對順序檢查出站。核心通常採用第一條符合的規則,因此區域網路直連和特定網域封鎖,應排在範圍較廣的規則之前。網域條件和位址條件需分別驗證;在同一條規則中同時填入兩種條件,不代表符合其中一種就會生效。修改後重新送出請求,並從記錄檔確認出站方式,不要只看網頁能否開啟來判斷分流是否生效。

出站對應示意圖,預設出站方式依實際設定而定
geoip:private             → direct
geosite:category-ads-all  → block
geosite:cn                → direct

03 安裝套件選擇

依作業系統與架構下載

先選擇作業系統,再確認處理器架構。桌面平台使用 v2rayN;Android 則依需求選擇 v2rayNG 或 v2flyNG。

Windows

v2rayN Desktop / WPF

初次安裝可從 Desktop 版開始;習慣使用 WPF 介面的使用者可選擇經典 WPF 版。兩者主要差異在介面和封裝方式,並非採用不同的代理協定。先在系統資訊中確認系統類型,再依下載頁說明準備執行環境。

解壓縮後請從完整資料夾啟動,不要只將執行檔拖到桌面單獨執行。遷移時先備份舊資料夾中的使用者資料,再測試新程式能否讀取群組與節點。若雙擊後沒有出現介面,優先確認執行階段、資料夾寫入權限及安全軟體記錄,而不是重新匯入訂閱。

前往下載

macOS

v2rayN Apple Silicon / Intel

在「關於這台 Mac」查看晶片或處理器欄位。Apple Silicon 選擇 arm64,Intel 選擇 x64。不要根據產品外觀或購買年份猜測架構,同一系列的電腦可能因世代不同而採用不同晶片。

安裝後先使用一筆已知可用的設定,確認用戶端能啟動核心。若瀏覽器可以連線,但某個程式仍無法連線,請檢查該程式是否使用系統代理。已有獨立代理設定的應用程式,應另外核對本機位址、監聽連接埠及代理類型,避免沿用其他用戶端留下的設定。

前往下載

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 核心。明確需要 V2Fly 核心時,再選擇 v2flyNG。裝置支援 arm64-v8a 時可選擇 arm64 套件;不確定裝置支援哪種架構時,可先查看通用套件,但仍須符合系統需求。

首次啟動代理服務時,請依系統提示允許 VPN 連線權限。如果裝置上還有其他占用 VPN 連線的應用程式,先中止舊連線再測試。若鎖定螢幕後連線中斷,請分別檢查 VPN 狀態、背景限制和網路切換記錄,不要只憑此現象判定遠端節點已失效。

前往下載

Linux

v2rayN deb / rpm

Debian、Ubuntu 系統優先選擇 deb;Fedora 等使用 RPM 套件管理的發行版則選 rpm。套件格式與處理器架構是兩項獨立條件。x86_64 對應 x64,aarch64 對應 arm64;更換套件格式無法解決架構不符的問題。

安裝完成後,分別以桌面應用程式和終端機程式測試。桌面環境的系統代理不一定會影響終端機程式;某些工具會使用自己的代理設定或環境變數。若只有終端機連線失敗,先確認它實際讀取哪些設定;若兩者都失敗,再回到用戶端檢查核心啟動與本機監聽狀態。

前往下載

04 開源生態系

Project V、V2Fly 與 Xray 的關係

判斷設定能否遷移時,應分別確認用戶端、核心與規則庫,而不只是查看節點名稱或匯入結果。

單一請求在核心中的處理順序

inbound → routing → outbound

用戶端產生或載入設定;進入核心的請求則依路由規則選擇出站。

查看核心與路由術語

了解本站文件範圍

  1. Project V:從入站到出站的設定模型

    Project V 是 V2Ray 生態系的起點。日常使用時,最重要的是它的設定模型:入站接收請求,路由決定將流量交給哪個出站,出站再依設定直連、轉送或拒絕。圖形用戶端的節點清單只是設定的一部分,無法證明所有應用程式的請求都會進入核心。例如,瀏覽器和同一台裝置上的命令列工具可以各自設定代理,即使連線到相同位址,實際流量也可能經由不同入口。

    因此,即使桌面介面顯示已選取節點,仍須分別確認兩件事:核心是否成功監聽,以及目標應用程式是否真的將請求送到該監聽入口。若記錄檔中沒有目標請求,應先檢查應用程式的接入方式。此時反覆修改遠端傳輸參數,無法改變尚未到達核心的流量路徑。

  2. V2Fly 與 Xray:設定概念相通,實作各異

    V2Fly 是社群持續維護 V2Ray 核心的專案。Xray 從這條技術脈絡衍生,並以獨立專案發展。兩者在入站、路由、出站等基本概念上相通,但協定、傳輸方式與安全欄位會隨各自的實作持續演進。用戶端能解析分享連結,只代表連結格式可辨識;不代表所選核心支援其中每個參數,更不代表遠端使用了相同的設定組合。

    遷移時先核對協定、傳輸方式與安全層,再決定使用哪個用戶端和核心。以 REALITY 為例,應依 Xray 對應文件檢查安全層設定,不要把分享連結中顯示的協定名稱當成完整設定。若一般設定可以連線,只有特定節點顯示不支援,請保留完整錯誤類型,優先核對該節點的欄位與核心實作。

  3. 三款開源用戶端各自負責什麼

    v2rayN 是桌面版圖形用戶端,可管理訂閱、服務設定、代理模式與路由;實際支援哪些核心,則取決於所選發行套件與設定。v2rayNG 適用於 Android,主要提供 Xray 設定入口;v2flyNG 同樣適用於 Android,但使用 V2Fly 核心。三者都能管理節點,但各自的介面選項、匯入格式和預設路由並不相同。

    初次設定不必同時安裝兩款 Android 用戶端。先依節點需求選擇核心,再匯入一筆設定進行基本測試。若要比較兩款用戶端,請使用相同的測試網路和目標,並確認每次只有受測用戶端的 VPN 服務正在執行。如此才能分辨差異來自用戶端、核心,還是流量接管方式。

  4. 開源授權與社群發行版本

    V2Fly 的 V2Ray 核心和 Xray-core 採用 MPL-2.0。這是檔案層級的開源授權;散布經修改且受該授權涵蓋的程式碼時,應依授權履行相應的原始碼義務。用戶端和核心是不同專案,套件內的其他元件也可能採用各自的授權。查閱或重新散布時,應分別確認專案及發行套件所附的元件授權聲明,不要以某個核心的授權概括整個用戶端。

    社群會分別維護介面、核心實作和規則資料。文件中的設定名稱用於尋找功能,不代表所有介面配置都相同,也不代表更新用戶端時會自動更新訂閱與規則庫。選擇套件時先確認作業系統、架構和核心功能;診斷問題時則以本機設定和實際記錄檔為準。

  5. 訂閱、規則庫與用戶端分開更新

    更新用戶端會變更程式,更新訂閱會變更節點來源,更新規則庫則會變更比對資料。建議分開執行這三項操作。更新前先保留一份可用設定,並記下目前使用的規則集和本機監聽連接埠。更新後先重新測試相同目標,再確認本機服務直連及需要代理的請求是否仍走預期路徑。

    若更新訂閱後只有少數設定失敗,先比對這些設定的傳輸參數;若更新規則庫後只有某類網域的連線路徑異常,請檢查分類是否變更,以及是否已被前面的規則比對。若更新用戶端後所有請求都失敗,先查看核心啟動和監聽錯誤。依變更範圍縮小排查方向,比同時重新安裝、更新訂閱和修改 DNS 更容易找出原因。

05 資訊與排查

最新設定與排查文章

啟動失敗先檢查本機監聽,安裝失敗先確認套件,流量路徑異常再查看路由與規則庫。

V2Ray 本機連接埠遭占用:找出衝突程序並修改監聽連接埠

使用系統內建命令找出占用 10808、10809 連接埠的程序,說明如何在 v2rayN 中修改本機 SOCKS 與 HTTP 監聽連接埠,以及修改後需同步調整哪些設定。

修改連接埠前,先確認占用者是否為正在執行的用戶端。若是舊執行個體,結束它並重新啟動通常更直接。若確實需要同時保留兩個程式,再為它們指定不同連接埠。修改後以相同應用程式重新測試,並確認應用程式沒有繼續使用舊的代理位址。

v2rayN Windows 版安裝與設定完整教學:WPF 版和 Desktop 版如何選擇

從選擇套件、解壓縮、首次執行到匯入訂閱,逐步完成設定,並比較 WPF 版與 Desktop 版的差異,整理缺少執行階段、遭防毒軟體攔截、路徑含中文字等常見問題。

以首次啟動作為判斷依據:介面未出現時先檢查執行環境;介面已出現但沒有節點時,再檢查匯入與訂閱更新。這兩類問題應查看不同的提示。

GeoIP 與 GeoSite 規則庫更新方式及路由規則寫法

介紹 geoip.dat 與 geosite.dat 的用途、在用戶端中更新規則庫的步驟,以及 geosite:cn、geoip:private 等常用寫法如何組合於分流規則中。

驗證規則時,分別準備一個網域請求和一個直接使用位址的請求。若只有其中一種的連線路徑異常,先確認比對對象是否符合規則類型。

下載用戶端