desktop / v2rayN
Windows
桌面端優先選擇 v2rayN。下載頁也會說明跨平台桌面版與經典 WPF 版的介面差異、適用系統及安裝方式, 方便新系統與既有設備分別選擇。
前往下載 →routing / rules
瀏覽器或系統流量會先進入本機監聽連接埠,接著由 routing 規則檢查網域、IP、協定類型與程序來源, 最後交給指定的 outbound。理解這條路徑後,系統代理、繞過區域網路、直連規則與遠端連線之間的關係會更清楚。
download / platforms
先依目前使用的系統進入對應分區,再根據處理器架構與使用習慣選擇用戶端。首頁僅負責平台導覽, 安裝套件類型、系統需求與具體下載入口統一在下載頁說明。
desktop / v2rayN
桌面端優先選擇 v2rayN。下載頁也會說明跨平台桌面版與經典 WPF 版的介面差異、適用系統及安裝方式, 方便新系統與既有設備分別選擇。
前往下載 →desktop / v2rayN
v2rayN 桌面版分別提供 Apple Silicon 與 Intel 架構入口。開啟系統資訊查看晶片名稱即可判斷, 下載頁也會說明首次執行、匯入設定與切換系統代理的位置。
前往下載 →mobile / v2rayNG
Android 端首選採用 Xray 核心的 v2rayNG,也可依核心偏好選擇 v2flyNG。主流裝置通常使用 arm64, 無法確認架構時,可閱讀下載頁的通用安裝套件選擇說明。
前往下載 →desktop / v2rayN
v2rayN 提供適用於常見發行版的套件,並區分 x64 與 arm64 架構。先確認發行版採用 deb 或 rpm, 再進入下載頁選擇對應架構,可減少安裝時的格式錯誤。
前往下載 →config / anatomy
一份設定由多個職責明確的頂層欄位組成。選擇左側目錄即可查看欄位用途、常見值、 圖形化用戶端中的對應設定位置,以及修改時最容易忽略的連動關係。
config > inbounds
inbounds 定義用戶端如何接收來自瀏覽器、系統或其他程式的流量。常見設定包含
listen、port、protocol 與 tag:
監聽位址決定哪些裝置可以連線,本機連接埠需要與系統代理設定一致,協定通常使用 SOCKS 或 HTTP。
在 v2rayN 中,這部分對應參數設定裡的本機監聽連接埠;在 v2rayNG 中,則對應本機代理與 VPN 服務入口。
修改連接埠後,也要同步調整手動設定代理位址的瀏覽器或應用程式,否則用戶端雖然啟動成功,流量仍不會進入核心。
config > outbounds
outbounds 描述流量離開本機後的處理方式。一份設定通常包含遠端代理、直接連線與攔截出口,
每個出口透過 tag 取得固定名稱,再由 routing 規則引用。遠端出口還會帶有協定、伺服器位址、
連接埠、使用者參數與傳輸層選項。圖形化用戶端匯入訂閱後會自動產生主要出口,使用者較常接觸的是目前伺服器選擇、
傳輸設定與核心切換。手動編輯時應先確認 tag 與路由規則一致,避免出口已存在卻沒有任何規則能夠引用。
config > routing > rules
routing 決定一段流量應交給哪個 outbound。規則可依網域、IP 網段、連接埠、網路類型、
入站 tag 或程序名稱進行比對,並透過 outboundTag 指向代理、直連或攔截出口。
v2rayN 的路由設定提供預設規則集與自訂規則入口,v2rayNG 則可在路由設定中調整網域策略與規則順序。
實際比對通常受規則順序影響,因此精確規則應放在寬泛規則之前;調整後要用日誌確認命中的規則與最終出口。
config > dns
dns 控制核心使用哪些解析伺服器,以及不同網域採用哪條解析路徑。常見設定包括伺服器清單、
hosts 對映、查詢策略與依網域指定解析器。它與 routing 緊密相關:網域先解析為位址後,後續 IP 規則可能繼續參與比對。
圖形化用戶端通常會將這些選項放在 DNS 設定、路由進階設定或自訂設定區域。排查網域能解析但連線異常的問題時,
應分別核對系統 DNS、用戶端 DNS 與路由網域策略,避免把三個層次混為一談。
config > log
log 用於設定存取日誌、錯誤日誌與輸出等級。日常使用可維持較低的輸出量,出現連線失敗、
路由誤判、連接埠衝突或訂閱產生異常時,再暫時提高日誌等級查看關鍵紀錄。v2rayN 與 v2rayNG 都提供日誌查看入口,
應重點確認監聽是否啟動、出站是否建立、網域解析是否回傳結果,以及 routing 最終選擇的 tag。
日誌可能包含伺服器位址與本機路徑,分享排查資訊前應先整理與問題直接相關的行列,並隱藏個人連線參數。
project v / ecosystem
圖形化用戶端、代理核心與設定資料屬於不同層次。釐清各層職責,才能正確理解用戶端更新、 核心切換、訂閱內容與路由規則之間的關係。
Project V 奠定了 V2Ray 設定模型與模組化網路工具的基本結構。設定檔將入站、出站、路由、 DNS、傳輸與日誌拆分為彼此關聯的模組,使用者可以透過 tag 將多個模組組合成清晰的資料路徑。 這種結構既適合手動維護 config.json,也方便圖形化用戶端根據訂閱與介面選項產生設定。 因此,圖形化用戶端介面中看到的伺服器、代理模式、路由預設與本機連接埠,最終都會對應到相應的設定欄位。
V2Fly 延續並維護 V2Ray 的核心能力,著重模組化設定與協定實作;Xray 則在相近的設定體系上發展出獨立核心, 並被多個用戶端用於連線與路由處理。兩者都不是圖形化用戶端本身,而是用戶端呼叫的底層核心。 同一款圖形化用戶端可以圍繞不同核心組織功能,同一份訂閱也可能因用戶端與核心的支援範圍不同, 在傳輸參數、路由能力或設定寫法上呈現細節差異。
v2rayN、v2rayNG、v2flyNG 以及相關核心均由開源社群持續維護。開源授權規定程式碼使用、修改與再發佈的界線, 也讓協定實作、設定解析與問題修復能由開發者公開審閱。對一般使用者而言,更實際的判斷標準是: 下載與目前系統相符的用戶端,閱讀更新說明,保留目前能正常運作的設定,並在升級後檢查系統代理、路由與核心狀態。
用戶端更新與核心更新不一定同時發生。介面程式負責訂閱管理、設定編輯、系統匣控制與系統整合; 核心負責協定連線、DNS、路由與流量處理。若某次更新只涉及介面配置,現有連線方式通常不會改變; 若包含核心或設定格式調整,則應重點檢查自訂路由、傳輸參數與舊設定的相容性。 日常維護時記錄用戶端類型、使用的核心與關鍵設定,比只記錄一個軟體名稱更有助於定位問題。
desktop
面向 Windows、macOS 與 Linux 的桌面圖形化用戶端,負責訂閱管理、伺服器選擇、系統代理、 路由預設、TUN 模式與日誌查看。桌面端需要完整控制系統網路設定時,優先從 v2rayN 開始。
android / xray
採用 Xray 核心的 Android 用戶端,提供掃描 QR Code、剪貼簿匯入、訂閱更新、分應用程式代理與路由設定。 已有 Xray 相關參數或需要對應協定能力時,可將其作為行動端的主要選擇。
android / v2fly
以 V2Fly 核心為基礎的 Android 替代用戶端,介面操作與常見訂閱流程相近。 需要沿用 V2Fly 設定體系或核對不同核心的表現時,可依實際設定需求選擇。
workflow / checklist
quick answers
先執行一次訂閱更新,再檢查訂閱群組是否啟用、連結是否完整,以及用戶端日誌中是否出現解析錯誤。 完整操作順序請參考訂閱匯入步驟。
系統代理主要接管遵循系統代理設定的應用程式;TUN 模式則透過虛擬網路介面處理更廣泛的流量。 選擇前請先閱讀TUN 模式章節。
先找出佔用本機監聽連接埠的程序,再修改用戶端的 SOCKS 或 HTTP 連接埠,並同步調整瀏覽器與其他應用程式的代理設定。 可查看連接埠衝突排查。
新系統可先考慮跨平台桌面版,若依賴經典介面與既有操作習慣,再比較 WPF 版。 具體差異整理於用戶端比較頁。
notes / latest
文章聚焦於可重現的問題:先說明觸發條件,再提供設定路徑、檢查方法與復原步驟。 涉及設定結構時也會解釋欄位職責,方便將圖形化介面操作對應到核心設定。
啟動用戶端時出現連接埠衝突,通常是常用監聽連接埠已被其他程式佔用。本文說明如何找出程序, 再於 v2rayN 參數設定中修改本機連接埠,並同步調整瀏覽器代理。
閱讀全文 →從下載、解壓縮、首次啟動到匯入訂閱,依序完成 Windows 端設定,並說明執行環境缺失、 系統代理未生效與用戶端版本選擇等常見問題。
閱讀全文 →拆解一份最小設定,說明入站如何接收本機流量、出站如何建立連線,以及 routing 如何透過 tag 將不同規則指向指定出口。
閱讀全文 →