桌面用戶端 · 訂閱與代理設定

V2Ray Windows版v2rayN 下載與設定

下載v2rayN 查看教學

從多平台用戶端選擇到訂閱匯入，依應用程式接入範圍設定代理。

圖形介面系統代理路由分流

用戶端入口

依系統與架構選擇下載

桌面裝置選擇 v2rayN；Android 優先了解 v2rayNG，再依核心需求考慮 v2flyNG。先確認執行環境，再選擇安裝套件；用戶端名稱相近，不代表安裝檔可以跨系統使用。

Windows

v2rayN · Desktop / WPF

桌面首選

首次選擇可從桌面版開始；它採用跨平台介面。經典 WPF 版保留熟悉的 Windows 介面，兩者都用於管理代理設定。選擇重點在於系統需求、操作習慣與所需功能，而不是同時安裝兩套用戶端。

進入下載頁查看 x64 下載入口與執行條件。安裝前先備份原有設定，首次啟動後確認用戶端能正常開啟、核心可以啟動，再匯入訂閱。若核心提示本機監聽失敗，應檢查連接埠是否被占用，而不是反覆切換訂閱或重新安裝系統。

前往下載

macOS

v2rayN · Apple Silicon / Intel

先在「關於本機」中查看晶片類型：Apple Silicon 對應 arm64，Intel 對應 x64。依實際硬體選擇檔案，比根據購買年份猜測更可靠。桌面用戶端的介面概念相近，但系統權限提示與網路設定入口並不相同。

首次執行如遇到系統安全性提示，應先確認檔案來源與應用程式身分，再依照系統提供的方式處理，不要把關閉整套安全機制當成安裝步驟。啟用系統代理後，還要檢查瀏覽器是否讀取系統設定；有獨立代理選項的工具則需要個別設定。

前往下載

Android

v2rayNG / v2flyNG

優先選擇 v2rayNG

v2rayNG 使用 Xray 核心，v2flyNG 則是採用 V2Fly 核心的替代選擇。先核對訂閱中的協定與傳輸要求，再決定用戶端。較新的主流裝置通常使用 arm64；無法確認架構時，先閱讀下載頁說明，再考慮通用安裝套件。

Android 透過 VpnService 接入應用程式流量，首次啟動連線時需要系統授權。這項授權不代表遠端連線已經成功。若鎖定螢幕後斷線，應一併檢查電池最佳化、背景執行限制與其他 VPN 應用程式；若只有某個應用程式無法使用，先查看分應用程式代理範圍。

前往下載

Linux

v2rayN · deb / rpm

依發行版的軟體套件體系選擇 deb 或 rpm，同時確認處理器是 x64 還是 arm64。套件格式與處理器架構是兩個獨立條件，只確認其中一項仍可能無法安裝。頁面提供圖形用戶端入口，不要把僅執行核心視為已完成桌面代理設定。

不同桌面環境讀取系統代理的方式有所差異，命令列工具也可能只讀取環境變數或自身參數。先確認本機監聽位址、連接埠與代理類型，再讓目標應用程式接入。需要 TUN 時，還要個別核對權限、虛擬介面與現有網路路由之間的關係。

前往下載

用戶端負責管理設定，不附帶可用的遠端服務。準備好有權使用的訂閱或連線參數後，再進行匯入；不要把安裝完成當成連線條件已經齊備。

查看所有用戶端 →比較三款用戶端

操作主題索引

代理設定的四個層次

訂閱提供連線參數，系統代理和 TUN 決定應用程式如何接入，路由規則決定已接入的要求如何處理。排查時先確認問題所在的層次，避免用修改出口規則去解決應用程式根本沒有接入的問題。

訂閱匯入與更新

設定要解決什麼問題

訂閱會將一組連線參數交給用戶端管理。新增位址並更新後，再選擇要使用的設定；匯入成功只代表內容已被讀取，不等於遠端可以連線。

哪些應用程式會使用

訂閱不會直接修改瀏覽器或終端機。只有接入本機代理的應用程式，才會依目前選擇的設定傳送要求。

何時需要進一步設定

更新失敗時，先檢查位址是否有效以及取得路徑是否正常。分享螢幕截圖前請隱藏訂閱位址，避免其中的存取憑證外洩。

設定項目示意：訂閱群組 → 新增訂閱位址 → 更新訂閱
查看代理模式、協定與核心概念 →

三步快速上手

從匯入設定到分別驗證

首次設定先建立一條可解釋、可重現的使用路徑。暫時不要疊加複雜分流與 TUN，先確認基本連線，再逐項增加設定；如此一來發生問題時，才能知道是哪個步驟改變了結果。

  1. 匯入訂閱，選擇設定

    安裝並開啟用戶端，找到訂閱管理或訂閱群組入口，新增容易辨認的名稱，再貼上完整訂閱位址並儲存。接著執行更新，確認用戶端已讀取到連線項目。若手上是單一分享連結，應使用相應的匯入功能，不要把它當成訂閱位址反覆更新。

    選擇本次要使用的設定後，檢查協定、傳輸與安全參數是否已完整辨識。不要為了消除錯誤訊息而任意修改伺服器提供的欄位。訂閱更新失敗與連線失敗是兩種不同問題：前者關注設定取得流程，後者關注核心啟動與實際要求。訂閱連結屬於敏感資訊，不宜出現在公開截圖、聊天記錄或排查附件中。

    查看訂閱匯入步驟

  2. 選擇接入方式，啟動連線

    桌面版先確認核心已啟動且本機監聽沒有錯誤，再選擇自動設定系統代理，讓遵循系統設定的應用程式接入。路由先使用容易理解的預設值，記下目前選項。不要同時開啟多個代理用戶端爭用系統設定，否則看到的開關狀態可能與實際要求路徑不一致。

    Android 選擇設定後啟動連線，閱讀並確認系統 VPN 授權提示，再檢查分應用程式設定是否包含目標應用程式。桌面終端機工具若需要手動填寫代理，應從用戶端讀取實際位址、連接埠與類型，不要照抄其他裝置的數值。只有明確需要涵蓋不讀取代理設定的應用程式時，才進入 TUN 的權限與路由設定。

  3. 分應用程式驗證，保留基準

    先在瀏覽器中開啟有權存取且熟悉的目標，再用實際需要的終端機或桌面工具發出要求。一次網頁開啟不能代表所有應用程式都已接入，也不能據此判斷全部路由規則正確。結合用戶端記錄確認要求是否進入核心，並記錄當時的接入方式與所選設定。

    若瀏覽器可用而終端機失敗，優先檢查終端機代理環境；若某個網域失敗，檢查規則比對與 DNS；若核心無法啟動，先處理設定錯誤或連接埠衝突。基本連線穩定後先備份設定，再逐項加入分流與 TUN。停用時清除不再使用的系統代理，並確認手動設定的應用程式沒有繼續指向已關閉的監聽連接埠。

查看完整教學 →

如果已完成基本設定，可繼續閱讀新手到進階手冊。手冊依核心概念、安裝、訂閱、代理模式、路由、TUN 與日常維護逐步說明，適合每一步驗證通過後逐章補充，而不是一次修改所有設定。

開源生態說明

用戶端、核心與連線參數

這三個層次各有職責。用戶端提供介面並整理設定，核心執行連線與路由，訂閱或手動參數描述遠端服務。了解它們之間的關係，比單憑產品名稱判斷功能更準確。

Project V 與核心家族

Project V 是理解這個代理工具生態的起點，V2Ray 是其中廣泛使用的核心專案。V2Fly 社群延續了 V2Ray 的維護與發展；Xray 從相關程式碼基礎分支演進，形成自己的功能路線。它們具有歷史淵源，但如今不能只根據名稱相似，就認定設定能力完全相同。

核心負責協定處理、傳輸、安全連線與路由等底層工作。VLESS 是協定名稱，Xray 是核心名稱，兩者並非同一層級的概念。選擇時應同時核對協定、傳輸方式與相關安全特性，不能只看到訂閱寫著某個協定，就斷言任意用戶端都能完整使用。

三款圖形用戶端的定位

v2rayN 面向桌面平台，為設定管理與核心使用提供圖形入口；具體可呼叫的核心及功能，以安裝套件和目前介面為準。v2rayNG 面向 Android，採用 Xray 核心；v2flyNG 同樣面向 Android，採用 V2Fly 核心，可在明確需要相應核心能力時考慮。

三款用戶端都是開源專案，但用戶端本身不是訂閱服務。它們不會因為安裝完成就自動取得可用的遠端連線。遷移時也應區分可共用的連線參數與平台專屬設定：訂閱可能可以重新匯入，但系統代理、權限、分應用程式範圍與本機連接埠仍需在新裝置上重新確認。

開源授權與使用邊界

開源表示程式碼依相應授權條款提供檢視、使用、修改或再散布的條件，並不代表所有元件都採用同一種授權。V2Fly 核心與 Xray 核心採用 MPL 2.0；圖形用戶端及其相依套件的授權說明仍需分別閱讀，尤其是在修改程式碼或再散布軟體時。

程式碼開放也不能取代對設定來源的判斷。遠端服務由誰營運、訂閱位址如何保存、目標網站連線是否正確驗證，仍是獨立的使用問題。應在取得授權的裝置與網路環境中操作，遵守適用規定；遇到憑證錯誤時，先排查時間、網域與參數，不要把跳過驗證當成日常設定。

用戶端更新與訂閱更新

用戶端更新可能調整介面與設定管理邏輯，核心更新可能改變協定支援或行為，訂閱更新則主要重新整理遠端連線項目。這三種更新不能互相取代。訂閱項目失效時，重新安裝用戶端未必能解決；核心不支援某項設定時，反覆更新同一份訂閱也不會增加該能力。

日常維護宜先備份設定，再閱讀與實際使用功能相關的變更說明。更新後依序驗證核心啟動、訂閱讀取、系統代理與常用應用程式，最後檢查自訂路由。若出現異常，記錄觸發條件與錯誤類別，隱藏敏感欄位後再整理問題，避免在沒有基準的情況下同時修改多個環節。

本站整理下載入口與中文操作說明，不取代用戶端介面、核心文件或遠端服務說明。遇到術語差異時，可先查閱概念，再決定是否調整設定。

了解 Xray 核心了解 VLESS 協定訂閱更新失敗如何排查

最新文章

依現象定位設定問題

先記錄是哪個應用程式、哪個步驟出現異常，再選擇對應文章。連接埠監聽、系統代理範圍與背景執行限制屬於不同環節，只有分開驗證，才能減少重複安裝與無關的設定修改。

查看所有文章 →
下載用戶端