開源客戶端 · 中文設定指南

V2Ray官網客戶端下載與設定

桌面裝置使用 v2rayN,Android 裝置使用 v2rayNG。依照步驟完成訂閱、路由與 DNS 設定,再確認應用程式是否透過代理連線。

  • Xray 核心
  • V2Fly 核心
  • VLESS · VMess · Trojan

依裝置選擇客戶端

PROJECT V / V2FLY / XRAY

V2Ray 生態系與核心家族

先分清核心與客戶端。核心負責處理協定、連線和路由;圖形客戶端則用來管理訂閱、設定與程序。客戶端名稱相近,不代表核心功能和設定欄位完全相同。

Project V

Project V 是了解 V2Ray 技術背景的起點。V2Ray 將入站、出站、路由與傳輸拆分為可組合的設定模組。本機監聽入口可接收應用程式的請求,再依規則交由不同出站處理。這種模組化架構也說明了,為什麼客戶端介面需要分別設定系統代理、伺服器和路由,而不是只提供單一連線開關。

查看專案介紹 →

V2Fly

V2Fly 是持續維護 V2Ray 的社群專案,其核心實作延續模組化設定的設計理念。v2flyNG 將這個核心家族作為 Android 客戶端的另一種選擇。若現有設定仰賴特定功能,請先確認協定、傳輸方式和欄位是否受支援,再決定使用哪款客戶端;訂閱能夠匯入,不代表目前使用的核心能執行其中所有項目。

了解核心與客戶端的差異 →

Xray

Xray 源自 V2Ray 技術體系,在協定與傳輸的實作上有自己的維護方向。v2rayNG 使用 Xray 核心,v2rayN 也常用來管理 Xray 設定。VLESS、Trojan 和 REALITY 等名稱屬於不同層級的設定概念,不能互相替代;組合能否使用,須確認伺服器端需求、客戶端欄位與核心功能彼此相符。

查看進階設定 →

三款開源客戶端的定位

v2rayN 適用於桌面裝置,將伺服器清單、訂閱分組、系統代理與路由整合在同一個管理介面。v2rayNG 適用於 Android 裝置,透過系統 VPN 介面接管應用程式流量,也提供依應用程式代理等設定。v2flyNG 同樣適用於 Android,適合需要 V2Fly 核心的設定。這三款產品皆有開源專案背景,客戶端本身可免費使用;伺服器位址與訂閱內容仍須自行準備,下載安裝不會自動產生可連線的服務。

開源授權與更新範圍

開源授權規範程式碼的使用、修改與散布條件,不同元件應分別查看各自的授權說明。圖形介面、代理核心和路由資源可能各自更新,因此更新客戶端、更新訂閱與更新規則資料是三件不同的事。升級前請備份訂閱分組、自訂路由和 DNS 設定;升級後先用原有設定測試,再逐項啟用新功能。遇到錯誤時,記下錯誤位置與相關設定,通常比反覆重新安裝更容易找出問題。

本網站依客戶端選擇、安裝與設定等任務編寫中文指南。專案名稱用於說明技術關係;本站品牌不代表 Project V、V2Fly 或 Xray 專案的官方維護者。介面示意用來呈現設定結構,實際選單名稱請以已安裝的客戶端為準。

四大平台客戶端下載入口

先確認裝置系統與處理器架構,再選擇安裝套件。桌面裝置可優先查看 v2rayN,Android 裝置可優先查看 v2rayNG;需要 V2Fly 核心時,再考慮 v2flyNG。下載頁整理了下載入口、適用條件與安裝前檢查事項。

Windows

使用 v2rayN。桌面版採用跨平台介面,WPF 版則保留傳統桌面介面。先在系統的「關於」頁面確認處理器架構,再依下載頁說明選擇;兩種介面並不代表使用不同的伺服器,切換前請備份設定。

前往下載

macOS

使用 v2rayN。在「關於這台 Mac」中查看晶片名稱,並依 Apple Silicon 或 Intel 選擇相應安裝套件。首次啟動時依照系統提示授予權限,接著檢查網路代理設定,避免其他代理工具覆寫目前的設定值。

前往下載

Android

優先選擇 v2rayNG,v2flyNG 則是核心方面的另一個選項。多數裝置通常選擇 arm64;不確定架構時,請查看通用套件說明。首次連線時須允許系統提出的 VPN 要求;啟用依應用程式代理前,先確認預設連線正常。

前往下載

Linux

使用 v2rayN。Debian 和 Ubuntu 系發行版選擇 deb,Fedora 等發行版選擇 rpm,並確認處理器架構為 x64 或 arm64。圖形桌面的系統代理與終端機環境變數各自生效;安裝完成後,請在實際使用的應用程式中測試。

前往下載

安裝完成後,先匯入現有訂閱或伺服器設定,再選擇可用項目。訂閱是用來更新一組設定的入口,客戶端只負責讀取和管理內容;請妥善保管訂閱網址,勿放入公開截圖或分享給無關人士。需要還原設定時,先判斷要還原的是訂閱內容還是客戶端參數,兩者的處理方式不同。

初次使用建議從系統代理或預設 VPN 模式開始。確認瀏覽器與常用應用程式都能正常連線後,再設定分流、區域網路分享或 TUN。每次只調整一項,並保留可正常運作的基本設定,排除問題時才有明確的比較依據。

查看所有客戶端 →

訂閱、路由與連線設定

依照「設定來源 → 流量目的地 → 應用程式範圍 → 網域解析」的順序檢查。下方設定示意維持展開,方便逐項比對;任務分頁則用來查看各步驟的檢查重點。

先確認設定是否已載入。更新後查看目前的分組與伺服器清單,不要把清單空白誤認為網路連線故障。訂閱更新失敗時,先記下記錄中的錯誤類型,再檢查網址和更新方式。

比對訂閱分組設定 ↓

訂閱分組與伺服器篩選

在「訂閱分組設定」中,為不同來源各自建立分組,填入完整訂閱網址後再更新。分組用於管理來源,不會自動變更伺服器協定或可用狀態。更新後先確認目前選取的分組,再用名稱篩選縮小清單範圍;若清單空白,請檢查篩選條件,避免把「沒有符合項目」誤判為訂閱失效。相較於直接匯入單一分享連結,訂閱可以持續更新設定,但手動修改的項目也可能在更新時遭到覆寫,重要變更請另外備份。

查看訂閱分組與多訂閱管理 →
v2rayN / 訂閱分組設定
分組名稱更新方式啟用 預設分組手動更新是
伺服器篩選依名稱篩選目前分組
更新前確認來源,更新後檢查目前分組。

網域與 IP 路由分流

先選擇符合需求的路由預設,再新增少量自訂規則。網域比對與 IP 比對是不同條件,規則順序也會影響最後結果。示意中的區域網路位址會交由直連出站處理,範例網域則交由代理出站處理;這些文字用於說明比對語法,並非可直接貼上執行的完整設定。相較於只切換全域模式,依目標分流可保留區域網路存取,但須同時了解 DNS 與目標比對之間的關係。每次修改後請儲存,並使用相同目標重新測試。

查看路由規則與出站比對 →
路由比對項目 / 語法示意
網域條件 → proxydomain:example.com
私人網域 → directgeosite:private
區域網路網段 → directip:192.168.0.0/16
分別填寫比對條件與出站標籤;實際欄位請以客戶端的規則編輯器為準。

VPN 模式與依應用程式代理

v2rayNG 首次連線時會要求系統 VPN 權限,允許後才能透過虛擬網路介面接管流量。若只想處理部分應用程式,再進入「依應用程式代理」,確認目前使用的是允許清單還是略過清單;兩種模式下,相同的勾選操作代表不同意思。相較於桌面系統代理,VPN 模式的接管範圍較廣,但實際行為仍須一併考量應用程式清單、路由與系統限制。修改清單後,依客戶端提示重新連線,並檢查背景電池限制,避免把程序遭暫停誤判為伺服器斷線。

查看 Android 連線與驗證步驟 →
v2rayNG / 連線設定示意
VPN 模式
依應用程式代理
允許來自區域網路的連線
啟用流量嗅探
先確認清單模式,再勾選應用程式。此處為靜態設定示意。

DNS 解析與連線疑難排解

若網域無法開啟,但直接連線位址可用,請先檢查 DNS 記錄,不要立刻更換所有伺服器。確認解析請求經由本機網路還是代理通道,再檢查上游解析器是否可連線。加密 DNS 位址本身也可能需要先解析,設定不當會形成啟動依賴。比起只換一個 DNS 位址,依網域分流的解析策略更精細,但須與路由設定一致。FakeDNS 會回傳映射位址,啟用前請閱讀相關設定說明;排除問題時,先恢復簡單且可驗證的解析路徑。

查看 DNS 最佳化與 FakeDNS →
DNS / 基本欄位示意
本機解析器範例223.5.5.5
加密解析器格式範例https://dns.example.com/dns-query
查詢策略UseIPv4
example.com 位址僅供格式示範;實際解析器請自行選擇並確認是否可連線。

設定生效後的驗證順序

先確認核心程序已啟動,再檢查本機監聽連接埠,接著確認系統代理或 VPN 狀態,最後在目標應用程式中送出請求。客戶端顯示「已連線」只能表示連線流程已啟動,不能取代應用程式層級的驗證。若瀏覽器能連線、終端機卻無法連線,請分別檢查瀏覽器擴充功能、終端機代理環境變數與應用程式本身的設定。記錄檔有助於判斷錯誤發生在解析、建立連線或協定交握階段;分享記錄檔前,請移除訂閱網址、個人資訊與伺服器憑證。

若只有某個網站異常,先保留目前的客戶端與伺服器,重新測試其他目標,再查看該目標套用的路由規則。若所有應用程式都同時異常,請先檢查本機網路和核心執行狀態。依影響範圍逐步排查,可避免在訂閱、DNS、路由等頁面反覆修改,最後失去原始線索。基本流程請參閱使用指南,依症狀尋找解決方法可前往說明中心。

技術筆記與設定解析

先閱讀與目前狀況相符的文章,再決定是否需要修改設定。以下三篇依發布日期由新到舊排列,涵蓋應用程式代理範圍、設定檔結構與桌面安裝。若需要虛擬網卡或區域網路分享,可繼續瀏覽文章列表中的相關專題。

查看所有文章 →