跳至正文
桌面用戶端設定手冊從安裝到分流

V2Ray Mac用戶端 v2rayN macOS 下載與設定

下載v2rayN 查看教學

依晶片選擇安裝檔，完成訂閱匯入、系統代理與路由分流設定，再逐項調整 DNS 和 TUN。

PROTOCOLS VMessVLESSTrojanShadowsocks
DESKTOPv2rayN桌面設定入口
ANDROIDv2rayNG / v2flyNG依核心需求選擇
CORE FAMILYXray · V2Fly協定支援以所選核心為準

用戶端下載

依系統與晶片選擇安裝檔

查看所有用戶端 →

桌面版可從 v2rayN 開始，Android 則建議先查看 v2rayNG。先確認作業系統，再確認處理器架構；不能只憑電腦外觀判斷安裝檔名稱中的 arm64 或 x64。下載頁列出各平台的下載入口，版本資訊可在對應的用戶端卡片中查看。

Windows

v2rayN · Desktop / WPF

桌面版採用跨平台介面，WPF 版則保留經典操作配置。已有設定的使用者請先備份，再依使用習慣選擇；首次安裝請先查看下載頁的系統需求，避免同時將兩個版本設為系統代理。

前往下載 Windows 用戶端→

macOS

v2rayN · Apple 晶片 / Intel

開啟 Apple 選單中的「關於這台 Mac」。若顯示 Apple 晶片，請選擇 arm64；若顯示 Intel 處理器，請選擇 x64。下載磁碟映像檔後，將 App 移至「應用程式」再開啟，避免一直從掛載的映像檔執行。

首次啟動若出現系統安全性提示，請先確認來源與 App 名稱，再到「隱私權與安全性」查看相關提示。先使用系統代理測試瀏覽器連線，確認訂閱和節點參數正確後，再考慮啟用需要額外權限的 TUN。

前往下載 macOS 用戶端→

Android

v2rayNG · v2flyNG

主流手機可先查看 arm64 版本，若不確定架構，也可選擇通用版本。v2rayNG 使用 Xray 核心，v2flyNG 則可作為 V2Fly 核心的替代選擇。連線前請閱讀系統的 VPN 授權提示，並留意省電設定對背景執行的限制。

前往下載 Android 用戶端→

Linux

v2rayN · deb / rpm

依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。桌面環境是否採用系統代理，會影響應用程式的接管範圍；安裝完成後仍須檢查代理設定、本機監聽連接埠及應用程式本身的網路選項。

前往下載 Linux 用戶端→

用戶端用於管理本機設定，不會附帶可用的訂閱。安裝前請準備有權使用的訂閱網址或完整節點參數，並妥善保存來源資訊。訂閱連結通常含有存取憑證，請勿貼到公開留言或截圖中。

v2rayN 設定索引

系統代理、分流與訂閱管理

請分開理解「流量如何進入用戶端」與「進入後要走哪條路線」。系統代理和 TUN 負責接管流量，路由規則負責選擇出站，DNS 則影響網域名稱解析結果。依照下列順序逐項確認，比一次開啟所有選項更容易找出問題。

系統代理：先讓瀏覽器連線

系統代理會將遵循系統網路設定的應用程式導向用戶端的本機連接埠。匯入訂閱並選擇節點後，在狀態列選擇「自動設定系統代理」，再開啟瀏覽器測試。「清除系統代理」可還原系統代理設定；「不變更系統代理」只是維持現狀，不代表原有代理已關閉。相較於逐一在應用程式中填入連接埠，系統代理更方便桌面端開始使用，但不會自動涵蓋所有程式。若特定應用程式仍直接連線，先確認它是否採用系統代理，再決定要個別設定或使用 TUN。

  • 確認用戶端核心已啟動，且本機連接埠未被占用。
  • 結束前先清除系統代理，避免留下無法連線的本機入口。
  • 瀏覽器代理擴充功能可能會覆蓋系統設定，排查時請先停用衝突項目。

系統代理 · 狀態列選項

清除系統代理
自動設定系統代理
不變更系統代理

介面名稱可能隨用戶端更新而調整。若名稱不同，請先依「系統代理、路由、訂閱、核心」四類功能尋找對應入口，不要直接照搬其他平台截圖中的按鈕位置。視窗示意圖只說明設定之間的關係，不代表安裝後會自動取得可用設定。

查看所有平台的安裝與設定指南 →

快速入門

從匯入訂閱到確認連線

查看完整教學 →

首次設定請從最簡流程開始：準備訂閱、選擇節點、啟用系統代理並測試瀏覽器。基本連線正常後，再加入自訂規則與 TUN。這樣既能建立可重現的起點，也能在後續調整失敗時回到已知可用的狀態。

  1. 01 / IMPORT

    匯入訂閱並更新清單

    在「訂閱分組」中建立新分組，填入容易辨識的別名與完整訂閱網址，儲存後執行更新。確認清單中已出現設定，再選擇一個節點作為目前使用的設定。若已有分享連結，請使用用戶端對應的匯入功能，勿將分享連結誤填至訂閱網址欄位。

    若清單仍是空的，先查看更新結果：網址失效、回傳內容不相容與連線逾時需要不同處理方式。確認電腦時間正確，複製連結時沒有混入引號、空格或通訊軟體插入的換行。若無法連線至來源，再比較直連更新與透過代理更新的路徑，避免反覆刪除整個分組。

  2. 02 / ROUTE

    啟用系統代理與基本路由

    選擇節點後，確認核心已啟動，再將系統代理設為「自動設定系統代理」。路由先使用符合目前需求的預設值；若不確定規則是否影響連線，可暫時切換全域模式進行比較。請注意，全域路由不代表所有應用程式都會被接管；應用程式仍須透過流量入口連入用戶端。

    此階段先關閉 TUN，減少權限、虛擬網卡與其他 VPN 造成的變因。若瀏覽器有代理擴充功能，請先停用，或確認其代理設定與系統代理一致。若工作網路有專用代理，請先記下原有設定，避免覆寫後無法還原。Android 裝置則依系統提示確認 VPN 連線授權。

  3. 03 / VERIFY

    測試連線並儲存可用設定

    開啟瀏覽器前往要測試的目標，同時查看用戶端記錄。測試內容應包含一個預期直連的目標，以及一個預期透過代理連線的目標，並確認規則是否符合設定。單次連線測試或延遲結果只反映測試目標的狀況，不能取代實際網頁、登入與應用程式功能的檢查。

    若顯示已連線卻無法開啟網頁，請依序確認系統代理、本機監聽連接埠、路由與 DNS，不要立刻重新安裝。若只有特定應用程式失敗，再檢查該應用程式的個別代理設定。確認可正常使用後儲存設定；結束前清除系統代理並停止相關流量接管。完整操作與還原步驟請參閱快速入門教學。

Project V 生態系

用戶端、核心與協定的分工

Project V 是理解 V2Ray 技術生態系的起點。圖形化用戶端將訂閱、節點與規則整理成可操作的介面；核心讀取設定並執行連線；VMess、VLESS、Trojan、Shadowsocks 等協定則描述不同的通訊方式。這三個層級各有不同職責，因此「已安裝 V2Ray 用戶端」不代表特定協定功能一定可用，還須確認核心、傳輸方式與伺服器參數。

V2Fly 社群持續維護 V2Ray 相關專案；Xray 則以相關技術為基礎，發展出自己的核心功能與設定架構。兩者共用部分技術術語，但功能發展並不完全相同。閱讀教學時，請先確認文章適用於哪個核心，再對照目前的用戶端介面。尤其是 DNS、路由與傳輸安全參數，名稱相似不代表可以直接照抄；未知欄位或不支援的組合可能導致核心啟動時報錯。

v2rayN：桌面圖形介面

v2rayN 是採用 GPL-3.0 授權的開源桌面用戶端，提供設定管理與多核心使用入口。桌面操作時，須分清視窗狀態、核心執行狀態與系統代理狀態。主視窗能開啟，不代表核心已成功載入設定；選擇節點，也不代表系統代理已指向本機監聽連接埠。

從一台電腦移轉至另一台時，可將訂閱與路由保存為設定資料，但仍須重新確認應用程式路徑、權限與平台網路設定。先執行基本設定，再還原自訂規則，通常比一次搬入所有設定更容易排查問題。

v2rayNG：Android 與 Xray

v2rayNG 是採用 GPL-3.0 授權的開源 Android 用戶端，使用 Xray 核心。Android 透過系統 VPN 介面接管應用程式流量，操作方式與桌面系統代理不同。連線授權、背景執行限制、個別應用程式設定，以及其他 VPN 的資源占用，都可能影響實際使用。

同一份訂閱在桌面可用、在手機上失敗時，請先確認手機時間、目前網路與核心支援情況，再檢查傳輸參數。不要只因用戶端名稱相似，就認定不同裝置具備完全相同的協定支援與預設設定。

v2flyNG：V2Fly 核心替代選擇

v2flyNG 是採用 GPL-3.0 授權的開源 Android 用戶端，以 V2Fly 核心提供另一種設定選擇。適合需要比對 V2Fly 行為或使用相應設定的情況。選擇替代用戶端應以協定相容性與設定需求為依據，而非同時安裝後反覆切換連線。

比較結果時，請使用相同網路與同一組參數，並確認只有一個 VPN 連線正在執行。不同用戶端可能以不同方式轉換訂閱格式；成功匯入後，仍須檢查節點詳細資料是否保留伺服器要求的重要欄位。

開源授權與日常更新

開源授權會明確規範程式碼的使用、散布與修改條件，適用範圍請以各專案及其所含元件的授權為準。用戶端、核心與附加元件可能分別採用不同授權；開源不代表可以忽略授權條件，也不表示用戶端專案提供第三方訂閱服務。本網站整理下載與設定資料，用戶端專案、訂閱來源與目標網站各自扮演不同角色。

更新也應分層處理：更新用戶端會調整介面與設定管理邏輯；更新核心可能改變協定支援；更新訂閱則會同步來源中的節點資訊；更新路由資源會影響規則比對。發生問題時，先記下變更的是哪個層級，保留可用備份，再針對問題還原。不要把「更新訂閱」當成升級用戶端，也不要為了修復單一節點而同時更換所有元件。

跨平台操作可繼續閱讀所有平台指南，依下載、安裝、匯入與測試的順序完成設定。排查時只須保留錯誤類型與發生步驟；公開尋求協助前，請移除訂閱網址、驗證資訊與節點中的私人參數，避免一併公開可重複使用的存取憑證。

設定與排查筆記

連線失敗、網頁無法瀏覽與訂閱更新

查看所有文章 →

先依遇到的狀況選擇文章。節點逾時，重點檢查連線參數與記錄；瀏覽器無法開啟網頁，優先檢查流量入口與 DNS；訂閱更新失敗，則先檢查來源與請求路徑。將三類問題分開處理，避免在錯誤的設定層反覆嘗試。

V2Ray 用戶端下載