說明中心 · 依問題現象排查
V2Ray 常見問題與連線疑難排解
先確認設定來源,再檢查流量入口。每次只修改一項,並以相同目標重新測試。
入門指南
分清用戶端、核心、協定與流量入口,避免混淆不同層級的問題。
V2Ray、Xray 與 v2rayN 分別是什麼?
V2Ray 屬於 Project V 代理工具生態;V2Fly 維護 V2Ray 核心,Xray 則是相關技術分支,兩者支援的功能與設定細節會隨版本變動。v2rayN 是圖形化用戶端,用來管理設定、選擇連線、設定系統代理並啟動相應核心,並非某一種協定。排查問題時,先分辨是介面操作失敗還是核心連線失敗,再查看目前使用的核心及記錄。不能只憑用戶端名稱就判定某項設定一定相容,還需確認協定、安全層、傳輸方式與核心版本。
安裝用戶端後,還需要準備哪些連線資訊?
安裝用戶端只代表具備設定與連線工具,還需要合法取得且有權使用的伺服器設定。常見形式包括單筆分享連結、QR Code 或訂閱網址,內含伺服器位址、連接埠、驗證資訊,以及傳輸和安全層參數。匯入前請確認資訊來源及適用的用戶端,勿將一般網站首頁誤當成訂閱網址。QR Code 和分享連結也可能包含存取憑證,不宜公開。如果只有位址和連接埠,缺少驗證或安全層參數,應向設定提供者索取完整資訊,別反覆切換協定猜測正確設定。
分享連結和訂閱網址有什麼不同?
分享連結通常代表單筆連線設定,常見前綴包括 vmess://、vless://、trojan:// 和 ss://;訂閱網址通常是用來取得一組設定的 HTTPS 網址。前者適合匯入指定連線,後者則方便日後同步設定變更。判斷時應參考提供者的說明,不要只看網址外觀。匯入分享連結時使用剪貼簿或掃描 QR Code 的入口;訂閱網址則應新增至訂閱群組後再執行更新。訂閱網址可能含有存取憑證,截圖、求助或複製記錄時,請遮蔽完整網址及查詢參數。
全域代理、規則分流和 TUN 模式有什麼不同?
全域代理與規則分流主要決定已進入核心的流量要從哪個出口連線;TUN 模式則主要決定哪些系統流量會經由虛擬網路介面進入核心,兩者作用層級不同。系統代理通常只影響遵循系統代理設定的應用程式,不代表所有程式都會使用代理。用戶端的全域選項作用範圍,也需配合目前的流量入口和路由設定理解。日常使用可先確認系統代理與規則分流;確實有應用程式無法接入時,再考慮 TUN。不要同時修改流量入口、DNS 和路由,否則發生問題後難以判斷原因。
安裝設定
先選對用戶端與架構,再匯入設定。權限問題和連線參數分開處理。
Windows 版 v2rayN 桌面版和經典 WPF 版該怎麼選?
桌面版採用跨平台介面,經典 WPF 版則保留 Windows 上熟悉的操作方式。先查看下載中心目前提供的版本所需作業系統與執行環境,再依使用習慣選擇,別只憑介面新舊推測連線速度。兩個版本的選單位置、設定儲存位置與移轉方式可能不同;切換前,請使用用戶端提供的匯出或備份功能保存設定,並妥善保管其中的憑證。確認新版本能正常匯入並連線後,再處理舊設定。若啟動時提示缺少相依元件,請依明確提示處理,勿隨意複製其他版本的程式檔案。
Android 安裝檔的 arm64 和 universal 該怎麼選?
多數較新的 Android 手機採用 arm64 架構,可先查看裝置規格或系統資訊,確認支援後選擇 arm64 安裝檔。universal 安裝檔通常包含多種處理器架構,適合暫時無法確認架構時使用,但檔案通常較大。處理器支援某種架構,不代表目前的系統環境一定支援相同的應用程式執行方式,仍須以裝置實際狀況為準。若安裝檔無法解析,也請檢查系統版本需求、檔案是否下載完成,以及安裝權限。更新同一用戶端時,簽章不一致也可能導致無法覆蓋安裝,請先備份設定再處理。
如何將訂閱網址匯入 v2rayN 或 v2rayNG?
在 v2rayN 開啟訂閱群組相關設定,新增群組並填入方便辨識的備註和完整訂閱網址,儲存後執行該群組的更新。在 v2rayNG 中進入訂閱群組設定,新增網址並儲存,再返回清單執行更新訂閱;實際選單名稱請以目前版本為準。複製網址時,留意前後空格、換行,以及通訊軟體附加的標點符號。更新完成後,還需選擇實際使用的連線設定,再啟用合適的代理入口。如果取得的是單筆協定分享連結,應使用剪貼簿匯入,而非填入訂閱網址欄位;兩種入口不可混用。
啟用 TUN 模式時提示權限不足,該怎麼辦?
TUN 需要建立或管理虛擬網路介面;在桌面系統上可能需要系統管理員權限、特權服務或系統授權,實際要求取決於用戶端版本與平台實作。先查看記錄中的權限錯誤,再依用戶端提示授權,勿直接關閉系統安全功能。Android 通常會跳出系統 VPN 連線授權畫面,確認後才能建立介面;其他正在執行的同類連線也可能造成衝突。初步排查時,可先關閉 TUN,改用系統代理確認同一項設定能否連線。若系統代理正常但 TUN 失敗,應優先檢查權限、介面建立與路由衝突,而非立即修改伺服器參數。
使用技巧
測試結果需配合實際請求判讀。調整路由和更新訂閱時,都應保留可還原的基準設定。
匯入多筆設定後,如何選擇可用節點?
先確認訂閱已成功更新,再從清單選擇一筆設定作為目前連線,執行用戶端提供的實際連線測試,並以應用程式實際連線驗證。TCPing 主要反映是否能與目標連接埠建立 TCP 連線,無法完整證明驗證、安全層與代理出口都正常;實際連線測試也取決於所選測試網址是否可連線。不要只依單次數值排序,應觀察常用服務是否穩定、有無持續錯誤,以及記錄中的交握是否完成。測試時盡量維持相同網路、測試目標與路由設定,避免直接比較不同條件下的結果。
如何確認系統代理已生效?
在用戶端選擇自動設定系統代理或相應的啟用選項,再開啟作業系統的代理設定,確認代理位址指向本機,且連接埠與用戶端目前的監聽值一致。接著使用遵循系統代理的瀏覽器開啟目標網頁,並查看用戶端記錄或連線紀錄中是否出現相應請求。如果瀏覽器安裝了獨立的代理擴充功能,應先確認它是否覆蓋系統設定。終端機工具、部分下載程式和使用自有網路堆疊的應用程式可能不讀取系統代理,需另外設定或採用合適的接入方式。只看到用戶端程序正在執行,不能證明應用程式的請求已經經過代理。
如何調整規則分流,避免修改後無法連線?
先保留一份可正常使用的路由設定,再確認目標應用程式或網域應直連、走代理還是封鎖。規則通常依序比對,前面的寬泛條件可能覆蓋後面的精確條件,因此新增規則後,應檢查實際套用的出口,不要只確認設定已儲存。網域規則是否生效,也和請求是否帶有網域、嗅探設定及 DNS 處理方式有關。每次只修改一組條件,再以相同目標測試;若發生誤封鎖,先還原最近的變更。規則集名稱和支援語法依核心而異,不可直接混用不同核心的整套設定。
更新訂閱前需要備份什麼?手動修改能保留嗎?
更新前記下群組名稱、目前使用的連線、訂閱網址,以及自行維護的路由和 DNS 設定,並優先使用用戶端內建的備份功能。更新訂閱可能會取代由遠端管理的連線項目,直接修改訂閱項目的參數不一定會保留。若需要長期修改,可在用戶端支援的情況下複製成獨立設定,並清楚區分訂閱來源與本機維護的版本。備份檔也可能包含驗證資訊,應存放於安全位置。移轉至其他裝置或用戶端後,先確認設定匯入與連線正常,再刪除舊環境,避免只留下無法還原的截圖。
故障排除
依請求路徑逐步定位:取得訂閱、解析設定、連線交握、應用程式接入、網域解析。
訂閱更新失敗,或更新後清單變空,該檢查哪些項目?
先確認訂閱網址完整、是否已過期及是否有存取權限,再查看記錄中的請求結果。連線逾時、驗證失敗和回應格式無法辨識是不同問題;若回應內容是登入頁面或錯誤訊息,即使請求成功,也不能視為有效訂閱。確認用戶端支援提供者輸出的訂閱格式,必要時請對方提供相容格式;勿將私人網址提交給不明的轉換服務。如果只能透過代理存取訂閱來源,可在已有可用連線的前提下,嘗試用戶端的透過代理更新選項。清單突然變空時,先保留備份,避免反覆刪除群組而造成更多設定遺失。
節點連線逾時,為什麼不能只看連接埠測試結果?
逾時可能發生在網域解析、連線至伺服器、安全層交握或代理出口請求等階段。先確認目前網路能否直接連上一般網站,再查看記錄最後停在哪個階段。TCP 連接埠可連通,只代表部分連線路徑正常,無法證明 UUID、密碼、伺服器名稱或其他安全層參數正確。確認設定是否過期、系統時間是否準確,並以另一筆已知可用的設定作對照。如果所有設定都失敗,優先檢查本機防火牆、網路環境和用戶端入口;若只有一筆失敗,再著重檢查該伺服器的狀態與參數。
用戶端顯示已連線,但瀏覽器仍無法上網,該怎麼辦?
顯示已連線可能只代表本機服務或虛擬介面已啟動,不保證目標請求能成功。先關閉其他代理工具,確認已選取目前要使用的連線設定,再檢查系統代理位址與監聽連接埠是否一致。分別使用用戶端的實際連線測試和瀏覽器連線驗證,並查看記錄中是否有請求進入。沒有請求時,優先確認應用程式是否繞過代理;有請求但交握失敗時,核對連線參數;只有部分網域失敗時,檢查 DNS 與路由。若已啟用 TUN,可暫時切回系統代理作對照。每次只修改一項設定並記錄結果,避免同時調整多項而失去比較基準。
IP 位址能連線,網域卻打不開,是 DNS 問題嗎?
這種情況值得優先檢查 DNS,但直接用 IP 位址連線也可能因 HTTPS 憑證或網站託管方式而失敗,不能只憑一次測試下結論。先查看用戶端是否記錄了解析逾時、解析伺服器無法連線或網域規則未命中,再核對系統與用戶端各自的 DNS 設定。瀏覽器內建的安全 DNS 可能使用不同路徑,排查時需確認實際使用哪一套。調整解析方式後,清除相關快取,並以相同目標重新測試。如果代理伺服器位址本身使用網域,也要確認在建立代理連線前能解析該網域,避免解析請求依賴尚未建立的代理連線。