開源客戶端 / 設定指南

V2Ray官方下載站客戶端與設定指南

下載v2rayN 查看教學

透過 訂閱管理整理連線設定，以 路由分流區分流量去向，並依需求選擇系統代理或 TUN 模式。

Project V 生態系Xray / V2Fly中文操作文件
PLATFORMS
DESKTOP
v2rayN
MOBILE
v2rayNGv2flyNG
ROUTING
GeoSiteGeoIP
WORKFLOW
匯入 → 分流 → 驗證

CONFIGURATION / WORKSPACE

訂閱、路由與流量接管

圖形客戶端負責整理設定，核心則負責實際連線。先確認設定來源，再調整流量進入客戶端的方式，最後檢查規則是否命中。以下依日常操作說明重要功能；範例用於解釋欄位關係，並非完整的連線設定。

configuration / notes

先儲存訂閱連結，再更新

訂閱會將多筆伺服器設定集中在同一個網址。開啟訂閱群組設定，填入方便辨識的名稱與連結並儲存，再執行更新訂閱，清單才會載入設定。相較於逐一貼上分享連結，群組更方便統一更新及區分來源，但更新時也可能取代群組內的項目。更新前先保留手動修改的內容，更新後重新確認目前使用的伺服器。訂閱網址可能含有存取憑證，請妥善保管；排查問題時只記錄錯誤類型，勿公開完整網址。

訂閱網址格式示意（示例網域）：
https://example.com/subscription

操作順序：
訂閱群組 → 新增 → 儲存 → 更新訂閱

CLIENT / PLATFORM

依作業系統選擇客戶端

先在系統資訊中確認處理器架構，再前往相應的下載分類。桌面平台以 v2rayN 為主，Android 則依核心需求選擇客戶端。客戶端可管理本機設定，但安裝完成不代表已有可用伺服器；仍需準備有權使用的訂閱或設定。

Windows

v2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面，WPF 版則沿用經典桌面操作方式。選擇安裝套件前，請確認系統類型與執行需求；安裝後將程式及設定檔放在可寫入的位置，避免目錄權限導致設定無法儲存。

首次執行時先匯入訂閱、選取伺服器，再啟用自動設定系統代理。若瀏覽器可以連線，但其他應用程式沒有作用，請檢查應用程式是否讀取系統代理，不要直接認定是訂閱出了問題。若需要更完整地接管流量，再依教學檢查 TUN 所需權限。

前往下載

macOS

v2rayN 依 Apple Silicon 與 Intel 晶片提供不同安裝套件。可在「關於這台 Mac」查看晶片或處理器資訊，選擇相符的架構。安裝後從應用程式資料夾啟動；若系統要求確認開啟來源，請先確認應用程式來源，再透過系統提供的安全性設定完成確認。

系統代理與虛擬網卡接管使用不同的系統機制。初次設定時應先確認一般代理可正常運作，並查看瀏覽器請求與客戶端記錄。遇到網路延伸功能、授權或其他連線工具衝突時，記下目前狀態並逐項排查，不要一次修改多處系統網路設定。

前往下載

Android

建議先了解採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時，可參考 v2flyNG。多數較新的裝置可選擇 arm64 套件；若不確定架構，請查閱裝置資料或通用版說明。只針對目前使用的安裝來源開啟安裝授權，完成安裝後再依需求還原設定。

匯入訂閱後執行更新，選擇設定並啟動連線；首次啟動時須確認系統連線授權。背景連線容易受到省電策略影響，可依裝置設定允許必要的背景執行。切換客戶端前先停止既有連線，避免多個流量接管執行個體互相干擾。

前往下載

Linux

v2rayN 提供 deb 與 rpm 下載入口，並區分 x64、arm64 架構。Debian、Ubuntu 系統通常選擇 deb，Fedora 等發行版通常選擇 rpm；實際仍應以發行版使用的套件管理方式為準。先確認桌面環境可啟動並檢查相依套件，再設定使用者工作階段的自動啟動。

桌面環境對系統代理的支援並不完全一致，部分應用程式需要另外設定代理入口。安裝完成後，應分別確認圖形介面、核心啟動與應用程式請求。TUN 所需權限與網路路由也須另外設定，不能因安裝套件已成功部署，就認定流量接管已生效。

前往下載
查看所有客戶端 →閱讀全平台安裝指南 →

QUICKSTART / THREE STEPS

從匯入訂閱到確認連線

將設定、流量接管與驗證分開處理，才能判斷問題出在哪個環節，也方便修改失敗時還原至上一份可用設定。以下以桌面端 v2rayN 為例；Android 版 v2rayNG 的操作名稱可能不同，但步驟相同。

  1. 01 / IMPORT

    儲存訂閱並載入設定

    進入訂閱群組，新增名稱和完整訂閱網址，儲存後執行更新。網址末尾的查詢參數可能用於存取驗證，請勿自行截除。若從聊天訊息或文件複製，請確認沒有混入空格、換行或中文標點。完成更新後，設定項目才會出現在伺服器清單中。

    清單若是空的，先確認選取的群組，再查看更新記錄。伺服器回傳網頁內容、驗證失敗與解析失敗是不同問題，應分別處理。手動分享的連結應透過相應的匯入入口使用，不要只憑外觀就把它當成訂閱網址填入。

  2. 02 / CONNECT

    選擇伺服器與流量接管方式

    選取要使用的設定並設為目前伺服器，先保留符合當前需求的路由預設。桌面端啟用自動設定系統代理後，使用會讀取系統設定的瀏覽器進行測試。Android 啟動連線時，請確認系統授權，並留意狀態列是否顯示相應的連線圖示。

    系統代理決定應用程式如何將請求交給本機入口；路由則決定核心收到請求後要選擇哪個出站，兩者不能互相取代。先確認一般連線正常，再考慮使用 TUN；若同時修改 DNS、路由與接管方式，發生問題後將難以判斷是哪項設定造成變化。

  3. 03 / VERIFY

    以實際請求確認結果

    開啟目標頁面，搭配記錄確認請求是否進入客戶端、核心是否啟動，以及遠端是否傳回回應。單次連線測試只能證明該測試路徑的結果，不能代表所有應用程式、網域與傳輸方式都可使用。驗證時也保留一個直連情境，確認區域網路服務仍可正常存取。

    連線失敗時，依序檢查設定解析、核心啟動、網域解析與連線建立。記錄錯誤類型和觸發操作；分享記錄前，請移除訂閱網址及個人資訊。準備關閉客戶端時，先清除系統代理，避免應用程式繼續連線至已關閉的本機連接埠。

查看完整教學 →連線問題與設定問答 →

PROJECT V / CORE / CLIENT

開源生態系與客戶端分工

V2Ray、V2Fly、Xray 與圖形客戶端並非同一類元件。了解各自負責的部分，比單純比較軟體名稱更有助於選擇，也能縮小設定問題的排查範圍。

CONCEPT

Project V

模組化代理與路由設計

CORE FAMILY

V2Fly / Xray

設定解析、傳輸與出站處理

GRAPHICAL CLIENT

v2rayN / v2rayNG / v2flyNG

訂閱、介面與系統設定

Project V 與核心家族

Project V 是了解 V2Ray 技術背景的起點，其模組化設計將入站、出站、傳輸與路由等職責分開。V2Fly 社群延續 V2Ray 的開發與維護，Xray 則從相關程式碼基礎發展出另一條核心路線。兩者有共同的技術背景，但功能演進與欄位支援並不完全相同。即使看到相同的協定名稱，仍須核對具體傳輸方式與安全參數，不能據此認定設定可以直接互換。

核心負責實際建立連線，圖形客戶端則負責產生、儲存與整理設定。若啟動失敗，應先查看核心解析記錄；若只有訂閱群組、介面偏好或自動啟動異常，則較可能需要檢查客戶端層。區分這兩個層級，能避免反覆調整介面設定，卻忽略核心實際不支援的協定欄位。

三款開源圖形客戶端

v2rayN 適用於桌面系統，提供伺服器清單、訂閱群組、路由設定與系統代理等管理功能。v2rayNG 適用於 Android，採用 Xray 核心；v2flyNG 也適用於 Android，是採用 V2Fly 核心的替代選擇。三者皆有開源專案背景，但不是同一個程式的不同名稱，設定入口、系統授權與功能範圍都應分別確認。選擇時先依裝置平台篩選，再根據所需協定與核心相容性決定。

開源授權說明程式碼使用、修改與散布的條件，不代表對每種執行環境都保證相容。V2Fly 的 V2Ray 與 Xray-core 採用的開源授權方式有所不同，圖形客戶端及隨附元件也可能各自適用不同授權。一般使用與重新打包散布是不同情境；若涉及再散布，請閱讀相應發行檔中的授權文件，並保留規定的著作權與授權聲明。

請分別確認更新項目

客戶端、核心、規則庫與訂閱是不同的更新項目。更新客戶端可能改變介面與設定產生方式；更新核心會影響協定能力及連線行為；更新 GeoIP 與 GeoSite 會影響分類比對；更新訂閱則會重新載入伺服器項目。完成其中一項更新，不代表其他項目也已同步。遇到規則失效時，應一併確認使用的標籤、規則庫來源與載入位置，而非只重複更新訂閱。

調整前先保留目前可用的設定，並記下變更項目。每次只修改一類設定，變更後以相同的請求情境重新測試；若結果異常，就能更快還原。若問題涉及伺服器參數，也需要向設定提供者確認；客戶端本身不會建立伺服器服務，也不會自動修復已失效的存取憑證。更多平台差異與安裝細節，請參閱全平台安裝與設定指南。

NOTES / CONFIGURATION

客戶端與路由設定文章

依實際操作主題補充說明：先了解主視窗的設定入口，再認識核心分工，最後維護分流所需的規則庫。文章中的設定片段須配合目前客戶端與核心的支援範圍使用；修改後應檢查記錄及實際請求結果。

查看所有文章 →
下載客戶端