v2rayN中文網 v2rayN 客戶端下載與設定教學

從訂閱管理、路由分流與系統代理著手,依平台選擇客戶端,再逐項完成設定。

桌面:v2rayN Android:v2rayNG / v2flyNG 核心生態:Xray · V2Fly · sing-box

CONFIGURATION LAYERS

訂閱、路由與核心設定

圖形介面負責整理設定,核心負責處理連線。分別檢查訂閱來源、流量入口與出站規則,比一次修改多項設定更容易找出問題。

依來源管理訂閱,避免覆蓋手動設定

訂閱網址用來取得一組伺服器設定,不等同單一伺服器位址。在 v2rayN 新增訂閱群組,填寫易於辨識的備註,再貼上完整網址並執行更新。不同來源分別建立群組,之後才能各自重新整理、停用或排查。相較於逐筆手動輸入伺服器參數,訂閱更適合持續管理多組設定;但更新時也可能移除來源端已刪除的項目。需要長期保留的手動設定應另行管理。若更新失敗,先查看記錄中的請求錯誤,再判斷是否需要透過現有代理更新。

訂閱群組設定
備註依來源命名
訂閱網址輸入完整連結
訂閱更新
啟用更新依群組設定
更新結果查看記錄確認

依無法上網、訂閱失敗與 DNS 異常等狀況查閱疑難排解手冊 →

CLIENT DOWNLOADS

依作業系統選擇客戶端

桌面端選用 v2rayN;Android 端可先了解 v2rayNG,需要 V2Fly 核心時再考慮 v2flyNG。安裝套件架構與設定協定是兩回事,請先選對裝置架構,再確認訂閱相容性。

Windows

v2rayN · Desktop / WPF

Windows 使用者可選擇桌面版或經典 WPF 版。桌面版採用新一代跨平台介面,WPF 版則保留經典桌面操作方式。兩者都應先確認系統需求,再依使用習慣選擇;若只是匯入同一份訂閱,無須同時執行兩個執行個體。

已有設定時,請先備份訂閱群組、路由與個人設定,再更換客戶端。安裝後確認本機監聽連接埠與系統匣中的系統代理狀態,避免瀏覽器仍指向舊執行個體。系統代理只影響遵循該設定的應用程式;曾單獨設定代理的程式,則需在程式內確認入口。若發生連接埠占用,應先關閉舊執行個體,不要接連修改多個連接埠。

macOS

v2rayN · Apple Silicon / Intel

macOS 使用者請先在「關於這台 Mac」確認晶片類型,再選擇 Apple Silicon 或 Intel 安裝套件。將應用程式移至「應用程式」資料夾後再啟動,方便後續管理。若系統顯示安全性提示,先確認檔案來源與提示內容,再到「隱私權與安全性」處理相應的開啟權限。

初次設定時,不要一次啟用所有接管方式。先匯入訂閱、選擇伺服器,再設定系統代理並以瀏覽器測試。若瀏覽器可連線、其他應用程式卻失敗,請確認應用程式是否使用獨立代理或略過系統設定;若所有請求都失敗,再查看核心記錄與網路權限。結束使用前清除不再使用的代理設定,可減少下次啟動時入口狀態不一致的問題。

Android

v2rayNG · Xray / v2flyNG · V2Fly

Android 端可優先選擇使用 Xray 核心的 v2rayNG;若需要 V2Fly 核心設定,可了解 v2flyNG。較新的主流裝置通常選擇 arm64;不確定裝置架構時,再查看通用安裝套件。兩款應用程式是獨立客戶端,安裝其中一款不會自動共用另一款的訂閱與路由設定。

匯入設定後,首次連線需確認系統的 VPN 授權。連線狀態代表本機接管已建立,不表示遠端伺服器一定可用。若背景連線容易中斷,請檢查電池最佳化、背景執行與省電策略;若設定依應用程式分流,也要確認目標應用程式是否包含在接管範圍內。不要讓多個同類 VPN 連線同時爭用系統入口;排查時先保留一個作用中的連線。

Linux

v2rayN · deb / rpm

Linux 桌面使用者可依發行版的套件管理系統選擇 deb 或 rpm,再確認處理器架構為 x64 或 arm64。套件格式相同,不代表各發行版的相依環境也相同;安裝時仍應留意套件管理器顯示的相依性提示。桌面捷徑、系統匣支援與系統代理入口,也可能因桌面環境而異。

安裝完成後,先手動啟動並確認訂閱更新與瀏覽器連線正常,再設定登入後自動啟動。圖形桌面的系統代理通常不會自動套用到終端機工具;終端機或開發工具需另外確認代理設定。若視窗已開啟但無法建立連線,優先確認核心是否成功啟動、監聽連接埠是否可用,以及設定目錄是否具有正常讀寫權限;不要以提高執行權限取代問題排查。

查看所有客戶端 →比較三款客戶端的適用情境 →

FIRST CONFIGURATION

從匯入訂閱到確認連線

首次設定時,先建立一條可測試的連線,再新增自訂路由與其他接管方式。每次只修改一個環節,並保留可還原的設定。

STEP 01 / IMPORT

匯入訂閱並確認伺服器項目

準備好設定服務提供者給的完整訂閱網址。在 v2rayN 的訂閱群組設定中新增群組,填寫備註與網址,儲存後執行更新。若取得的是單一分享連結,應使用對應的匯入入口,不要誤填為訂閱網址。Android 端可在 v2rayNG 的訂閱設定中進行相同操作,實際選單名稱請以目前介面為準。

更新完成後,確認群組中是否出現預期的設定,再選擇一個項目作為目前伺服器。訂閱只提供連線參數,不包含伺服器服務;免費客戶端與訂閱服務應分開看待。網址可能包含存取憑證,不應貼到公開留言或截圖中。若群組是空的,先查看更新記錄,確認是請求失敗、回傳內容無法辨識,還是來源本身沒有可用項目。

STEP 02 / ROUTE

選擇路由並設定應用程式流量入口

桌面端先選擇適合目前網路環境的路由預設,再啟用自動設定系統代理。路由預設控制進入核心後的請求如何出站;系統代理則決定哪些應用程式會把請求交給本機監聽,兩者不能互相取代。若需存取區域網路裝置,請確認私有位址規則,避免本地連線被誤送至代理出站。

初次設定時,可先使用遵循系統代理的瀏覽器進行測試,無須同時啟用其他接管方式。Android 端則需確認 VPN 授權,並檢查依應用程式代理的範圍。若已安裝瀏覽器代理擴充功能、其他代理客戶端或網路過濾工具,應逐一確認是否發生入口衝突。暫時只保留最少的作用中設定,確認可用後再逐步恢復日常設定;這比同時切換多種模式更容易找出差異。

STEP 03 / VERIFY

確認網頁、DNS 與結束連線後的狀態

連線後先開啟常用網頁,再造訪一個應直連的網站或區域網路服務,分別確認代理與直連路徑。不要只憑系統匣圖示、連線按鈕或單次測試結果,就判斷所有功能正常。若只有特定網域失敗,請查看該請求套用的路由、解析伺服器與解析結果;若所有網站都無法連線,先檢查系統代理、本機監聽與核心啟動狀態。

記下可重現問題的應用程式、網域與發生時間,再對照記錄中的錯誤。依入口到出站的順序排查:應用程式設定、本機連接埠、目前伺服器、路由、DNS。每次修改後都重複相同測試,避免結果無法比較。結束使用時,請清除系統代理或關閉相應的接管方式,再退出客戶端;若退出後網頁無法開啟,先確認系統是否仍保留指向本機的代理位址。

PROJECT V / CORE / CLIENT

Project V 生態系與客戶端分工

客戶端、核心與協定名稱經常同時出現,但各自負責的工作不同。了解這三個層次的關係,才能判斷設定應在圖形介面中修改,還是需要參閱對應核心的設定說明。

Project V、V2Fly 與 Xray

Project V 是圍繞代理通訊與網路設定所形成的開源專案生態系,V2Ray 是其中廣泛使用的核心專案。V2Fly 延續相關社群的維護工作,Xray 則從這個技術脈絡發展出獨立實作與擴充功能。它們有部分共通概念,但支援能力、欄位意義與更新節奏並不完全相同。閱讀標示為 V2Ray 的教學時,仍須確認範例適用的核心,不要只因名稱相近就直接套用。

VMess、VLESS、Trojan 屬於連線協定的概念;傳輸方式與安全層則是其他設定面向。客戶端列出某種協定,不代表任意欄位組合都能運作;客戶端是否能匯入、核心是否支援,以及伺服器參數是否相符,都必須分別確認。排查交握或設定載入錯誤時,保留原始參數的意義,比反覆切換協定名稱更重要。

三款開源客戶端各自的定位

v2rayN 面向桌面環境,提供訂閱、伺服器、路由與系統代理的圖形管理入口,並支援搭配 Xray、sing-box 等核心。v2rayNG 面向 Android 裝置,使用 Xray 核心處理連線;v2flyNG 同樣面向 Android 裝置,提供以 V2Fly 核心為基礎的另一種選擇。三款客戶端都是開源專案,但並非同一個應用程式在不同裝置上的簡單改名,介面操作、匯入支援與背景執行行為都各有差異。

客戶端負責將使用者設定整理成核心能辨識的內容;核心則負責協定處理、路由與實際連線。sing-box 有自己的設定結構,不應直接將 Xray JSON 當成它的設定使用。選擇客戶端時,先考量作業系統與目前的設定需求,再比較介面與維護習慣。頻繁更換客戶端,無法解決訂閱來源失效或伺服器參數不一致的問題。

開源授權與設定來源

開源表示專案程式碼依相應授權條款公開;使用、修改與再散布仍須遵守各自的授權條件。客戶端、核心及其相依項目可能採用不同授權,請詳閱各專案隨附的授權檔案。程式碼公開不代表所有發行檔、訂閱來源與網路環境都同樣可信,也不表示所有設定預設都適用於目前裝置。使用者仍須了解安裝來源與設定內容。

這三款客戶端都可免費使用,但執行客戶端與取得遠端服務是兩回事。訂閱網址可能包含帳戶識別資訊,伺服器設定也可能帶有驗證資料。分享疑難排解記錄前,應移除訂閱網址中的敏感參數、驗證欄位與個人瀏覽記錄。文件中的設定片段僅用於說明結構,不能取代服務提供者交付的有效連線參數。

社群維護與更新順序

客戶端與核心由各自社群持續維護,介面調整、協定支援與設定相容性可能分別變動。更新前先閱讀變更說明,備份訂閱群組、自訂路由與必要的個人設定。更新後先確認客戶端能正常啟動,再測試核心載入、訂閱更新、常用網頁與區域網路存取。不要將軟體更新、訂閱重新整理與路由重寫合併成同一次操作,否則發生問題時很難判斷原因。

目前設定穩定可用時,可依實際需求安排更新,不必只比較名稱或發布日期。若教學中的選單與介面不同,先依設定對象尋找相應功能,再參閱客戶端與核心文件。本網站提供下載選擇與中文設定說明,不提供訂閱帳戶或遠端伺服器;連線是否可用,仍取決於本地網路、伺服器狀態以及雙方參數是否一致。

查看 v2rayN、v2rayNG 與 v2flyNG 的比較評測 →

CONFIGURATION NOTES

近期設定與疑難排解文章

依照實際症狀查閱文件。先確認請求經過哪個入口,再逐層檢查解析、規則與出站,不要把單一錯誤一概歸咎於客戶端。

進階設定

V2Ray DNS 設定詳解:中國大陸與海外分流解析及防污染設定

說明 V2Ray dns 模組中 servers、domains 與 expectIPs 的寫法,介紹中國大陸網域使用本地解析、海外網域使用遠端解析的分流方式,以及實用的防污染設定。

重點在於區分「網域交由哪個伺服器解析」與「連線經由哪個出站送出」。網域規則、解析結果篩選與 IP 路由是不同環節。修改前先記錄目前的解析路徑,再以相同網域重新測試,避免只更換解析伺服器,實際請求路徑卻沒有改變。

閱讀文章 →
疑難排解

v2rayN 顯示已連線卻無法開啟網頁:逐項檢查清單

代理已啟用但網頁載入失敗時,依序確認系統代理狀態、連接埠占用、節點是否可用、時間是否同步、路由模式與 DNS,找出問題所在。

連線圖示只能反映部分本機狀態。文章從應用程式是否將請求交給客戶端開始,逐步排除監聽、遠端連線與解析問題,並說明每個步驟應觀察的結果。使用同一個測試目標,能更清楚判斷設定變更是否真正生效。

閱讀文章 →
進階設定

V2Ray 設定檔 JSON 結構解析:inbounds、outbounds 與 routing 各區段說明

逐段解讀 V2Ray 設定 JSON:log、inbounds 本機監聽、outbounds 出站與 freedom/blackhole、routing 規則比對順序,並搭配可供對照的範例片段。

適合已使用圖形客戶端、想進一步了解產生之設定的使用者。先釐清入站接收、路由比對與出站處理之間的完整關係,再閱讀個別欄位。尤其要留意 tag 引用與規則順序,避免語法正確卻沒有比對到預期的出站。

閱讀文章 →

查看所有文章 →