CLIENTS / CONFIGURATION

V2Ray安裝包下載 設定與教學

下載v2rayN 查看教學

依作業系統選擇 v2rayN 等開源用戶端，從匯入訂閱到路由分流，逐項確認設定。

  • JSON 設定欄位
  • Xray · V2Fly
  • 圖形用戶端教學

參數視窗僅為靜態設定示意；監聽連接埠與選單名稱請以實際用戶端為準。

01 / DOWNLOAD

依作業系統選擇安裝套件

桌面平台使用 v2rayN；Android 可先了解 v2rayNG，再依核心需求考慮 v2flyNG。

Windows

v2rayN 提供桌面版與經典 WPF 版。桌面版採用新一代跨平台介面；WPF 版保留經典操作配置。先依介面偏好選擇，再查看下載頁的執行需求；若只是匯入同一份訂閱，不必兩個版本都安裝。

首次啟動後，先確認程式能正常寫入設定資料夾，再新增訂閱群組。若要從舊環境移轉，請先備份現有設定與自訂路由，避免直接將舊資料夾覆蓋到新的安裝位置。若啟動異常，應先判斷是執行環境還是設定出了問題。

前往下載 Windows 安裝套件

macOS

v2rayN 依處理器架構提供 Apple Silicon 與 Intel 下載選項。先在系統的「關於這台 Mac」查看晶片資訊：Apple Silicon 選 arm64，Intel 選 x64。架構選擇與訂閱協定無關，也不能依伺服器使用的處理器判斷。

安裝後，先啟動用戶端並選擇伺服器，再設定系統代理。若瀏覽器已安裝代理擴充功能，請確認它是否覆蓋系統設定。終端機程式也可能使用獨立的環境變數，因此瀏覽器能連線，不代表所有應用程式都走相同的連線路徑。

前往下載 macOS 安裝套件

Android

v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。多數較新的 Android 裝置可先查看 arm64 安裝套件；若不確定裝置架構，再了解通用版。選擇哪款應用程式應考量設定相容性與核心需求，而非檔名是否相似。

首次連線時，須授予系統 VPN 連線權限，讓用戶端接管應用程式流量。若鎖定螢幕後連線中斷，請檢查電池最佳化與背景執行限制。分應用程式代理可指定哪些應用程式走代理路徑，請先確認規則方向，避免把「繞過」和「僅代理」弄反。

前往下載 Android 安裝套件

Linux

v2rayN 提供 deb 與 rpm 安裝套件，請依發行版的套件管理系統選擇；處理器架構則分為 x64 與 arm64。套件格式決定「使用哪種套件管理器安裝」，架構決定「在哪類處理器上執行」，兩者都要分別確認。

安裝完成後，在桌面工作階段啟動圖形用戶端，先確認本機監聽正常。不同桌面環境使用系統代理的方式可能不同，部分應用程式需要手動填入代理位址與連接埠。不要把「安裝成功」當成「所有應用程式都已接入代理」。

前往下載 Linux 安裝套件

安裝套件只包含用戶端程式。訂閱網址、伺服器連線參數與存取權限由設定來源提供；安裝後仍須匯入有效設定。下載頁集中說明處理器架構與套件格式，用戶端比較頁則介紹三款應用程式各自適用的環境。

查看所有用戶端 →
02 / CONFIG OBJECTS

設定物件索引

先找到用戶端中的設定項目，再了解它影響的設定層級。

訂閱群組：區分來源與更新範圍

訂閱群組是用戶端管理層的物件，不是核心 JSON 通用的頂層欄位。為不同來源設定獨立備註，填入訂閱網址後執行更新，再確認是否產生伺服器項目。更新失敗時，先釐清是網址無法連線、回傳內容無法解析，還是目前的網路路徑異常，不要立刻刪除現有設定。若來源需要持續更新，使用群組管理通常比逐筆手動維護方便；但本機修改是否保留取決於用戶端行為，重要參數應另行備份。

訂閱群組
├─ 備註
├─ 訂閱網址
└─ 更新訂閱

用戶端介面與核心設定並非逐字對應。訂閱群組、視窗偏好等設定由用戶端儲存；入站、出站、路由與 DNS 才是常見的核心設定物件。手動編輯前，先確認修改的是用戶端設定還是產生的執行設定；後者可能在下次啟動時重新產生。

查看 JSON 結構與設定欄位 →
03 / QUICK START

v2rayN 設定三步驟預覽

依照「設定來源 → 流量入口 → 連線結果」的順序操作。

  1. 步驟 01

    匯入訂閱並選擇伺服器

    開啟訂閱群組設定，為來源填寫容易辨識的備註，再貼上完整的訂閱網址。儲存後執行更新，確認清單中出現可用設定，並選擇要使用的伺服器。若持有單一分享連結，請使用用戶端的匯入功能，不要誤填為訂閱網址。

    匯入成功只代表內容可以解析，不表示一定能連上伺服器。此時先確認位址、連接埠、協定、傳輸方式與安全參數都來自同一份設定。訂閱網址可能包含存取憑證，不應出現在公開截圖或求助內容中；分享記錄檔前也應移除敏感欄位。

  2. 步驟 02

    確認代理入口與路由模式

    啟動連線後，確認用戶端沒有回報監聽連接埠已被占用，再依需求啟用系統代理。瀏覽器通常可以讀取系統設定，但終端機與部分桌面應用程式需要另外設定。手動填寫代理時，位址、連接埠與協定都必須符合用戶端實際的監聽項目。

    接著選擇適合目前需求的路由模式。路由控制請求進入核心後的去向；系統代理則控制應用程式是否將請求交給核心，兩者並非同一個開關。初次使用可先保留用戶端提供的基本規則，確認連線正常後，再逐項加入自己的網域或位址條件。

  3. 步驟 03

    測試應用程式並查看記錄

    使用需要代理的實際應用程式連線至目標，觀察用戶端是否出現相應的連線記錄。若只有某個應用程式失敗，應檢查它自己的代理路徑；若所有應用程式都失敗，再查看核心執行狀態、伺服器參數與網路連線。每次只修改一個條件，才能判斷問題出在哪裡。

    記錄中的連線遭拒、逾時與交握失敗分屬不同階段，不能一概歸因於訂閱失效。暫時提高記錄等級有助於定位問題，排除後應恢復常用等級。Android 端也須確認 VPN 連線授權與分應用程式範圍；若背景執行中斷，接著檢查電池最佳化設定，不要反覆重新匯入訂閱。

移轉裝置或更換用戶端時，先保存目前可用設定的來源與自訂規則。不要一次啟用系統代理、複雜分流與區域網路分享；先建立最基本的可用連線，再逐項擴充。這樣既能減少設定互相干擾，也能保留清楚的故障排除起點。

查看完整教學 →
04 / OPEN SOURCE ECOSYSTEM

Project V、核心與用戶端

釐清生態系、執行核心與圖形介面的差異，才能判斷設定適用於哪個層級。

生態背景

Project V 與 V2Ray 的關係

Project V 是以網路代理工具及相關功能為核心的開源專案體系，V2Ray 則是其中廣泛使用的核心專案。日常搜尋中提到的「V2Ray 用戶端」通常指圖形管理程式；技術文件中的 V2Ray 也可能專指執行核心。兩者屬於不同層級，閱讀教學時應先釐清上下文。

核心通常透過設定檔描述入口、出口與比對規則；圖形用戶端則將這些物件轉換成可操作的表單、清單與選單。因此，介面上有某個按鈕，不代表所有核心都接受相同的 JSON。理解這點，比記住某個選單的位置更有助於長期維護設定。

核心家族

V2Fly 與 Xray 的相容性界線

V2Fly 延續 V2Ray 的社群開發；Xray 則從相關生態系分出，發展出自己的功能。兩者共用部分概念，但協定實作、傳輸選項與設定細節仍有差異。使用 REALITY、XTLS Vision 等功能時，應確認 Xray 的支援情況，而非只看用戶端名稱是否含有 V2Ray。

「支援某種協定」不代表支援該協定的所有組合。傳輸方式、安全層、流量控制選項與核心功能會共同影響可用性。更換核心後若發生錯誤，先查看解析階段的提示，再檢查執行期間的連線狀態；不要把設定不相容誤判為伺服器無法連線。

開源與授權

三款圖形用戶端的用途

v2rayN、v2rayNG、v2flyNG 都是開源圖形用戶端，負責管理桌面與 Android 環境中的設定。v2rayN 提供多平台桌面介面，v2rayNG 使用 Xray，v2flyNG 使用 V2Fly。選擇時先看作業系統，再看設定需求，不必因名稱相近而重複安裝。

開源表示程式碼依相關授權公開；複製、修改與再散布仍須遵守各專案及相依元件的授權條款。用戶端與核心的授權可能不同，不能用單一概括標籤取代完整說明。用戶端程式可以免費使用；伺服器資源與訂閱服務則屬於不同層面的提供項目。

更新與維護

介面、核心與規則分別更新

一次用戶端更新可能涉及介面、設定產生邏輯或隨附核心；訂閱更新主要更新伺服器設定；規則資料更新則會影響網域與位址集合。三種更新的作用不同，不能因「訂閱已更新」就認定程式與核心也已更新。排除問題前記錄實際環境，有助於找到相應的欄位說明。

更新前請備份自訂路由、DNS 設定與訂閱群組資訊。更新後先測試原有連線，再確認自訂規則是否仍然生效。若參數名稱或預設值有變動，請以目前介面與對應核心文件為準。本頁提供物件層級的閱讀入口；下載頁集中說明安裝選擇，設定欄位頁則介紹各段 JSON 的用途。

可依遇到的問題選擇閱讀路徑：需要挑選應用程式時看用戶端比較；要完成首次連線時看教學；想了解特定欄位時看設定參考。遇到訂閱更新失敗或系統代理沒有生效，先判斷問題發生在哪個階段，再查看相應的故障排除說明，避免混淆不同層級的問題。

關於網站與內容範圍 →常見問題與連線故障排除 →
05 / READING

設定與故障排除文章

從核心差異、協定選擇到 Android 執行機制，補充各項設定背後的判斷依據。

查看所有文章 →