V2RAY 桌面用戶端 · v2rayN

V2Ray電腦版 v2rayN 用戶端下載與設定。

從平台選擇到訂閱匯入,依實際設定了解路由分流與本機代理。

  • 程式碼開源
  • 多核心設定
  • 中文設定參考

設定工作台 / CLIENT SETTINGS

v2rayN 設定與配置關係

先釐清流量如何進入用戶端,再決定連線如何離開用戶端。

用戶端介面中的開關,不一定對應到設定檔裡同名的欄位。系統代理負責提供應用程式流量入口,路由規則負責選擇流量的出口,訂閱群組用來整理連線資料;核心則負責執行產生的設定。分開理解這幾個層次,遇到「已啟動卻無法連線」時,就能依序檢查入口、規則和出口,而不是一次更動所有選項。以下五項是初次設定時最常用的工作台選項。

"listen": "127.0.0.1"

建議先用系統代理搭配瀏覽器測試連線。選擇自動設定後,會遵循系統代理設定的應用程式便會將請求交給本機入站;自行管理網路連線的應用程式仍可能直接連線。上方的監聽位址屬於核心入站設定,並非系統代理開關本身。相較於逐一手動設定應用程式代理,使用這個入口更容易統一啟用或停用,但不能取代路由分流。先確認實際監聽的連接埠,再測試網頁;離開前清除系統代理,避免應用程式繼續連線到已停止的本機服務。

查看設定參考 →

安裝套件下載入口 / PLATFORM SELECTION

依作業系統選擇 V2Ray 用戶端

桌面平台使用 v2rayN,Android 平台可優先了解 v2rayNG。

先確認作業系統與處理器架構,再選擇安裝套件。用戶端名稱、介面類型與核心名稱分別代表不同層次:介面負責管理設定,核心負責處理連線,安裝套件格式則決定系統如何安裝。下載頁整理了各平台的下載入口與適用說明;初次使用可先保留預設設定,完成匯入、啟動和瀏覽器驗證,再逐步加入分流或虛擬網卡設定。

Windows

推薦 v2rayN

v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,適合希望在不同電腦上維持相近操作習慣的使用者;WPF 版保留經典的 Windows 操作方式,適合已熟悉此介面的環境。選擇時先確認系統相容性,不必只因介面名稱不同就同時安裝兩個版本。

安裝後先確認本機監聽連接埠是否被其他程式占用,再匯入連線資料。若瀏覽器曾手動設定代理,請確認該設定是否仍優先於系統設定。兩種介面的選單位置可能不同,排除問題時應以實際代理模式、核心狀態與記錄內容為準,而非只比較視窗外觀。

macOS

v2rayN

依電腦晶片選擇 Apple Silicon 或 Intel 的安裝入口。在系統的「關於這台 Mac」中查看晶片或處理器資訊,比依購買年份推測更可靠。v2rayN 桌面介面負責訂閱與設定管理;系統代理授權、網路權限及核心執行狀態仍須分別確認。

首次開啟時依照系統提示處理應用程式權限,不建議為了完成一次安裝而長期降低系統安全設定。若連線只在部分應用程式中生效,先確認這些程式是否會讀取系統代理;需要涵蓋更多流量時,再參閱 Tun 模式與系統路由的說明。

Android

推薦 v2rayNG

Android 平台建議優先使用採用 Xray 核心的 v2rayNG,採用 V2Fly 核心的 v2flyNG 則可作為替代選擇。多數較新的裝置適用 arm64 安裝套件;若不確定裝置架構,可參閱下載頁的通用版說明。兩款應用程式各自管理連線資料,匯入其中一款不會自動同步到另一款。

啟動連線時須確認系統 VPN 授權;這代表允許應用程式建立本機虛擬網路介面,不代表已連上可用服務。若背景執行經常中斷,請檢查電池最佳化及背景執行限制;需要讓部分應用程式繞過代理時,再設定個別應用程式代理,並確認清單採用的是包含或排除邏輯。

Linux

v2rayN

依發行版的套件管理系統選擇 deb 或 rpm,再確認處理器架構是 x64 或 arm64。使用 v2rayN 搭配圖形桌面時,也要留意桌面環境如何儲存系統代理設定;同一台電腦上的瀏覽器、終端工具與背景服務,不一定會讀取相同的代理設定。

開始設定時,可先讓支援手動代理的應用程式連線到本機入站,以便分辨桌面設定問題與核心連線問題。需要使用 Tun 時,再處理虛擬介面權限及路由衝突。更換網路管理工具後若出現間歇性斷線,請一併檢查 DNS 指向與預設路由是否有所變動。

查看所有用戶端 →

快速入門 / FIRST CONNECTION

v2rayN 設定教學:先完成三個步驟

匯入資料、選擇入口、驗證連線;每次只調整一個設定層次。

STEP 01 / IMPORT

匯入訂閱或單一連線

安裝好用戶端後,還需要準備有權使用的連線資料。訂閱網址是取得一組項目的入口,單一分享連結則描述一條連線,兩者不能當成一般網頁網址任意混用。可在訂閱群組中新增網址並更新,或從剪貼簿匯入單一連結;完成後確認伺服器位址、連接埠、協定與傳輸設定是否符合來源資料。

請勿將訂閱連結貼到公開討論區,也不要在求助截圖中保留完整的存取參數。匯入後清單出現項目,只能表示資料已成功解析,不代表伺服器目前可用。若清單空白,先確認複製內容是否完整、訂閱是否需要更新,再處理代理模式,避免將資料取得失敗誤判為網路分流問題。

查看匯入步驟 →

STEP 02 / MODE

選擇連線與代理模式

選擇要使用的連線項目,啟動核心,再啟用適合目前應用程式的代理入口。初次驗證可從系統代理開始,讓遵循系統設定的瀏覽器連線到本機服務。路由模式決定流量接入後如何處理;系統代理則決定應用程式如何送出請求。兩者解決的問題不同,不能靠切換路由來補救應用程式未使用代理的情況。

先保留預設路由與 DNS 設定,不必急著啟用 Tun 或匯入大量自訂規則。如果電腦同時執行其他代理、VPN 或網路接管工具,先確認它們是否會爭用系統代理、監聽連接埠或預設路由。需要對照設定檔時,請著重檢查入站位址與連接埠、出口標籤,以及路由規則引用的標籤是否一致。

對照路由設定 →

STEP 03 / VERIFY

以實際請求驗證連線

使用同一個瀏覽器和同一個測試目標進行連線,再查看用戶端記錄是否出現對應請求。連接埠測試成功只代表某個連線環節可以建立,不代表完整代理連線已正常運作;實際連線還涉及協定、安全協商、DNS 與路由。測試失敗時,先查看記錄中的第一個明確錯誤,再決定要檢查連線資料、伺服器或本機入口。

若只有某個應用程式失敗,優先比較該程式的代理設定;若所有請求都失敗,再確認核心是否已啟動,以及目前選用的項目是否有效。每次只修改一項,並重複原本的測試,保留可正常運作的基準。準備提供排錯資訊時,可記下系統、用戶端介面類型、所選核心及錯誤片段,但請移除訂閱網址、使用者識別資訊與認證資料。

查看疑難排解問答 →
查看完整教學 →

開源生態 / PROJECT V

V2Ray、V2Fly 與 Xray 核心差異

用戶端是操作介面,核心是連線引擎,協定則是雙方遵循的規範。

搜尋「V2Ray 官方網站」時,容易將專案文件、核心發布頁面與用戶端下載頁面混為一談。本網站整理圖形用戶端的下載入口與中文使用說明,並非協定或核心專案的官方發布單位。了解各專案的職責,有助於找到合適的資料:安裝問題參閱用戶端說明,欄位行為查閱對應核心文件,連線參數則以服務提供者給的設定為準。

Project V 的模組化設定概念

Project V 生態中的 V2Ray 以入站、出站與路由等模組組織連線處理。入站接收本機或其他程式送來的請求,出站描述請求後續如何傳輸,路由則串連兩者。這種架構說明了為什麼「選擇一台伺服器」不代表設定已全部完成:還需要能接收應用程式流量的入口,以及將請求送往正確出站的規則。圖形用戶端將常用操作集中在視窗中,降低設定門檻,但底層仍遵循明確的配置關係。

閱讀 JSON 時,可先找出各模組的標籤與引用,再查看協定參數。沒有語法錯誤,不代表連線路徑符合預期;例如規則引用錯誤的出站標籤,或應用程式根本沒有連到本機入站,都可能導致無法存取。設定參考會依模組說明欄位用途,適合在基本連線完成後分段閱讀,不建議一次取代整份正在使用的設定。

V2Fly 與 Xray 的發展關係

V2Fly 社群延續 V2Ray 的開源開發與維護;Xray 則從相關程式碼基礎發展為獨立演進的核心專案,在協定、安全性與傳輸能力方面形成自己的實作。兩者共用部分概念與設定習慣,但並非只更換程式名稱就能完全互換。判斷某條連線需要哪種核心時,應一併確認協定、傳輸方式與安全選項,不能只根據「V2Ray」這類稱呼判斷。

例如,看到 VLESS 協定名稱時,還應確認是否搭配特定安全機制,以及所選用戶端能否為目前核心正確產生相應參數。核心支援某項功能,不代表每種用戶端介面都提供相同的設定入口。若匯入成功卻無法啟動,先比對產生的設定與核心要求,再決定修改連線項目或切換核心,通常比一再重新匯入更有效。

三款開源用戶端的職責範圍

v2rayN 適用於桌面環境,提供連線資料管理、系統代理、路由及多核心設定入口;v2rayNG 適用於 Android,主要搭配 Xray 核心提供連線與本機 VPN 接入;v2flyNG 適用於 Android,可作為 V2Fly 核心路線的替代選擇。三者都是以開源專案形式維護,但用戶端程式碼與所使用的核心是不同的軟體元件,發布週期、設定支援與授權範圍也應分別了解。

v2rayN 與 v2rayNG 用戶端採用 GPL 系列開源授權,V2Fly 與 Xray 核心則採用 MPL 系列開源授權;具體適用範圍請以各專案隨附的授權文字為準。開源表示程式碼與授權條件可以供人檢視,不代表任何訂閱來源都值得信任。用戶端也不會附帶可取代伺服器的連線資源,實際能否使用仍取決於連線資料、網路環境與伺服器設定。

分別檢查用戶端、核心與規則更新

用戶端更新可能調整介面、匯入行為或設定產生方式;核心更新可能變更協定支援與欄位行為;規則資源更新則可能改變目標比對結果。它們影響的層次各不相同,因此不宜用「都更新過了」取代排查記錄。更新前保留可用設定與必要選項,更新後先重新測試原有連線,再啟用新功能;若行為有差異,逐層比對較容易找出原因。

同樣地,訂閱更新只會從來源更新連線資料,不一定會更新用戶端程式、核心或本機自訂規則。回報問題時,說明更新的是哪一層,會比籠統地說「更新後不能用了」更有幫助。若環境中已有穩定可用的設定,可先閱讀變更說明,確認是否涉及目前使用的協定與系統,再安排更新和驗證,避免在一次測試中疊加多項變更。

近期文件 / READING NOTES

用戶端選擇與進階路由

建立基本連線後,再依實際需求補充相關知識。介面差異會影響安裝套件選擇,規則順序會影響流量去向,而路由器部署則涉及整個區域網路的閘道與 DNS。以下文章分別說明這些問題,方便從單機設定延伸閱讀到更具體的使用環境。

查看所有文章 →