客戶端安裝 · 訂閱 · 分流

V2Ray 新手指南

依平台選擇開源客戶端,完成訂閱匯入,再設定路由分流。

  • v2rayN
  • v2rayNG
  • v2flyNG

匯入訂閱
與路由分流

  • 先匯入設定,再接管流量
  • 系統代理與 TUN 分開設定
  • 示意介面,不代表目前執行狀態

客戶端設定可拆解成三個問題:設定從哪裡來、應用程式流量如何進入核心,以及進入後要走哪個出口。訂閱用來解決第一個問題,系統代理或 TUN 負責第二個問題,路由規則與 DNS 則共同影響第三個問題。依照這個順序設定,發生錯誤時就能縮小排查範圍,不必在多個設定頁面間來回切換。

以下透過實際設定項目說明各層的用途。桌面端以 v2rayN 為例,行動端則可在 v2rayNG 或 v2flyNG 中尋找相應功能。不同客戶端的選單位置與名稱可能不同,匯入的節點參數也不等於完整的本機設定;從電腦換到手機後,仍須檢查分應用程式策略、DNS 與路由模式。

v2rayN / 訂閱管理
訂閱群組先新增群組,再填入訂閱網址
群組設定
匯入訂閱訂閱網址與單一節點分享連結須分別處理
更新訂閱
目前伺服器從匯入結果中手動選擇
selected
更新方式首次匯入時優先確認直連是否可用
直連透過代理

訂閱管理用來集中更新節點參數。在訂閱群組中填入可信來源提供的網址,儲存後執行更新,再從結果中選擇目前使用的伺服器。訂閱網址通常包含存取憑證,不宜出現在公開截圖、聊天紀錄或線上轉換工具中。相較於逐一貼上分享連結,透過群組更新更容易讓多台裝置使用相同節點,但通常不會同步本機路由、DNS 與分應用程式設定。更新失敗時,先確認連線是否可達,再檢查網址是否已失效,不要直接刪除所有現有設定。

依步驟完成首次設定 →

四大平台
依作業系統選擇安裝套件

  • 桌面端首選 v2rayN
  • 行動端首選 v2rayNG
  • 請在下載頁確認架構與套件格式

選擇安裝套件時,先確認作業系統,再確認處理器架構,最後才選介面版本或套件格式。同一份訂閱可以在相容的客戶端間使用,但安裝檔不能跨平台互換。更換裝置時,也不要把整個程式資料夾當成通用備份直接覆蓋;節點資料、客戶端偏好與系統整合設定應分開處理。

Windows

首選 v2rayN

提供 v2rayN 桌面版與經典 WPF 版下載入口。桌面版採用新一代跨平台介面,WPF 版則保留傳統桌面操作方式。初次安裝可先從桌面版開始;若已有使用習慣,請依系統需求與現有設定選擇,無須因介面不同而同時執行兩個執行個體。

安裝後先匯入訂閱並選擇目前使用的伺服器,再設定系統代理。若要使用 TUN,請另外確認系統管理員權限、虛擬網卡,以及其他網路工具是否占用相關資源。結束客戶端後若瀏覽器仍無法連線,優先檢查系統代理是否已還原,而非一再重新安裝程式。

macOS

v2rayN

v2rayN 提供 Apple Silicon 與 Intel 兩種安裝版本。請在系統的「關於這台 Mac」查看晶片資訊,再選擇相符的架構。安裝完成後,從應用程式資料夾啟動,並依系統提示完成必要授權;若遇到安全限制,先確認檔案來源與提示內容,不要直接關閉整台電腦的安全機制。

系統代理可能與瀏覽器擴充功能、其他代理應用程式,或目前網路服務中的手動設定互相影響。首次測試時,請只保留一種流量接管方式。若切換無線網路後狀況改變,也應檢查該網路服務的代理設定;不能只看選單列的連線狀態,就認定所有應用程式都已使用代理。

Android

首選 v2rayNG

建議優先選擇使用 Xray 核心的 v2rayNG;需要 v2fly 核心環境時,再考慮 v2flyNG。多數較新的手機適用 arm64 套件;不確定裝置架構時,可查看下載頁的通用版說明。QR Code、分享連結與訂閱網址用途不同,匯入前請先確認來源提供的是哪一種設定。

首次啟動連線時,需確認系統 VPN 授權。分應用程式代理決定哪些應用程式會進入客戶端,路由規則則決定這些流量要走哪個出口。若背景連線中斷,可從電池最佳化與廠商的背景管理功能著手排查;若持續耗電,則應查看實際流量、重新連線與應用程式喚醒情況,單靠關閉通知無法解決問題。

Linux

v2rayN

依照 Linux 發行版的套件管理系統選擇 v2rayN 的 deb 或 rpm 套件,再確認 x64 或 arm64 架構。此處的桌面客戶端需要圖形工作階段,並非背景服務。安裝前請確認桌面環境與執行相依套件;安裝後從應用程式選單啟動,避免混用不同架構或格式的套件。

桌面環境設定的系統代理,不一定會被終端機或所有應用程式讀取。若瀏覽器測試成功,但某個工具仍無法連線,請檢查該工具是否支援代理。啟用 TUN 還涉及虛擬網路介面權限與系統路由;若已使用容器、虛擬機器或其他 VPN,請留意網段及路由優先順序的衝突。

安裝套件只負責安裝客戶端。要實際連線,仍需要有效的節點設定或訂閱,以及符合目前網路環境的流量接管方式。

查看所有客戶端 →

Project V 生態系
客戶端與核心的分工

  • 圖形介面負責管理與系統整合
  • 核心負責協定、解析與路由
  • 分別了解開源授權與節點服務
設定執行流程 / 分工示意client → core → outbound
圖形客戶端v2rayN · v2rayNG · v2flyNG
訂閱與本機設定
核心系列Xray · V2Fly
協定與路由執行
實際出口出口由規則指定,不取決於介面名稱
proxy / direct / block

從 Project V 到核心系列

Project V 是以網路代理功能為核心發展的開源生態系,V2Ray 是其中廣泛使用的專案名稱。隨著生態系發展,V2Fly 延續相關核心的社群維護,Xray 則以共同技術基礎獨立演進。兩者有歷史淵源,也共用部分協定與設定概念,但支援的功能與具體欄位並非始終一致。

搜尋「V2Ray」時,常會同時看到協定、核心、客戶端與訂閱服務;它們並不是同一種產品。客戶端提供操作介面,核心負責執行設定,伺服器端提供連線目標,訂閱則是批次傳送節點參數的方式。釐清這些層次,才能判斷問題應從介面、設定、系統網路還是伺服器端著手。

因此,分享連結能被辨識,不代表所有參數都適用於目前的執行環境。若協定或傳輸方式不相容,應依伺服器端需求確認核心支援情況,而不是只憑「支援 V2Ray」這類籠統說法判斷。

Xray 核心與客戶端選擇

v2rayN 是面向桌面平台的圖形客戶端,負責節點管理、訂閱更新與系統整合等工作,並可依自身支援情況呼叫相應核心。v2rayNG 適用於 Android,使用 Xray 核心;v2flyNG 則是採用 v2fly 核心的 Android 替代選擇。選擇時應先考量平台與設定需求,再考量操作習慣。

核心名稱不代表連線品質排名。實際連線表現也會受到伺服器狀態、傳輸組合、解析路徑與本機網路影響。同一節點在兩個客戶端中的結果不同時,應先比較目前使用的節點、路由模式、DNS 與流量接管範圍,避免把本機設定差異誤認為核心效能差異。

需要比較三款客戶端時,可先閱讀客戶端比較。若現有設定可正常使用,也沒有明確的相容性問題,建議保留可重現的執行環境;有明確目標的移轉,通常比同時更換客戶端、核心與規則集更容易驗證。

開源授權與使用範圍

三款客戶端都是開源軟體,客戶端本身可免費使用。相關專案採用開放原始碼授權,允許的使用、修改與再散布方式,應以各專案及隨附元件的授權條款為準。圖形客戶端與核心是彼此獨立的軟體元件,不能將其中一個專案的授權直接套用到所有元件。

開源說明的是程式碼與授權關係,不代表會替使用者選擇訂閱服務,也不表示網路上的所有出口都值得信任。訂閱網址、節點憑證與備份檔案仍應妥善保存。分享記錄時,請移除可辨識的伺服器位址、使用者識別資訊與存取憑證,只保留排查問題所需的錯誤類型及相關設定。

本網站著重提供下載入口與中文操作說明,不提供節點或代管訂閱。客戶端能否成功連線,取決於有效設定、相容的伺服器端與本機網路環境;完成安裝與確認網路可用,是兩個需要分別驗證的步驟。

客戶端、核心與規則分別更新

介面更新、核心更新、訂閱更新與規則資源更新,處理的內容各不相同。客戶端更新可能調整選單、系統整合與設定產生方式;核心更新會影響協定與執行行為;訂閱更新會替換節點參數;規則資源更新則會影響分類比對。完成其中一項更新,不代表其他部分也已更新。

調整前先備份現有設定,並記下目前使用的節點與路由模式。更新後先重新測試原本可正常使用的情境,再啟用新功能。若出現異常,保留記錄並逐項還原設定,比同時清除訂閱、重新安裝客戶端及修改 DNS 更容易找出原因。

選單位置與預設行為可能隨版本更新而變動,本網站依設定用途與操作順序編排教學。請在下載頁選擇適用的安裝套件;平台準備、權限處理與設定檢查的完整說明,請參閱各平台安裝與設定指南。

首次設定的驗證順序

先確認訂閱更新後確實出現可選節點,再手動指定目前使用的伺服器。接著檢查核心能否啟動,最後才測試目標應用程式。若瀏覽器能連線、其他應用程式卻失敗,重點檢查流量接管範圍;若記錄顯示網域解析失敗,先沿著 DNS 路徑排查;若所有應用程式都無法連線,再確認系統代理是否殘留、TUN 路由與本機網路是否正常。每次只變更一項條件,排查結果才有比較價值。

V2Ray 節點測速可用來輔助篩選,但不能取代實際連線測試。測試使用的位址、協定與逾時條件都會影響結果;單次逾時不代表節點永久失效,單次成功也不代表所有應用程式都能使用。請先在相同條件下比較,再測試實際需要的服務。只有目標客戶端確實要求特定格式時,才考慮使用 V2Ray 訂閱轉換;轉換過程可能遺漏欄位,也可能暴露完整訂閱網址,不宜作為匯入失敗後的預設處理方式。

系統代理不是路由模式,TUN 也不等於「所有流量都走代理」。前者決定流量如何進入客戶端,後者仍須由規則決定出口。設定 V2Ray DNS 時也須配合流量接管方式理解:應用程式內的解析、系統解析與核心解析可能經由不同路徑。先建立最基本的可用設定,再逐步加入規則、嗅探或 FakeDNS,可減少多項功能互相影響而造成的誤判。

從匯入訂閱開始閱讀 v2rayN 設定教學 →

設定專題
與故障排除

  • 最新三篇技術文章
  • 依使用情境拆解設定影響
  • 基礎操作請先看入門教學

完成基本連線後,再處理多裝置同步、網域映射與解析路徑。專題文章會說明各項功能的適用條件與副作用,避免將特定情境的設定直接套用到所有裝置。閱讀前請先確認目前使用的客戶端、核心與流量接管方式,方便將文章中的說明對照實際環境。