FAQ / CLIENT CHECKLIST

V2Ray 常見問題與用戶端排查步驟

依基礎知識、安裝設定、使用技巧與故障排查四類整理。遇到問題時先確認發生的環節,再依序核對網路、用戶端、節點參數與系統設定,避免同時修改多項設定。

01 確認現象

記錄錯誤訊息、平台與觸發操作。

02 縮小範圍

區分網路、節點或用戶端問題。

03 逐項驗證

每次只調整一項設定並重新測試。

BASICS

基礎知識

先釐清生態、核心、用戶端、訂閱與節點之間的關係,再進行安裝或調整參數。

5 QUESTIONS
V2Ray、v2rayN 和 v2rayNG 分別是什麼?

V2Ray 通常指 Project V 相關的協定、核心與工具生態,不是單一圖形化用戶端。v2rayN 是適用於 Windows、macOS 與 Linux 的桌面用戶端,v2rayNG 是 Android 用戶端;兩者負責管理訂閱、節點、路由與系統代理,並呼叫相應核心處理連線。

桌面端與 Android 應該選哪個用戶端?

Windows、macOS 與 Linux 優先選擇 v2rayN,Android 優先選擇 v2rayNG。若 Android 設定明確依賴 v2fly 核心,也可以選擇 v2flyNG;不要混用不同用戶端的安裝套件或平台設定檔。

Xray 核心與 v2fly 核心有什麼差異?

兩者都源自 Project V 生態,支援範圍與功能演進方向並不完全相同。Xray 常用於 v2rayN 與 v2rayNG,v2fly 核心則搭配 v2flyNG;選擇時應以節點協定、傳輸參數及用戶端實際支援情況為準。

VMess、VLESS、Trojan 與 Shadowsocks 該怎麼選?

先選擇伺服器端已提供且用戶端核心明確支援的協定,不要只更改協定名稱而保留其他參數。VLESS 通常需搭配 TLS、REALITY 或其他傳輸設定,VMess 取決於正確的使用者識別碼,Trojan 應重點核對密碼與 TLS 網域,Shadowsocks 則要核對加密方式與密碼。

訂閱、節點與設定檔有什麼關係?

訂閱網址用於批次取得與更新節點,節點記錄伺服器位址、連接埠、協定與傳輸參數,設定檔還可能包含路由、DNS 與入站設定。更新訂閱通常會替換訂閱群組中的節點,但不一定會覆蓋用戶端的全域路由與介面設定。

INSTALLATION

安裝設定

安裝套件架構、訂閱入口與用戶端版本需要與裝置平台相符,匯入後還應執行一次更新以確認設定有效。

5 QUESTIONS
匯入訂閱連結後沒有出現節點怎麼辦?

先確認匯入入口是訂閱管理,而不是單一節點匯入,再檢查連結是否完整,前後是否混入空格或換行。接著手動執行一次更新訂閱並查看日誌;若回傳內容為空或無法辨識格式,請向訂閱提供者確認網址狀態與輸出格式。

v2rayN 訂閱更新失敗,先檢查什麼?

先用瀏覽器確認訂閱網址可以連線,再核對系統日期、時間與時區是否正確。接著檢查 v2rayN 的訂閱群組網址、更新代理設定與日誌中的 HTTP 狀態;舊網址失效時應更換網址,不要反覆重新整理同一筆記錄。

Android 安裝套件的 arm64 與 universal 該怎麼選?

2015 年後推出的大多數主流 Android 手機可優先選擇 arm64,套件通常更精簡。無法確認處理器架構、裝置較舊或 arm64 安裝失敗時,再選擇 universal;同一個用戶端保留一個能正常更新的安裝來源即可。

v2rayN 桌面版與經典 WPF 版有什麼差異?

桌面版採用新一代跨平台介面,適合希望在不同桌面系統維持相近操作方式的使用者。經典 WPF 版面向 Windows,介面與設定路徑更接近既有使用習慣;已有穩定設定時,不必只因介面差異而頻繁切換版本。

macOS 下載時如何判斷 Apple Silicon 與 Intel?

開啟系統資訊或「關於這台 Mac」,晶片欄位顯示 Apple M 系列時選擇 Apple Silicon 版本,處理器欄位顯示 Intel 時選擇 Intel 版本。安裝套件架構不相容可能導致無法啟動或需要額外相容層,因此應先確認晶片類型。

USAGE

使用技巧

連線狀態只代表用戶端已啟動連線處理,還需要檢查系統代理、TUN、路由規則與應用程式本身的設定。

5 QUESTIONS
用戶端顯示已連線,但網頁無法開啟怎麼辦?

依序檢查目前節點是否可用、系統代理或 TUN 是否確實啟用,以及瀏覽器是否使用獨立的代理設定。接著切換至規則較簡單的路由模式測試,並查看日誌是 DNS 解析失敗、連線逾時還是 TLS 錯誤,避免同時修改多個參數。

瀏覽器可以連線,但終端機沒有使用系統代理怎麼辦?

瀏覽器通常會讀取系統代理,許多終端機程式則不會自動讀取。可以為目前終端機設定 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 環境變數,並確認連接埠與用戶端本機入站設定一致;也可以使用 TUN 模式接管需要涵蓋的網路流量。

啟用 TUN 模式時顯示權限不足,該如何處理?

TUN 需要建立虛擬網路介面並調整系統路由,因此通常需要管理員權限或系統的 VPN 授權。桌面端可依照系統提示提升權限,Android 端應接受 VpnService 授權;若仍然失敗,先關閉其他佔用虛擬介面的網路工具再重試。

全域、規則與直連模式該如何使用?

全域模式會將符合條件的流量統一交由代理出站,適合暫時確認節點是否正常;規則模式依網域、IP 或程序規則選擇出站,適合日常使用;直連模式主要用於排除用戶端接管造成的影響。排查時先用全域模式驗證連線,再回到規則模式檢查匹配順序。

V2Ray 節點測速結果該怎麼看?

延遲測試只反映探測要求的回應時間,不等同於實際下載速度與持續穩定性。應在相同網路、相近時間及相同測試方式下比較,並綜合連線成功率、網頁開啟情況與連續傳輸表現判斷,不要只依一次延遲結果排序。

DIAGNOSIS

故障排查

先保留錯誤現場與日誌,再從網路連通性、時間、網域、連接埠、DNS 與系統權限逐層檢查。

5 QUESTIONS
節點連線逾時應按照什麼順序排查?

先確認裝置本身可以正常連線,再切換同一訂閱中的其他節點,判斷是單一節點問題還是整體連線問題。接著核對伺服器位址、連接埠、協定、傳輸方式與安全層參數,並檢查本機防火牆、路由器或網路環境是否阻擋相關連線。

TLS 握手失敗或憑證錯誤怎麼處理?

先校準裝置日期、時間與時區,再核對 serverName 或 SNI 是否與憑證網域一致。也要確認節點位址、TLS 開關、傳輸層與指紋參數來自同一份設定;不要把略過憑證驗證當作長期解決方案。

連線後出現 DNS 解析失敗怎麼辦?

先判斷是所有網域都失敗,還是只有特定網域失敗,並測試直接連線至 IP 是否可行。接著檢查用戶端 DNS 設定、路由規則如何處理 DNS 請求、系統快取與本機連接埠佔用;修改後應重新啟動用戶端並清除系統 DNS 快取,再次驗證。

Android 用戶端切到背景後經常斷線怎麼辦?

將 v2rayNG 或 v2flyNG 加入系統省電白名單,並允許其在背景執行及進行必要的網路活動。部分系統會在鎖定螢幕後限制 VpnService,也應同時檢查應用程式自動啟動、背景活動與電池最佳化設定,完成後重新建立連線並鎖定螢幕測試。

用戶端啟動失敗或頻繁崩潰,如何找出原因?

先記錄問題發生前執行的操作,並查看用戶端日誌最後一段錯誤訊息。接著確認安裝套件架構與系統相容、設定檔可以解析且磁碟空間充足,再暫時移出最近新增的設定或規則;若舊設定可以啟動,可逐項還原以找出具體原因。

NEXT STEP

問題仍未定位時

保留用戶端日誌、系統版本、用戶端名稱、連線模式與具體錯誤訊息,再進入故障排查文件,依症狀逐章檢查。首次設定可先完成快速入門流程,確認訂閱、節點選擇與系統代理三個基礎環節。