桌面與 Android · 客戶端設定指南

V2Ray 客戶端 下載與設定指南

下載v2rayN 查看教學

從 匯入訂閱到路由分流，依照實際選單整理 v2rayN 與 v2rayNG 的設定順序。

開放原始碼 Xray / V2Fly 生態系 中文設定文件

畫面僅示意設定項目；選單位置與可用核心請以實際客戶端為準。跨平台使用設定前，請確認核心與欄位相容。

設定入口

訂閱、路由與核心設定

先分清設定來源、流量入口與請求去向，再調整進階欄位。圖形介面客戶端負責管理設定，核心則依產生的設定檔執行連線；兩者各有不同職責。

訂閱群組與更新範圍

訂閱網址用來取得一組伺服器設定，並不等同於單一分享連結。在 v2rayN 的「訂閱分組設定」中填寫備註與網址，儲存後更新對應群組；在 v2rayNG 中透過「訂閱分組設定」新增，再執行「更新訂閱」。依來源分別建立群組，可保留各自的更新範圍，避免手動設定與訂閱內容混在一起。更新後先檢查伺服器位址、協定與傳輸設定，再切換使用中的設定。訂閱可能包含存取憑證，截圖與問題排查紀錄請勿顯示完整網址。

addressportprotocol
查看訂閱匯入步驟 →

初次設定時，建議先完成一條明確流程：新增一個訂閱群組，選擇一組可用設定，啟用本機代理入口，再檢查一次目標應用程式。完成後再加入網域分流、應用程式清單或自訂 DNS。每次只修改一類設定，較容易將問題限定在特定層次；若同時調整核心、連接埠與路由，往往會失去原本可用的參照狀態。

此處的介面卡片用於對照選單概念，不能取代實際設定。不同客戶端的按鈕名稱可能隨介面調整，判斷時仍應看設定本身的作用：訂閱負責取得設定，入站負責接收本機請求，出站負責建立連線，路由負責選擇出站。若需編輯 JSON，請先閱讀設定欄位參考，確認欄位所屬區段，再決定是否需要離開圖形介面。

下載客戶端

依作業系統與裝置架構選擇

桌面裝置使用 v2rayN，Android 裝置可優先查看 v2rayNG。安裝檔也須符合處理器架構與系統環境；先在裝置設定中確認資訊，再前往對應平台的下載頁面。

Windows

v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面，WPF 版則保留經典桌面操作版面。選擇時先確認系統需求，再依日常使用習慣決定介面；不必為了匯入同一份訂閱而同時執行兩者。

首次啟動後，檢查本機監聽連接埠與系統代理狀態。舊版客戶端若仍在執行，可能占用相同連接埠；請先結束舊版程式再測試。若瀏覽器另有代理擴充功能，也請確認它是否覆寫系統設定，避免兩個流量入口互相干擾。

前往下載 Windows 客戶端

macOS

v2rayN 分別提供 Apple Silicon 與 Intel 版本。在「關於這台 Mac」中查看晶片或處理器資訊，再選擇對應安裝檔。處理器架構與介面語言無關，不能只憑裝置外觀或購買年份判斷。

安裝後先確認客戶端能正常啟動，再設定訂閱與系統代理。遇到系統安全提示時，請核對下載來源與系統顯示的具體原因，依照系統設定處理，不要直接關閉整體安全功能。連線完成後，仍須在實際使用的應用程式中驗證代理是否正常運作。

前往下載 macOS 客戶端

Android

v2rayNG 使用 Xray 核心，是 Android 端的優先選擇；若需要 V2Fly 核心設定，可查看 v2flyNG。多數新款裝置採用 arm64 架構；不確定時，請先查看裝置資訊，或參閱下載頁的通用版說明。

首次連線時，須確認系統 VPN 授權。此授權用於接管本機網路流量，不代表伺服器已成功連線。連線建立後，請測試目標應用程式並檢查背景執行的電池限制；若切換至背景後連線中斷，先排查系統對客戶端的執行限制，再更換設定。

前往下載 Android 客戶端

Linux

v2rayN 提供 deb 與 rpm 安裝套件，並區分 x64 和 arm64。先依 Linux 發行版選擇套件格式，再依處理器選擇架構；套件格式不是代理協定，也不會變更訂閱中的伺服器參數。

安裝後使用圖形介面客戶端匯入設定。不同桌面環境對系統代理的支援可能有所差異，部分應用程式須另外填入本機 HTTP 或 SOCKS 入口。驗證時請分別測試瀏覽器、桌面應用程式與終端機程式；單一程式可正常連線，不代表所有程式都讀取相同設定。

前往下載 Linux 客戶端

安裝客戶端後，仍須具備有效的伺服器設定或訂閱。安裝檔用於安裝客戶端，不包含可直接使用的連線參數。

查看所有客戶端 →

快速開始

匯入設定、選擇入口、驗證連線

先建立一組可重現的基本設定，再加入個人化規則。以下三個步驟依照完整教學的操作順序整理；桌面與 Android 的差異主要在本機流量入口。

  1. 步驟一

    確認設定來源並匯入

    先確認取得的是訂閱網址，還是以 vmess://、vless:// 等協定開頭的單一分享連結。將訂閱網址新增至「訂閱分組設定」後執行更新；單一分享連結則使用客戶端的剪貼簿匯入功能。請勿將網頁說明網址當作訂閱，也不要把訂閱網址填入伺服器位址欄位。

    匯入後檢查備註、協定、伺服器位址與連接埠是否完整。訂閱更新失敗時，先確認網址沒有截斷或多餘空格，再查看更新提示。能開啟訂閱網頁，不代表客戶端已解析出有效設定。首次排查時請保留原有群組，不要反覆刪除重建，以免失去比對資訊。

  2. 步驟二

    選擇使用中的設定與流量入口

    桌面端選擇要使用的伺服器設定，再啟用「自動設定系統代理」；Android 端選取設定後點選連線按鈕，並確認系統 VPN 授權。路由先採用明確的預設模式，暫時不要疊加複雜的自訂規則。系統代理、VPN 接管與核心路由屬於不同層次，名稱相似也不能互相取代。

    若需存取區域網路服務，請核對繞過規則與目標位址。若需限定 Android 應用程式的範圍，再設定「依應用程式設定代理」，並確認是否啟用繞過模式。修改後重新連線，並以實際應用程式的請求結果驗證。若裝置同時執行其他代理或 VPN 工具，請先關閉其他程式再測試。

  3. 步驟三

    透過實際請求與日誌驗證

    連線按鈕顯示已啟動，只能表示客戶端已進入執行狀態。接著開啟實際要使用的網站或應用程式，確認請求是否完成，並查看日誌中的出站、解析或交握提示。內建測速可用於輔助比較目前條件下的連線表現，不代表持續下載速度，也不能取代目標應用程式的存取測試。

    遇到問題時，依序檢查本機入口、DNS、伺服器連線與目標服務。記錄目前選用的模式與修改項目，每次只調整一個變數。若瀏覽器正常但某個軟體失敗，優先檢查該軟體自己的代理設定；若所有請求都失敗，再檢查設定參數、系統時間與伺服器連線狀態，而不是直接加入更多路由規則。

需要還原設定時，先中斷連線並還原系統代理，再重新選擇設定。保留可用的基本設定，有助於找出後續規則變更造成的問題。

查看完整教學 →

開源生態系

客戶端、核心與設定之間的關係

V2Ray 是生態系與技術背景，v2rayN、v2rayNG 和 v2flyNG 則是具體的客戶端名稱。分清介面與核心，才能判斷設定會在哪個環節生效。

從 Project V 到核心系列

Project V 專注於模組化網路代理，V2Ray 是其中廣泛使用的實作。V2Fly 延續 V2Ray 的社群維護，Xray 則從相關程式碼與技術生態發展出自己的實作與功能。兩者共享部分概念與設定慣例，但不能只憑專案名稱就認定完全相容。支援某種協定，不代表所有傳輸選項、安全欄位與路由資源都能直接互換。

圖形介面客戶端負責訂閱管理、設定編輯、啟動控制與系統整合；核心則負責實際的網路處理。看到選單選項時，應同時確認客戶端如何儲存設定，以及目前使用的核心是否識別對應欄位。手動修改執行時產生的檔案，可能在下次儲存設定時遭到覆寫；要長期保留的調整，應使用客戶端支援的設定入口。

三款客戶端的開源授權

v2rayN、v2rayNG 與 v2flyNG 都是開源客戶端，分別針對桌面與 Android 使用情境設計圖形操作介面。v2rayN 專案採用 GPL 系列授權，v2rayNG 同樣採用 GPL 系列授權，v2flyNG 專案則採用 GPLv3 授權；實際授權範圍、第三方元件與散布條件，請以各專案的授權文件為準。V2Fly 與 Xray 核心採用 MPL 2.0 授權；客戶端與核心是不同軟體，不能將其中一方的授權直接套用於所有元件。

開放原始碼表示可依授權條件閱讀、研究及參與維護，不代表任何來源的安裝檔都具有相同狀態。選擇客戶端時，應考量裝置平台、所需協定與設定相容性。桌面裝置可優先查看 v2rayN；Android 使用 Xray 設定時可優先查看 v2rayNG，需要符合 V2Fly 的行為時再評估 v2flyNG。客戶端本身不決定伺服器的營運方式，也不能取代對訂閱來源的判斷。

更新前先保留可重現的設定狀態

客戶端介面、核心功能與規則資源可能各自更新。介面升級後仍須檢查實際啟用的核心；規則檔更新後，也應確認自訂標籤仍有對應項目。更新前記下本機連接埠、系統代理模式、使用中的設定與自訂路由；若支援匯出，請儲存一份妥善控管的備份。更新後先測試原本可用的請求，再逐項還原進階設定，避免將多項變更混成同一個問題。

訂閱更新與軟體更新也應分開看待。前者會重新取得伺服器設定，可能變更位址、協定或連線參數；後者則會更新客戶端與其元件。訂閱提供的單一設定通常無法涵蓋裝置上的所有路由偏好，客戶端的本機規則也不會自動同步至其他裝置。管理多台裝置時，記錄哪些設定來自訂閱、哪些屬於本機，有助於避免跨平台移轉時誤判。

JSON 參考與敏感資訊注意事項

需要進一步設定時，可從 inbounds、outbounds、routing 與 dns 四個部分開始閱讀。入站監聽範圍應符合實際需求，出站標籤必須與路由引用一致；DNS 行為則須配合網域策略判斷。範例中的 geosite:cn 規則需要相應資源；若只複製規則，卻沒有可用的資源檔，設定可能無法如預期啟動。

完整設定、分享連結與訂閱網址都可能包含存取身分資訊。尋求協助時，只保留必要欄位，隱藏身分參數與完整訂閱路徑，並說明客戶端名稱、使用的核心、出錯階段及相關日誌。日誌顯示的目標網域也可能暴露使用紀錄，請依排查需要擷取必要內容。依照這些原則整理資料，比只提供連線失敗的截圖更容易重現問題。

繼續閱讀 V2Ray 設定欄位 →

設定檔閱讀指南

分享連結、路由器部署與速度問題排查

從匯入方式延伸至閘道部署與分層排查。以下是最新三篇文章，請依問題範圍選讀，不必一次修改所有設定。

正在排查系統代理或連線日誌？文章目錄也收錄模式選擇與錯誤訊息解讀，可依具體問題繼續查閱。

查看所有文章 →
V2Ray客戶端下載