v2rayN · v2rayNG · v2flyNG 文件

V2Ray文件中心用戶端與設定手冊

下載v2rayN 查看教學

從圖形用戶端開始，透過實際 JSON 設定了解入站、出站與路由；查閱繁體中文操作說明。

訂閱匯入路由分流DNS 設定

CONFIGURATION / 設定章節

從介面選項到 JSON 鍵名

先釐清請求從哪裡進入、依據哪些條件比對，以及最後交由哪個出站處理。再調整參數，排查時才能明確界定問題範圍。

v2rayN / v2rayNG / v2flyNG

本機連接埠是應用程式的入口

入站負責接收應用程式送來的請求，並非遠端伺服器位址。桌面應用程式可透過本機 SOCKS 入口連線至核心；若支援，也可讀取系統代理設定。範例僅監聽回送位址，適合在本機使用；連接埠須與用戶端介面及應用程式設定一致。啟用 UDP 只代表此入口允許處理相關請求，能否完成轉送仍取決於應用程式、出站及伺服器。相較於自行維護完整設定，圖形用戶端會自動產生多數入站欄位；手動編輯前，請先確認目前設定是否會被重新產生。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}
查看 inbounds 入站說明 →

CLIENTS / 平台選擇

V2Ray 用戶端下載入口

桌面系統可選擇 v2rayN；Android 建議先了解 v2rayNG，再依核心相容需求考慮 v2flyNG。先確認作業系統與處理器架構，再前往下載頁選擇安裝檔。

Windows

v2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面，WPF 版則適合熟悉經典操作配置的使用者。兩者的介面架構不同，實際可用功能仍須參考發行說明及所選核心，不能直接將介面差異視為協定差異。

已有設定時，切換程式目錄前請先保留訂閱群組、路由與 DNS 設定。初次使用可先選定一種介面完成匯入與連線，避免同時執行兩個用戶端，造成監聽連接埠衝突或系統代理設定反覆遭到修改。

前往下載

macOS

v2rayN 依 Apple Silicon 與 Intel 提供不同下載入口。請在系統的「關於這台 Mac」確認晶片資訊，再選擇相符架構的安裝檔。跨平台介面的設定概念大致相同，但權限提示、選單位置與系統代理入口可能和其他桌面系統不同。

啟動後先確認程式能讀取設定目錄，再匯入訂閱。若系統代理已啟用，但應用程式仍未使用代理，請檢查該應用程式本身的網路設定；不會讀取系統代理的工具，則須依說明另外指定本機位址與連接埠。

前往下載

Android

v2rayNG 使用 Xray 核心，適合需要相關協定與傳輸功能的情境；v2flyNG 則是採用 V2Fly 核心的另一個選擇。多數較新的裝置可優先查看 arm64 版本；若不確定架構，再了解通用版本。實際相容條件請以下載頁及裝置資訊為準。

首次啟動連線時，系統會要求授權建立 VPN 介面。這是用戶端接收裝置流量的入口，不代表已連上遠端伺服器。背景執行限制、依應用程式分流，以及其他占用相同系統介面的程式，都可能影響連線狀況。

前往下載

Linux

v2rayN 提供 deb 與 rpm 套件，並區分 x64、arm64 架構。Debian、Ubuntu 通常選擇 deb；Fedora 等系統通常選擇 rpm。套件格式須符合系統的套件管理方式，處理器架構也必須與目前裝置相符。

不同桌面環境對系統代理的支援程度不盡相同。若瀏覽器可以連線、終端機工具卻不行，請先分別檢查兩者的連線入口，不要立即修改遠端節點。開機自動啟動、設定目錄的寫入權限，以及本機連接埠占用，也應分開檢查。

前往下載

查看所有用戶端 →

FIRST CONNECTION / 快速入門

匯入、選擇模式、確認連線

查看完整教學 →

開始前請準備可用的訂閱網址或單一節點參數。用戶端負責儲存設定及啟動核心，安裝程式本身不會提供遠端連線資料。以下步驟以圖形介面為主，先建立最基本的連線流程，再逐步加入分流與自訂設定。

  1. 匯入訂閱，確認欄位完整

    在 v2rayN 的訂閱群組中新增網址，填入方便辨識的名稱，再執行更新；Android 用戶端也應先儲存訂閱群組，再更新節點清單。單一分享連結可透過剪貼簿匯入，但分享連結與訂閱網址是不同類型的輸入，選錯入口可能造成解析失敗。

    清單出現項目後，請確認協定、伺服器位址、連接埠、傳輸方式及安全設定均已保留。節點名稱只是顯示標籤，不能取代參數核對。訂閱更新可能覆蓋手動調整的項目；若要長期保留修改，請使用獨立設定或用戶端提供的覆寫功能，並記錄修改來源。

    訂閱網址可能包含存取憑證，排查時請勿在截圖中顯示完整網址。若清單為空，先確認更新結果是網址無法連線、回傳內容不相容，還是解析失敗，再決定是否重新匯入。

  2. 選擇節點，釐清代理與路由

    設定目前使用的節點後，再選擇系統代理入口與路由模式。系統代理決定哪些遵循系統設定的應用程式會將請求交給用戶端；路由模式則決定請求進入核心後，是使用直連還是代理出站。兩者名稱都有「代理」，不代表屬於同一層。

    初次驗證可先使用規則較少、連線路徑明確的設定。若需存取區域網路資源，再確認私有位址規則是否優先比對。「略過中國大陸」通常仰賴網域與位址規則資料，不能只看模式名稱就斷定所有應用程式都會依預期分流。切換設定後，請建立新連線並觀察實際狀況。

    Android 也應確認依應用程式代理的範圍：「僅代理選取的應用程式」與「略過選取的應用程式」意義相反。排查期間一次只變更一項設定，並保留上一步已確認可用的節點，避免混淆入口與節點問題。

  3. 建立新連線，逐層驗證

    啟動連線後，先確認用戶端沒有立即回報設定錯誤，再透過目標應用程式送出一筆新請求。清單中的測試結果只反映特定測試方式，不代表瀏覽器頁面、檔案傳輸或即時通訊一定可用。判斷結果時，應以實際使用的應用程式與目標為準。

    若連線失敗，請依序檢查本機入口、網域解析、遠端連線及協定交握。若應用程式的流量沒有經過本機入口，反覆修改遠端參數通常沒有幫助；若已連上遠端但交握失敗，則須核對協定欄位、安全參數與系統時間。記錄檔中的錯誤類型有助於區分這兩種情況。

    確認連線可用後，再加入自訂路由、背景執行及開機自動啟動設定。退出用戶端前，請還原不再使用的系統代理，避免應用程式繼續連到已停止監聽的本機連接埠。完整教學會進一步說明各步驟的操作位置與常見分支。

PROJECT V / 核心與用戶端

開源生態系與設定範圍

用戶端負責管理設定，核心負責執行連線。各專案之間有技術傳承，但協定支援、欄位意義與更新節奏仍須分別確認。

Project V、V2Fly 與 Xray

Project V 是了解 V2Ray 技術背景的起點。V2Ray 將代理功能拆分為入站、出站、傳輸、路由等模組，讓本機應用程式入口與遠端連線方式能分別設定。V2Fly 延續 V2Ray 的社群維護；Xray 則以相關技術為基礎發展出自己的實作與擴充功能。兩者共用部分設定概念，但並非所有欄位與協定組合都能互換。

閱讀資料時，應先確認說明適用於哪一種核心，再確認用戶端是否能產生相應設定。例如，REALITY 是與安全傳輸相關的技術組合，不宜簡化為可與所有代理協定並列的單一選項。即使用戶端提供相應設定入口，也必須同時符合遠端參數與實際核心，才能建立連線。

圖形介面不等於核心本身

v2rayN 負責管理桌面端的節點清單、訂閱、路由預設及核心呼叫；v2rayNG 在 Android 上結合系統 VPN 介面與 Xray 核心處理流量；v2flyNG 則提供以 V2Fly 為基礎的另一種設定方式。這三個用戶端都是開源專案，但不能只憑名稱相似，就推斷其介面操作、設定產生方式及相容範圍相同。

介面顯示儲存成功，只代表參數已記錄。核心還需要讀取產生的設定、完成解析，並與遠端協商。自訂設定模式與一般節點模式可能採用不同的產生流程，因此直接修改產生的檔案未必能永久保留。修改前請先確認該檔案是設定來源，還是用戶端執行時產生的結果。

設定資料的閱讀順序

只需建立連線時，先閱讀快速入門；想了解「節點」、「訂閱」、「傳輸」等名詞，再查閱術語手冊；需要自訂行為時，進入 JSON 手冊依設定區段閱讀。程式碼範例用於說明局部結構，缺少出站資訊的片段不能當成完整連線設定。組合不同片段時，也要檢查標籤參照、陣列層級與規則順序。

查閱術語手冊 閱讀 JSON 手冊

READING NOTES / 專題文章

用戶端選擇與分層排查

查看所有文章 →

建立基本連線後，再依照遇到的問題查閱專題。選擇安裝檔時考量作業系統與介面架構；排查速度問題時檢查線路與本機入口；選擇協定時則確認遠端設定與核心能力。將問題分開處理，才能判斷哪些設定值得調整。

需要查找特定設定鍵時，可直接前往JSON 手冊；想分辨訂閱、節點與核心的差異時，可從術語手冊開始。