v2rayN 使用教學 · 下載與設定

v2rayN 下載 訂閱匯入與代理設定

參照實際設定項完成訂閱匯入,再依用途設定系統代理與分流。

GPL-3.0 客戶端開源授權

三步快速上手

  1. 匯入訂閱
  2. 選擇節點
  3. 啟用系統代理

靜態介面示意圖;實際入口與選項位置可能隨客戶端更新而調整。

代理設定,分清四個入口

路由、系統代理、核心類型與訂閱匯入各自負責不同環節。先確認問題所在層級,再調整對應設定。

路由分流

路由規則會決定送入核心的連線要直連、經代理轉送或阻擋。日常使用可先了解「繞過中國大陸」預設規則,讓符合中國大陸網域或 IP 位址的連線直連,其餘流量則依規則處理;「全域」則會將送入該路由的連線一律交由代理出口處理。這兩種模式都不能取代系統代理,也不代表所有應用程式都已納入代理。切換後請用同一個網站重新測試,避免同時更動 DNS 和節點。自訂規則也要檢查排列順序,前面的規則可能先匹配,導致後續規則不會生效。

預設路由
繞過中國大陸
全域
查看路由設定 →

核心類型

v2rayN 負責圖形介面與設定管理,實際連線則由核心處理。核心類型必須配合節點使用的協定、傳輸方式及相關參數,不能只看名稱決定。客戶端中的 Xray 與 sing-box 是不同實作,設定欄位與支援範圍也不盡相同。請先使用客戶端相容的預設設定;遇到不支援的欄位時,再參照記錄檔查找原因。V2Fly 則屬於另一個核心家族,不要與 sing-box 混為一談。更換核心後,請重新確認節點能否啟動,而非只看介面上是否仍有紀錄。

核心類型 · 切換說明

依照 Xray 支援的協定與記錄檔檢查設定;REALITY 等參數須與伺服器端一致。

查閱核心與協定術語 →

系統代理

桌面端選擇「自動設定系統代理」,會將本機代理入口寫入作業系統的代理設定,供遵循該設定的應用程式使用。「清除系統代理」會移除這項設定;「不變更系統代理」則表示維持目前狀態,不代表停止連線。如果瀏覽器能連線,但某個應用程式仍無法使用,請先確認該程式是否讀取系統代理,或另有設定代理位址。系統代理與 TUN 是不同的流量接管方式;初次設定建議先使用系統代理,確認基本連線正常後再了解其他模式。

系統代理
清除系統代理
自動設定系統代理
不變更系統代理
排查代理未生效 →

行動裝置匯入

在 v2rayNG 右上角的加號選單中,可選擇「從剪貼簿匯入」或「掃描 QR Code」。這兩個入口常用來新增單一節點的分享資訊,請勿將單一分享連結當成可定期更新的訂閱。取得訂閱網址後,應前往「訂閱群組」填寫備註與網址,儲存後再更新訂閱。匯入後還需選擇設定並啟動連線;首次啟動時,請依系統提示授權 VPN。QR Code 與剪貼簿內容可能包含登入憑證,分享截圖前請先遮住網址、識別資訊與金鑰等敏感內容。

v2rayNG +
從剪貼簿匯入
掃描 QR Code
對照兩端的訂閱入口 →

客戶端下載,依作業系統選擇

先確認作業系統與處理器架構,再選擇相符的安裝套件。桌面端使用 v2rayN;Android 則依核心需求選擇 v2rayNG 或 v2flyNG。

Windows

選擇 v2rayN。下載頁面提供桌面版與經典 WPF 版:桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。請依頁面標示的系統與執行環境需求選擇,不要只憑檔名判斷。壓縮套件請完整解壓縮至可寫入的資料夾後再執行,避免直接從壓縮檔啟動。

前往下載 Windows 客戶端

macOS

選擇 v2rayN,並在系統的「關於這台 Mac」中確認晶片型號。Apple Silicon 對應 arm64,Intel 對應 x64。首次開啟時若出現系統安全性提示,請先確認下載來源與安裝步驟,再依系統提供的方式處理;不要為了執行客戶端而直接關閉整體系統安全防護。

前往下載 macOS 客戶端

Android

建議先了解採用 Xray 核心的 v2rayNG;需要 V2Fly 核心時,再選擇 v2flyNG。多數新型裝置可先確認是否採用 arm64 架構;若無法確認,請參閱下載頁面的通用版說明。啟動連線時需要授予系統 VPN 權限;若已有其他 VPN 連線,請先排除連線衝突,再檢查節點與分應用程式代理設定。

前往下載 Android 客戶端

Linux

選擇 v2rayN 的 deb 或 rpm 套件,並確認符合 x64 或 arm64 架構。deb 常用於 Debian、Ubuntu 等發行版,rpm 則常用於 Fedora 等發行版。不同圖形桌面對系統代理的支援方式各異,成功安裝不代表應用程式已透過代理連線;必要時請前往應用程式的網路設定,填入本機代理入口。

前往下載 Linux 客戶端

初次設定,依序完成

安裝客戶端只是第一步,還需要有效的設定、可用的連線出口,以及正確的流量接管方式。以下以桌面端為主,另行說明行動裝置的操作入口。

  1. 匯入並更新訂閱

    在 v2rayN 中開啟「訂閱群組設定」,新增群組並填寫容易辨識的備註,再將完整訂閱網址貼到「網址(url)」欄位。初次設定時,先保留預設更新選項;儲存後,更新該群組的訂閱。訂閱網址通常會提供一組設定,與以 vmess:// 或 vless:// 開頭的單一節點分享連結用途不同,兩者的匯入入口不可任意互換。

    v2rayNG 則透過「訂閱群組」管理訂閱。若更新後仍是空白,請先檢查記錄檔中的下載或解析錯誤,並確認複製時沒有漏掉查詢參數,也沒有將說明網頁誤當成訂閱網址。訂閱內容屬於敏感資訊,排查時只記錄錯誤類型,請勿將完整網址貼到公開頁面。

  2. 選擇節點與路由

    更新完成後,請在目標群組中選擇一筆設定,並設為作用中的伺服器。先確認目前使用的核心能辨識該設定,再選擇適合日常使用的預設路由。新手可先了解「繞過中國大陸」的用途;需要比較路由影響時,再短暫切換至「全域」測試。每次只變更一項設定,並保留可重現的對照條件。

    設定成功匯入,不代表伺服器端一定可連線;客戶端也不會自動提供可用的連線資訊。測試逾時可能與服務狀態、位址、連接埠或目前的網路有關,不能只根據單次測試結果判斷原因。若記錄檔顯示協定參數不受支援,請先核對核心與設定,而非一再更新同一份訂閱。

  3. 啟用代理並測試

    桌面端選擇「自動設定系統代理」,再用會遵循系統代理的瀏覽器開啟目標網站,同時查看客戶端記錄檔。Android 端則選擇設定並啟動連線,允許系統授予 VPN 權限。測試時請區分網頁解析失敗、連線逾時與憑證錯誤,這些狀況的排查方向不同。

    完成後,再測試一個原本能正常開啟的網站,確認路由沒有影響日常連線。結束桌面端客戶端前,可先清除系統代理,避免系統仍指向已停止的本機連接埠。若瀏覽器正常但其他應用程式異常,優先檢查該程式自己的代理設定;若所有連線都異常,再檢查核心啟動記錄與本機連接埠。

開源生態,分清客戶端與核心

名稱相近的專案,負責的工作不一定相同。了解各層的職責,有助於避免在選擇、更新與故障排除時判斷錯誤。

Project V 與核心家族

Project V 是理解 V2Ray 技術生態的背景。V2Ray 核心提供協定處理、傳入與傳出連線,以及路由等基礎功能;V2Fly 延續相關核心的社群維護;Xray 則是從這套技術體系發展出的另一種實作。兩者背景相近,但功能演進與設定方式各有差異。

VMess、VLESS、Trojan 是協定相關名稱;WebSocket、gRPC 等描述傳輸方式;REALITY 則涉及連線安全與交握機制。這些名稱屬於不同層級,不能簡單視為可互換的選項。選擇時應以伺服器端實際提供的組合為準,並確認客戶端使用的核心能夠處理。

三款圖形化客戶端

v2rayN 為桌面使用者提供訂閱管理、設定選擇、系統代理與路由設定介面;v2rayNG 適用於 Android,使用 Xray 核心;v2flyNG 同樣適用於 Android,為需要 V2Fly 核心的使用情境提供另一種選擇。介面操作方式可能相似,實際支援的參數仍取決於所搭載的核心。

這三款客戶端都是開源專案,客戶端專案採用 GPL-3.0 授權。開源授權規範程式碼使用與散布的條件,不代表所有相依元件都採用相同授權。閱讀設定說明時,請同時留意客戶端與核心的名稱,不要將某一款的選單位置直接套用到另一款。

訂閱與連線服務

客戶端負責儲存並執行設定,訂閱用來取得設定,伺服器端則提供實際的連線出口,三者職責不同。本網站提供客戶端選擇與操作說明,不提供訂閱網址,也不負責維護伺服器端。安裝完成後若清單仍是空白,請先準備合法取得的設定,而不是到系統代理中尋找訂閱入口。

更新訂閱會重新取得伺服器端發布的內容,手動修改的節點可能在下次更新時被覆蓋。若要保留測試設定,請先確認客戶端的群組與複製方式。訂閱失效也可能是網址已更換或存取權限有所變動,並非所有問題都能靠重新安裝客戶端解決。

更新與排查順序

客戶端更新、核心更新與訂閱更新是三件不同的事。客戶端更新可能調整介面與設定產生方式;核心更新會影響連線能力;訂閱更新則會變更實際設定。遇到相容性問題時,先記下目前錯誤與操作過程,再判斷需要更新哪個部分,避免同時變更多項設定,導致問題無法重現。

更新前請保留必要的群組與自訂規則,更新後先測試原本可用的設定。若連線失敗,依序檢查「核心能否啟動、伺服器端是否可連線、DNS 是否正常、應用程式是否使用代理」。分享診斷資訊前,請移除訂閱網址、使用者識別資訊、金鑰與個人路徑等敏感內容。

設定文章,依主題查閱

近期三篇文章分別介紹初次安裝、DNS 分流與分享連結。先完成基本連線,再依需求進一步調整設定。