v2rayN / v2rayNG / v2flyNG 用戶端

V2Ray之家用戶端下載與設定

依裝置選擇開源用戶端,從匯入訂閱到確認路由分流,逐步完成設定。

節點管理DNS 設定
01 閱讀路徑

用戶端、訂閱與分流

先釐清三者的角色:用戶端是操作介面,核心負責處理連線,訂閱則是更新節點清單的方式之一。下載用戶端只是第一步,不會自動取得可用節點。

首次安裝

前往下載頁確認作業系統、處理器架構與安裝套件類型。更換裝置時,也要依新裝置重新挑選套件,不要直接沿用舊裝置的安裝檔。

已有訂閱網址

訂閱是會持續更新的節點來源。匯入後還要更新清單並選取節點;若取得的是單一分享連結,請使用單節點匯入,不必建立訂閱群組。

連線異常

先確認是清單未更新、核心啟動失敗,還是只有特定應用程式無法開啟。記下問題發生的步驟,再查閱相應說明,比重新安裝更容易找出原因。

02 核心設定

路由、訂閱與 DNS

分開處理不同問題:路由決定連線走哪條路徑,訂閱決定節點來源,DNS 則負責解析網域名稱。

讓特定連線走指定路徑

出口是核心處理連線的出口,可以直連,也可以交由代理處理。相較於把所有接管的連線都送往同一個出口,路由分流可以依網域或位址比對:例如讓本地服務直連,將需要代理的連線交給選定的節點。先套用預設設定建立基準,再新增確實需要的規則。儲存後,分別開啟一個應直連和一個應走代理的目標,對照記錄確認實際命中的規則。若連線路徑不符,先檢查具體規則是否排在較廣泛的規則之後。

設定項目:出口標籤

{ "protocol": "freedom", "tag": "direct" }

這是直連出口的設定片段;路由規則會透過 outboundTag 引用同名標籤。

03 安裝套件

依平台下載用戶端

先確認作業系統,再確認處理器架構。套件名稱中的 x64 和 arm64 代表不同的硬體架構,不表示功能多寡,也不能只憑版本新舊互換使用。

Windows

選擇 v2rayN。桌面版採用跨平台介面,經典 WPF 版則保留原有介面。首次安裝前,請先在系統的「關於」頁面確認系統類型,再核對下載頁的需求。

若要從舊環境遷移,先記下目前的訂閱群組、路由模式與系統代理狀態。不要讓兩個用戶端同時管理系統代理,否則很難判斷是哪一個寫入了設定。

前往下載

macOS

在「關於這台 Mac」查看晶片或處理器。Apple 晶片選擇 arm64 套件,Intel 處理器選擇 x64 套件,兩者都是 v2rayN 的桌面版本。

首次啟用代理前,先確認用戶端與核心都能正常啟動。若系統提示權限或相容性問題,請依提示內容核對安裝需求,不要把啟動失敗和節點無法連線混在一起排查。

前往下載

Android

優先考慮採用 Xray 核心的 v2rayNG;若需要 V2Fly 生態系的設定,再比較 v2flyNG。裝置確認支援 arm64 時,可選擇相應套件;不確定時,先確認通用套件的需求。

兩款用戶端的安裝套件不能互相覆蓋更新。切換前先記下節點來源和應用程式分流範圍,切換後重新測試常用應用程式,不要假設舊用戶端的設定會自動沿用。

前往下載

Linux

先依發行版選擇套件格式,再依機器架構選擇 v2rayN。Debian 和 Ubuntu 系的發行版通常使用 deb,Fedora 等發行版通常使用 rpm。

圖形介面用戶端和在閘道器上單獨執行核心,適用情境不同。安裝桌面版後,先用會讀取代理設定的應用程式測試;終端程式和背景服務不一定會沿用桌面環境的設定。

前往下載

查看所有用戶端 →

04 快速入門

從匯入訂閱到測試連線

首次設定只需建立一條可驗證的連線路徑。使用同一個測試目標逐步確認,基本連線正常後,再新增應用程式分流或自訂 DNS。

  1. 匯入並更新清單

    開啟用戶端的訂閱管理,將網址新增至新群組,儲存後更新該群組。更新前先記下群組名稱,更新後切回該群組確認結果。若清單空白,先確認目前選取的群組,再檢查貼上時是否帶入空格或換行,以及訂閱是否仍有效。

    若服務提供者只提供單一節點連結,請使用分享連結匯入;把單節點連結當成訂閱更新,通常無法取得預期清單。訂閱網址可能包含存取憑證,求助時可以描述錯誤訊息,但不要直接貼出完整網址。

  2. 選取節點並啟用接管

    從已匯入的清單選擇資料完整的節點,並設為目前節點。桌面端可以先從系統代理開始,使用遵循系統代理設定的應用程式測試;行動裝置則依用戶端提示建立系統 VPN 連線。核心啟動和代理接管是兩回事:核心成功啟動,不代表測試中的應用程式一定正在使用它。

    先保留預設路由,不要同時啟用多種接管方式。若裝置原本已執行其他代理,或有組織派發的網路設定,先確認哪些設定可以修改,並記錄原本狀態。

  3. 測試連線並確認退出狀態

    先開啟一個平常可直連的目標,再測試一個依規則應走代理的目標。若有記錄,將測試時間與目標對照,確認連線是否到達核心,以及是否命中預期的出口。節點速度測試只能作為比較參考,不能取代應用程式中的實際請求。

    完成後停止用戶端並重新檢查網路狀態。若退出後瀏覽器反而無法開啟網頁,先確認系統代理是否仍指向已停止的本機連接埠,再決定是否調整節點或 DNS。

查看完整教學 →

05 開源生態系

Project V、V2Fly 與 Xray

將用戶端、核心和服務來源分開看,才能判斷教學中的選單、設定欄位或更新說明是否適用於目前的裝置。

連線的處理流程
  1. 應用程式發起連線
  2. 用戶端設定核心
  3. 核心依規則選擇出口

查看核心與生態系術語 →

  1. Project V:從專案名稱認識核心

    Project V 提供一系列建構網路代理的工具,V2Ray 則是其中負責處理連線的核心。設定中的「入站」描述核心從哪裡接收連線,「出站」描述核心如何處理收到的連線,路由則負責在兩者之間做選擇。圖形介面用戶端會將這些設定整理成節點清單、代理開關和路由頁面,省去逐段編輯設定檔的作業。

    看到「V2Ray 設定」時,先確認它指的是完整核心設定、某個欄位,還是供用戶端匯入的連結。三者用途不同。例如,教學若只列出一段出站設定,還需要搭配本機既有的入站與路由;若將片段當成整份檔案覆寫,原本的監聽連接埠和規則也會一併遺失。

  2. V2Fly 與 Xray:源自同一脈絡,各自發展

    V2Fly 延續 V2Ray 核心的社群維護;Xray 則從相關程式碼分支發展為獨立核心。兩者共用許多設定概念,但支援的通訊協定功能、傳輸選項與欄位並不完全相同。即使兩邊顯示相同的通訊協定名稱,也要一併確認傳輸方式、安全設定和伺服器參數,不能只憑名稱判斷是否可用。

    例如,兩個使用 VMess 的節點可能採用不同傳輸方式。成功匯入只代表用戶端能讀取連結,後續連線仍取決於所選核心是否支援相關欄位,以及連線兩端的設定是否一致。若遇到可以匯入但無法連線,先檢查目前使用的核心與節點設定,再考慮是否更換用戶端。

  3. 三款用戶端:介面與預設核心各有分工

    v2rayN、v2rayNG 和 v2flyNG 都是開源圖形介面用戶端。v2rayN 適用於桌面,可依用戶端支援情況為不同節點選擇核心類型;v2rayNG 是採用 Xray 核心的行動裝置用戶端;v2flyNG 則對應 V2Fly 核心,設定明確以該核心為目標時可考慮使用。用戶端提供操作介面,核心負責處理連線,兩者的設定不應混為一談。

    選擇時先確認裝置與現有設定:需要在桌面管理群組,可先從 v2rayN 開始;在行動裝置上,則依節點需求比較兩款用戶端。遷移時,通常以原有訂閱在新用戶端重新產生節點清單,再逐項重建自訂規則最省事,不要直接複製另一款用戶端的完整設定檔。

  4. 開源授權:程式碼、訂閱與服務各不相同

    開源授權規定程式碼如何檢視、修改和再散布,但不會提供遠端節點,也不會規範第三方服務的流量額度、使用時段或可用性。用戶端的授權說明與服務提供者的使用條款應分開閱讀。遇到訂閱失效,請檢查網址和服務狀態;遇到介面無法啟動,則先確認用戶端的執行需求。

    網頁截圖、設定匯出檔和記錄可能洩漏訂閱網址、節點位址或個人瀏覽紀錄。整理問題描述時,提供用戶端名稱、錯誤類型、觸發步驟和必要的去識別化欄位即可。若問題可重現,記下使用的網路環境和測試目標,比貼上整張設定畫面更有幫助。

  5. 更新管理:分開記錄用戶端、核心與訂閱

    社群維護的用戶端、配套核心和訂閱清單,各有不同的更新週期。用戶端更新可能調整選單和匯入方式,核心更新可能影響通訊協定相容性,訂閱更新則可能替換節點或變更名稱。如果三者同時變動,發生問題時就很難判斷該還原哪一項。

    更新前可在本機記錄目前使用的用戶端、核心類型、節點和系統代理模式,並依用戶端支援的方式備份必要設定。更新後,使用先前確認過的測試目標重新測試,檢查直連、代理和退出後的狀態。若只有一組節點異常,先檢查該組訂閱;若所有應用程式都無法連線,再確認核心啟動與系統接管狀態。

06 技術筆記

訂閱管理與部署筆記

基本連線正常後,可依需求繼續閱讀:節點清單太長時先整理訂閱,準備擴大接管範圍時再了解路由器部署。

查看所有文章 →