v2rayN · 下載與設定指南

下載 v2rayN

依平台選擇用戶端,從匯入訂閱開始,逐步設定代理模式與路由分流。先確認連線正常,再調整進階設定。

永久免費 原始碼開放 繁體中文文件

匯入訂閱、代理模式與路由分流

依設定順序認識五項核心功能。右側為靜態設定示意,實際選單名稱可能隨用戶端介面調整。

訂閱群組設定

備註我的訂閱
啟用已開啟
訂閱操作更新訂閱
更新完成後設為作用中伺服器

流程示意:儲存群組 → 取得設定 → 選擇伺服器。

先分清楚三個設定層。訂閱負責取得伺服器資料,系統代理或 TUN 負責將應用程式流量交給用戶端,路由則決定流量從哪個出口送出。三者需要搭配使用,卻不能互相取代。只更新訂閱不代表代理已生效;只開啟系統代理,也無法修正伺服器設定錯誤。依照這個順序檢查,可減少在無關選單之間反覆嘗試。

初次使用時保留預設設定,只建立一條可驗證的連線路徑。確認網頁能正常瀏覽後,再新增群組、定時更新、路由例外與 TUN。每次只調整一類設定,並記錄修改內容與測試結果。需要完整的逐步操作說明,請參閱匯入訂閱教學;想了解各項設定之間的關係,可繼續閱讀從入門到精通完整手冊。

依作業系統選擇用戶端安裝套件

桌面端選擇 v2rayN,Android 裝置可先了解 v2rayNG。前往下載頁後,再確認處理器架構與套件格式。

Windows

可選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面,WPF 版保留經典介面配置;選擇時應考量操作習慣與系統相容性,兩者並非不同的代理協定。前往下載頁查看安裝說明,並確認系統與處理器符合相應下載入口的需求。

安裝完成後,先啟動用戶端、加入訂閱並選取作用中伺服器,再設定系統代理。若舊版用戶端仍在背景執行,請先結束舊程序,以免本機監聽連接埠衝突。升級既有安裝前,先備份訂閱與自訂路由,保留可還原的設定副本,再測試常用應用程式。

前往下載 · Windows

macOS

選擇 v2rayN 時,先開啟系統的「關於這台 Mac」,查看晶片資訊。Apple Silicon 請選 arm64 下載入口,Intel 請選 x64。不要只憑電腦外觀或購買年份判斷架構,也不要混用不同晶片的安裝套件。

首次執行時,依系統提示處理應用程式權限;若出現封鎖提示,先確認提示內容與系統要求,不要為了完成安裝而任意關閉系統保護。匯入訂閱後,分別檢查作用中伺服器與系統代理。若瀏覽器連線正常、其他應用程式卻異常,先確認該應用程式是否使用系統代理;確實需要接管流量時,再閱讀 TUN 章節並確認所需權限。

前往下載 · macOS

Android

建議優先選擇使用 Xray 核心的 v2rayNG;若需要 V2Fly 核心,再了解 v2flyNG。多數較新的手機適用 arm64 套件;若不確定架構,先查看裝置資訊與下載說明,再考慮通用套件。兩款用戶端各自管理設定,不要假設安裝後會自動共用訂閱與規則。

貼上訂閱網址並更新後,先選擇節點,再啟動連線並依提示授權系統 VPN。同一時間通常只有一個應用程式能使用系統 VPN 通道,切換用戶端前請先停止原有連線。若切到背景後中斷,請檢查電池最佳化與背景執行限制;若始終無法連線,則從節點設定與記錄開始排查。

前往下載 · Android

Linux

選擇 v2rayN 時,也要確認發行版的套件系統與裝置架構。使用 deb 套件系統的發行版,應選擇相應下載入口;使用 rpm 套件系統的發行版亦同。arm64 裝置請選擇下載頁中對應的架構入口。套件格式相同不代表所有相依套件都已備妥,仍須逐項閱讀安裝提示。

圖形桌面環境、系統代理的實作方式與權限管理可能各不相同。初次測試時,先確認瀏覽器明確使用用戶端提供的本機代理入口,再檢查桌面環境的代理設定。若要啟用 TUN,請確認授權方式,並留意是否與現有虛擬網卡衝突。日常使用圖形介面用戶端即可管理訂閱與伺服器,不必先部署路由器方案。

前往下載 · Linux

安裝套件只用來安裝用戶端,不含可直接使用的伺服器訂閱。訂閱網址與伺服器參數應向可信來源取得,並依所在地法規與網路服務規範使用。

查看所有用戶端 →

Project V 生態系與開源用戶端

先釐清專案、核心、用戶端與伺服器設定的差異,再決定需要安裝或更新哪些項目。

從介面到連線

圖形介面用戶端
v2rayN · v2rayNG · v2flyNG
核心系列
Xray · V2Fly
連線設定
協定、傳輸、加密與伺服器端參數
本機接入
系統代理、應用程式代理或 TUN

此圖僅示意各層職責,不代表每款用戶端都支援圖中所有功能組合。

閱讀 V2Ray 核心差異 →

Project V:先認識生態系名稱

V2Ray 起源於 Project V 體系,常用來泛指相關代理技術與工具生態系。日常搜尋的「V2Ray 用戶端」通常是指具有圖形介面的設定管理程式,而非某個固定的安裝套件。用戶端將訂閱、伺服器與路由等設定整理成可操作的介面,再交由核心執行連線。了解這層關係後,就不會把下載用戶端、設定伺服器與更新核心混為一談。

同一份分享連結可被多款用戶端辨識,不代表所有進階欄位都能完整移轉。匯入前請確認來源提供的是訂閱網址、單一分享連結,還是原生設定檔;不同入口用途各異。初次設定建議依照用戶端介面操作,建立可用連線後,再了解協定與傳輸細節。

V2Fly 與 Xray:依設定需求選擇

V2Fly 延續 V2Ray 相關核心的社群開發,Xray 則是在相關技術基礎上發展出的另一條核心路線。兩者共享部分概念與協定背景,但功能支援、設定欄位與發展方向並不完全相同。選擇時先確認伺服器要求的協定與傳輸組合,再核對用戶端實際支援的核心。名稱相似不能取代相容性判斷,也不能據此推論速度一定較快或較慢。

若設定包含特定核心路線才支援的功能,應搭配支援該功能的核心與用戶端。切換後若無法啟動、欄位無法識別或交握失敗,先查看記錄中的明確錯誤。保留可用設定再進行測試,比一次變更核心、DNS、路由與傳輸方式更容易找出原因。

三款用戶端:開源不代表介面相同

v2rayN、v2rayNG 與 v2flyNG 都是原始碼開放、免費使用的用戶端專案,採用 GPL-3.0 開源授權。開源授權說明程式碼使用、修改與再散布的條件,不能取代伺服器服務條款,也不代表所有訂閱來源都可信。桌面端與 Android 端的介面、權限與網路接入方式各有差異,閱讀教學時應先確認用戶端名稱,再對照實際選單。

v2rayN 適用於桌面系統,方便集中管理訂閱、伺服器與路由設定;v2rayNG 適用於 Android 裝置,使用 Xray 核心;v2flyNG 則提供採用 V2Fly 核心的 Android 替代選項。選擇時優先考量平台與設定相容性,不必為了更多功能名稱而同時執行多款用戶端。移轉時先保留原有設定,再逐項確認訂閱、連線與分流。

更新機制:程式、核心與訂閱分開維護

用戶端更新負責介面與程式邏輯,核心更新會影響協定處理與連線能力,訂閱更新則會重新取得伺服器資料。三種操作處理的內容不同:更新程式不會自動修復過期訂閱,更新訂閱也不會讓舊核心取得新功能。日常維護時,應依錯誤發生的位置選擇相應操作,不要把「全部更新」當成唯一的排查方式。

升級前先備份自訂路由、訂閱群組與重要設定,並閱讀相關變更說明。升級後先用原本可用的伺服器測試基本連線,再確認區域網路存取、常用應用程式與 DNS。訂閱網址中的憑證應妥善保管,如同帳號資料;分享截圖或記錄時,請遮住網址參數、使用者識別資訊與伺服器驗證資料。記錄問題時,保留錯誤類型與發生步驟即可。

連線前常見問題

匯入訂閱後,為什麼還不能直接使用?

匯入網址只是儲存來源,更新訂閱後才會讀取伺服器資料。取得資料後,還要選擇伺服器、設為作用中伺服器,並讓應用程式透過系統代理或其他接入方式使用用戶端。若清單是空的,先查看更新訂閱時的錯誤訊息;若清單有項目但無法連線,再檢查伺服器與本機接入方式。請依照匯入訂閱步驟逐項確認。

系統代理與全域路由是同一個開關嗎?

不是。系統代理決定遵循系統設定的應用程式是否將要求交給用戶端;路由模式則決定用戶端收到要求後如何傳送。即使選擇全域路由,不讀取系統代理的應用程式仍可能沒有經過用戶端。先檢查接入方式,再檢查流量分流,才不會把應用程式代理問題誤判為節點故障。操作順序請參閱代理設定教學。

如何確認連線確實生效?

不要只看啟動按鈕或單次延遲測試。先執行用戶端提供的連線測試,再用目標應用程式確認實際存取情況,並參考出口位址與記錄進行判斷。單一測試成功不代表所有應用程式都使用相同網路路徑;啟用分流時,不同目標也可能使用不同出口。請依照連線驗證清單分別測試代理目標與直連目標。

網頁無法開啟時,應該先修改 DNS 嗎?

先判斷是所有連線都失敗,還是只有部分網域異常。憑證錯誤、驗證失敗與伺服器無法連線,通常不是修改 DNS 就能解決。確認基本連線正常後,再檢查網域解析結果、DNS 要求路徑與路由規則是否一致。修改前先記下原有設定,每次只變更一個環節;進階說明請參閱DNS 設定章節。

V2Ray 使用教學與連線排解

從首次連線、線路診斷到路由器部署,依目前遇到的問題選擇文章,不必一次修改所有設定。

遇到明確錯誤時,先記錄用戶端名稱、操作步驟與錯誤訊息,再選擇相應文章。描述問題時請隱藏訂閱憑證,並保留必要的設定類型與錯誤脈絡。

查看所有文章 →