v2rayN / 桌面用戶端

V2Ray for Linux 用戶端下載與設定

下載v2rayN 查看教學

從匯入訂閱開始，依照選單設定系統代理與 TUN 模式；桌面平台選 v2rayN，Android 選 v2rayNG。

永久免費原始碼開放中文設定文件

v2rayN 常用設定
先分清流量接管方式，再調整規則

匯入訂閱只是備妥連線參數。應用程式是否使用代理，還取決於系統代理、虛擬網路介面和路由規則。分開檢視這幾個環節，遇到「節點測試正常，網頁卻打不開」時，才能知道該檢查哪個選單，而不是一再重裝用戶端。

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

系統代理會將用戶端的本機代理位址交由作業系統使用，適合會讀取系統設定的瀏覽器與桌面應用程式。初次使用時，可在系統匣選單選擇「自動設定系統代理」，再開啟網頁測試。「清除系統代理」可還原設定；「不變更系統代理」則表示用戶端不主動修改現況，並非清除設定。相較於 TUN，這種方式不必接管整個網路介面，但無法確保所有程式都會使用代理，命令列工具通常還需要另外設定。

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

選單名稱可能會隨用戶端介面更新。若要依平台逐步操作，請查看完整安裝與設定文件 →

V2Ray 用戶端平台下載入口

桌面平台使用 v2rayN；Android 優先選擇 v2rayNG，需要 V2Fly 核心時再考慮 v2flyNG。下載前先確認作業系統與處理器架構，再前往下載頁選擇安裝檔。

Windows

v2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式。兩者的介面配置可能不同，參照教學操作前先確認下載的版本，不必為了尋找相同按鈕而來回更換。

安裝前請在系統「設定」中確認處理器與系統類型。首次啟動後先匯入訂閱，再從系統匣設定系統代理。關閉主視窗不一定會結束程式，停止使用前請確認代理設定已還原，避免瀏覽器繼續連線到已關閉的本機連接埠。

前往下載 Windows 用戶端→

macOS

v2rayN 依 Apple Silicon 與 Intel 提供不同下載入口。開啟「關於這台 Mac」，若看到「晶片」，請依晶片型號選擇；若看到「處理器」，請確認是否為 Intel。別只憑電腦購買年份判斷架構，也不必為了匯入同一份訂閱而混用安裝檔。

首次開啟時若出現系統安全提示，請先確認檔案來源，再依系統設定中的實際提示處理。系統代理與 TUN 的授權方式不同，瀏覽器確認可用後再測試其他應用程式；若只有特定程式異常，先檢查該程式本身的代理選項。

前往下載 macOS 用戶端→

Android

優先使用搭載 Xray 核心的 v2rayNG；若設定需要相容 V2Fly 核心，可選擇 v2flyNG。多數較新的裝置可選 arm64；不確定架構時，請查看裝置資訊或依下載頁說明選擇通用安裝檔。兩款用戶端的設定選項不一定完全相同。

匯入訂閱、更新清單並選好節點後，啟動連線時請依系統提示允許建立 VPN 連線。若系統中已有其他 VPN 應用程式正在執行，請先排除接管衝突。背景中斷也可能與省電限制有關；排查時請一併檢查應用程式的電池管理設定與實際記錄，別只是不斷按下連線按鈕。

前往下載 Android 用戶端→

Linux

v2rayN 的 Linux 下載入口依 deb、rpm 套件格式與處理器架構區分。Ubuntu、Debian 等發行版通常選 deb，Fedora 等發行版通常選 rpm；x64 或 arm64 架構則須另外確認。套件格式與處理器架構是兩項獨立條件。

安裝後先確認桌面環境是否顯示系統匣圖示，再測試瀏覽器能否讀取系統代理設定。不同桌面環境處理代理設定的方式可能不同，終端機程式也未必會跟著使用。需要 TUN 時，再檢查對應權限與虛擬介面狀態；不建議一開始就同時修改系統路由、DNS 和多種代理工具。

前往下載 Linux 用戶端→

下載頁整理了安裝檔類型與系統需求。本網站提供用戶端下載入口與設定文件，連線所需的有效訂閱或節點參數仍須自行準備。

查看所有用戶端 →

從匯入訂閱到測試連線

先讓最基本的連線成功，再新增分流規則或啟用 TUN。每次只調整一項設定，出現問題時才容易還原到上一步。

  1. 新增訂閱並確認更新結果

    在 v2rayN 開啟「訂閱群組」，新增容易辨識的群組名稱，並貼上完整訂閱網址。儲存後執行「更新訂閱（不透過代理）」，確認清單中確實出現可選節點，再進行下一步。複製時留意網址前後是否有空格，以及通訊軟體是否截斷連結。

    更新失敗不代表用戶端安裝失敗。先判斷回傳的是網路錯誤、驗證錯誤，還是內容格式無法辨識。若已有可用連線，才考慮透過代理更新。單筆分享連結與訂閱網址也不是同一種輸入：前者匯入一組連線參數，後者則用來取得及更新整批節點。

  2. 選擇節點，再決定流量接管方式

    選取要使用的節點並設為目前設定。桌面平台先從「自動設定系統代理」開始，讓會使用系統設定的瀏覽器連上代理；Android 則依用戶端操作啟動連線，並允許系統建立 VPN。首次測試時先關閉其他網路工具，降低設定互相覆蓋的可能性。

    若要讓更多應用程式透過核心處理，再單獨測試 TUN。接管方式只決定流量如何進入用戶端，路由規則才決定流量進入後的去向。因此，「啟用 TUN」不等於「全域代理」。保留一份可用設定的記錄，之後調整 DNS 或路由時才有明確的參照。

  3. 測試網頁、應用程式與停止連線

    先用瀏覽器造訪已知可用的網站，再測試實際需要使用的應用程式。用戶端顯示正在執行，只代表程式或介面已啟動，不能取代端對端的連線測試。若瀏覽器可用、特定應用程式卻失敗，優先檢查該應用程式是否會讀取系統代理，以及是否使用獨立的網路設定。

    節點測試結果也不代表檔案下載或影片播放一定順暢。速度異常時，依序檢查節點、線路與本機設定，並觀察是否只有特定目的地受到影響。最後測試停止連線：清除不再使用的系統代理，確認一般網路仍可正常使用，方便下次啟動時找出狀態變化。

查看完整教學 →

Project V、V2Fly 與 Xray

用戶端、核心與協定各自負責不同層面。先了解它們之間的關係，比把所有網路問題都歸因於「節點失效」更有幫助。

OPEN SOURCE

開源生態
與設定範圍

關於本網站 →

Project V：從工具組合認識生態

Project V 是認識 V2Ray 生態的起點之一。在日常使用中，「V2Ray」有時指核心，有時又泛指某類用戶端，因此教學常把不同層面的設定混為一談。實際使用時，可將圖形介面視為設定管理層、核心視為連線執行層：前者負責儲存訂閱、選擇使用中的節點及整理設定；後者負責解析設定、建立連線並執行路由。瀏覽器或其他應用程式則位於更外層，需要透過系統代理、應用程式內的代理設定或虛擬介面傳送流量。

這也說明了為什麼同一份訂閱能在不同用戶端使用，卻不代表所有選項都能原樣移轉。介面可能只提供部分核心功能，訂閱轉換也可能影響設定欄位。排查問題時，先記下用戶端名稱、使用的核心與流量接管方式，比只說「V2Ray 連不上」更容易找到對應的說明。

V2Fly 與 Xray：彼此相關，但參數不能互換

V2Fly 社群延續了 V2Ray 相關開發，Xray 則是在相關程式碼基礎上發展出的另一條核心分支。兩者有共同的技術背景，也各自發展協定支援、傳輸能力與設定實作。別把其中一個簡單視為另一個的介面外觀，也不能只憑名稱判斷哪個在所有情境下都比較快。能否成功連線，關鍵通常在於伺服器參數、協定支援與本機設定是否相符。

VMess、VLESS 是連線設定中需要辨識的協定名稱；REALITY 則與連線安全機制有關，不應視為可任意替換的一般節點標籤。訂閱中出現不熟悉的選項時，先查明對應核心的支援情況，再決定是否調整用戶端。協定補充說明請參閱完整文件的通用準備章節，不必為了理解單一欄位而重新安裝整套軟體。

三款用戶端：依平台與核心挑選

v2rayN 是適用於桌面平台的開源圖形化用戶端，方便集中管理訂閱、系統代理與路由設定；v2rayNG 適用於 Android，採用 Xray 核心；v2flyNG 也是 Android 圖形化用戶端，提供以 V2Fly 核心為主的替代選擇。三者皆為開源用戶端專案，發布與重新散布時應遵守 GPL-3.0 等適用授權及所附相依元件的授權條款。開源僅代表程式碼與授權方面的特性，不保證任何訂閱服務都能使用。

桌面用戶可先選擇 v2rayN，再依作業系統與處理器選擇安裝檔；Android 用戶先確認節點參數是否適用於 v2rayNG，確有相容需求時再考慮 v2flyNG。用戶端不會附帶通用且可用的連線資源，也無法取代對伺服器帳戶、有效期限與流量狀態的確認。需要比較差異時，請參閱三款用戶端比較，依實際平台與參數選擇，而非只看名稱是否相似。

更新方式：分別檢視用戶端、核心與訂閱

更新用戶端主要影響介面與設定管理功能；更新核心可能改變協定支援或執行方式；更新訂閱則會從服務來源重新取得節點清單。這是三種不同的維護方式：更新訂閱不會自動升級用戶端，更換用戶端也無法讓過期帳戶恢復有效。規則資料庫則是另一類資料，涉及網域、IP 分類與分流比對。只有部分網站異常時，應搭配規則與 DNS 解析結果判斷，而非一次替換所有元件。

升級前記下原本的代理方式、使用中的節點與自訂規則；升級後先重新測試基本連線，再逐項還原複雜設定。分享記錄時，只保留排查所需資訊，並隱藏訂閱網址、帳戶識別資訊與連線金鑰。本網站整理下載入口與中文操作指南，實際選單與功能仍以已安裝的用戶端為準；判斷問題時，請一併參考系統提示、用戶端記錄與實際連線結果。

V2Ray 設定與疑難排解文章

基本連線正常後，再了解設定結構、DNS 與規則資料庫。依照遇到的問題閱讀文章，不必一次改完所有設定。

查看所有文章 →