Windows
v2rayN Desktop / WPF
初次安裝可從 Desktop 版開始;習慣使用 WPF 介面的使用者可選擇經典 WPF 版。兩者主要差異在介面和封裝方式,並非採用不同的代理協定。先在系統資訊中確認系統類型,再依下載頁說明準備執行環境。
解壓縮後請從完整資料夾啟動,不要只將執行檔拖到桌面單獨執行。遷移時先備份舊資料夾中的使用者資料,再測試新程式能否讀取群組與節點。若雙擊後沒有出現介面,優先確認執行階段、資料夾寫入權限及安全軟體記錄,而不是重新匯入訂閱。
前往下載01 生態系概覽
用戶端負責編輯及管理設定,核心則負責建立連線、處理請求與比對路由。介面能開啟,不代表核心已正常啟動。
02 設定流程
從設定來源、流量接管到規則比對,逐一確認。發生異常時,先找出問題所在的層級,再調整設定。
在 v2rayN 的路由設定中,先確認目前使用的規則集,再依比對順序檢查出站。核心通常採用第一條符合的規則,因此區域網路直連和特定網域封鎖,應排在範圍較廣的規則之前。網域條件和位址條件需分別驗證;在同一條規則中同時填入兩種條件,不代表符合其中一種就會生效。修改後重新送出請求,並從記錄檔確認出站方式,不要只看網頁能否開啟來判斷分流是否生效。
geoip:private → direct
geosite:category-ads-all → block
geosite:cn → direct
在 v2rayN 中先開啟訂閱群組設定,新增群組並儲存網址,再從訂閱群組選單更新。匯入後切換回該群組,確認節點確實出現在清單中。手動新增的單一設定不會隨群組更新。若更新失敗,先確認錯誤發生在擷取、憑證驗證還是內容解析,再檢查是否誤將單一節點連結填入訂閱網址欄位。若舊節點已無法連線,也可能無法用它更新訂閱。
訂閱群組設定 → 新增群組
更新訂閱 → 檢查目標群組
v2rayN 的系統代理設定會影響使用系統代理的應用程式;選擇全域路由,也不會讓忽略系統代理的應用程式自動接入。先在已知會使用系統代理的應用程式中測試,再確認目標程式是否使用獨立的網路設定。需要接管更多流量時,再另行測試 TUN 模式,並留意區域網路存取和系統路由的變化。結束用戶端前可清除系統代理,避免應用程式繼續連線到已關閉的本機連接埠。
系統代理 → 設定系統代理 / 清除系統代理
路由設定 → 選擇目前的規則集
GeoSite 提供網域集合,GeoIP 提供位址集合。用戶端取得網域時可直接比對網域;若規則採用位址比對,還需確認目前的路由策略是否會解析該網域。若規則庫載入失敗,先確認檔案路徑和分類名稱是否存在,再考慮更新規則庫檔案。若同一網站在瀏覽器和其他應用程式的連線路徑不同,也應檢查瀏覽器內建的加密 DNS,以及應用程式送出請求時使用的是網域還是位址。
geosite.dat → geosite:cn
geoip.dat → geoip:private
遇到 V2Ray 無法連線時,先確認核心是否啟動、本機監聽是否建立,再實際送出一次請求,對照同一時間的記錄檔。若監聽失敗,檢查連接埠是否被其他執行個體占用;若連線遠端失敗,再核對位址、協定、傳輸方式與安全設定。延遲測試成功,只能證明當下的測試請求通過,不代表所有應用程式都使用代理。找出問題後一次只修改一項,否則難以判斷是哪項變更讓連線恢復。
核心啟動 → 本機監聽 → 遠端連線 → 目標請求
03 安裝套件選擇
先選擇作業系統,再確認處理器架構。桌面平台使用 v2rayN;Android 則依需求選擇 v2rayNG 或 v2flyNG。
v2rayN Desktop / WPF
初次安裝可從 Desktop 版開始;習慣使用 WPF 介面的使用者可選擇經典 WPF 版。兩者主要差異在介面和封裝方式,並非採用不同的代理協定。先在系統資訊中確認系統類型,再依下載頁說明準備執行環境。
解壓縮後請從完整資料夾啟動,不要只將執行檔拖到桌面單獨執行。遷移時先備份舊資料夾中的使用者資料,再測試新程式能否讀取群組與節點。若雙擊後沒有出現介面,優先確認執行階段、資料夾寫入權限及安全軟體記錄,而不是重新匯入訂閱。
前往下載v2rayN Apple Silicon / Intel
在「關於這台 Mac」查看晶片或處理器欄位。Apple Silicon 選擇 arm64,Intel 選擇 x64。不要根據產品外觀或購買年份猜測架構,同一系列的電腦可能因世代不同而採用不同晶片。
安裝後先使用一筆已知可用的設定,確認用戶端能啟動核心。若瀏覽器可以連線,但某個程式仍無法連線,請檢查該程式是否使用系統代理。已有獨立代理設定的應用程式,應另外核對本機位址、監聽連接埠及代理類型,避免沿用其他用戶端留下的設定。
前往下載v2rayNG / v2flyNG
v2rayNG 使用 Xray 核心。明確需要 V2Fly 核心時,再選擇 v2flyNG。裝置支援 arm64-v8a 時可選擇 arm64 套件;不確定裝置支援哪種架構時,可先查看通用套件,但仍須符合系統需求。
首次啟動代理服務時,請依系統提示允許 VPN 連線權限。如果裝置上還有其他占用 VPN 連線的應用程式,先中止舊連線再測試。若鎖定螢幕後連線中斷,請分別檢查 VPN 狀態、背景限制和網路切換記錄,不要只憑此現象判定遠端節點已失效。
前往下載v2rayN deb / rpm
Debian、Ubuntu 系統優先選擇 deb;Fedora 等使用 RPM 套件管理的發行版則選 rpm。套件格式與處理器架構是兩項獨立條件。x86_64 對應 x64,aarch64 對應 arm64;更換套件格式無法解決架構不符的問題。
安裝完成後,分別以桌面應用程式和終端機程式測試。桌面環境的系統代理不一定會影響終端機程式;某些工具會使用自己的代理設定或環境變數。若只有終端機連線失敗,先確認它實際讀取哪些設定;若兩者都失敗,再回到用戶端檢查核心啟動與本機監聽狀態。
前往下載04 開源生態系
判斷設定能否遷移時,應分別確認用戶端、核心與規則庫,而不只是查看節點名稱或匯入結果。
inbound → routing → outbound
用戶端產生或載入設定;進入核心的請求則依路由規則選擇出站。
Project V 是 V2Ray 生態系的起點。日常使用時,最重要的是它的設定模型:入站接收請求,路由決定將流量交給哪個出站,出站再依設定直連、轉送或拒絕。圖形用戶端的節點清單只是設定的一部分,無法證明所有應用程式的請求都會進入核心。例如,瀏覽器和同一台裝置上的命令列工具可以各自設定代理,即使連線到相同位址,實際流量也可能經由不同入口。
因此,即使桌面介面顯示已選取節點,仍須分別確認兩件事:核心是否成功監聽,以及目標應用程式是否真的將請求送到該監聽入口。若記錄檔中沒有目標請求,應先檢查應用程式的接入方式。此時反覆修改遠端傳輸參數,無法改變尚未到達核心的流量路徑。
V2Fly 是社群持續維護 V2Ray 核心的專案。Xray 從這條技術脈絡衍生,並以獨立專案發展。兩者在入站、路由、出站等基本概念上相通,但協定、傳輸方式與安全欄位會隨各自的實作持續演進。用戶端能解析分享連結,只代表連結格式可辨識;不代表所選核心支援其中每個參數,更不代表遠端使用了相同的設定組合。
遷移時先核對協定、傳輸方式與安全層,再決定使用哪個用戶端和核心。以 REALITY 為例,應依 Xray 對應文件檢查安全層設定,不要把分享連結中顯示的協定名稱當成完整設定。若一般設定可以連線,只有特定節點顯示不支援,請保留完整錯誤類型,優先核對該節點的欄位與核心實作。
v2rayN 是桌面版圖形用戶端,可管理訂閱、服務設定、代理模式與路由;實際支援哪些核心,則取決於所選發行套件與設定。v2rayNG 適用於 Android,主要提供 Xray 設定入口;v2flyNG 同樣適用於 Android,但使用 V2Fly 核心。三者都能管理節點,但各自的介面選項、匯入格式和預設路由並不相同。
初次設定不必同時安裝兩款 Android 用戶端。先依節點需求選擇核心,再匯入一筆設定進行基本測試。若要比較兩款用戶端,請使用相同的測試網路和目標,並確認每次只有受測用戶端的 VPN 服務正在執行。如此才能分辨差異來自用戶端、核心,還是流量接管方式。
V2Fly 的 V2Ray 核心和 Xray-core 採用 MPL-2.0。這是檔案層級的開源授權;散布經修改且受該授權涵蓋的程式碼時,應依授權履行相應的原始碼義務。用戶端和核心是不同專案,套件內的其他元件也可能採用各自的授權。查閱或重新散布時,應分別確認專案及發行套件所附的元件授權聲明,不要以某個核心的授權概括整個用戶端。
社群會分別維護介面、核心實作和規則資料。文件中的設定名稱用於尋找功能,不代表所有介面配置都相同,也不代表更新用戶端時會自動更新訂閱與規則庫。選擇套件時先確認作業系統、架構和核心功能;診斷問題時則以本機設定和實際記錄檔為準。
更新用戶端會變更程式,更新訂閱會變更節點來源,更新規則庫則會變更比對資料。建議分開執行這三項操作。更新前先保留一份可用設定,並記下目前使用的規則集和本機監聽連接埠。更新後先重新測試相同目標,再確認本機服務直連及需要代理的請求是否仍走預期路徑。
若更新訂閱後只有少數設定失敗,先比對這些設定的傳輸參數;若更新規則庫後只有某類網域的連線路徑異常,請檢查分類是否變更,以及是否已被前面的規則比對。若更新用戶端後所有請求都失敗,先查看核心啟動和監聽錯誤。依變更範圍縮小排查方向,比同時重新安裝、更新訂閱和修改 DNS 更容易找出原因。
05 資訊與排查
啟動失敗先檢查本機監聽,安裝失敗先確認套件,流量路徑異常再查看路由與規則庫。
使用系統內建命令找出占用 10808、10809 連接埠的程序,說明如何在 v2rayN 中修改本機 SOCKS 與 HTTP 監聽連接埠,以及修改後需同步調整哪些設定。
修改連接埠前,先確認占用者是否為正在執行的用戶端。若是舊執行個體,結束它並重新啟動通常更直接。若確實需要同時保留兩個程式,再為它們指定不同連接埠。修改後以相同應用程式重新測試,並確認應用程式沒有繼續使用舊的代理位址。
從選擇套件、解壓縮、首次執行到匯入訂閱,逐步完成設定,並比較 WPF 版與 Desktop 版的差異,整理缺少執行階段、遭防毒軟體攔截、路徑含中文字等常見問題。
以首次啟動作為判斷依據:介面未出現時先檢查執行環境;介面已出現但沒有節點時,再檢查匯入與訂閱更新。這兩類問題應查看不同的提示。
介紹 geoip.dat 與 geosite.dat 的用途、在用戶端中更新規則庫的步驟,以及 geosite:cn、geoip:private 等常用寫法如何組合於分流規則中。
驗證規則時,分別準備一個網域請求和一個直接使用位址的請求。若只有其中一種的連線路徑異常,先確認比對對象是否符合規則類型。