v2rayN 提供跨平台介面的桌面版,以及經典 WPF 版。初次使用可先選桌面版;若手邊的操作說明以經典介面為例,選擇 WPF 版會更容易對照。前往系統的「關於」查看「系統類型」,確認裝置適用下載頁列出的架構。
若應用程式在視窗出現前就關閉,請先查看發行說明列出的桌面執行環境。此時尚未進入訂閱或連線階段,修改節點參數無法解決啟動失敗。
前往下載先找出問題發生在哪個步驟:更新訂閱只會取得設定,啟用系統代理才會改變部分應用程式的連線入口,而路由規則則決定進入用戶端的流量如何傳送。這三個步驟不能互相取代。排查時一次只改一項設定,並用同一個應用程式重試,才容易確認是哪項設定生效。
路由規則範例:目標符合私人位址集合時,透過標記為 direct 的出站傳送。此標記必須與現有出站名稱一致。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
訂閱群組適合管理一批會變動的連線設定;若只需匯入單一項目,則直接使用單一連結即可。桌面版 v2rayN 可先在「訂閱群組」儲存網址,再更新目前群組;Android 版 v2rayNG 則從側邊選單進入訂閱群組設定,儲存後回到主清單更新。確認新項目出現在正確群組後,再手動選取一筆連線設定。若更新後自訂項目遭到覆蓋,請將本機項目存放在獨立群組,而非反覆修改訂閱群組內容。
路由分流處理的是已進入核心的請求,依據網域或目標位址決定直接連線,或交由代理出站傳送;這與是否啟用系統代理是兩回事。先用現有預設測試一筆需要直連的請求,再到「路由設定」尋找對應規則。規則通常依序比對,涵蓋範圍較小的例外應排在較廣泛的規則之前。若網域規則未生效,先確認用戶端取得的是網域還是位址,再判斷該檢查解析方式或調整比對條件。
v2rayN 的「自動設定系統代理」會設定作業系統的代理入口,供遵循此設定的桌面應用程式使用。這與 Android 透過系統 VPN 服務接入應用程式流量的方式不同,也不保證所有桌面程序都使用相同入口。需要驗證時,請用瀏覽器發出新請求,再查看用戶端是否記錄這次連線;若應用程式有獨立的網路選項,也要在該處確認代理來源。臨時測試結束後,可用「清除系統代理」撤銷用戶端設定的代理入口。
在 v2rayNG 的 VPN 模式中,「應用程式代理」可依應用程式限制連線範圍。啟用後,先確認勾選清單代表納入還是排除:開啟「略過模式」時,勾選的應用程式不會經過此 VPN。儲存後先中斷連線,再重新連線,並分別使用已選取與未選取的應用程式發出新請求。應用程式清單只決定哪些應用程式進入 VPN;進入後使用哪個出站仍由路由規則決定。同一應用程式內,不同網域的請求也可能使用不同出站。
核心負責解析連線設定並建立連線,用戶端則負責介面與系統接入。桌面版 v2rayN 可針對支援的設定選用相應核心;Android 端若要從 Xray 系列改用 V2Fly 系列,通常應重新選擇相應的用戶端。匯入前,先確認伺服器使用的通訊協定、傳輸方式與安全選項,不要只看連結是否能辨識。使用 REALITY 的設定應選擇支援此功能的核心;切換後若欄位出現錯誤,先比對原始設定,不要逐一刪除欄位來強行啟動。
介面示意將分散的設定集中呈現,方便對照,但不代表實際選單順序。若目前用戶端的用詞不同,可先查閱概念速查:確認要調整的是流量入口、目標比對,還是連線設定本身,再返回對應選單。
先確認要安裝在哪部裝置,再依作業系統與處理器架構挑選安裝檔。同一架構的安裝檔也不能跨作業系統使用;已安裝的裝置在更新前,還要確認目前使用的用戶端與發行版本。
v2rayN 提供跨平台介面的桌面版,以及經典 WPF 版。初次使用可先選桌面版;若手邊的操作說明以經典介面為例,選擇 WPF 版會更容易對照。前往系統的「關於」查看「系統類型」,確認裝置適用下載頁列出的架構。
若應用程式在視窗出現前就關閉,請先查看發行說明列出的桌面執行環境。此時尚未進入訂閱或連線階段,修改節點參數無法解決啟動失敗。
前往下載在「關於這台 Mac」查看「晶片」或「處理器」。顯示 Apple 晶片的機型請選 Apple Silicon 安裝檔;顯示 Intel 處理器的機型則選 Intel 安裝檔。不要依購買年份猜測,同一時期可能推出不同架構的機型。
開啟磁碟映像檔後,依其中的安裝說明將應用程式移至「應用程式」資料夾。若曾直接從映像檔視窗試用用戶端,請先結束程式,再從實際安裝位置啟動,避免安裝與測試時開啟不同副本。
前往下載優先考慮以 Xray 為基礎的 v2rayNG;若有明確的 V2Fly 設定需求,再評估 v2flyNG。多數近年的裝置可選 arm64 安裝檔;不確定系統支援哪種架構時,可先查看通用版,並核對最低系統需求。
若系統提示與已安裝的應用程式衝突,先確認是否為覆蓋安裝失敗。解除安裝可能會清除本機設定,排查前請先備份訂閱群組與手動建立的項目,不要一開始就解除安裝。
前往下載安裝桌面版 v2rayN 時,先依發行版的套件管理系統選擇 deb 或 rpm,再確認處理器架構。Debian、Ubuntu 通常使用 deb,Fedora 通常使用 rpm;若使用 ARM 裝置,也要選擇相符架構的套件。
用戶端能啟動,不代表桌面應用程式就會使用系統代理。安裝後先查看目前桌面環境的網路代理設定,再以會讀取該設定的應用程式驗證;部分應用程式仍須在自身設定中指定連線方式。
前往下載第一次連線時先保留預設設定,使用已知可用的設定建立基準。確認連線正常後,再調整分流、應用程式清單或背景設定;之後若發生問題,就能回到上一步重試。
若有訂閱網址,請在用戶端新增群組,填入方便辨識的名稱與訂閱網址,儲存後更新該群組。若只有一筆分享連結,請使用從剪貼簿匯入的功能,不必先建立訂閱。匯入後檢查主清單是否出現預期項目,並選取一筆作為測試。若用戶端顯示找不到設定,先確認複製的內容是完整網址或分享連結,而非 QR Code 旁的說明文字。訂閱網址可能包含存取憑證,請勿將完整網址貼在公開截圖或問題回報中。
桌面端在 v2rayN 選取設定後,啟用「自動設定系統代理」,再開啟一個使用系統代理的瀏覽器。Android 端則在 v2rayNG 點選連線;首次出現系統 VPN 權限確認時,先確認由哪個應用程式發起,再授予權限。測試期間先不要修改應用程式清單,必要時確認沒有其他 VPN 正在佔用系統連線。若在啟用代理或授予系統權限前就遇到錯誤,請先處理用戶端啟動、執行環境或授權問題,不必急著修改路由規則。
開啟平常會瀏覽的頁面,發出一筆新請求並記下時間,再回到用戶端查看當時的執行記錄。若找不到對應記錄,先確認測試應用程式是否已接入;若記錄顯示直接連線,但預期應使用代理,再檢查規則比對結果;若已嘗試建立連線卻逾時,依序檢查本機網路、連線設定與伺服器狀態。驗證完成後,可還原原本的系統代理設定或中斷 Android VPN,再用同一個應用程式重試,確認連線狀態確實會隨設定變化。
專案、核心與用戶端分屬不同層次。先釐清文件討論的是哪一層,才能判斷某項功能屬於連線協定、核心實作,還是介面提供的設定。
Project V 是 V2Ray 早期所屬的專案生態系;V2Ray 核心負責處理入站、出站與路由。V2Fly 社群持續維護 V2Ray 核心,Xray 則從這個程式碼脈絡分支發展。日常討論中,「V2Ray」可能指核心,也常被用來泛稱這類工具。遇到教學提到「支援 V2Ray」時,應進一步確認實際指的是可匯入某種分享格式,還是能依所用協定與傳輸參數完成連線。
兩種核心路線共用部分設定概念,但協定名稱相同,不代表所有傳輸與安全設定都相容。尤其要分別確認協定類型與附加欄位:使用 VLESS 的設定也可能要求特定傳輸方式或安全選項。若更換核心後用戶端能顯示項目,但啟動或握手仍失敗,應逐項比對原始設定與支援欄位,並確認伺服器端的需求;不能把「已匯入」視為「已相容」。
v2rayN 適用於桌面環境,可管理訂閱、參數與系統代理;v2rayNG 以 Xray 為基礎,透過 Android 系統 VPN 服務接入連線;v2flyNG 採用 V2Fly 核心,為有相關設定需求的 Android 裝置提供另一種選擇。三款圖形化用戶端皆採 GPL-3.0 開源授權,可免費使用。用戶端授權不等於核心及其他元件的授權,也不包含可用的伺服器或訂閱服務;已有連線設定時,仍應依實際參數選擇用戶端。
用戶端、核心與路由規則資料可能分別更新。更新用戶端可能影響介面或系統接入,更新核心則可能改變設定解析與連線行為。若只有個別網域的出站結果不如預期,請優先檢查目前使用的路由規則與資料,不要同時更換用戶端和核心。更新前記下啟用的群組、路由預設與應用程式範圍;更新後先重現一筆原本可用的連線,再測試新增設定,方便區分版本遷移與既有問題。
視窗無法開啟、單筆連線逾時、記錄出現握手錯誤,各有不同的檢查起點。先選擇最符合目前狀況的文章;若多個應用程式同時異常,建議從問題診斷依症狀逐項排除。
針對用戶端啟動時立即崩潰或閃退,依序檢查 .NET 桌面執行階段、解壓縮路徑與資料夾權限、安全軟體攔截及損毀的設定檔,並提供 Android 端閃退的處理方式。
依序檢查本機系統時間、連接埠占用、系統代理模式、訂閱參數、傳輸層與 TLS 設定,逐層排查節點逾時與連線失敗,並提供各步驟的檢查方法。
說明記錄層級設定與記錄格式,逐一解讀 connection refused、i/o timeout、tls handshake failure 等常見錯誤,並提供相應的排查方向。