V2Ray白話指南:
下載 v2rayN與設定說明

從挑選開源用戶端開始,分別說明匯入訂閱與路由設定。

圖形化用戶端 v2rayN・v2rayNG・v2flyNG 核心系列 Xray / V2Fly 設定來源 訂閱 / 分享連結
設定 / 原文與白話說明

訂閱、代理與路由,各自負責不同環節

成功匯入設定,不代表瀏覽器已開始使用代理。先確認各設定項目負責的環節,再調整參數,能避免許多重複操作。

訂閱群組設定
別名:日常訂閱
網址:https://example.com/sub?token=xxxx
啟用更新:開啟
白話說明

訂閱是一份可更新的伺服器設定清單,網址通常由服務提供者提供。將完整網址填入訂閱群組並儲存,再執行更新,用戶端才會讀取其中的設定。訂閱和單一伺服器的分享連結不同,也不是登入網頁的網址。更新失敗時,先確認連結是否完整、是否已過期,再檢查取得訂閱時使用的網路路徑。不要反覆刪除現有群組,也不要把含有個人權杖的網址貼到公開截圖。訂閱只負責取得設定,之後仍須另外設定系統代理與路由。

可以把整個流程想成一條管線:訂閱提供設定,用戶端選定伺服器,系統代理或虛擬網路介面接收應用程式的連線,核心再依據路由規則建立連線。任何一個環節未完成,都可能導致最後無法連線。因此,伺服器清單出現內容,只能確認設定已匯入,不能據此判定整條連線路徑都正常。

首次設定時建議保留預設參數,先完成最精簡的連線測試。不要同時修改 DNS、路由、傳輸方式與網路接管模式,否則即使恢復連線,也很難判斷是哪項設定生效。基礎連線穩定後,再依實際應用需求新增規則。不熟悉的欄位可先到術語表查詢;明確的錯誤則可前往說明中心依問題現象排查。

用戶端 / 依作業系統挑選

四種平台的用戶端下載入口

桌面平台可選 v2rayN,Android 則建議先了解 v2rayNG。下載前先確認作業系統與處理器架構,再挑選安裝套件;名稱相似的軟體,安裝套件不能跨平台使用。

Windows

v2rayN 提供桌面版與傳統 WPF 版。桌面版採用跨平台介面,WPF 版則保留熟悉的 Windows 操作配置。初次安裝可先了解桌面版;已習慣既有操作方式的使用者,則可比較兩種介面的選單位置再決定。匯入訂閱的基本流程相同,不必為了更換介面重新申請訂閱。

安裝前請先確認系統架構並閱讀安裝說明。啟動後先更新訂閱,再選擇伺服器並設定系統代理。若關閉用戶端後瀏覽器仍顯示代理連線失敗,先確認系統代理是否已還原,不要直接認定是伺服器的問題。

前往下載

macOS

v2rayN 的 macOS 安裝套件分為 Apple Silicon 與 Intel 晶片版本。可以在系統的「關於本機」查看晶片或處理器資訊,再選擇相符的架構。下載安裝套件不代表系統一定允許應用程式啟動,首次開啟時也可能需要處理系統安全性提示。

系統代理與 TUN 所需的授權不同。先使用一般代理方式確認訂閱與伺服器可正常使用,再依需求授予額外的網路權限。若啟動遭到阻擋,請閱讀具體提示,依照系統設定中的允許流程操作,不要任意關閉整套安全防護。

前往下載

Android

v2rayNG 使用 Xray 核心,是本文優先推薦的 Android 選擇;v2flyNG 使用 V2Fly 核心,則是另一種設定方案。兩者都提供 arm64 與通用安裝套件,較新的主流裝置通常可先查看 arm64 版本;不確定架構時,再參考下載頁的選擇說明。

首次連線時出現系統 VPN 授權提示,是建立本機網路介面的步驟。允許後仍需選擇有效的伺服器設定。若鎖定螢幕後經常中斷,可檢查系統對背景執行與電池用量的限制;不要把手機的省電策略誤認為訂閱失效。

前往下載

Linux

v2rayN 的 Linux 安裝套件依 deb、rpm 格式及處理器架構區分。先確認發行版使用哪種套件管理格式,再確認 x64 或 arm64。不要只因檔案能開啟就繼續安裝,套件格式、架構與桌面環境的相依項目都必須符合。

不同桌面環境讀取系統代理的方式可能不同,終端機程式也未必會沿用桌面代理設定。測試時先選擇一個確定會遵循代理設定的應用程式,再逐步檢查其他程式。若需要 TUN,請繼續參閱平台指南中的權限與網路接管說明。

前往下載
查看所有用戶端 →
快速開始 / 三步預覽

從匯入訂閱到測試連線

用戶端本身不包含可用的遠端服務。開始前須準備有效的訂閱網址或分享連結,並確認適用於所選用戶端與核心。

  1. 步驟 01 / 設定來源

    新增訂閱群組並執行更新

    在 v2rayN 中開啟訂閱群組設定,填入方便辨識的別名與完整訂閱網址,儲存後執行訂閱更新。在 v2rayNG 中,透過訂閱設定新增網址,再返回主畫面更新訂閱。貼上前後請留意空格、換行與內容是否遭截斷,尤其不要將服務提供者的管理頁面網址誤當成訂閱網址。

    更新完成後,確認是否出現預期的伺服器設定。若清單仍是空的,先查看更新結果與記錄;若已有舊設定,請保留作為比對。訂閱權杖相當於存取設定的憑證,整理截圖或尋求協助時應隱藏完整網址,不要只遮住網域卻留下查詢參數。

  2. 步驟 02 / 應用程式入口

    選擇伺服器並設定代理與路由

    桌面端先選擇要使用的伺服器,再將系統代理設為自動設定,並從內建路由預設開始。Android 端選好設定後點選連線,依系統提示允許建立 VPN 介面。選單名稱可能隨介面調整,但「選擇設定」和「讓應用程式連線進入用戶端」始終是兩件事;缺少後者時,瀏覽器可能仍會直接連線。

    一開始不要同時啟用多種網路接管方式。系統代理適合先測試常見瀏覽器;TUN 則適合進一步處理不讀取系統代理設定的應用程式,但也會增加權限、DNS 與路由的排查難度。區域網路裝置無法正常連線時,也應先檢查略過區域網路的設定,而不是盲目更換協定。

  3. 步驟 03 / 逐項測試

    測試實際使用的應用程式並記錄異常

    先開啟一個日常使用、結果容易判斷的網頁,再測試目標應用程式。用戶端內建的連線測試只能反映該測試條件下的結果,不能保證所有網站與應用程式都能正常運作。有些網站可能有自己的存取限制,單一網頁無法開啟,不應直接推斷整份訂閱都無法使用。

    發生異常時,記錄時間、應用程式與錯誤現象,再開啟記錄檢查同一時段的資訊。先確認用戶端仍在執行、本機入口正常,再檢查 DNS、遠端連線與交握。每次修改後重做相同測試,才能比較前後結果。完整步驟與平台差異請參閱教學;首頁僅保留最精簡的操作順序。

查看完整教學 →
生態系 / 用戶端與核心

Project V、V2Fly 與 Xray 的關係

先分清專案、核心與圖形化用戶端,再比較協定支援。這些名稱彼此有歷史淵源,但並非同一套軟體的三種介面主題。

從 Project V 開始認識生態系

V2Ray 是 Project V 生態系中的核心專案,提供可設定的網路代理協定、傳輸與路由能力。使用者平常操作的圖形介面,通常是在這些能力之上提供伺服器管理、訂閱更新與設定入口。搜尋「V2Ray 用戶端」時,真正需要的往往是這類圖形化程式,而不是直接編輯核心設定檔。

分清這幾個層次很實用:介面中的選項可能影響用戶端行為,也可能轉換成核心設定。訂閱管理、視窗配置與系統代理開關主要屬於用戶端層;協定交握、出口連線與規則比對則由相應核心執行。遇到問題時先判斷屬於哪個層次,才能找到適用的文件,也能避免照著另一款用戶端的選單名稱搜尋。

V2Fly 與 Xray 是相關但獨立的發展路線

V2Fly 社群延續 V2Ray 相關開發,Xray 則以相關程式碼為基礎,發展成另一條核心路線。兩者共用部分概念與設定習慣,但功能演進、協定細節和欄位支援並不同步。不能因為兩邊都支援 VLESS,就認為所有相關設定都能直接通用,更不能只憑檔名判斷相容性。

挑選核心時,應優先確認伺服器端的需求:使用哪種協定與傳輸方式、是否需要特定安全機制,以及用戶端能否完整匯入這些欄位。REALITY 等功能須逐項確認支援情況。若訂閱已提供適用用戶端的匯入方式,請優先依照相關設定說明;不確定的參數可先查詢協定與傳輸術語,不要只憑名稱猜測。

三款用戶端皆為開源圖形化工具

v2rayN 適用於桌面平台,提供訂閱管理、伺服器選擇及代理相關設定;v2rayNG 適用於 Android,使用 Xray 核心;v2flyNG 同樣適用於 Android,使用 V2Fly 核心。三者的原始碼皆依各自的開源授權提供,實際使用與再散布條件請以專案授權為準。開源代表程式碼及其授權條件公開,不代表遠端服務的品質有所保證。

用戶端可以免費取得,但訂閱背後的遠端服務是另一回事;服務提供者的帳戶、費用與可用範圍,不會因安裝用戶端而自動取得。也不應將訂閱網址交給無關網站代為解析。本網站提供用戶端下載與設定說明;閱讀教學時,請務必區分「工具如何運作」與「服務由誰提供」,兩者的更新與故障來源並不相同。

介面、核心與規則檔分別更新

用戶端更新通常涉及介面、匯入邏輯與平台相容性;核心更新會影響協定實作和執行行為;GeoIP、GeoSite 資料檔更新則會改變部分路由規則所依賴的資料。更新訂閱只能取得服務提供者提供的設定,無法取代這三類更新。路由異常時反覆更新訂閱,通常不會更新已過期的規則資料。

調整前先保留可還原的設定紀錄,更新後再用原本的應用程式與網址重新測試。若新版介面變更了選單位置,請依功能名稱尋找,不必繼續比對舊截圖的位置。需要了解更多平台差異時,請參閱全平台指南;遇到明確錯誤時,先儲存已去識別化的錯誤原文,再依本機到遠端的順序排查。

接著閱讀 / 資訊與操作說明

介面、權限與路由資料

完成基本連線後,再依實際問題繼續閱讀。以下三篇分別介紹如何尋找選單、處理首次啟動權限及維護分流資料,不必一次修改所有設定。

v2rayN 主介面功能區一覽:伺服器清單、訂閱群組、記錄面板與設定入口

帶你逐區認識 v2rayN 主視窗,說明伺服器清單、訂閱群組、底部記錄、系統代理切換與參數設定各自的用途,新手看完就能找到常用功能。

v2rayN 在 macOS 顯示「無法驗證開發者」:透過隱私權與安全性設定允許開啟及設定網路權限

說明 macOS 首次開啟 v2rayN 遭到阻擋時,如何在「隱私權與安全性」中允許開啟、授予網路與系統代理權限,以及 TUN 模式所需的額外授權。

geoip.dat 與 geosite.dat 更新方式:路由規則資料檔使用詳解

說明 GeoIP、GeoSite 兩種資料檔在分流中的用途,示範如何在 v2rayN 與 v2rayNG 更新規則檔,並解釋 geosite:cn 這類寫法的意思。

查看所有文章 →