v2rayN · v2rayNG · v2flyNG 用戶端

V2Ray幫助中心用戶端下載與設定

依平台選擇用戶端,按照中文設定教學完成訂閱匯入,再檢查路由與連線狀態。

用戶端選擇與平台下載

先確認作業系統與處理器架構,再選擇安裝套件。用戶端負責讀取設定;所需的訂閱或伺服器連線參數則須另外準備。

Windows

選擇 v2rayN。桌面版採用跨平台介面,經典 WPF 版則保留熟悉的桌面操作方式。初次使用可先依下載頁說明安裝桌面版;已有設定的使用者應先匯出備份,再決定是否更換介面版本。

前往下載 →

macOS

選擇 v2rayN,並在「關於這台 Mac」查看晶片資訊,區分 Apple Silicon 與 Intel 安裝套件。初次開啟若出現系統安全性提示,請先確認 App 來源,再依「隱私權與安全性」中的說明允許開啟並設定網路權限。

前往下載 →

Android

建議先查看採用 Xray 核心的 v2rayNG;使用 V2Fly 設定時,也可了解 v2flyNG。主流裝置通常選擇 arm64;不確定架構時,請查看通用版說明。初次連線時,需同意系統的 VPN 連線要求。

前往下載 →

Linux

選擇 v2rayN,依發行版的套件管理方式選用 deb 或 rpm,再確認裝置使用 x64 或 arm64。桌面環境的系統代理設定與應用程式行為可能不同;安裝後應分別驗證瀏覽器與目標應用程式的實際連線狀況。

前往下載 →

常用設定與設定方式

分別檢查訂閱、路由與 DNS。每次只調整一類設定,並保留可還原的原始設定。

先新增群組,再更新訂閱

訂閱網址用來取得伺服器設定,不是直接填入伺服器位址欄的內容。在 v2rayN 的「訂閱群組」中新增來源,填入方便辨識的備註並儲存,再執行「更新訂閱」。清單空白時,先切回「全部」確認篩選條件,再查看更新記錄。不同來源分別建立群組,日後更新、停用與刪除時會更容易辨識。相較於逐筆手動輸入,訂閱可集中更新參數,但有效期限與內容仍由提供者決定;訂閱網址應妥善保管,如同帳號憑證。

了解設定方式 →

介面示意圖用於說明設定之間的關係,實際選單位置可能因用戶端版本而異。路由片段須合併至完整設定中使用;開始修改前,請先確認目前使用的核心與設定格式。

從匯入訂閱到驗證連線

先用最少設定建立可用連線,再逐步啟用分流與流量接管功能。遇到問題時,回到上一步確認結果。

  1. 準備並匯入設定

    安裝用戶端後,先確認手邊的是訂閱網址、分享連結,還是完整設定檔。訂閱網址應儲存在訂閱群組中;分享連結則透過用戶端的剪貼簿匯入功能處理。不要把網頁說明網址誤當成訂閱網址,也不要在公開截圖中顯示完整連結。

    在 v2rayN 中儲存群組後執行「更新訂閱」,確認伺服器清單已顯示內容。Android 裝置可透過 v2rayNG 的新增或匯入選單讀取現有設定。匯入失敗時,先查看記錄中的要求錯誤,分辨連結失效、回應格式不符或網路要求失敗,再決定如何處理。

  2. 選擇伺服器與代理方式

    從匯入清單中選擇一個項目,並在 v2rayN 中執行「設為作用中伺服器」。桌面版若需要讓瀏覽器使用系統代理,請選擇「自動設定系統代理」;Android 裝置啟動連線後,依系統提示同意 VPN 連線要求。先使用用戶端現有的基本路由,不要急著疊加自訂規則。

    系統代理並不是所有應用程式都會遵循的通用開關。瀏覽器能連線、某個應用程式卻無法連線時,應先檢查該應用程式自己的代理設定。只有確實需要接管這類流量時,才查看 TUN 設定章節,避免把權限問題和伺服器問題混在一起處理。

  3. 測試連線並保留基準設定

    執行「測試實際連線延遲」後,還要開啟實際使用的網站或應用程式進行驗證。清單中的測試結果只反映指定測試目標的連線狀況,不代表所有網域、傳輸協定與應用程式都能使用。測試時盡量使用相同目標,並記錄代理模式與路由設定。

    連線正常後再備份設定,接著逐項加入路由例外、DNS 或 TUN 設定。每次變更後都重新測試;出現異常時,還原至剛才可用的狀態。排查記錄可保留錯誤類型與發生時間,但應移除訂閱網址、使用者識別資訊及其他存取憑證。

Project V · V2Fly · Xray

開源生態與
用戶端的角色

先區分介面、核心與服務設定,再了解為什麼同一份訂閱在不同環境中的表現可能不同。

原始碼開放圖形化管理社群維護

Project V 與核心系列

Project V 是以網路代理技術為核心的開源專案生態系,V2Ray 是其中的重要組成部分。V2Fly 社群延續相關核心的維護;Xray 則是以相關技術為基礎發展出的另一條核心路線。它們共用部分協定概念與設定慣例,但功能發展、擴充欄位與支援範圍並不完全相同。因此,看到「V2Ray 設定」時,還需要確認實際使用的核心,不能只憑檔名判斷是否相容。

協定名稱只是連線條件的一部分。同一份 VLESS 或 VMess 設定,也可能搭配不同的傳輸方式、安全層與路由設定。使用 REALITY 等特定功能時,應確認核心支援情況及伺服器端要求;不要靠猜測補齊參數。若記錄明確指出欄位無法辨識,應優先檢查相容性與設定來源,不要先把所有網路設定還原為預設值。

三款用戶端各自負責什麼

v2rayN 為桌面環境提供伺服器清單、訂閱群組、路由與系統代理等圖形化管理功能,適合需要整理多個訂閱來源設定的使用者。用戶端會將介面選項轉換為核心執行所需的設定,實際連線仍由選用的核心負責。介面能儲存設定,不代表伺服器一定接受這些參數;必須搭配啟動記錄與實際連線結果確認。

v2rayNG 專為 Android 裝置設計,採用 Xray 核心路線,透過系統 VPN 介面處理代理連線,並提供訂閱管理與個別應用程式等設定。v2flyNG 同樣適用於 Android 裝置,採用 V2Fly 核心,可在設定需求相符時作為替代選項。選擇時先看訂閱要求與功能需求,再考量介面使用習慣;不要因名稱相近,就認定兩者的擴充參數、設定匯出格式與行為完全相同。

開源授權與使用範圍

這三款用戶端都有公開原始碼,用戶端與整合的核心各自遵循不同的開源授權。授權說明程式碼的使用、修改與散布條件,不代表外部訂閱內容或網路服務品質獲得保證。閱讀相關資訊時,應分別看待用戶端專案、核心專案與訂閱提供者;即使介面相同,也可能連線至完全不同的服務環境。

日常使用時,訂閱連結、分享連結與匯出的設定檔可能包含帳號識別資訊、存取權杖或金鑰資料。需要求助時,提供錯誤訊息、操作步驟與模式名稱通常就已足夠,不宜直接公開完整設定。本網站文件著重於用戶端設定與技術概念;服務有效期限、伺服器權限與訂閱內容,請向相應的提供者確認。

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

更新用戶端主要影響管理介面與整合功能;更新核心可能改變協定支援與執行行為;更新 GeoIP、GeoSite 資料庫則會影響分類規則的比對範圍。這三件事不應混在同一次操作中。若只有個別網域的分流不如預期,可先檢查規則順序與資料庫;若核心無法啟動,再核對設定欄位與核心支援能力。

更新前先匯出可用設定,並記錄目前的代理方式與路由預設值。更新後先驗證基本連線,再檢查自訂出口、DNS 與 TUN,不要同時加入多項新設定。更新訂閱也可能改變伺服器清單,重要的手動修改應另外記錄,避免下次更新覆蓋後難以還原。建立明確的檢查順序,比一味追求更新頻率更能維持設定清晰、易於理解。

設定問題的主題說明

依照實際症狀閱讀:先釐清後台執行、DNS 解析或協定差異,再查看對應設定。以下是最近發布的三篇文章。