下載頁分別列出 v2rayN 桌面版與經典 WPF 版。桌面版採用跨平台介面;若已習慣舊版操作,或正在參照舊版教學,可先查看經典 WPF 版的說明。兩者介面位置可能不同,請依功能名稱尋找訂閱分組、路由和系統代理,不必逐項比對截圖。
下載前,請前往「設定 → 系統 → 關於」確認系統類型。首次連線時,可先選擇一台伺服器,再用會讀取系統代理設定的瀏覽器測試;若要讓其他應用程式也走代理,再考慮使用 TUN。退出後若系統仍嘗試連線至本機代理,請檢查系統代理是否已還原。
設定圖層
訂閱決定伺服器清單的來源;系統代理或 TUN 決定哪些流量會進入用戶端;路由則決定這些流量要往哪裡走。遇到問題時,分別檢查這三個環節,比一次重設所有選項更容易找出原因。
訂閱分組 → 訂閱分組設定 → 添加
將不同來源的訂閱分開儲存,並為每個分組取容易辨識的別名。更新前先選取目標分組,再使用更新目前訂閱的功能;只有需要一次全部更新時,才選擇更新全部。與逐筆貼上伺服器不同,更新訂閱會重新讀取來源回傳的清單,手動修改的項目可能遭到覆蓋。需要長期保留的手動設定,請另外儲存。更新失敗時,先確認提示是下載錯誤還是內容無法解析,再決定是否調整設定。
查看訂閱與伺服器篩選說明"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
這段規則會將符合指定網域集合的請求交由名為 direct 的輸出處理;若要使用,設定中必須定義對應的輸出,並備妥所需的規則資料。路由不是系統代理開關:應用程式的流量進入核心後,才會依規則順序進行比對。請將較具體的例外規則放在通用規則之前,每次只修改一處,再分別用應直連和應走代理的位址確認結果。若請求落入預設輸出,先確認收到的是網域還是位址。
"dns": {
"servers": ["https://1.1.1.1/dns-query"]
}
這段設定會為核心指定一個 DNS over HTTPS 解析端點,不會自動變更所有應用程式的解析設定。若瀏覽器啟用了安全 DNS,仍可能使用自己的解析器。排查網域連線異常時,先確認應用程式是否將網域交給用戶端,再檢查核心能否連上解析端點,並記下受影響的網域。不要同時更換解析端點和路由策略,否則即使問題解決,也很難判斷是哪項調整生效。
查看 DNS 設定章節啟用 Tun · 清除系統代理
系統代理仰賴應用程式主動讀取代理設定;TUN 則透過虛擬網路介面接收系統路由導入的流量。先確認目前平台支援此模式,並完成所需的系統授權;接著關閉其他流量接管工具,再啟用 TUN,並確認目標應用程式與區域網路是否正常。若關閉 TUN 後故障消失,請先檢查虛擬介面、預設路由和區域網路例外,不必直接重裝用戶端或更換訂閱。
查看 TUN 設定與排查說明核心類型 · Xray / v2fly
匯入伺服器後,先確認協定、傳輸方式與安全機制,再判斷目前的核心是否能處理這些欄位。即使兩種核心都辨識某個協定,支援的具體組合和設定欄位也未必相同。切換前先保留原本的選項與設定,只測試一台伺服器,並查看啟動記錄是否出現未識別欄位。若啟動失敗,先處理記錄中的設定問題;清單顯示項目,不代表設定一定相容。
比較 Xray 與 V2Fly 的差異平台與安裝套件
桌面裝置請使用 v2rayN。Android 裝置則依核心需求,在 v2rayNG 和 v2flyNG 之間選擇。下載前先確認裝置的處理器架構;同一款用戶端提供的安裝套件,可能適用於不同晶片或安裝方式。
下載頁分別列出 v2rayN 桌面版與經典 WPF 版。桌面版採用跨平台介面;若已習慣舊版操作,或正在參照舊版教學,可先查看經典 WPF 版的說明。兩者介面位置可能不同,請依功能名稱尋找訂閱分組、路由和系統代理,不必逐項比對截圖。
下載前,請前往「設定 → 系統 → 關於」確認系統類型。首次連線時,可先選擇一台伺服器,再用會讀取系統代理設定的瀏覽器測試;若要讓其他應用程式也走代理,再考慮使用 TUN。退出後若系統仍嘗試連線至本機代理,請檢查系統代理是否已還原。
在「關於這台 Mac」查看晶片或處理器。若顯示 Apple 晶片,請選擇 arm64;若顯示 Intel 處理器,請選擇 x64。兩種安裝套件適用於不同架構,不能只憑系統名稱選擇。安裝後先開啟用戶端,確認能進入主畫面,再匯入訂閱。
無法開啟應用程式,和開啟後無法設定代理,是兩種不同問題。前者先查看系統的應用程式開啟提示;後者再檢查網路相關授權與代理設定。受管理的裝置可能受到系統限制,請勿誤以為是安裝套件選錯。
需要 Xray 核心時選擇 v2rayNG;需要對照 V2Fly 設定時選擇 v2flyNG。確認系統支援 arm64 後,再選擇相應的安裝套件;不確定時請查看通用版。安裝套件架構決定能否安裝在裝置上;核心選擇則決定能否處理訂閱中的協定與傳輸欄位。
若系統提示安裝衝突,先確認正在更新的是同一個應用程式,並查看系統提示的具體原因。若打算解除安裝後重新安裝,請先確認訂閱和本機設定是否能還原。首次申請 VPN 權限時,也要確認裝置上是否已有其他應用程式正在使用該連線。
依發行版選擇套件格式:Debian、Ubuntu 通常使用 deb,Fedora、openSUSE 通常使用 rpm;接著依系統架構選擇 x64 或 arm64。格式相符不代表相依元件一定齊全;若安裝程式提示缺少元件,請先處理相依套件,再檢查桌面選單入口。
本教學以圖形桌面工作階段為前提。若視窗能開啟,但應用程式沒有走代理,先確認目前的桌面環境是否套用系統代理設定,再檢查目標應用程式是否會讀取該設定。瀏覽器測試成功,也不代表其他應用程式會沿用相同設定。
遷移前先區分訂閱網址、手動新增的伺服器和本機設定。訂閱網址可在新裝置上重新新增;不屬於訂閱的手動項目需要另外儲存;系統代理、虛擬網卡和應用程式分流通常與原裝置相關,需在新裝置上重新確認。備份若包含訂閱連結或連線資訊,請與公開的問題排查截圖分開存放。
先在新裝置上完成最基本的設定:匯入一個來源、選擇一台已知可用的伺服器,再用一種連線模式測試。確認基本連線正常後,再還原自訂 DNS 和路由規則。若新裝置連基本設定都無法通過,請先確認架構、核心和權限,不要依賴整套舊設定碰運氣。
生態系與維護
用戶端負責呈現設定並管理組態,核心則負責建立連線和執行路由規則。這兩層的專案可以分別發布,因此遇到連線問題時,除了要會尋找介面設定,也要知道實際由哪個核心處理。
Project V 是早期專案生態系的名稱,V2Ray 是其中的核心代理程式。原有專案逐步由社群接手後,V2Fly 延續 V2Ray 的維護與發布;Xray 則以相關程式碼為基礎分支,獨立發展。現在在用戶端看到的名稱,可能指整個生態系,也可能指某個正在執行的核心;閱讀教學時需依上下文判斷。
圖形用戶端會將訂閱項目整理成可選的伺服器設定,並把路由與網路模式轉換成核心可使用的設定。若看不到伺服器清單,通常應先檢查匯入或更新;若清單能選取但核心無法啟動,則應優先查看記錄,而不是再次匯入相同位址。
判斷 V2Fly 和 Xray 是否適用於某份設定,必須同時確認協定、傳輸方式與連線安全機制。VMess、VLESS 和 Trojan 是協定名稱,WebSocket 是傳輸方式,REALITY 則是連線安全機制。只看清單中的協定縮寫,無法判斷其他欄位是否也受支援。
例如,伺服器要求使用 VLESS、REALITY 和特定流控組合時,應選擇支援整套組合的核心,並依伺服器參數設定,而不是只把協定選單改成 VLESS。遷移完整設定時,也要確認 DNS 和輸出欄位;連線參數相容,不代表同一份自訂路由也能原封不動地使用。
v2rayN 是以 GPL-3.0 發布的桌面圖形用戶端,提供訂閱、核心選擇、路由和網路模式設定。v2rayNG 與 v2flyNG 是開源 Android 用戶端,分別以 Xray 和 V2Fly 為核心。這些用戶端負責管理本機連線設定,不會提供訂閱或遠端伺服器。
閱讀授權條款時,應區分用戶端與隨附使用的核心、元件。用戶端的開源授權說明適用於其程式碼;核心和其他元件仍應分別查看各自的授權。免費取得用戶端也不代表能使用特定遠端服務,服務使用權由實際服務提供者決定。
用戶端發布可能調整介面與平台支援,核心發布可能變更設定欄位與協定支援,重新整理訂閱則會重新讀取伺服器提供的清單。這三種更新彼此獨立:訂閱更新成功不代表程式已升級,同一個用戶端下載檔也不保證不同來源的訂閱都能正常使用。
更新前記下目前使用的核心、路由設定和連線模式。更新後先重新測試一項原本正常的操作,再啟用自訂設定。若問題是在重新整理訂閱後出現,優先比對該分組的設定變化;若問題是在程式升級後出現,先檢查設定遷移或核心啟動提示。
使用心得
正在挑選 Android 用戶端時,先比較 Xray 與 V2Fly 的差異;想釐清某個名稱指的是圖形用戶端還是核心,先了解生態系關係。若已取得 REALITY 設定,再對照安全機制與流控欄位,避免把兩種設定混為一談。
透過握手流程圖解說 REALITY 如何借用目標網站的 TLS 特徵,並說明 XTLS Vision 減少重複加密的原理,以及在用戶端填寫 flow 和公鑰參數的要點。
從 Project V 的起源談到 V2Fly 社群接手與 Xray 分支,再說明 v2rayN、v2rayNG、v2flyNG 如何呼叫核心,以及各自採用的開源授權。
整理 Xray 與 V2Fly 的分支緣由、協定支援差異和設定相容性,並依訂閱的協定類型,說明 Android 用戶端該選 v2rayNG 還是 v2flyNG。
更新成功只代表用戶端取得伺服器清單;選取項目後,請確認核心是否已啟動、應用程式是否將流量交給用戶端,再依問題排查說明區分連線失敗和網域解析失敗。
先確認該應用程式是否讀取系統代理、是否設定了自己的代理,或在 VPN 模式下是否被排除;確認流量已進入用戶端後,再檢查路由規則與輸出標籤。
先還原至最近一次可正常使用的模式,保持伺服器不變,檢查常用應用程式和區域網路連線,再逐項還原 DNS 或 TUN 設定;若某個步驟再次引發異常,請依常見問題繼續檢查該層設定。
能否讀取訂閱取決於回傳格式;匯入後能否連線,則取決於實際核心和設定欄位。兩台裝置能否同時使用,還要看服務提供者的規定。可先參考訂閱與節點相關術語,釐清這三件事。