用戶端安裝 / 設定檔 / 路由規則

V2Ray 設定教學

從匯入訂閱開始,了解設定檔與路由分流。

  • JSON
  • Xray · V2Fly
  • 原始碼開放

CLIENT SETTINGS / 用戶端設定

V2Ray 使用教學,從設定項目開始

先釐清用戶端介面與代理核心各自負責的部分,再逐項設定。用戶端負責儲存伺服器資訊、更新訂閱並產生執行設定;核心負責接收連線、比對路由並轉送流量。以下五個入口依實際操作順序排列,畫面僅用來說明選單與設定之間的關係,不代表目前裝置的執行狀態。

v2rayN / 訂閱群組設定 · 介面示意
  • 伺服器
  • 訂閱群組
  • 設定
  • 路由設定
群組名稱日常使用
訂閱網址貼上完整連結
更新訂閱先使用直連

更新完成後,請在伺服器清單中選取要使用的設定。

訂閱網址與分享連結

訂閱網址用於批次取得及更新伺服器設定;分享連結通常只包含一筆設定。v2rayN 可在訂閱群組設定中儲存網址,再執行更新;v2rayNG 則可從訂閱群組入口新增。匯入前請確認複製的是完整連結,而不是網頁標題或登入頁面的網址。首次更新建議先使用直連;只有訂閱服務明確要求透過代理連線時,再嘗試使用代理更新。網址可能包含存取憑證,請勿放在公開截圖中。匯入成功後仍須選取要使用的設定;清單中出現項目不代表已建立連線。

查看設定參考 →

首次設定:先建立最精簡的連線路徑

準備好可用的伺服器設定或訂閱網址,匯入後選取一筆設定,再啟用合適的代理入口。先用瀏覽器連線至已知可存取的目標,並查看用戶端記錄是否出現相應連線。這個步驟只用來確認目前設定與目前應用程式是否正常,不必立刻啟用複雜路由、虛擬介面或自訂 DNS。基本連線正常後,再逐項新增其他設定;每次修改都應保留可還原的狀態。

測試結果也要分開解讀。伺服器項目存在,表示用戶端已接受其格式;連接埠測試有回應,表示某一層連線可能可達;實際網頁能夠開啟,才進一步涉及網域解析、傳輸交握與應用程式請求。不同測試測量的對象並不相同。結果不一致時,記錄測試方式與記錄內容,比只比較單一延遲數字更有幫助。

閱讀設定:沿著流量方向檢查欄位

理解 JSON 時,可以依序查看入站、路由與出站。入站說明本機連線從何處進入;路由說明如何選擇處理路徑;出站則說明最後要轉送到哪裡。DNS 負責相關解析,策略項目則用來調整連線管理行為。教學中的連接埠與規則僅為語法範例,實際使用時應以用戶端設定為準,尤其不要假設所有用戶端都使用相同的預設連接埠。

圖形化用戶端可能在啟動時重新產生設定檔,因此直接修改產生的檔案未必能永久保留。請優先使用介面提供的自訂路由或設定入口,並在修改前匯出備份。若要核對欄位型別、陣列結構與標籤對應,請繼續閱讀V2Ray 設定檔參考;不熟悉入站、出站與傳輸等名稱時,可先查閱術語表。

DOWNLOAD / 平台與安裝套件

下載 v2rayN,依裝置選擇

桌面平台可選擇 v2rayN,Android 可先參考 v2rayNG,也可依 V2Fly 設定需求了解 v2flyNG。先確認作業系統、處理器架構與安裝套件格式,再前往下載頁選擇適用檔案。用戶端與訂閱是兩回事:安裝用戶端不會自動取得伺服器設定;匯入訂閱也不能取代系統所需的安裝與授權步驟。

Windows

v2rayN / Desktop · WPF

下載頁提供桌面版與經典 WPF 版入口。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。請依系統環境與使用習慣選擇,不必讓兩個用戶端同時使用同一組設定。安裝前請先關閉舊版程式,避免本機監聽連接埠被占用。

首次啟動後,先匯入設定並確認本機服務已啟動,再設定系統代理。如果瀏覽器仍使用自己的代理擴充功能或手動設定,請另外檢查其連線入口。變更監聽連接埠後,也要同步修改依賴該連接埠的應用程式設定。

前往下載 Windows 用戶端

macOS

v2rayN / Apple Silicon · Intel

先在系統的「關於這台 Mac」中確認晶片類型,再選擇 Apple Silicon 或 Intel 安裝套件。架構選擇與伺服器協定無關,不能根據訂閱名稱判斷。依照安裝提示完成應用程式安裝,首次執行時請留意系統顯示的權限與安全性提示。

系統代理與 TUN 模式的授權範圍不同,建議先用一般代理確認連線。如果只有特定應用程式無法存取,請先確認該應用程式是否遵循系統代理,不要直接擴大為全裝置流量接管。下載頁整理了各種架構的下載入口,以及安裝前需要確認的事項。

前往下載 macOS 用戶端

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 核心;v2flyNG 使用 V2Fly 核心,可依設定需求作為替代選擇。多數較新的裝置可先查看 arm64 安裝套件;若不確定架構,再了解通用套件。能否安裝仍取決於系統與應用程式需求,不宜只依裝置購買年份判斷。

匯入後選取設定並啟動連線;首次啟動通常需要確認系統的網路連線要求。背景省電限制可能影響持續執行,若裝置鎖定後連線中斷,請檢查應用程式的背景執行權限。訂閱網址與 QR Code 都可能包含存取憑證,分享操作截圖前請遮蔽相關內容。

前往下載 Android 用戶端

Linux

v2rayN / deb · rpm

依發行版的套件管理系統選擇 deb 或 rpm,再確認裝置使用 x64 或 arm64 架構。套件格式與處理器架構是兩項獨立條件,下載檔案不代表能在目前環境中安裝。桌面環境與相關執行相依項目也必須符合用戶端需求。

不同桌面環境支援系統代理的方式可能不同,終端機程式也未必會讀取桌面代理設定。測試時應分別確認瀏覽器與命令列連線使用的代理入口。先確保圖形化用戶端與本機監聽正常,再考慮虛擬介面權限和系統路由設定。

前往下載 Linux 用戶端

若裝置已安裝用戶端,更新前請先儲存訂閱群組、自訂規則與必要的應用程式設定。未確認設定相容性前,不要覆寫唯一可用的環境。安裝套件處理的是程式部署問題;連線問題仍應依序檢查設定、代理入口、路由與記錄。

查看所有用戶端 →

PROJECT V / 核心與圖形化用戶端

V2Ray 開源生態系,釐清專案與用戶端

V2Ray 既是常見的搜尋關鍵字,也與 Project V 生態系中的特定軟體及設定架構相關。日常操作主要在圖形化用戶端中進行,實際轉送流量則由所使用的核心負責。了解兩者的關係,才能判斷教學、JSON 設定與目前安裝的用戶端是否適用。

生態系背景

Project V

核心家族

V2Fly / Xray

圖形化用戶端

v2rayN / v2rayNG / v2flyNG

Project V 與設定結構

Project V 以模組化網路代理功能為基礎,V2Ray 設定涵蓋入站、出站、路由、DNS 與連線策略等部分。模組化表示同一種本機入口可以搭配不同出站,也表示單一協定名稱不足以描述完整連線。閱讀設定時,必須同時查看驗證資訊、傳輸方式與安全層,而不只是確認某個名稱是否相同。

V2Fly 社群延續 V2Ray 相關實作與維護;Xray 則以相關技術為基礎,發展成獨立演進的核心專案。兩者共用部分概念與設定慣例,但功能、欄位與更新時程並不完全相同。在另一個核心中使用原本可運作的設定時,仍須確認支援狀況,尤其要留意特定傳輸方式與安全機制的欄位。

圖形化用戶端與開源特性

v2rayN、v2rayNG 與 v2flyNG 都是開源圖形化用戶端專案。開源讓實作方式、修改紀錄與授權條款得以公開討論,但不代表任何第三方設定都適合直接匯入。用戶端主要提供設定管理、呼叫核心與顯示記錄等便利功能;伺服器參數是否有效、訂閱內容是否可信,仍須依來源判斷。

桌面版 v2rayN 方便集中管理訂閱、系統代理與路由。Android 版 v2rayNG 與 v2flyNG 則依行動作業系統的連線授權及背景執行需求設計介面。三者並非同一程式的不同名稱,選單與設定也不一定完全相同。選擇時先考量裝置與設定需求,再閱讀相應的用戶端教學,避免直接把桌面選單套用到行動裝置。

開源授權與元件範圍

開源授權規定程式碼使用、修改與散布的條件,並不等同於訂閱服務的使用條款。核心、圖形化用戶端與隨附相依元件可能採用不同授權,應以各專案隨附說明為準。V2Ray 相關核心實作採用的 MIT 授權,以及 Xray-core 採用的 MPL 2.0,分別說明各自程式碼的授權規則,不能據此推斷所有元件都使用相同授權。

網站名稱不等同於專案身分。本頁是用戶端與設定的中文閱讀入口,介紹 Project V、V2Fly 與 Xray 的技術關係,不會將教學網站與核心專案混為一談。判斷某項功能是否存在,應以已安裝用戶端的介面、隨附說明與實際執行記錄為準,而非只看搜尋結果中的產品簡稱。

更新機制與問題排查

用戶端更新、核心更新、訂閱更新與路由資源更新,分別處理不同問題。更新用戶端可能變更介面或設定產生邏輯;更新訂閱會重新取得伺服器項目;更新路由資源則會影響網域或位址集合的比對。更新訂閱通常不會替換用戶端程式,安裝新版用戶端也不代表訂閱中的伺服器參數會自動修復。

發生問題時,先記下最近的變更,再檢查記錄。設定解析失敗,優先檢查欄位、格式與核心相容性;本機連接埠遭占用,優先檢查是否有重複執行的程式;交握失敗則核對時間、目標位址與安全層參數。公開記錄前,請移除訂閱網址、使用者識別資訊與驗證內容。分層排查比同時重新安裝、切換核心與重寫路由更能保留線索。

READING NOTES / 設定專題

V2Ray 技術文章,依問題閱讀

建立基本連線後,再依實際問題補充相關知識。匯入失敗可先閱讀格式說明;選擇設定可參考協定比較;連線異常則從執行記錄著手。各篇專題分別處理一項問題,方便與設定參考中的欄位說明交叉查閱。

下載用戶端