01 / DESKTOP
Windows
使用 v2rayN。下載頁提供新一代桌面介面與經典 WPF 介面兩類入口,適合想透過圖形介面管理訂閱、伺服器、系統代理與路由規則的使用者。首次安裝前先確認系統架構,並為設定目錄保留固定位置,避免移動目錄後找不到原有設定。
前往下載// INSTALLER INDEX · 中文文件
輸入 v2ray5.com,即可找到適用於 Windows、macOS、Android、Linux 的客戶端,並繼續閱讀訂閱匯入、代理模式與路由分流的中文操作說明。
// CLIENT CAPABILITIES
從訂閱匯入客戶端,到系統代理、路由分流與執行記錄,四個設定面板涵蓋日常使用中最常見的操作流程。這裡不將設定拆成孤立術語,而是說明每項設定解決的問題、適合調整的時機,以及變更後應觀察的結果。
select feature → read field note
路由分流可將不同網域、IP 網段或規則集合交由不同出口處理。常見做法是先保留客戶端提供的基本規則,再依實際需求增加少量自訂項目,並將較具體的規則放在較寬泛的規則之前。v2rayN 的路由設定可組合 domain、ip、geosite 等比對方式;調整時應一次只修改一組規則,儲存後透過執行記錄確認是否命中預期出口。與全域轉送相比,分流更適合長期使用,因為本機服務、區域網路位址與指定網站都能維持原有連線路徑。
routing.rules[].domain · routing.rules[].ip
訂閱管理處理的是設定批次匯入與後續更新。新增連結時先確認複製內容完整,再為訂閱設定容易辨識的群組名稱;執行更新後,伺服器項目才會寫入對應群組。並存多個訂閱時,不建議頻繁刪除再重新新增,而應保留穩定的群組結構,透過更新同步變更。若更新後清單為空,可依序檢查連結頭尾、網路連通狀態、訂閱群組是否啟用,以及記錄中的回應資訊。v2rayN 與 v2rayNG 的介面位置不同,但處理順序大致一致。
subscription.updateInterval · subscription.group
系統代理主要影響遵循作業系統代理設定的程式,適合作為桌面端的預設起點;部分不讀取系統代理的應用程式,則需要個別設定或使用 TUN。啟用任何模式前,都應先選取可用伺服器並確認核心已啟動。切換模式後不要只看按鈕顏色,還應檢查客戶端狀態、系統代理標記與實際請求是否一致。剛開始設定時建議盡量減少變數:先使用系統代理完成基本連線,再學習繞過規則與 TUN,遇到問題時也更容易判斷是伺服器、規則還是接管範圍造成的。
systemProxy · tunMode · inbound.socks
執行記錄不是附屬視窗,而是確認設定是否生效的第一手資訊。排查時先找到最近一次核心啟動記錄,再觀察設定載入、網域解析、建立連線與命中路由等階段。若客戶端介面顯示已啟動但請求仍失敗,應記錄錯誤發生的階段,而不是連續切換多個開關。常見線索包括連接埠遭佔用、訂閱內容無法讀取、系統時間偏差、DNS 回應異常,以及規則未命中。保留一次完整的重現過程,比只截取最後一行錯誤更有助於判斷問題來源。
logLevel: warning · routing decision · core startup
// PLATFORM ENTRY
桌面端統一從 v2rayN 開始,Android 端則依核心偏好選擇 v2rayNG 或 v2flyNG。點選平台入口後會進入下載頁,並自動切換至對應群組;檔案格式、架構差異與系統要求都會在群組內說明。
01 / DESKTOP
使用 v2rayN。下載頁提供新一代桌面介面與經典 WPF 介面兩類入口,適合想透過圖形介面管理訂閱、伺服器、系統代理與路由規則的使用者。首次安裝前先確認系統架構,並為設定目錄保留固定位置,避免移動目錄後找不到原有設定。
前往下載02 / DESKTOP
使用 v2rayN 桌面客戶端。安裝包分為 Apple Silicon 與 Intel 晶片版本,選擇前可在系統資訊中查看處理器類型。完成安裝後,需依系統提示授予必要的網路相關權限;若系統阻止首次啟動,應從系統設定的安全性區域確認應用程式,而不是反覆重新下載安裝包。
前往下載03 / MOBILE
優先選擇使用 Xray 核心的 v2rayNG;需要 V2Fly 核心時,可使用 v2flyNG。大多數近年裝置適合 arm64 安裝包,不確定處理器架構時可選擇通用版。匯入訂閱後仍需主動更新伺服器清單、選取一個項目,並確認系統的網路連線授權已生效。
前往下載04 / DESKTOP
使用 v2rayN,並依發行版的套件體系選擇 deb 或 rpm;裝置採用 ARM 架構時,還要對應選擇 arm64。安裝完成後先從終端機或應用程式選單確認客戶端能正常啟動,再匯入訂閱。若視窗能開啟但核心未執行,應優先查看執行權限、連接埠佔用與記錄路徑。
前往下載// QUICK START
首次使用時,將客戶端安裝、訂閱匯入與啟用代理分開完成。每個步驟結束後先確認結果,再進入下一步,可避免多個設定同時變更而無法定位問題。
桌面平台從 v2rayN 開始,Android 從 v2rayNG 開始。下載時先核對作業系統、處理器架構與安裝包格式,不要只根據檔名中的某個片段判斷。安裝完成後先啟動一次客戶端,確認主視窗、設定入口與記錄區域都能開啟。桌面端建議將設定目錄放在長期保留的位置;行動端則應允許系統要求的網路連線權限,以便後續建立本機接管介面。
如果程式沒有正常啟動,此時尚未匯入任何訂閱,排查範圍通常只涉及系統相容性、檔案權限或執行環境。先解決啟動問題,再繼續設定,比一開始就修改路由、DNS 與 TUN 更容易得到清楚結論。
在訂閱管理區域新增群組,貼上完整連結並儲存,然後執行一次手動更新。新增訂閱與更新訂閱是兩個動作:只儲存連結並不代表伺服器項目已出現在清單中。更新完成後檢查群組名稱、項目數量與更新時間是否符合預期,再選取一個伺服器作為使用中的項目。
若清單為空,先重新複製連結並檢查頭尾是否夾帶空格,再查看記錄中是否出現讀取或解析錯誤。多個訂閱應分別命名,以便日後判斷某個項目來自哪個群組。定期更新可以同步服務端調整,但沒有必要每次啟動客戶端時都刪除並重建群組。
桌面端可先啟用系統代理,Android 則在選取伺服器後啟動連線。不要將介面顯示為執行中直接等同於所有程式都已使用該連線:不同應用程式是否遵循系統代理、路由規則是否命中、DNS 是否按預期運作,都會影響最終結果。驗證時先使用一般網路請求確認基本連線,再逐步測試需要分流的網域與應用程式。
基本連線穩定後,再依需求調整繞過區域網路、規則模式或 TUN。每次只變更一項,並保留調整前可用的設定。若連線中斷,回到記錄查看最近一次變更後的啟動與路由記錄,而不是連續切換多個伺服器與模式。
// OPEN SOURCE ECOSYSTEM
V2Ray 通常用來概括一套開放的網路代理技術生態,而不只指某個圖形程式。早期 Project V 奠定了設定結構、協定實作與模組化處理方式,之後社群沿著不同維護路線形成 V2Fly 與 Xray 等核心家族。圖形客戶端負責將訂閱、伺服器清單、系統代理、路由規則與記錄入口組織成可操作的介面;真正執行連線、傳輸、路由與 DNS 處理的部分,則由所選核心負責。
理解「客戶端介面」與「核心」之間的界線,有助於排查問題。介面無法啟動時,通常先檢查作業系統相容性與程式權限;介面正常但核心啟動失敗,應查看連接埠、設定產生結果與執行記錄;核心正常而特定請求路徑不符合預期,則需要繼續檢查 DNS、路由規則與接管範圍。將所有現象都歸結為客戶端故障,容易忽略真正發生錯誤的層級。
協定、傳輸、路由與設定模型的開放實作體系。
延續 V2Ray 體系的社群維護路線,可由 v2flyNG 等圖形客戶端呼叫。
在相容常見設定概念的同時發展獨立能力,v2rayN 與 v2rayNG 常採用這條核心路線。
01 / CLIENT
v2rayN 適用於 Windows、macOS 與 Linux,集中管理訂閱群組、伺服器項目、系統代理、路由規則、DNS、TUN 與核心執行狀態。它的價值主要在於將結構化設定轉換成可重複操作的介面流程,並保留記錄與進階參數入口。對一般桌面使用者而言,先掌握訂閱更新、選取使用中的伺服器與系統代理三項操作,就能建立穩定的基本使用流程;需要精細分流時,再進入路由與進階設定。
02 / CLIENT
v2rayNG 是 Android 平台常見的圖形客戶端,通常搭配 Xray 核心執行。它將訂閱、分享連結、單筆設定、路由規則與本機連線控制整合在行動端介面中。行動作業系統會對背景執行、電池策略與網路連線權限進行額外管理,因此同一份伺服器設定在桌面端可用、在行動端表現不同,不一定代表協定參數發生變化,也應檢查系統是否限制背景程序或網路接管。
03 / CLIENT
v2flyNG 同樣服務於 Android,但採用 V2Fly 核心路線。它適合需要維持 V2Fly 設定習慣,或希望在同一平台比較不同核心行為的使用者。選擇客戶端時不應只看名稱相似度,而應確認核心家族、設定支援範圍與現有訂閱是否相符。一般使用者可先使用 v2rayNG;已有明確 V2Fly 需求時,再選擇 v2flyNG,避免在不清楚差異時反覆遷移設定。
三款客戶端與相關核心都屬於開放原始碼生態。開放實作意味著設定產生、協定處理與功能變更可以由社群討論與審閱,也讓不同客戶端能圍繞相同的基礎概念提供各自的介面。對使用者而言,更實際的判斷依據是專案維護狀態、文件完整度、系統相容範圍與更新記錄,而不只是依介面樣式或名稱選擇。
客戶端更新通常涉及介面、核心、規則資料或預設設定的變化。更新前應記住目前的客戶端類型與設定目錄位置,更新後先確認訂閱群組、使用中的伺服器與代理模式仍然存在,再檢查新增選項。跨客戶端遷移時,訂閱連結通常比手動複製整個設定目錄更穩妥;自訂路由與 DNS 規則則需要另行記錄,因為不同客戶端的介面欄位不一定完全對應。
核心能力會隨維護路線演進,客戶端也會調整可見設定項目。日常使用不需要頻繁追逐每個新增參數,穩定設定應以「能夠啟動、訂閱可更新、請求路徑符合規則、記錄沒有持續錯誤」為基本判斷。升級後遇到行為變化時,先閱讀客戶端變更說明,再比較升級前後的路由、DNS 與 TUN 設定,通常比直接重新安裝更容易找出差異。
// COMMON QUESTIONS
以下四項涵蓋首次安裝後最常見的判斷重點。更完整的訂閱、代理模式、節點測速與故障排除說明集中在疑難排解頁。
Windows、macOS、Linux 桌面平台優先選擇 v2rayN;Android 使用者通常先選擇採用 Xray 核心的 v2rayNG,已有明確 V2Fly 核心需求時再使用 v2flyNG。選擇依據應包括作業系統、核心家族與現有設定來源,而不是將三個名稱視為同一程式的不同安裝包。
新增連結後還需要執行訂閱更新。若更新後仍為空,應檢查連結是否完整、群組是否啟用、網路請求是否成功,並從記錄中尋找讀取或解析錯誤。尚未查看記錄前不要連續建立多個重複群組,否則會增加後續整理與定位的難度。
系統代理主要影響主動讀取作業系統代理設定的應用程式,設定簡單,適合作為桌面端起點。TUN 的接管範圍更廣,但也會引入路由、DNS、權限與虛擬網路介面等額外變數。建議先讓系統代理穩定運作,再依具體應用程式是否繞過代理來決定是否啟用 TUN。
顯示執行中只代表客戶端或核心程序已啟動,還需要確認使用中的伺服器、系統代理狀態、應用程式接管範圍、DNS 與路由規則。先用記錄判斷請求是否進入核心,再查看它命中了哪條規則與哪個出口。若記錄中沒有對應請求,問題通常位於應用程式代理設定或系統接管環節。
// LATEST NOTES
近期文章聚焦客戶端選型、路由規則優先順序與 v2rayN 介面結構。每篇只處理一個具體問題,方便從安裝流程進一步了解訂閱管理與進階設定。
從執行平台、核心家族、訂閱管理與路由功能四個面向比較三款客戶端,提供桌面端與 Android 端的預設選擇,並說明哪些情況適合改用 v2flyNG。
閱讀全文 →整理 domain、ip、geosite 三類比對語法,解釋規則由上至下的命中順序,以及具體規則與寬泛規則應如何排列。
閱讀全文 →依主視窗區塊介紹伺服器清單、訂閱群組、記錄面板與常用設定入口,為第一次開啟 v2rayN 的使用者建立完整的介面地圖。
閱讀全文 →