config.json 用戶端下載與設定索引

V2Ray中文下載站 v2rayN / v2rayNG 設定手冊

集中整理 v2rayN 與 v2rayNG 用戶端config.json 設定方法路由分流操作,從選擇安裝套件、匯入訂閱到切換代理模式,均依實際設定路徑說明。

  • 永久免費
  • 程式碼開源
  • Xray · V2Fly
  • 中文設定文件
platforms / 4 core / Xray · V2Fly config / JSON license / open source

routing / rules

一條連線如何經過入站、路由與出站

瀏覽器或系統流量會先進入本機監聽連接埠,接著由 routing 規則檢查網域、IP、協定類型與程序來源, 最後交給指定的 outbound。理解這條路徑後,系統代理、繞過區域網路、直連規則與遠端連線之間的關係會更清楚。

download / platforms

V2Ray 用戶端平台入口

先依目前使用的系統進入對應分區,再根據處理器架構與使用習慣選擇用戶端。首頁僅負責平台導覽, 安裝套件類型、系統需求與具體下載入口統一在下載頁說明。

desktop / v2rayN

Windows

桌面端優先選擇 v2rayN。下載頁也會說明跨平台桌面版與經典 WPF 版的介面差異、適用系統及安裝方式, 方便新系統與既有設備分別選擇。

前往下載 →

desktop / v2rayN

macOS

v2rayN 桌面版分別提供 Apple Silicon 與 Intel 架構入口。開啟系統資訊查看晶片名稱即可判斷, 下載頁也會說明首次執行、匯入設定與切換系統代理的位置。

前往下載 →

mobile / v2rayNG

Android

Android 端首選採用 Xray 核心的 v2rayNG,也可依核心偏好選擇 v2flyNG。主流裝置通常使用 arm64, 無法確認架構時,可閱讀下載頁的通用安裝套件選擇說明。

前往下載 →

desktop / v2rayN

Linux

v2rayN 提供適用於常見發行版的套件,並區分 x64 與 arm64 架構。先確認發行版採用 deb 或 rpm, 再進入下載頁選擇對應架構,可減少安裝時的格式錯誤。

前往下載 →

config / anatomy

設定欄位拆解台

一份設定由多個職責明確的頂層欄位組成。選擇左側目錄即可查看欄位用途、常見值、 圖形化用戶端中的對應設定位置,以及修改時最容易忽略的連動關係。

config > inbounds

本機入站監聽

inbounds 定義用戶端如何接收來自瀏覽器、系統或其他程式的流量。常見設定包含 listenportprotocoltag: 監聽位址決定哪些裝置可以連線,本機連接埠需要與系統代理設定一致,協定通常使用 SOCKS 或 HTTP。 在 v2rayN 中,這部分對應參數設定裡的本機監聽連接埠;在 v2rayNG 中,則對應本機代理與 VPN 服務入口。 修改連接埠後,也要同步調整手動設定代理位址的瀏覽器或應用程式,否則用戶端雖然啟動成功,流量仍不會進入核心。

查看系統教學 →

project v / ecosystem

Project V 生態系與用戶端分工

圖形化用戶端、代理核心與設定資料屬於不同層次。釐清各層職責,才能正確理解用戶端更新、 核心切換、訂閱內容與路由規則之間的關係。

從 Project V 到核心家族

Project V 奠定了 V2Ray 設定模型與模組化網路工具的基本結構。設定檔將入站、出站、路由、 DNS、傳輸與日誌拆分為彼此關聯的模組,使用者可以透過 tag 將多個模組組合成清晰的資料路徑。 這種結構既適合手動維護 config.json,也方便圖形化用戶端根據訂閱與介面選項產生設定。 因此,圖形化用戶端介面中看到的伺服器、代理模式、路由預設與本機連接埠,最終都會對應到相應的設定欄位。

V2Fly 延續並維護 V2Ray 的核心能力,著重模組化設定與協定實作;Xray 則在相近的設定體系上發展出獨立核心, 並被多個用戶端用於連線與路由處理。兩者都不是圖形化用戶端本身,而是用戶端呼叫的底層核心。 同一款圖形化用戶端可以圍繞不同核心組織功能,同一份訂閱也可能因用戶端與核心的支援範圍不同, 在傳輸參數、路由能力或設定寫法上呈現細節差異。

開源授權與可審閱更新

v2rayN、v2rayNG、v2flyNG 以及相關核心均由開源社群持續維護。開源授權規定程式碼使用、修改與再發佈的界線, 也讓協定實作、設定解析與問題修復能由開發者公開審閱。對一般使用者而言,更實際的判斷標準是: 下載與目前系統相符的用戶端,閱讀更新說明,保留目前能正常運作的設定,並在升級後檢查系統代理、路由與核心狀態。

用戶端更新與核心更新不一定同時發生。介面程式負責訂閱管理、設定編輯、系統匣控制與系統整合; 核心負責協定連線、DNS、路由與流量處理。若某次更新只涉及介面配置,現有連線方式通常不會改變; 若包含核心或設定格式調整,則應重點檢查自訂路由、傳輸參數與舊設定的相容性。 日常維護時記錄用戶端類型、使用的核心與關鍵設定,比只記錄一個軟體名稱更有助於定位問題。

desktop

v2rayN

面向 Windows、macOS 與 Linux 的桌面圖形化用戶端,負責訂閱管理、伺服器選擇、系統代理、 路由預設、TUN 模式與日誌查看。桌面端需要完整控制系統網路設定時,優先從 v2rayN 開始。

android / xray

v2rayNG

採用 Xray 核心的 Android 用戶端,提供掃描 QR Code、剪貼簿匯入、訂閱更新、分應用程式代理與路由設定。 已有 Xray 相關參數或需要對應協定能力時,可將其作為行動端的主要選擇。

android / v2fly

v2flyNG

以 V2Fly 核心為基礎的 Android 替代用戶端,介面操作與常見訂閱流程相近。 需要沿用 V2Fly 設定體系或核對不同核心的表現時,可依實際設定需求選擇。

workflow / checklist

更新用戶端前先記錄四項設定

  1. 目前設定:確認目前使用的訂閱群組與伺服器項目,避免升級後誤選其他設定。
  2. 代理模式:記錄系統代理、PAC、全域、規則或 TUN 的目前狀態,方便還原原有路徑。
  3. 本機連接埠:核對 SOCKS 與 HTTP 監聽連接埠,瀏覽器手動代理需使用相同數值。
  4. 自訂規則:另外儲存手動新增的網域、IP、程序與出口 tag,更新後逐條驗證比對結果。

quick answers

常見問題精選

匯入訂閱後為什麼看不到伺服器?

先執行一次訂閱更新,再檢查訂閱群組是否啟用、連結是否完整,以及用戶端日誌中是否出現解析錯誤。 完整操作順序請參考訂閱匯入步驟

系統代理與 TUN 模式有什麼差別?

系統代理主要接管遵循系統代理設定的應用程式;TUN 模式則透過虛擬網路介面處理更廣泛的流量。 選擇前請先閱讀TUN 模式章節

連接埠被佔用時應該修改哪一項?

先找出佔用本機監聽連接埠的程序,再修改用戶端的 SOCKS 或 HTTP 連接埠,並同步調整瀏覽器與其他應用程式的代理設定。 可查看連接埠衝突排查

桌面版與經典 WPF 版該怎麼選?

新系統可先考慮跨平台桌面版,若依賴經典介面與既有操作習慣,再比較 WPF 版。 具體差異整理於用戶端比較頁