v2rayN
涵蓋 Windows、macOS、Linux 桌面用戶端,集中管理訂閱、伺服器與路由。
下載v2rayN 查看設定說明 →開源用戶端 · 下載與設定指南
整理開源用戶端的多平台下載入口與中文設定指南,從訂閱匯入到路由、DNS 和 TUN 設定。
選擇安裝套件
先確認作業系統,再確認處理器架構。桌面裝置可從 v2rayN 開始;Android 裝置優先查看 v2rayNG,需要 V2Fly 核心時再考慮 v2flyNG。安裝套件只是執行用戶端的起點,伺服器位址、連接埠、驗證資訊與訂閱連結仍須由服務提供者提供;也請確認已儲存的設定與所選核心相容。
v2rayN 提供跨平台桌面版與經典 WPF 版下載入口。初次安裝可先試用桌面版;習慣經典介面的使用者可參考 WPF 版說明。切換介面版本前,請先備份現有訂閱群組和路由設定,避免誤用不同資料夾中的設定。
前往下載 →v2rayN 依 Apple Silicon 與 Intel 晶片提供不同安裝入口。請先在「關於這台 Mac」查看晶片或處理器資訊,再選擇適用版本。首次啟動若出現系統安全提示,請先確認下載來源與提示內容,再依系統指示完成授權。
前往下載 →v2rayNG 使用 Xray,v2flyNG 使用 V2Fly。較新的裝置可先查看 arm64 套件;不確定處理器架構時,請參考通用版說明。首次連線時須確認系統 VPN 授權;若之後背景連線中斷,請檢查電池最佳化與背景執行限制。
前往下載 →v2rayN 提供 deb 與 rpm 安裝套件,並區分 x64 和 arm64。請依 Linux 發行版的套件管理方式選擇格式,再確認電腦架構。桌面環境是否讀取系統代理設定會影響應用程式的行為;啟用 TUN 前也須確認所需權限與虛擬網卡條件。
前往下載 →初次使用時,建議將服務提供者提供的訂閱連結、節點協定與適用用戶端說明放在一起確認。訂閱是發佈設定的方式,不等同用戶端帳號;成功匯入只表示內容可供解析,不能據此判定遠端伺服器已可連線。若只有單一分享連結,可先匯入該伺服器設定並測試連線,暫時不必建立複雜的群組。
若其他裝置已有設定,請勿直接逐項照搬。桌面系統代理、Android VPN 接管,以及不同作業系統的權限機制各不相同,個別設定須依裝置重新確認。先使用預設路由完成基本連線,再移轉自訂 DNS、分流規則與其他進階設定;若發生問題,也較容易找出是哪個步驟造成變化。
用戶端設定
用戶端會將底層設定整理成可操作的項目,但不同平台的選單名稱與功能範圍仍可能不同。以下依實際需求說明操作順序:先整理伺服器來源,再決定請求要走哪個出口,最後依應用程式是否遵循代理設定選擇接管方式。切換項目即可查看相應的設定情境。
訂閱可集中更新伺服器設定,適合節點內容會變動的情況。先在 v2rayN 建立訂閱群組、填入連結並更新,再確認協定、備註與可用狀態;Android 用戶端也應先檢查匯入結果。依來源分組可減少重複項目與誤選;手動修改的設定則建議另行保存,避免遭更新覆寫。與逐筆貼上分享連結相比,訂閱更容易維護;但解析成功不代表連線成功,仍須選取伺服器並測試實際請求。
路由會依網域、IP 等條件,決定請求使用代理、直連或其他出口,適合需要同時存取本機資源與遠端服務的情境。先使用用戶端內建的規則方案,再將確有需要的例外放在適當位置。相較於所有請求都走同一出口,分流能更精確地指定存取方式,但規則順序與解析策略也會影響結果。DNS 應配合路由調整;修改後請查看記錄,確認網域比對結果與實際出口,不要只憑網頁能否開啟判斷規則是否生效。
TUN 透過虛擬網卡接入流量,適合不讀取系統代理設定的應用程式。請先確認一般代理連線正常,再依系統要求授予權限並啟用 TUN,接著檢查本機網路、DNS 與目標應用程式。相較於系統代理,TUN 通常接管範圍更廣,但不代表所有流量都會經過遠端節點,最終仍由路由規則決定。若連線異常,請先關閉其他接管網路的工具,再檢查介面與路由是否衝突;要還原設定時,請關閉 TUN 並確認系統網路已恢復原狀。
核心負責實際連線與協定處理,圖形用戶端則負責管理設定與操作入口。v2rayN 可依設定需求使用相應核心;Android 版 v2rayNG 與 v2flyNG 則分別對應 Xray 和 V2Fly。比起只看用戶端名稱,確認實際使用的核心更能釐清協定與參數相容性問題。切換前請查看服務提供者的設定要求並保留可用設定;切換後重新啟動並測試。不同核心的功能並不完全相同,不要假設同一份自訂設定都能直接執行。
設定順序比設定項目多寡更重要。初次連線只要先確認伺服器設定、目前選取的項目與代理接管方式,路由和 DNS 暫時維持預設即可。瀏覽器可正常連線後,再檢查其他應用程式是否讀取系統代理;只有確實需要接管流量時,才進一步嘗試 TUN。每次只修改一項並記錄前後差異,比同時啟用多項功能更容易找出原因。
系統代理與路由模式是兩個不同層次的設定:前者決定應用程式是否將請求交給用戶端,後者決定用戶端收到請求後要選擇哪個出口。若已啟用系統代理,但某個應用程式完全不使用系統設定,調整網域分流規則通常無法解決流量接管問題;反之,若請求已進入用戶端卻走錯出口,就應檢查規則、解析結果與目前模式。
DNS 設定不只是挑選某個解析位址。首先要確認各網域要透過哪條路徑解析、解析請求本身要走代理還是直連,以及路由是否依賴解析後的 IP。有些問題看似伺服器無法連線,實際上可能出在網域解析。排查時先保留可用的基本設定,透過記錄分辨解析失敗或連線失敗,再針對問題調整 DNS 或出口設定。
若需使用 FakeDNS、自訂出口或多組訂閱篩選,建議先閱讀進階用法的完整章節。這些功能需要搭配其他條件,單獨複製一段設定容易遺漏前後脈絡。穩定運作的設定可作為回復基準;調整後請分別測試常用網站、本機資源與目標應用程式,確認符合預期再進行下一項。回報問題時保留錯誤類型即可,請先隱藏訂閱網址與驗證資訊。
開源核心生態系
Project V
代理核心與設定生態系
V2Ray 的社群維護方向
從 V2Ray 發展而來的核心分支
圖形用戶端會將伺服器、路由與 DNS 設定交由相應核心執行。
日常所說的「V2Ray」有時指代理生態系,有時特指核心程式。Project V 提供模組化的代理架構,V2Ray 是這個脈絡中的核心專案;V2Fly 延續 V2Ray 的社群維護,Xray 則從 V2Ray 發展而來,並在協定與功能上走出自己的演進方向。了解這層關係後,就不會把圖形用戶端名稱、節點協定與實際執行的核心混為一談。
v2rayN、v2rayNG 和 v2flyNG 都是供使用者操作的用戶端。介面中的新增伺服器、更新訂閱、選擇路由等操作,最後會轉換成核心可使用的設定。用戶端成功啟動,只能表示介面正在執行;核心是否啟動、設定是否通過,以及連線是否成功,仍須查看狀態與記錄。這也說明了為何介面看起來相同,切換核心後連線表現仍可能不同。
桌面裝置可優先考慮 v2rayN,適用於 Windows、macOS 與 Linux,方便透過圖形介面集中管理伺服器與訂閱。跨平台桌面版與經典 WPF 版的介面配置不同,既有使用者應依操作習慣與系統條件選擇,不要只看介面截圖判斷功能。跨系統移轉時,可先移轉伺服器資料,再分別確認系統代理、權限與 TUN 行為,避免把特定系統的環境設定當成通用設定。
Android 裝置可優先查看採用 Xray 核心的 v2rayNG;若現有設定明確要求 V2Fly,則可查看 v2flyNG。兩款用戶端都提供圖形介面,但核心功能與支援的設定範圍不應直接視為相同。尤其使用 REALITY 等功能時,請核對服務端提供的完整設定要求,不能只把協定名稱改成另一個選項。分享連結能成功匯入,也不代表目前使用的核心能正確處理其中所有擴充參數。
選擇用戶端時,可依序確認三件事:裝置使用哪個作業系統、現有節點要求哪個核心,以及常用應用程式需要哪種流量接管方式。前兩項決定安裝入口與相容性,第三項則決定連線後的使用設定。條件都符合時,就不必因名稱相近而頻繁更換用戶端。若只有單一節點無法使用,請先排查該設定與網路環境,不要直接歸咎於整款用戶端。
這三款用戶端均以開源專案形式發布,程式碼與修改紀錄可供社群討論與審查。v2rayN、v2rayNG 和 v2flyNG 採用 GPL-3.0 授權;V2Fly 與 Xray 的核心程式碼則採用 MPL-2.0 授權。用戶端與其呼叫的核心是不同軟體元件,分別遵循各自適用的授權。個人日常使用與修改後重新散布屬於不同情境;若涉及重新散布,請詳閱相關元件的授權條款與聲明。
開源說明的是軟體的開發與發布方式,無法取代對網路設定的個別判斷。實際請求會經過本機、服務端與目標服務;隱私與安全也取決於設定來源、存取協定及執行環境。訂閱連結可能包含可用的服務憑證,請像帳號資料一樣妥善保管;向他人求助時,不要在截圖中直接公開完整連結、QR Code 或驗證欄位。
社群維護通常涵蓋介面、核心相容性、作業系統支援與問題修正,各部分的更新時程可能不同,因此閱讀版本說明比單純追求「最新」更有幫助。先確認變更是否與自己的平台及設定有關,再決定是否更新。若環境依賴自訂路由或出口設定,請先保存目前設定,並以常用的存取情境測試新的執行組合。
用戶端更新會替換軟體程式,訂閱更新則會替換或補充伺服器設定,兩者解決的問題不同。新增協定支援、介面調整或系統相容性改善,通常屬於用戶端與核心更新;伺服器位址、驗證參數及服務端設定變更,則通常透過訂閱更新提供。只更新訂閱,不會讓舊核心自動支援新功能;只更新用戶端,也無法修復已失效的訂閱網址。
訂閱更新後,請先確認群組是否仍存在、目前選取的伺服器是否仍在,以及先前手動編輯的項目有沒有被覆寫。名稱相同的項目也可能已變更位址或傳輸參數,必要時請對照服務提供者的說明。若更新失敗,可分別確認連結是否有效、目前網路能否取得訂閱內容,以及用戶端是否支援回傳格式。尚未確認原因前,請勿反覆刪除所有群組。
更新軟體前,可先保存現有訂閱資訊與自訂設定;更新完成後,再確認目前核心、系統代理狀態與路由模式。系統重新啟動、權限變更或多個工具同時執行時,某些設定可能會改變,不能只看介面保留的開關狀態來判定實際流量路徑。用於描述問題的記錄應涵蓋一次完整的失敗過程,並隱藏位址、驗證欄位等敏感資訊。
設定與疑難排解指南
新手入門、訂閱異常與連線逾時需要不同的處理順序。先判斷問題發生在安裝、取得設定或實際連線階段,再選擇相應文章。記錄一次完整的操作流程與明確錯誤訊息,比反覆切換模式更有助於排查;已正常運作的設定請先保留,不必為了測試清空所有項目。
從 V2Ray 與 Xray 的關係談起,整理如何選擇用戶端、訂閱由誰提供,以及系統代理與 TUN 有何不同。適合已找到安裝入口,卻還不熟悉設定流程的使用者按順序閱讀,先建立基本概念,再完成首次連線。
閱讀文章 →更新結果為空、無法解析或沒有產生伺服器項目時,請先分辨是取得內容失敗,還是內容格式有問題。本文依序說明連結有效性、更新路徑、回傳內容與用戶端相容性,協助保留原有可用設定,同時找出更新失敗的環節。
閱讀文章 →從本機網路與系統時間開始,再檢查用戶端模式、節點參數、傳輸安全、DNS 與核心記錄。適用於連線逾時,也適用於顯示已連線卻無法開啟網頁的情況;請逐項調整設定,避免同時變更多個條件而失去判斷依據。
閱讀文章 →