v2rayN 提供採用新一代跨平台介面的桌面版,以及經典 WPF 版。首次安裝可先試用桌面版;若已習慣 WPF 介面,可依執行環境選擇。介面不同不代表訂閱服務有所差異,連線仍取決於設定內容與核心相容性。
若啟動異常,先檢查執行環境、目錄寫入權限與安全軟體提示,不要反覆覆蓋設定目錄。更新前先備份個人設定,並確認新介面中的監聽連接埠與原設定一致。
用戶端功能與設定入口
先確認裝置與核心,再設定訂閱、分流及流量接管。畫面僅供設定參考,實際名稱可能隨用戶端更新而異。
v2rayN 在同一個桌面介面中整合訂閱、伺服器設定、路由規則與執行記錄。安裝後先確認本機監聽連接埠,再匯入服務商提供的連結,選取要使用的設定並啟動核心。系統代理適合遵循系統設定的瀏覽器與應用程式;終端機工具則可另外指定代理位址。桌面版方便在不同系統間沿用操作習慣,但檔案路徑、網路權限與 TUN 授權仍須依各系統分別處理,不能直接套用另一台裝置的執行環境。
查看桌面版設定步驟 →v2rayNG 是採用 Xray 核心的 Android 用戶端,適合在手機上匯入訂閱、掃描分享連結的 QR Code,以及選擇路由模式。首次啟動連線時,系統會要求建立 VPN 連線;確認後,用戶端才能接管對應流量。與桌面系統代理不同,Android 通常透過本機 VPN 介面運作;若只想處理部分應用程式,可檢查依應用程式設定代理的選項。連線中斷時,先查看記錄與系統電池限制,再檢查訂閱,避免把背景程序遭暫停誤判為伺服器故障。
選擇 Android 安裝套件 →v2flyNG 適用於需要 V2Fly 核心的 Android 使用情境。選用時應考量設定與核心的相容性,而非介面是否相似。匯入前請核對通訊協定、傳輸方式與安全設定;某個欄位可在 Xray 中使用,不代表在 V2Fly 中也有相同意義或實作。若已有 v2rayNG 設定,請先保留原訂閱,再以少量設定測試匯入與連線。兩款 Android 用戶端應分別管理授權與設定,測試期間一次只啟動一款,降低 VPN 介面衝突的機會。
比較三款用戶端 →訂閱網址用來取得一組伺服器設定,與用戶端本身或單一分享連結並不相同。在訂閱群組設定中填入完整網址及方便辨識的備註,儲存後更新訂閱。更新成功只代表已取得設定,仍須另外測試能否連線。若更新失敗,先確認網址是否遭截斷、是否已過期,以及目前網路能否連上訂閱端點,再決定是否透過代理更新。訂閱連結可能包含存取憑證,不宜出現在公開截圖、聊天記錄或問題回報中。
查看訂閱更新排查方法 →路由規則會決定連線要直連、透過代理或封鎖,通常依序比對,先符合的規則先套用。初次設定可先略過區域網路與私人位址,避免影響印表機、路由器管理頁面與本機開發服務。若要依網域分流,再新增範圍明確的規則,並確認對應的出口標籤確實存在。DNS 會影響網域解析及部分規則的比對結果,因此排查分流問題時也要檢查 DNS 設定,不能只確認系統代理是否已啟用。
閱讀 routing 欄位說明 →TUN 模式透過虛擬網路介面接管流量,適合不讀取系統代理設定的應用程式,但無法修正錯誤的伺服器參數。建議先透過本機代理確認連線正常,再啟用 TUN,這樣排查範圍會更明確。桌面系統可能要求額外的網路權限或管理員權限;Linux 還須留意虛擬介面、路由表與 DNS 的變化。若啟用後區域網路存取異常,先停用 TUN 並還原網路狀態,再檢查略過規則,避免同時調整核心、DNS 與路由,導致問題難以重現。
查看模式選擇與測試方式 →用戶端下載與安裝
桌面裝置可使用 v2rayN,Android 裝置建議先了解 v2rayNG。安裝套件類型、處理器架構與用戶端核心是三種不同的選擇條件。
v2rayN 提供採用新一代跨平台介面的桌面版,以及經典 WPF 版。首次安裝可先試用桌面版;若已習慣 WPF 介面,可依執行環境選擇。介面不同不代表訂閱服務有所差異,連線仍取決於設定內容與核心相容性。
若啟動異常,先檢查執行環境、目錄寫入權限與安全軟體提示,不要反覆覆蓋設定目錄。更新前先備份個人設定,並確認新介面中的監聽連接埠與原設定一致。
v2rayN 安裝套件分為 Apple Silicon 與 Intel 架構。先在「關於這台 Mac」查看晶片資訊,再選擇相符的版本。首次開啟應用程式時,系統可能會要求確認開發者相關提示;網路與代理設定權限也須依實際提示授權。
安裝完成不代表系統代理已啟用。先啟動用戶端核心,再檢查代理模式與瀏覽器要求;遇到權限提示時,依教學逐項處理,不建議直接關閉系統安全機制。
v2rayNG 採用 Xray 核心,v2flyNG 則是 V2Fly 核心的備選方案。較新的主流手機通常選擇 arm64 套件;不確定裝置架構時,可先查看通用版說明。不要只因兩款用戶端名稱相似,就認定它們支援完全相同的通訊協定欄位。
首次連線時須確認系統 VPN 授權。若切換至背景後中斷,請檢查電池最佳化與背景執行限制;同時執行其他占用 VPN 介面的應用程式,也可能導致連線被取代。
v2rayN 的 deb 套件適用於採用相應套件管理系統的發行版,rpm 套件則適用於另一類發行版;此外還須區分 x64 與 arm64。選擇前先確認發行版、處理器架構與桌面環境,避免混淆套件格式與處理器架構。
Linux 上不同應用程式讀取代理設定的方式不盡相同。桌面代理、終端機環境變數與應用程式本身的代理設定應分別檢查;只有確實需要更全面地接管流量時,再考慮 TUN 模式與相關網路權限。
首次連線流程
用戶端負責讀取設定並啟動代理,不會自動提供可用的伺服器。請先準備有權使用的訂閱網址或分享連結,再依序操作。
首次測試時,設定盡量保持簡單:一個啟用中的設定、一種代理連線方式,以及一個明確的測試要求。連線穩定後再新增複雜的分流與自動更新;若發生問題,也更容易找出變更來源。
查看完整教學 →在訂閱群組中輸入完整網址,儲存後更新訂閱;單一分享連結則透過相應的匯入入口新增。看到設定項目後,請核對通訊協定、伺服器位址與傳輸設定。訂閱更新失敗與設定連線失敗發生在不同階段,應分別查看記錄,反覆更新訂閱並不能解決所有問題。
將要測試的設定設為啟用項目,再啟動連線。桌面裝置先使用系統代理或為應用程式指定代理;Android 裝置則須確認 VPN 授權。實際連線測試有助判斷目前設定是否可用,但結果會受到測試目標與網路狀態影響,不應只憑一次測試就刪除整組設定。
先用瀏覽器開啟測試頁面,再透過明確指定代理位址的命令測試要求。若瀏覽器可用、終端機不可用,通常應先檢查終端機是否已設定代理;若兩者都無法使用,再檢查核心記錄、本機連接埠與遠端連線。每次只變更一項設定,並保留可重現問題的操作順序。
Project V 開源生態系
介面負責管理,核心負責執行。了解兩者的分工,比只記住用戶端名稱更有助於選擇與排除問題。
圖形化用戶端
v2rayN · v2rayNG · v2flyNG代理核心系列
Xray · V2Fly實際功能取決於用戶端呼叫的核心及其設定支援。
Project V 是以網路代理功能為核心發展而成的開源專案生態系,V2Ray 則是其中常見的核心名稱。日常所說的「安裝 V2Ray」,實際上往往是安裝圖形化用戶端,再由用戶端管理代理核心。訂閱管理、系統匣選單與設定編輯屬於介面層功能;接收本機連線、建立對外連線與執行路由則由核心負責。釐清這兩個層次,才能判斷問題出在介面設定還是核心執行。
V2Fly 延續 V2Ray 相關開發,Xray 則是從 V2Ray 衍生並獨立發展的核心專案。兩者在部分通訊協定與設定概念上相近,但功能、欄位與更新步調不盡相同。尤其是 VLESS、REALITY 或部分傳輸選項,應確認目前使用的核心是否支援。REALITY 是與連線安全相關的技術,不能因為它經常與通訊協定名稱一起出現,就將它視為可任意互換的獨立代理通訊協定。
v2rayN、v2rayNG 與 v2flyNG 都是開源用戶端專案。桌面端的設定管理需求可優先考慮 v2rayN;Android 端則依 Xray 或 V2Fly 的相容需求,選擇另外兩款。開源代表程式碼與相關授權資訊可供查閱,不代表任何來源的訂閱都值得信任。用戶端、核心及隨附元件可能採用不同的開源授權;若涉及修改、再散布或重新打包,應分別閱讀對應的授權條款與發布說明,不能只憑用戶端名稱推斷所有相依項目的授權條件。
更新程式是更換用戶端元件;更新訂閱則是重新取得伺服器設定。前者不會自動延長服務期限,後者也不會補上核心缺少的功能。升級前記下原有的代理模式、連接埠、路由與 DNS 設定;升級後先測試基本連線,再逐步恢復進階選項。設定檔可能包含驗證資訊與訂閱網址,請妥善保管;提供記錄時先移除敏感內容,同時保留足以判斷問題的錯誤類型、發生時間與操作步驟。
先確認要編輯的是用戶端本身的設定,還是交由核心執行的設定。核心 JSON 中,inbounds 定義本機入口,outbounds 定義流量出口,routing 將規則指向出口標籤,dns 負責解析設定。欄位名稱相似,不代表不同核心之間可以完全互換。手動修改前請先備份原始檔案,再檢查 JSON 語法,並逐段測試功能;由用戶端自動產生的檔案,也可能在下次啟動時遭到覆寫。
設定與問題排除文章
遇到問題時,先確認故障階段:程式能否啟動、訂閱能否更新、核心能否連線,以及應用程式是否確實使用代理。