Project V 生態系 · 繁體中文設定文件

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

下載v2rayN 查看教學

整理開源客戶端安裝入口、匯入訂閱與 JSON 設定參考，從系統代理到路由規則，依流量傳遞順序逐步說明。

永久免費 Xray / V2Fly 圖形介面客戶端

客戶端安裝入口

先確認作業系統，再確認處理器架構。桌面版可選 v2rayN，Android 建議優先查看 v2rayNG；若已有 V2Fly 設定，也可比較 v2flyNG 是否相容。

Windows 桌面版與經典 WPF 版 前往下載 → macOS Apple Silicon / Intel 前往下載 → Android Xray 與 V2Fly 核心選項 前往下載 → Linux deb / rpm 桌面安裝套件 前往下載 →
查看所有客戶端 →

桌面安裝與架構選擇

Windows 版 v2rayN 桌面客戶端採用跨平台介面，WPF 版則保留經典桌面操作方式。兩種介面的選單位置可能不同，但匯入訂閱、選擇伺服器及設定系統代理的基本步驟相同。初次使用建議先選定一種介面，避免在兩個執行個體間反覆修改連接埠和系統代理。安裝前請確認系統需求；移轉設定時，先匯出原有設定，再確認新執行個體實際使用的核心與工作目錄。

macOS 使用者可在系統的「關於這台 Mac」查看晶片資訊，Apple Silicon 與 Intel 的安裝入口不同。Linux 使用者則須同時確認發行版套件格式與裝置架構：Debian、Ubuntu 系通常使用 deb，Fedora 等發行版通常使用 rpm。套件格式與處理器架構是兩項獨立條件，不能只看副檔名判斷是否適用。桌面版啟動方式與相依套件處理方式，請參閱平台安裝說明。

行動裝置設定與安裝後檢查

Android 版 v2rayNG 使用 Xray 核心，可參考 Xray 欄位說明理解連線參數；v2flyNG 則是採用 V2Fly 核心的另一種選擇。多數較新的裝置可選 arm64；不確定架構時，再查看通用套件說明。客戶端名稱相近，不代表支援的傳輸組合完全相同。匯入既有設定前，請確認協定、傳輸層與安全性設定，尤其不要假設某個核心的擴充欄位也適用於所有客戶端。

安裝完成只表示程式能執行，不代表已備妥可用的遠端設定。訂閱網址、伺服器位址及驗證參數須自行準備。首次匯入後，先確認設定清單中有有效項目，再查看核心記錄；請勿同時啟用多個代理客戶端。若清單為空，應先確認匯入格式或訂閱回應是否有問題，而非直接修改路由規則。客戶端選擇的詳細差異請參閱三款客戶端比較。

V2Ray 設定區段索引

依流量路徑找出對應欄位：應用程式先連至入站，路由再選擇出站，最後由出站建立連線。訂閱與系統代理屬於客戶端管理功能，不一定是 JSON 根物件中的同名欄位。

本機監聽與流量入口

入站定義核心接收連線的方式。應用程式使用 SOCKS 代理時，須將位址與連接埠指向對應的入站；只啟動核心，不會自動讓所有應用程式改用這個入口。範例監聽回送位址，僅供本機存取，並以 tag 標示來源，方便後續路由引用。排查連線遭拒時，先確認連接埠是否正在監聽、是否被其他程序占用，再檢查應用程式設定的代理類型。客戶端產生的連接埠可能不同，請以實際設定為準，不要直接照抄範例數值。

{
  "inbounds": [{
    "tag": "socks-in",
    "listen": "127.0.0.1",
    "port": 10808,
    "protocol": "socks",
    "settings": { "udp": true }
  }]
}
閱讀入站設定

設定片段與完整設定的差異

這些片段用來辨識各欄位的用途，並非可直接拼接後連線至遠端的一組完整設定。完整檔案還需要有效的遠端出站、彼此對應的標籤，以及符合目前核心的參數。相同的根欄位應合併至同一個物件或陣列，不能將多個 JSON 物件直接串接。標準 JSON 不接受註解與尾隨逗號；文字編輯器顯示格式整齊，也不代表核心能辨識其中欄位。

使用圖形介面客戶端時，建議先在相應設定頁面調整常用選項，再檢視產生的結果。直接編輯執行目錄中的設定，可能只在當次啟動時有效；下次切換伺服器或儲存設定後，檔案可能會重新產生。若要使用自訂設定，應先確認檔案由哪個元件管理、何時載入，以及錯誤記錄的存放位置。設定參考依序介紹結構概覽、入站、出站、路由、DNS 與策略，適合在首次連線成功後接續閱讀。

開啟 JSON 設定參考

v2rayN 快速入門

先建立最基本的可用設定，再逐項增加分流條件。每次只修改一項會影響連線的設定，並保留可還原的設定副本。

STEP 01 / IMPORT

匯入訂閱或設定

準備可用的訂閱網址，或客戶端支援的分享連結。在 v2rayN 的「訂閱群組設定」中新增來源，儲存後執行訂閱更新；單一分享連結則可從剪貼簿匯入。選單位置請以實際介面為準。匯入後檢查伺服器清單，確認收到的不是空白回應或一般網頁內容。

v2rayNG 可透過新增入口選擇從剪貼簿匯入，或管理訂閱。設定中的位址、連接埠、使用者識別碼與傳輸參數須來自同一份有效資訊，不能從不同教學各取一段拼成連線設定。訂閱網址通常包含存取憑證，不宜放進公開截圖或問題描述。

STEP 02 / ROUTE

選擇伺服器與代理入口

在清單中選擇要使用的伺服器，並確認核心能正常啟動。桌面版可依應用程式需求設定系統代理，路由則先沿用容易理解的預設值。系統代理控制應用程式如何進入客戶端，路由模式控制進入後的出口；兩者須分別檢查，不能把名稱相近的選項當成同一個開關。

Android 首次啟動連線時，須確認系統 VPN 授權。授權表示允許客戶端建立本機流量入口，不代表遠端連線已成功。若裝置上已有其他 VPN 連線，請先排除連線衝突。初次驗證時，避免同時加入複雜的自訂規則，以利縮小排查範圍。

STEP 03 / VERIFY

驗證要求與記錄

使用實際需要的應用程式送出要求，同時查看客戶端記錄。核心成功啟動、能連上伺服器，以及特定應用程式的流量確實經過代理，是三個不同的檢查項目。若記錄中沒有相應要求，先檢查應用程式入口；若有要求但連線失敗，再檢查伺服器參數、解析結果與網路可連通性。

不要只根據清單中的測試結果，就判斷所有應用程式都能正常運作。不同要求可能使用不同協定與解析路徑。確認基本連線正常後，再逐項啟用網域分流、應用程式規則或自動更新。測試結束、準備關閉桌面客戶端時，請確認系統代理已清除，避免應用程式繼續連線至已停止監聽的本機連接埠。

查看完整教學 →

故障排查順序

先確認設定能否匯入，再確認核心是否啟動，接著檢查要求是否進入，最後確認目標是否連線成功。依此順序可分開處理格式、程序、入口與遠端問題。例如「連接埠已被占用」屬於本機啟動問題，更新訂閱通常無法解決；遇到憑證錯誤，應檢查系統時間、伺服器名稱與相應安全性參數，不能一概歸因於路由。保留完整錯誤訊息，比只說「無法使用」更有助於找出問題。

修改後若出現新問題，先還原最近一次可用的設定，再逐一重現變更。記錄中可能包含伺服器位址與存取紀錄，回報問題前請先隱藏敏感資訊。常見錯誤與設定範圍請參閱常見問題；不熟悉的協定、核心或傳輸術語，可先查看術語表，避免混淆客戶端介面名稱與底層協定名稱。

PROJECT V / CORE / CLIENT

Project V 核心生態系

專案、核心與圖形介面客戶端分屬不同層次。選擇時先確認需要的協定與設定，再考量作業系統和管理方式。

Project V V2Fly / Xray 圖形介面客戶端
比較客戶端

Project V 與 V2Ray 的定位

Project V 是一項以網路通訊工具與元件為核心的專案，V2Ray 則是其中廣泛使用的核心名稱。核心負責接收連線、解析協定、比對路由並建立出站連線；圖形介面客戶端則將這些功能整理成可操作的設定介面。日常所說的「安裝 V2Ray」，實際上常是安裝一個管理核心的客戶端。因此，遇到選單或訂閱操作問題時，應先確認使用的是哪個客戶端，而非只用 V2Ray 這個泛稱尋找按鈕。

這種分層方式也說明了為何同一份技術文件可能需要對照不同介面。核心文件討論欄位是否合法，客戶端文件說明如何透過介面產生欄位，兩者處理的問題不同。客戶端可以切換核心、產生設定並啟動程序，但不會因此讓不同核心的所有功能自動一致。本網站將首次安裝與常用操作整理在使用指南中，原始欄位與相依關係則收錄於設定參考，方便依問題所在層級查找。

V2Fly 與 Xray 的分支關係

V2Fly 是 V2Ray 社群維護方向的重要組成部分；Xray 則是在相關程式碼基礎上發展而來的核心分支。兩者沿用部分歷史與設定概念，也各自持續演進協定實作、傳輸能力與欄位限制。閱讀 JSON 範例時，可先從 inbounds、outbounds、routing 等共通結構了解各自用途，再確認具體欄位是否受到目前核心支援。根物件名稱相同，不代表內部選項可以任意互換。

選擇核心時應以既有設定需求為依據，而非將分支名稱當成通用的效能結論。伺服器要求的協定、安全層與傳輸組合，都須由客戶端核心提供相應支援；缺少其中任一項，即使介面能儲存項目，也不代表可以連線。若使用特定分支的擴充功能，請優先閱讀相應說明，並記錄實際執行的核心資訊。遇到相容性問題時，分辨「欄位不受辨識」與「參數已辨識但連線失敗」，有助於避免不必要的修改。

三款開源客戶端的定位

v2rayN 適用於 Windows、macOS 與 Linux 桌面版，提供伺服器管理、訂閱群組、系統代理及路由設定等操作入口；可選的核心依客戶端功能而異。v2rayNG 適用於 Android，使用 Xray 核心；v2flyNG 同樣適用於 Android，採用 V2Fly 核心。三者都是開源客戶端，但圖形介面、權限管理與設定儲存方式各不相同。桌面版設定截圖不能直接用來判斷 Android 選單位置；移轉時應核對連線參數，而非整個工作目錄照搬。

開源代表實作內容與授權條件可供檢視，並不能取代設定判斷。客戶端軟體、核心程式與執行時使用的資料檔，可能各自採用不同的開源授權。V2Fly 的 v2ray-core 採用 MIT 授權，Xray-core 採用 MPL-2.0 授權；客戶端及其相依項目的再散布條件，也須分別查閱對應授權文件。使用者應留意軟體來源、功能範圍與設定相容性，不要只憑「開源」標籤就認定所有元件的條件相同。

客戶端、核心與訂閱分別更新

客戶端更新可能改變介面與設定產生方式，核心更新可能改變協定實作及欄位需求，訂閱更新則主要刷新遠端伺服器資訊。三種更新的對象不同；「訂閱已更新」不代表程式也已更新，也不應期待更新客戶端會自動修復失效的訂閱網址。更新前請記錄目前使用的設定，並匯出必要內容；更新後檢查啟動記錄、核心選擇與路由資料載入狀況，再透過實際應用程式送出要求進行驗證。

下載頁集中提供各平台的下載入口與安裝說明，首頁則保留穩定的使用流程，不在此固定列出客戶端版本資訊。處理設定問題時，應依實際安裝的客戶端、目前執行的核心與伺服器需求綜合判斷。文件中的 JSON 片段用來說明結構；執行環境中的預設值、產生方式與支援範圍仍須逐項確認。了解這些界線後，安裝、移轉與排查就能針對明確項目處理，不必在多個設定頁面間反覆嘗試。

設定與部署紀錄

整理桌面部署、訂閱維護與 DNS 分流的實作細節。先完成基本連線，再依實際問題查閱相關紀錄。

查看所有文章 →