開源用戶端下載與設定說明

V2Ray開源網·
v2rayN 用戶端下載與設定

依裝置選擇用戶端,逐項確認訂閱匯入、路由分流與DNS 設定。

永久免費原始碼開放中文設定指南
  • v2rayN · 訂閱分組設定
    備註日常訂閱
    網址https://example.com/sub?token=xxxx
    啟用更新已啟用
    篩選關鍵字香港|日本

    訂閱分組

    分別管理網址、更新與伺服器篩選條件。

  • v2rayN · 路由規則
    比對條件出站
    geosite:category-ads-allblock
    geoip:privatedirect
    geosite:cndirect

    路由規則

    依網域與位址,為連線選擇出站方式。

  • v2rayN · DNS 設定
    遠端 DNShttps://1.1.1.1/dns-query
    直連 DNSlocalhost
    網域策略IPIfNonMatch

    DNS 設定

    同時確認解析伺服器與請求路徑。

  • v2rayN · TUN 模式
    啟用 TUN已啟用
    系統代理清除系統代理
    堆疊gvisor

    TUN 模式

    接管系統流量前,請先確認權限與網路堆疊。

平台與安裝套件

用戶端下載入口

桌面裝置建議選擇 v2rayN,Android 裝置則可優先查看 v2rayNG。先確認作業系統與處理器架構,再選擇安裝套件;套件格式決定安裝方式,核心則決定協定與傳輸支援,兩者應分開判斷。

初次設定建議先使用一般系統代理。匯入現有訂閱,選取一筆伺服器記錄,確認核心能否啟動,再測試應用程式的連線是否經過用戶端。基本連線正常後,再逐步調整規則與 DNS,避免一次變更多項設定,難以判斷問題來源。

下載用戶端與設定連線是兩個不同步驟。安裝用戶端不會自動建立可用的伺服器記錄;訂閱網址、節點參數與授權資訊,必須由使用者現有的服務設定提供。此處的示意網址僅供說明欄位位置,無法用來建立實際連線。

查看所有用戶端 →

Windows · v2rayN

桌面版採用跨平台介面,傳統 WPF 版則保留熟悉的 Windows 操作配置。兩者都以伺服器清單、訂閱分組與連線設定為核心;選擇時先考量系統需求與使用習慣,不必因介面不同而重新建立訂閱。

安裝後先確認本機監聽連接埠,再設定系統代理。如果瀏覽器可以連線,某個應用程式卻不行,請檢查該程式是否會讀取系統代理,或是否提供自己的代理設定。此時先找出流量入口,通常比反覆更換節點有效。

啟用 TUN 前,請再次確認系統管理員權限與其他網路工具。退出用戶端後,如果系統網路行為未恢復,請確認系統代理是否仍指向已停止的本機連接埠。

前往下載

macOS · v2rayN

請依裝置晶片選擇 Apple Silicon 或 Intel 安裝入口。可在系統的裝置資訊中查看晶片名稱;前者對應 arm64,後者對應 x64。選擇正確架構可減少相容層造成的不確定性,也方便依下載頁說明排查啟動問題。

用戶端啟動後,還需要另外確認目前網路服務的代理設定。切換無線網路、使用外接網卡或連接其他網路工具後,生效中的網路服務可能改變;不能只憑用戶端的按鈕狀態,就認定所有應用程式都已使用代理。

遇到系統安全性提示時,先確認安裝套件來源與提示內容,再依下載頁說明處理。不要只為了啟動單一程式,就全面關閉系統安全機制。

前往下載

Android · v2rayNG

v2rayNG 使用 Xray 核心,適合常見的 Android 訂閱匯入與連線管理。v2flyNG 則採用 V2Fly 核心,可作為替代選項;是否適用取決於現有節點設定,而不是用戶端名稱是否相近。下載頁依此順序提供入口。

多數裝置使用 arm64;若不確定架構,請先查看系統資訊或選擇通用套件。匯入訂閱後,首次啟動時需要授權系統 VPN 連線要求。這是用戶端接管應用程式流量的系統入口,與桌面系統代理的運作方式不同。

如果鎖定螢幕後連線中斷,請先檢查電池最佳化與背景執行限制。也要確認是否有其他應用程式占用同一個 VPN 連線入口,再判斷是背景程序遭終止,還是伺服器連線失敗。

前往下載

Linux · v2rayN

依發行版的套件管理方式選擇 deb 或 rpm,並確認架構是 x64 還是 arm64。圖形桌面環境、系統相依套件與網路權限都會影響使用方式;安裝成功後,先確認介面能正常啟動、核心能正常載入,再調整流量接管方式。

圖形桌面的系統代理設定不一定會被所有程式讀取。有些應用程式需要另外指定本機 HTTP 或 SOCKS 入口,因此若出現「瀏覽器正常、其他程式異常」,應先查看應用程式本身的代理設定。

TUN 涉及虛擬網卡、路由表與權限。若裝置已有容器網路、虛擬機器網路或其他通道工具,建議先記錄原有設定,並在每次變更後確認本機網路與預設路由是否符合預期。

前往下載

設定說明閱覽區

先查看重要欄位,再了解設定影響。以下是局部範例,並非可直接取代用戶端設定的完整檔案。圖形介面的欄位名稱可能因平台與核心而異,設定時請對照實際記錄與產生的內容。

備註:日常訂閱
網址:https://example.com/sub?token=xxxx
啟用更新:是
篩選關鍵字:香港|日本

訂閱分組會將網址、備註與更新行為集中管理,適合整理多個來源。先為分組命名,再匯入網址並更新,確認伺服器記錄已加入預期分組。篩選關鍵字支援正規表示式,但篩選結果取決於節點名稱;範圍設得太窄,更新後的清單可能看起來是空的。相較於逐筆手動新增,分組更新更容易隨來源變動,也可能覆寫手動修改。需要長期保留的自訂記錄應分開管理,並在更新前確認影響範圍。

這些設定有前後關係:訂閱提供伺服器記錄,核心載入連線參數,路由決定出站方式,DNS 為網域提供位址,系統代理或 TUN 則決定應用程式流量如何進入用戶端。排查時沿著這條流程逐項檢查,比一次重設所有設定更能保留有效資訊。

閱讀設定範例時,也要分清用戶端選項與核心欄位。訂閱備註、篩選關鍵字屬於設定管理;路由規則與 DNS 片段則由用戶端產生或傳遞給核心。直接把介面文字當成 JSON 欄位使用,可能導致設定無法解析。若需要完整操作流程,可繼續閱讀進階設定手冊。

用戶端與核心

Project V 開源生態系

V2Ray 是 Project V 生態系中的網路代理工具,核心職責是處理協定、傳輸與路由。日常使用者更常接觸的 v2rayN、v2rayNG 與 v2flyNG,則是提供操作介面的用戶端,負責搭配核心運作。它們將伺服器參數、訂閱更新與啟動控制集中管理,讓設定不必完全仰賴手動編輯。

這種分層能解釋一種常見情況:用戶端可以正常開啟,核心仍可能啟動失敗。圖形介面負責管理設定,核心負責讀取設定並建立連線;兩者的執行狀態不能互相取代。遇到錯誤時,應先確認錯誤來自介面、設定產生過程,還是核心輸出,再決定是否調整節點參數。

V2Fly 與 Xray:背景相近,支援情況分別確認

V2Fly 延續 V2Ray 的社群維護工作;Xray 則以相關程式碼為基礎,發展出另一條核心分支。兩者共用部分概念與使用習慣,但協定功能、傳輸能力與設定細節並非始終一致。討論「V2Ray 核心差異」時,應聚焦於具體欄位與功能,而不是將整個生態系視為可任意互換的單一程式。

節點名稱只是一段備註,無法完整描述連線需求。以 VLESS 設定為例,還需要確認傳輸方式、TLS 或 REALITY 等安全層設定,以及相關參數是否與伺服器端一致。選擇用戶端前,先了解現有設定所需的核心功能;現有連線穩定時,也不必只因另一個分支名稱較新就立即遷移。

三款用戶端:分別依平台與設定需求選擇

v2rayN 適用於桌面環境,提供伺服器清單、訂閱分組、路由管理與多核心設定入口,方便使用者透過圖形介面集中管理連線。跨平台介面讓不同桌面裝置的操作方式更接近,但系統代理、權限與網卡處理仍由各作業系統決定,不能假設所有平台的行為完全相同。

v2rayNG 適用於 Android,使用 Xray 核心處理連線,並透過系統 VPN 介面接收應用程式流量。使用時應留意訂閱匯入、作用中節點選擇、應用程式分流與背景執行限制。v2flyNG 同樣適用於 Android,但採用 V2Fly 核心;若節點符合該核心的支援範圍,可作為替代選項,而不是用來將所有節點轉換成另一種協定。

這三款用戶端都以開源專案形式維護。開源代表程式碼與修改過程可供討論與檢視;免費使用則是另一回事,與伺服器資源無關。用戶端本身不提供訂閱服務,也不會決定伺服器端線路品質;遇到速度、流量額度或節點地區問題時,需分別檢查用戶端設定與現有服務設定。

開源授權:了解程式碼的使用條件

開源授權規範程式碼的使用、修改與散布方式。V2Fly 的 V2Ray 核心與 Xray 核心採用 MPL 2.0;v2rayN、v2rayNG 與 v2flyNG 用戶端則採用 GPL 系列授權。用戶端與核心是不同專案,散布軟體或修改程式碼時,應分別閱讀相關專案的授權條款,不能只看外層用戶端的名稱。

對一般使用者而言,了解這點有助於釐清來源與界線:用戶端由社群維護,核心也有各自的演進步調,本網站則負責整理中文下載與設定說明。文件中的範例用來解釋設定含義,不代表特定節點、線路或設定在所有環境下都會得到相同結果。

更新順序:保留基準,再驗證變更

用戶端更新可能涉及介面調整、設定產生邏輯與隨附元件;核心更新則可能影響協定處理與欄位支援。兩者彼此相關,但不應視為完全同步的版本體系。首頁著重於選擇與使用方式,具體安裝入口與最新發佈資訊則集中在下載頁,方便一併確認平台與套件格式。

更新前記下目前使用的核心、作用中節點、路由方案與本機監聽連接埠,並備份必要設定。更新後先用原本可正常運作的節點測試基本連線,再確認訂閱更新、分流與 DNS。如果發現差異,查看記錄中最早出現的錯誤行,判斷原因是設定欄位變動、權限改變,還是應用程式未使用新的代理入口。

不要在同一次測試中同時更換用戶端、核心與伺服器,還啟用 TUN。每增加一項變更,判斷原因就多一層不確定性。保留一組已知可用的基準設定,一次只修改一項,才能讓排查結果更容易重現,也方便還原正常狀態。

四種常見的設定排查情境

訂閱更新失敗。先確認網址沒有被截斷,再檢查要求記錄中的狀態與回應內容。如果本機已有節點,可以分開測試匯入問題與既有連線是否可用。詳細步驟請參閱訂閱更新疑難排解。

瀏覽器正常,其他應用程式異常。先確認應用程式使用哪種代理入口。系統代理不是接管所有網路流量的開關;若需要接管更多流量,再參照TUN 模式說明檢查權限與網路堆疊。

網域連不上,位址卻能連線。優先檢查解析路徑、回傳結果與路由網域策略。透過位址能連線,不代表所有 DNS 設定都正確;可參考DNS 設定章節,區分解析失敗與連線失敗。

協定名稱相同,卻無法匯入。繼續確認傳輸方式、安全層與參數格式。有些資訊編碼在連結中,有些則由訂閱產生;名稱相同不代表設定完全一致。請先閱讀VLESS 名詞解釋,再查閱核心對照。

設定原理與疑難排解文章

快速入門協助掌握操作順序,專題文章則說明背後的網路行為。需要找出複雜問題時,先確認流量在哪一層中斷,再選擇相應文章;不要把路由器部署、核心相容性與節點速度測試混為同一個問題。

查看所有文章 →