Windows
選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面;若已習慣舊版操作,或正在比對舊版選單,也可查看 WPF 版入口。請先在系統資訊中確認處理器是否為 x64。
若發行套件需要解壓縮,請先完整解壓至具有寫入權限的資料夾,再啟動程式。若出現執行階段元件提示,記下缺少的元件名稱,依下載頁說明補齊後再試。
前往下載01 設定層級
看得到節點,只代表項目已匯入。應用程式是否使用代理、核心能否與節點交握,以及請求是否依規則分流,分別由不同設定控制。依症狀切換下方刻度,先找出需要檢查的層級。
節點已正常匯入卻總是交握失敗,請先確認協定、傳輸方式與安全層設定是否和伺服器一致。VMess、VLESS、Trojan 與 Shadowsocks 的參數不能互換;同一協定也可能搭配不同的傳輸方式。在支援多核心的桌面用戶端中,開啟節點編輯面板逐項核對,再確認目前啟用的核心。相較於只支援單一協定的工具,多協定用戶端更便於集中管理;但切換核心不會自動改寫既有參數。只調整已確認不一致的項目,再實際測試連線。
相關排查章節:無法上網 →比起逐一貼上節點連結,訂閱會將同一來源的節點集中在一個群組,更新時再由來源同步清單。在 v2rayN 的訂閱群組設定中新增網址後,先手動更新一次,確認群組是否新增或取代項目,再考慮啟用自動更新。逾時代表尚未取得回應;若記錄顯示請求已完成但清單仍是空的,請檢查回傳內容是否為用戶端支援的格式。更新訂閱與連線到節點是兩條不同的路徑,節點連線成功不代表訂閱網址也能存取。
相關排查章節:訂閱更新失敗 →只有部分網站異常時,先確認請求符合哪一條規則。相較於只有全域開關的工具,規則分流可讓區域網路請求直連,並為其他流量指定不同的出站方式。用戶端通常依序比對規則,由第一條符合的規則決定流向。請將範圍較窄的例外規則放在較寬泛的規則之前;規則指定的標籤也必須已在出站設定中定義。測試時各選一個預期直連與預期使用代理的目標,以同一個應用程式重新測試,再查看記錄確認設定是否生效。
相關排查章節:路由分流 →{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}瀏覽器可以連線,另一個應用程式卻仍直接連線時,先確認該應用程式是否會讀取系統代理設定。系統代理會將本機位址與連接埠寫入系統設定,和透過虛擬網卡接管流量不同,不一定適用於所有程式。在 v2rayN 中設定系統代理後,先用會讀取系統設定的瀏覽器測試,再確認目標應用程式是否有自己的代理選項。若關閉用戶端後所有網頁都無法開啟,請檢查系統是否仍指向已停止監聽的本機連接埠。修改路由預設值,無法解決應用程式未將流量送出的問題。
相關排查章節:系統代理未生效 →更換裝置時,可先使用相同訂閱與節點進行比對,通常不必整份搬移另一台裝置的本機設定。與只在單一平台排查相比,跨裝置比對能協助區分共用設定問題與個別裝置問題。兩台裝置都連線失敗,先檢查節點與目前網路;若只有行動裝置在鎖定螢幕後中斷,優先確認系統的電池限制與背景執行權限。桌面版的代理連接埠和系統開關不適用於行動裝置的 VPN 連線,勿因名稱相似就照搬設定;請在實際發生問題的裝置上單獨驗證。
相關排查章節:行動裝置專項 →02 平台入口
程式無法開啟時,先確認作業系統、處理器架構與套件格式,不要急著更換節點。安裝和連線是兩個不同階段:至少要能正常開啟用戶端並進入設定頁面,再匯入設定排查網路問題。
選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面;若已習慣舊版操作,或正在比對舊版選單,也可查看 WPF 版入口。請先在系統資訊中確認處理器是否為 x64。
若發行套件需要解壓縮,請先完整解壓至具有寫入權限的資料夾,再啟動程式。若出現執行階段元件提示,記下缺少的元件名稱,依下載頁說明補齊後再試。
前往下載選擇符合 v2rayN 的處理器版本。在「關於本機」查看晶片或處理器:Apple 晶片選 arm64,Intel 處理器選 x64。僅憑作業系統版本無法判斷處理器架構。
從磁碟映像安裝後,請從「應用程式」重新啟動用戶端。若系統出現提示,先分辨是架構不符、系統版本需求,還是權限問題,這幾種情況的處理方式不同。
前往下載常用入口是以 Xray 為核心的 v2rayNG;若有明確的 V2Fly 設定需求,再選用 v2flyNG。請先確認裝置支援的應用程式架構;支援 arm64 時選擇對應套件,不確定時可查看通用套件。
安裝後,請先在前景完成首次 VPN 授權。若只有切換網路或鎖定螢幕後才中斷,請保留相同節點重新測試,再逐項檢查其他 VPN 工作階段與背景電池限制。
前往下載先確認發行版使用的套件格式:Debian、Ubuntu 系通常選 deb,Fedora 系通常選 rpm。接著查看系統資訊,確認架構是 x64 或 arm64;套件名稱中的處理器架構不能互換。
此入口提供圖形化用戶端。能夠安裝不代表目前的桌面環境會為所有應用程式設定代理。完成設定後,先用瀏覽器比對,再確認實際發生問題的程式是否會沿用桌面代理設定。
前往下載03 首次連線
首次設定只驗證一條連線路徑:使用一台裝置、一個網路和一個節點。記錄每個步驟的結果,之後即使更換裝置,也能重現成功條件或找出失敗環節。
在桌面版 v2rayN 新增訂閱群組並儲存網址,再手動更新該群組;使用 v2rayNG 時,也要先在訂閱群組管理中新增訂閱,再執行更新。節點清單出現項目後,請確認它屬於剛才更新的群組,避免把舊節點誤認為新訂閱的結果。
若節點數量沒有變化,請查看更新時顯示的訊息。若逾時,先檢查取得訂閱的路徑;若提示格式不支援,請確認訂閱類型。訂閱網址可能包含存取憑證,排查問題時請遮蔽完整網址。
從剛匯入的群組中選擇與用戶端核心相容的節點;桌面版請確認已設為目前使用的設定,再啟用系統代理。行動裝置則啟動連線並完成系統 VPN 授權。首次測試先使用預設規則,暫時不要加入自訂分流或 DNS 設定。
若啟動按鈕很快就恢復未連線狀態,先查看記錄中的第一個錯誤。連接埠被占用、設定無法辨識與交握失敗是不同問題;先排除啟動錯誤,再測試網路存取。
在會讀取系統代理的瀏覽器中送出新請求,記錄連線前後的存取結果,必要時比對出口 IP 位址與用戶端記錄。測得到節點延遲,不代表這個瀏覽器的請求也走相同路徑。
若只有一個網站無法連線,請用同一個瀏覽器再測試另一個預期使用相同出站的目標,接著檢查規則比對結果與網域解析。若關閉代理後仍無法連線,先恢復基本網路,不要同時更換多個節點和規則。
04 開源生態系
專案、核心、用戶端和節點協定並非同一層級的名稱。閱讀指南或回報問題前,請先確認討論的是哪一層;尤其錯誤發生在啟動階段時,介面顯示的名稱不能取代實際執行的核心名稱。
V2Ray 源自 Project V,將接收請求的入站、負責轉送的出站,以及決定請求流向的路由拆分為獨立設定。入站負責將瀏覽器或其他應用程式的請求交給核心;路由依條件選擇出站;出站則負責直連、代理或其他處理。
這三個位置也對應三種常見狀況:核心未收到連線時,先檢查本機連線設定;連線已進入核心卻走錯出口,請檢查路由順序;請求已到達預期出站仍然失敗,再確認伺服器參數與網路連通性。將問題分類到這三個層級,比只憑「網頁無法開啟」判斷原因更準確。
V2Fly 社群延續 V2Ray 核心專案;Xray 從這段程式碼脈絡分支後獨立發展,兩者分別由各自社群維護。常見設定概念有所重疊,但支援的傳輸方式、安全層與欄位可能不同。使用相同協定名稱,不代表兩者接受完全相同的參數。
遇到「項目可以匯入,核心卻無法啟動」時,先查看記錄指出哪個欄位,再判斷是該核心不支援此選項,還是用戶端產生設定時漏掉了該項目。切換核心前先記下原本的選擇;重新測試時維持相同節點與網路,才能判斷差異來自哪個層級。
VMess、VLESS、Trojan 與 Shadowsocks 都能在開源代理生態系中找到實作。協定規定兩端如何交換資料,傳輸方式與安全層則決定資料如何傳送及受到保護。以 VLESS 為例,不能只憑協定名稱推斷連線已設定 TLS,也不能將 TLS 與傳輸方式視為同一項設定。
查看共用設定時,先確認協定,再檢查傳輸方式與安全層,依各自欄位逐項比對伺服器設定。若只從另一份指南照抄一個參數,可能反而讓兩端原本一致的設定變得不相符。協定公開有助於比對實作與排查問題,但不代表某項訂閱或第三方服務屬於用戶端專案。
v2rayN 是桌面圖形化用戶端,可管理節點、訂閱與路由,並依設定選用相應核心。v2rayNG 以 Xray 為核心,提供行動版訂閱與 VPN 連線;v2flyNG 以 V2Fly 為核心,適合需要確認 V2Fly 相容性的行動裝置設定。三者都是開源用戶端,介面負責整理設定,實際建立連線的是底層核心。
訂閱服務和用戶端也是兩回事。安裝用戶端不會自動取得節點;用戶端能開啟,也不代表訂閱仍然有效。遠端回傳錯誤、項目過期或應用程式缺少權限,分別要檢查訂閱來源、節點設定與裝置設定。先確認錯誤來自哪一方,再決定要查看指南的哪個部分。
用戶端更新可能調整介面、系統支援或套件方式;核心更新可能新增欄位或修正連線行為;訂閱更新則只同步來源提供的節點清單。訂閱更新成功不代表軟體已升級;重新安裝用戶端也無法讓失效的訂閱恢復使用。
升級前請備份自訂路由與設定,並記下目前使用的核心和正常運作的連線模式。升級後先測試原本的節點,再逐項還原選用設定。若出現回歸問題,記錄發生時間、平台與架構、使用的核心、重現步驟和已去識別化的記錄,比只提供無法連網的截圖更容易定位。
05 主題速讀
依故障發生的位置選擇文章:訂閱更新失敗,查看取得與解析流程;節點已出現但首次連線失敗,檢查節點與出口;只有部分應用程式的行為不同,再區分系統代理與路由設定。
整理訂閱更新失敗的常見原因:連結失效、更新請求未透過代理,以及回傳內容解析結果為空;並說明自動更新間隔與更新時是否使用代理的設定方式。
從匯入訂閱後的首次連線開始,說明如何選擇節點、實際連線測試與 TCPing 的差異,以及如何確認流量確實經過代理出口。
釐清「系統代理設定」與「路由規則」是兩個不同層級的開關,並比較全域、繞過區域網路及中國大陸、直連三種預設模式各自適用的情境。