桌面版首選 v2rayN · Xray / sing-box

V2Ray Mac 用戶端 v2rayN 下載與設定

下載v2rayN 查看教學

依作業系統選擇用戶端，從匯入訂閱到系統代理，再到TUN 模式。

免費開源 繁體中文設定指南 訂閱與路由管理

訂閱、系統代理與路由設定

先釐清設定層級，再決定要調整哪個項目。下方為唯讀介面示意。

查看完整文件 →

v2rayN 是管理設定的圖形介面，核心則負責建立連線與執行規則。訂閱會將節點資料匯入用戶端；系統代理決定哪些應用程式會將請求交給本機代理；路由則決定這些請求要直接連線，還是經由遠端節點。三者位於不同環節：更新訂閱不會自動修復系統代理，切換路由也不會讓所有程式都遵循系統網路設定。

初次使用時，建議先匯入一個訂閱群組、選擇一個節點，再啟用系統代理並測試瀏覽器連線。依序操作比較容易看出每次變更的影響。若同時啟用 TUN、修改 DNS、加入自訂規則，連線異常時就難以判斷原因。各平台的介面文字可能略有不同，請以已安裝的用戶端為準。

v2rayN · 設定項目說明

訂閱群組與更新

訂閱網址是一份可更新的節點清單，不是用戶端安裝檔。進入訂閱群組設定，填寫備註與網址並儲存，接著更新目前的群組，再回到伺服器清單選擇節點。依用途建立不同群組，可避免個人設定與訂閱設定混在一起。v2rayN 與 v2rayNG 都有訂閱入口，但辨識原生設定的方式不同，匯入前請先確認格式。更新失敗時，先檢查請求錯誤與網址是否有效，不要反覆刪除本機群組；訂閱網址可能包含存取憑證，也不應貼到公開頁面。

啟用訂閱更新
群組操作更新目前的訂閱
匯入來源訂閱網址 / 分享連結
了解訂閱格式 →

依作業系統選擇 V2Ray 用戶端

桌面平台選 v2rayN；Android 建議先了解 v2rayNG，再依核心需求考慮 v2flyNG。

查看所有用戶端 →

Windows

 桌面版首選

v2rayN 提供 Desktop 桌面版與經典 WPF 版。Desktop 採用跨平台介面，WPF 則保留經典桌面操作方式。選擇時先確認作業系統與執行環境需求，不必為同一份訂閱同時安裝兩套用戶端。

安裝後先確認用戶端能正常啟動、核心能順利執行，再匯入訂閱。若啟動後立即關閉，請先查看執行環境與權限提示，而不是修改節點參數。若要遷移既有設定，請先備份訂閱網址與自訂路由，再進行替換。

前往下載

macOS

 v2rayN

Mac 使用者可先在「關於這台 Mac」查看晶片資訊。Apple Silicon 對應 arm64，Intel 處理器對應 x64。下載安裝後，依系統提示完成首次開啟，再設定訂閱與系統代理；若遇到阻擋，請先確認下載來源與系統提示。

日常瀏覽可先使用自動設定系統代理。若終端機工具沒有跟著使用代理，請另外檢查工具的網路設定。只有在確定需要涵蓋更多應用程式時，再了解 TUN 的授權、DNS 與路由行為，不必一開始就啟用所有功能。

前往下載

Android

 v2rayNG / v2flyNG

v2rayNG 使用 Xray 核心，適合需要相應協定與傳輸功能的設定；v2flyNG 使用 V2Fly 核心，可作為符合該核心需求的替代選擇。一般手機通常選擇 arm64；若不確定處理器架構，再查看通用安裝套件的說明。

匯入訂閱後更新群組、選擇節點，並確認系統連線授權。背景執行可能受到電池管理影響；若連線一段時間後中斷，請一併檢查省電策略與網路切換狀況。不建議同時啟動兩款用戶端連線，以免爭用系統網路通道。

前往下載

Linux

 v2rayN

依發行版選擇 deb 或 rpm，再確認 x64 或 arm64 架構。套件格式須符合系統的套件管理方式，處理器架構則須符合執行平台，兩者都要相符。安裝前也請確認桌面圖形環境、相依套件與權限需求。

Linux 桌面環境處理系統代理的方式不盡相同。若瀏覽器可以連線，但其他程式仍直接連線，請先確認應用程式是否讀取桌面代理設定。需要使用 TUN 時，再處理虛擬介面與權限；不要將網路管理員的設定問題誤認為訂閱失效。

前往下載

v2rayN 連線前的三步設定

先建立一條可驗證的連線，再新增路由規則或設定 TUN。

查看完整教學 →
步驟一 · 準備設定

匯入並更新訂閱

用戶端本身不提供可連線的遠端節點。請準備合法可用的訂閱網址或分享連結，在訂閱群組設定中儲存後執行更新。若只有一條連結，可透過用戶端支援的剪貼簿匯入功能新增；請勿將網頁網址當成訂閱網址。

更新完成後，確認伺服器清單是否出現預期的節點。若清單為空，請先核對訂閱格式、有效期限與更新記錄。網址中的查詢參數可能用於身分驗證，複製時請完整保留；分享截圖時則應遮蔽這些內容。

步驟二 · 選擇出口

選取節點並設定系統代理

從清單選取節點並設為目前使用項目，確認核心已成功啟動。桌面版接著選擇自動設定系統代理，路由則先使用符合目前用途的預設。Android 請依用戶端流程啟動連線，並確認系統跳出的網路連線授權。

路由中的直連與代理是出口策略，不能用來證明節點是否在線。初次驗證時請保留簡單設定；若有其他網路工具正在執行，請先停止其中一個再觀察連線結果，避免多層代理影響判斷。

步驟三 · 確認範圍

檢查應用程式與連線記錄

使用明確遵循系統代理的應用程式連線至目標服務，再查看用戶端記錄是否出現相應連線。能開啟用戶端介面，不代表請求已進入核心；能連上某個網站，也不代表所有應用程式都採用相同路徑。

若出現異常，請依序檢查訂閱、節點、核心、系統代理與 DNS。每次只調整一個項目並記錄結果。確認一般連線穩定後，再設定 TUN、區域網路存取或更細緻的規則，之後也更容易還原。

儲存設定時，建議一併記錄節點來源、使用的核心與自訂規則用途。訂閱更新通常會調整群組中的節點項目，手動修改的內容未必會保留；若有需要長期維護的設定，可先了解用戶端的處理方式，再另外管理。離開目前網路或結束測試後，請確認系統代理已還原，尤其準備關閉用戶端時更應留意。

首次連線失敗時，不建議直接重新安裝。先確認錯誤來自訂閱請求、核心啟動還是遠端交握，再前往相應章節排查。若記錄包含訂閱網址、節點網域或身分欄位，請先移除敏感資訊再分享。詳細操作步驟請參閱使用文件；依平台分類的安裝與權限說明請見完整文件。

Project V、V2Fly 與 Xray

釐清生態系、核心與用戶端的差異，才能判斷設定應交由哪個程式處理。

查看用戶端比較 →
Project V · 代理工具生態系
V2FlyXraysing-box · 獨立核心專案
v2rayN · 桌面設定介面v2rayNG · Android / Xrayv2flyNG · Android / V2Fly

生態系名稱不等於協定名稱

Project V 是一系列代理相關工具與元件的生態背景，V2Ray 則是其中廣為使用的名稱。後續社群發展出不同的核心與用戶端專案，因此搜尋「V2Ray 用戶端」時，經常會同時看到 V2Fly、Xray、v2rayN 等名稱。它們分屬不同層級：協定描述通訊方式，核心負責實作協定與路由，圖形用戶端則協助管理訂閱、設定選項與執行狀態。

V2Fly、Xray 與 sing-box 的定位

V2Fly 延續 V2Ray 社群開發，Xray 則從相關技術基礎發展出自己的協定實作與功能；sing-box 是另一個獨立的代理核心專案。三者的功能有部分重疊，但原生設定結構與支援功能並不完全相同。即使 VMess、VLESS 或 Trojan 名稱相同，也應進一步確認傳輸層、安全參數與用戶端產生設定的方式，不能只憑名稱就認定整份設定都通用。

三款開源用戶端的分工

v2rayN、v2rayNG 與 v2flyNG 都以開源方式提供用戶端程式碼。v2rayN 面向桌面平台，著重將訂閱、系統代理、路由與核心執行集中於同一介面；v2rayNG 面向 Android，使用 Xray 核心；v2flyNG 則以 V2Fly 核心提供另一種選擇。開源代表程式碼可供檢視並依授權條款使用，不表示所有專案採用相同授權；各專案的條款仍須分別確認。

用戶端更新與訂閱更新應分開處理

更新用戶端是為了解決介面、相容性與程式功能問題；更新核心會影響協定實作與執行行為；更新訂閱則是刷新遠端節點資料。規則資料庫也可能有獨立的更新入口。升級前請記錄目前設定並備份，升級後先確認原有連線正常，再嘗試新功能。遇到相容性問題時，應一併記錄用戶端、核心與節點參數，而不是只說「V2Ray 不能用」。

選擇用戶端時，先確認裝置平台，再檢查節點所需的協定與核心，最後確認操作方式是否符合用途。Mac 使用者通常可從 v2rayN 的訂閱與系統代理功能開始；行動裝置則可透過 Android 用戶端管理連線。本網站的下載與文件僅說明工具設定，不提供訂閱服務，也不取代訂閱提供方對帳戶、流量與節點可用性的說明。

REALITY、Vision、DNS 與 GeoSite 等名詞，應從各自的技術層級理解。REALITY 是與連線安全相關的設定，Vision 是相關的流控機制，DNS 會影響名稱解析，GeoSite 則用於比對網域集合。修改其中一項，不會自動解決其他環節的問題。先保留可正常運作的基本設定，再透過記錄與對照測試逐項擴充，通常比一次複製整套陌生設定更容易維護。

V2Ray 設定專題

從系統代理到規則資料庫，依照實際遇到的問題繼續閱讀。

查看所有文章 →