Windows
v2rayN / Desktop · WPF
桌面版提供跨平台介面,經典 WPF 版則保留熟悉的 Windows 桌面操作方式。兩種版本都能管理訂閱、選擇使用中的節點及設定代理;依系統需求與介面使用習慣選擇即可,不必為了匯入同一份訂閱而同時安裝兩個版本。
首次啟動後,先確認節點清單與記錄是否正常,再啟用系統代理。若瀏覽器可以連線,但開發工具仍連不上,請檢查該工具本身的代理設定。程式能啟動、核心正在執行,以及應用程式流量確實經過代理,是三個需要分別確認的環節。
前往下載 →download
桌面端使用 v2rayN,Android 裝置建議優先選擇 v2rayNG。先確認作業系統與處理器架構,再前往下載頁選擇相應安裝套件;用戶端名稱相近,不代表安裝格式與核心功能完全相同。
v2rayN / Desktop · WPF
桌面版提供跨平台介面,經典 WPF 版則保留熟悉的 Windows 桌面操作方式。兩種版本都能管理訂閱、選擇使用中的節點及設定代理;依系統需求與介面使用習慣選擇即可,不必為了匯入同一份訂閱而同時安裝兩個版本。
首次啟動後,先確認節點清單與記錄是否正常,再啟用系統代理。若瀏覽器可以連線,但開發工具仍連不上,請檢查該工具本身的代理設定。程式能啟動、核心正在執行,以及應用程式流量確實經過代理,是三個需要分別確認的環節。
前往下載 →v2rayN / Apple Silicon · Intel
先在「關於這台 Mac」查看晶片資訊。Apple Silicon 對應 arm64,Intel 對應 x64;依處理器選擇磁碟映像檔,比只看電腦外觀判斷更可靠。安裝完成後,從「應用程式」資料夾啟動,並依系統提示處理首次開啟所需的權限。
匯入訂閱後,先透過系統代理測試瀏覽器連線,再考慮其他流量接管方式。終端機工具不一定會讀取桌面網路代理設定,可能需要另外指定代理位址。變更系統網路選項前請先記下原設定;退出用戶端時,也要確認代理設定已還原。
前往下載 →v2rayNG / Xray · v2flyNG / V2Fly
Android 裝置建議優先使用 v2rayNG;需要 V2Fly 核心時,可選擇 v2flyNG。多數較新的手機可選 arm64;不確定裝置架構時,先查看下載頁的套件說明。兩款應用程式的核心與選項並不完全相同,不能只因為分享連結可以匯入,就認定設定相容。
首次連線時,請確認已授予系統 VPN 權限。節點設定負責連線參數,應用程式分流則決定哪些應用程式納入接管範圍,兩者不是同一個開關。若切換至背景後連線中斷,請檢查電池最佳化與背景執行限制,再查看記錄是否有實際的連線錯誤。
前往下載 →v2rayN / deb · rpm
Debian、Ubuntu 等發行版通常選擇 deb,Fedora 等發行版通常選擇 rpm,並確認架構是 x64 或 arm64。安裝套件格式符合需求只是第一步,還要確認目前發行版的桌面環境與執行相依項目符合要求。圖形化用戶端必須在可用的桌面工作階段中啟動。
Linux 桌面的系統代理設定與終端機環境變數彼此獨立。建議先透過本機 SOCKS 連接埠測試連線,再設定桌面網路代理;需要使用 TUN 時,再檢查權限、路由與 DNS。逐層驗證可避免把桌面設定問題誤判為節點故障。
前往下載 →下載頁集中列出各平台的套件類型與適用說明。選好安裝套件後,回到快速入門教學繼續匯入設定,不必在首頁尋找特定檔案。
查看所有用戶端 →features
訂閱提供設定來源,代理模式決定流量入口,路由則決定流量出口。先釐清這三個層次,再視需求啟用 TUN 或切換核心。下方為設定項目示意,實際名稱與可用功能請以使用中的用戶端為準。
訂閱連結可批次取得節點設定,適合需要定期同步連線參數的情況。在 v2rayN 中先建立訂閱分組,填入網址並儲存,再執行更新,接著選擇使用中的節點。相較於逐一貼上分享連結,分組更方便區分來源,也能個別更新或停用。更新通常只會處理節點清單,不代表所有本機路由規則也會同步;刪除或覆寫前,請先保留需要的設定。訂閱網址可能含有存取權限資訊,請勿放進公開截圖、記錄或共用文件。
設定示意:先儲存分組,再從訂閱選單執行更新。
系統代理會將遵循系統網路設定的應用程式請求交給用戶端;全域、繞過中國大陸等路由模式,則決定已進入用戶端的請求使用哪個出口。兩者屬於不同層次,啟用全域路由不會自動接管所有程式。初次使用可先啟用系統代理,再選擇合適的路由預設,並透過瀏覽器測試。相較於 TUN,系統代理的影響範圍通常較容易觀察,但部分命令列工具和應用程式需要另外設定。退出用戶端前,請確認系統代理已清除或還原。
選單示意:系統代理不等於「強制所有應用程式使用代理」。
路由分流依條件將請求導向代理、直連或阻擋出口,適合同時存取本機資源與遠端服務。建議先使用用戶端預設,再針對少數明確需求新增自訂規則。相較於只切換全域模式,規則可細分至網域與 IP 範圍,但必須留意比對順序、DNS 解析與分類資料。通常先確認前面的規則是否已命中,再檢查出口標籤是否存在。每次只調整一類條件,並搭配記錄驗證,避免重疊規則堆疊成難以維護的設定。
規則示意:分類比對須由使用中的核心與相應規則資料支援。
TUN 模式透過虛擬網路介面接收流量,適用於不讀取系統代理設定的應用程式。與一般系統代理不同,TUN 在更底層接管流量,因此也牽涉權限、系統路由、DNS 與本機網路存取。建議先確認一般代理連線正常,再依平台說明啟用 TUN。若無法存取區域網路裝置或網域解析異常,請先停用 TUN 進行對照測試,再檢查繞過範圍與 DNS 設定。TUN 不是通用的連線故障修復開關,能否使用也取決於用戶端與執行環境。
選項示意,各平台的預設設定不一定相同。
用戶端負責介面與設定管理,核心負責實際的協定處理與流量轉送。v2rayN 可使用 Xray、V2Fly 等核心管理相應設定,但不同核心支援的協定參數與擴充功能並不相同。相較於只看用戶端名稱,確認節點需求與實際使用的核心,更能釐清相容性問題。匯入後若出現不支援的欄位,請先確認協定、傳輸方式與安全層的組合,再選擇相符的核心。切換核心可能改變設定解析與執行行為,請保留原設定並重新驗證連線。
選擇示意:實際支援的協定範圍以所用核心的實作為準。
quickstart
安裝完成不代表設定也完成。依照「匯入設定、選擇入口、驗證連線」的順序操作,每個階段只處理一類問題。即使某個步驟失敗,也能保留已確認正常的部分。
01 / import
先準備有效的訂閱網址或分享連結。v2rayN 從訂閱分組開始,儲存網址後執行更新;v2rayNG 則在訂閱設定中新增來源,再更新設定。只把網址貼進輸入欄還不算完成匯入,請返回清單確認設定確實出現,並手動選擇要使用的節點。
確認協定類型、伺服器連接埠、傳輸方式與安全層符合設定來源的說明。不要把網頁網址當成訂閱網址,也不要在更新失敗時一再刪除所有分組。先判斷提示是網址無法連線、內容無法解析,還是匯入後清單為空,再決定要調整更新方式或確認設定來源。
訂閱與單一節點分享連結的差別在於管理範圍:前者通常用來批次更新,後者則用來匯入單一設定。用戶端不提供遠端伺服器帳號,安裝軟體本身也不會建立可連線的服務。必須先有設定,才能繼續下一步。
訂閱匯入操作說明 →02 / connect
桌面端先啟用系統代理,讓遵循系統設定的應用程式連至本機監聽連接埠。Android 裝置啟動連線時,請依系統提示確認 VPN 權限。接著選擇適合目前用途的路由預設;路由預設會改變出口判斷,不會取代應用程式連上代理的步驟。
日常瀏覽可先使用常見的分流預設測試,同時存取本機資源與遠端網站,確認兩類請求是否都正常。開發工具、終端機與部分獨立應用程式可能不會讀取系統代理,請在各自設定中指定代理類型、位址與連接埠。沒有明確需求時,不必一開始就啟用 TUN 或疊加多組自訂規則。
本機監聽位址通常使用迴圈位址。只有確實需要讓同一區域網路中的裝置使用代理時,才評估開放監聽範圍與防火牆設定;「允許區域網路連線」並非一般本機使用的必要選項。
查看模式選擇步驟 →03 / verify
先用瀏覽器開啟可供測試的網頁,再確認用戶端記錄中是否出現相應連線。若工具提供連線測試,可作為輔助參考,但測試成功不代表每個應用程式都已使用代理。實際服務存取、網域解析與系統接管範圍仍須分別確認。
網頁無法開啟時,先檢查系統時間、節點設定與本機連接埠,再檢查系統代理、DNS 和路由。瀏覽器正常但終端機失敗,優先檢查終端機的代理設定;網域無法連線但以 IP 連線的測試正常,則應優先檢查解析路徑。每次只變更一項設定,記錄結果後再繼續,避免同時修改多項設定而難以判斷故障來源。
驗證完成後,再整理日常設定:保留可用的訂閱分組、記下常用路由模式,並了解退出用戶端後的系統網路狀態。日後更新或更換網路時,可依相同順序重新檢查,不必從頭重新安裝。
前往故障排除 →ecosystem
V2Ray 並非單一圖形化應用程式的名稱。了解 Project V、V2Fly、Xray 與三款用戶端之間的關係,有助於判斷設定應交由哪個程式處理,以及錯誤發生在哪個環節。
Project V 以模組化代理工具為基礎建立生態系,V2Ray 是其中廣泛使用的核心專案。核心負責組合入站、出站、路由與協定處理,圖形化用戶端則將這些功能整理成訂閱分組、節點清單與設定視窗。使用者按下連線後,實際處理網路請求的通常是用戶端啟動或整合的核心,而不是介面本身。
這也說明了為什麼同樣標示 V2Ray 的設定,在不同用戶端中可能有不同結果:用戶端的匯入解析方式、產生設定的邏輯,以及核心支援的參數都可能影響結果。排查時應分別確認「連結能否匯入」、「核心能否啟動」與「目標請求能否完成」,不要把三個環節混為單一連線狀態。
V2Fly 延續 V2Ray 的社群開發,Xray 則是在相關技術基礎上發展出的核心專案。兩者技術來源相近,也各自演進協定功能與設定行為。VMess、VLESS、Trojan 等名稱代表協定;WebSocket 等名稱代表傳輸方式;TLS、REALITY 等則涉及安全層,這些名稱不能互相替代。
選擇核心應以實際設定需求為準,而非只比較專案名稱。例如使用特定擴充參數時,須確認該核心確實支援相應組合;一般設定也不應為了切換核心而任意改寫安全參數。協定本身無法單獨決定速度,網路路徑、伺服器資源、傳輸方式與用戶端環境都會影響使用體驗。
v2rayN 提供桌面圖形化設定介面,支援本頁列出的三種桌面平台。v2rayNG 適用於 Android,採用 Xray 核心;v2flyNG 則提供以 V2Fly 核心為基礎的 Android 版本。這三款用戶端都是開源專案,但介面配置、匯入功能與核心整合方式各不相同,不能直接照搬某一款的選單路徑。
開源表示原始碼可依相應授權條款檢視、使用與參與改進,不代表用戶端內含遠端代理服務,也不表示任何設定都適合匯入。設定來源、應用程式權限與裝置執行環境仍須個別評估。一般使用者選擇符合平台與協定需求的用戶端,比同時安裝多款後混合修改設定更容易維護。
用戶端、核心與配套資料可能採用不同的開源授權。使用、修改或重新散布時,應分別閱讀相關專案的授權說明,不能以籠統的「開源」標籤取代具體條款。社群維護讓問題修正與功能持續演進;更新是否適合目前裝置,仍須依系統需求與變更說明判斷。
日常維護也要區分更新對象。更新訂閱通常會變更遠端提供的節點設定;更新用戶端可能改變介面與設定產生邏輯;更新核心則可能影響協定實作。網域與 IP 分類資料又屬於另一個層次。發生變化後,先確認更新的是哪個部分,再對照記錄重新檢查,可減少不必要的回復與重裝。
journal
完成基本連線後,再處理更具體的設定問題。以下三篇文章分別介紹協定機制、多裝置同步與自訂路由;先確認目前需求屬於哪個層次,再選擇相應的設定方式。
從 TLS 交握、內層加密冗餘與流量控制機制切入,說明 XTLS Vision 減少重複加密的原理,以及 REALITY 如何免去自備憑證。協定功能與實際連線條件應分開判斷,了解運作方式後再核對節點參數。
閱讀文章 →比較統一分發訂閱連結、分享連結與 QR Code、匯入匯出設定檔三種做法,說明如何在桌面與 Android 裝置間維持節點與規則一致。節點同步與本機設定同步的範圍不同,遷移前請先確認哪些內容需要分別備份。
閱讀文章 →說明 domain 前綴比對、ip 與 geoip 區段、geosite 分類的寫法,以及規則由上而下的命中順序與常見衝突的處理方式。適合已使用預設分流,並準備為特定服務新增規則的讀者。
閱讀文章 →