客戶端設定與連線排查

V2Ray 常見問題

訂閱匯入、代理模式、TUN 權限。
先確認問題發生在哪個環節,再檢查相應設定。

記下錯誤原文與觸發操作;分享記錄前,請隱藏訂閱網址與驗證資訊。

連線排查流程
從應用程式入口,經核心與路由,檢查到遠端連線;DNS 參與網域名稱解析。 核心 DNS 應用程式入口 路由出口 遠端連線

依流程逐步排查,每次只調整一項設定。

概念與選擇

基礎認識

分清客戶端、核心、設定與流量入口,避免混淆不同環節的問題。

V2Ray、V2Fly、Xray 與圖形化客戶端有什麼關係?

V2Ray 通常指 Project V 生態系中的代理核心及相關工具;V2Fly 是延續 V2Ray 開發的社群專案,Xray 則是另一個核心分支。v2rayN、v2rayNG、v2flyNG 提供圖形介面,用來匯入設定、選擇伺服器及管理代理入口。能開啟圖形介面,不代表核心已成功執行;排查連線時也應查看核心啟動記錄。設定能否使用,取決於核心對協定及具體參數的支援,不能只看客戶端名稱。

Windows、macOS、Android 和 Linux 各適合使用哪個客戶端?

Windows、macOS、Linux 桌面裝置可優先選擇 v2rayN,再依處理器架構與安裝套件格式選擇下載項目。Windows 可選桌面版或經典 WPF 版;macOS 請確認是 Apple Silicon 還是 Intel;Linux 則須同時確認架構與發行版套件格式。Android 可優先考慮採用 Xray 核心的 v2rayNG;需要 V2Fly 核心環境時,可選擇 v2flyNG。先確認現有設定的協定與傳輸需求,再決定客戶端,避免把核心差異誤認為訂閱失效。

安裝好客戶端後,為什麼還需要訂閱或伺服器設定?

客戶端是管理連線的工具,本身不會附帶可直接使用的遠端伺服器。訂閱可集中取得伺服器設定;單一分享連結通常代表一項連線,包含位址、連接埠、驗證資訊與傳輸參數。安裝後須匯入自行管理或有權使用的設定,再選擇目前使用的伺服器。訂閱網址往往含有存取憑證,應妥善保管為敏感資訊;向他人求助時,請勿公開完整網址、QR Code 或含驗證資訊的截圖。

系統代理、全域路由和 TUN 是同一個開關嗎?

這三者負責不同環節。系統代理會提供本機代理位址給支援此設定的應用程式;全域路由則決定流量進入核心後如何選擇出口,並不會自動接管所有應用程式;TUN 透過虛擬網路介面接收符合接管範圍的流量。通常可先使用系統代理搭配預設路由確認基本連線,再依應用程式需求考慮 TUN。排查單一網頁時,不要同時開啟所有功能,否則難以判斷問題出在流量入口、規則還是遠端連線。

安裝套件與首次匯入

安裝設定

先選對裝置架構,再完成訂閱匯入與系統授權。

訂閱匯入失敗或匯入後清單是空的,該先檢查什麼?

先確認要匯入的是訂閱網址還是單一分享連結,分別使用訂閱管理或從剪貼簿匯入的功能。複製內容時請移除前後空格、換行及通訊軟體附帶的說明文字,並確認訂閱網址沒有遭到截斷。儲存訂閱群組後,還須執行更新訂閱;若清單為空,請檢查群組篩選條件與更新記錄。若回傳的是登入頁面、錯誤頁面或不支援的設定格式,重複貼上也無法解決,應確認存取權限或取得適用於目前客戶端的訂閱格式。

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

2015 年後推出的主流 Android 手機通常可先考慮 arm64,但仍應以裝置處理器及系統實際支援的應用程式架構為準。若無法確認架構,可選擇 universal 通用套件;它包含多種架構的相容內容,檔案通常較大。若出現無法安裝的提示,也請檢查系統版本需求、剩餘儲存空間,以及是否已有簽章不同的同名應用程式。更換安裝來源前先備份設定,不要直接解除安裝;即使安裝成功,也須實際啟動並測試連線,確認系統相容性。

v2rayN 桌面版和經典 WPF 版該怎麼選?

Windows 桌面版採用新一代跨平台介面,經典 WPF 版則適合習慣原有操作方式的使用者;兩者的選單位置與部分功能呈現可能不同。初次使用可從下載中心的桌面版開始;若已有穩定的操作流程,則可依相容需求選擇 WPF 版。請勿同時讓兩個執行個體管理系統代理或監聽相同連接埠。切換前先匯出設定並保留原目錄;若啟動時提示缺少執行環境,請依安裝套件的提示安裝所需元件,不要反覆更換訂閱。

Android 首次連線時出現 VPN 授權提示,該怎麼處理?

v2rayNG 和 v2flyNG 透過 Android VPN 服務建立本機流量入口,首次啟動連線時需要取得系統授權。確認提示來自目前操作的客戶端後再允許;取得授權本身不代表遠端伺服器已連線。若授權後立即中斷,請檢查是否有其他 VPN 服務占用連線,以及系統是否限制背景執行。若裝置受機構管理,或設有工作資料設定,相關權限可能由管理員控管;請勿反覆重新安裝客戶端,試圖繞過管理限制。

代理入口與規則

使用技巧

先確認應用程式是否進入核心,再決定路由模式與接管範圍。

系統代理已開啟,為什麼某個應用程式仍未使用代理?

系統代理只對遵循系統代理設定的應用程式生效;部分應用程式使用獨立的網路設定,既有連線也可能繼續沿用舊路徑。先確認客戶端核心正在執行,並檢查系統中的代理位址與連接埠是否和客戶端本機入口一致,再重新啟動目標應用程式。若瀏覽器設有獨立代理擴充功能,也應排除設定互相覆蓋的情況。需要代理不讀取系統代理設定的應用程式時,可使用其內建代理選項,或先了解流量接管範圍再設定 TUN;切換全域路由無法取代流量接管。

全域、繞過中國大陸與規則模式該怎麼選?

日常使用可先採用客戶端提供的規則模式或繞過中國大陸預設,再依實際需求調整。全域模式通常會讓進入核心的流量優先走代理出口,但仍可能受預設例外規則影響;繞過中國大陸模式依據網域、位址規則及相關資源,讓符合條件的連線直連;自訂規則模式則依規則順序決定出口。不同客戶端的模式名稱與實際內容不盡相同,請查看目前使用的規則,不要只憑名稱判斷。切換後請以新連線測試,避免沿用舊連線而誤判。

啟用 TUN 時提示權限不足,需要一直以系統管理員身分執行嗎?

TUN 需要建立虛擬介面並調整相關路由;若權限不足,應先查看記錄中失敗的具體操作。Windows 可能需要系統管理員權限,或使用客戶端提供的服務模式;macOS 和 Linux 則依客戶端提示完成系統授權。是否需要持續提升權限,取決於安裝方式與服務設定,不能一概而論。先關閉 TUN,確認一般代理入口可以連線,再處理權限與介面衝突;也請檢查是否有其他 VPN 或虛擬網卡軟體,不要直接關閉整體系統防護。

多個訂閱該如何管理,更新時怎麼避免覆蓋手動修改?

建議依來源建立不同的訂閱群組,並使用容易辨識的群組名稱。更新前確認目前群組、篩選條件與使用中的伺服器,避免把篩選後的清單誤認為更新時資料遺失。更新訂閱可能會重新產生來源中的伺服器項目,因此不要直接修改訂閱項目並期待自訂參數能長期保留;若需個別調整,可在客戶端支援的範圍內複製為本機設定並另外管理。定期匯出備份;刪除訂閱前,請確認本機項目是否會隨群組一併刪除。

依症狀排查

故障排查

保留原有設定,搭配記錄與交叉測試縮小範圍;每次只變更一個條件。

節點測試逾時,應依什麼順序排查?

先確認裝置本身可以正常連網,再檢查核心是否成功啟動,以及本機連接埠是否遭到占用。接著核對伺服器位址、連接埠、驗證參數與傳輸設定;裝置時間不正確也可能影響安全連線。測試逾時只表示這次測試未能在時限內完成,不能單憑此結果判定伺服器無法使用;部分測試方式與實際網頁請求的路徑不同。可改用已知可用的設定和網路交叉測試,再搭配記錄判斷是位址解析失敗、連線遭拒、憑證錯誤,還是遠端回應逾時。

客戶端顯示已連線,但網頁仍然打不開,該怎麼排查?

顯示已連線通常只代表本機服務或虛擬介面已啟動,不表示請求已成功抵達遠端。先確認已選擇可用的伺服器,再查看開啟網頁時記錄中是否出現相應連線;若沒有記錄,優先檢查應用程式入口、系統代理與 TUN 接管範圍。若有記錄但連線失敗,則檢查路由出口、DNS、驗證資訊與傳輸參數。先用單一瀏覽器開啟明確的測試頁面,暫停其他代理工具,每次只調整一項設定;不要一開始就重設所有設定,以免失去排查線索。

原本能更新的訂閱突然更新失敗,該怎麼辦?

先查看更新記錄,確認問題是連線逾時、位址解析失敗、存取遭拒,還是回傳內容無法解析。檢查訂閱是否已過期、網址是否變更,以及裝置時間是否正確。若必須透過現有代理才能存取訂閱,且客戶端提供此選項,可選擇透過代理更新;但前提是已有可用的伺服器。若可直接連線存取,就不必刻意繞道。請勿先刪除仍可使用的舊項目,也不要將完整訂閱網址貼到公開討論區;記下錯誤類型,並向訂閱來源確認存取狀態。

DNS 出錯或部分網域無法開啟,要直接啟用 FakeDNS 嗎?

不建議把 FakeDNS 當成萬用修復開關。先區分系統解析、瀏覽器安全 DNS 與核心 DNS,確認問題發生在哪一層,並檢查目前的 DNS 伺服器是否能透過預定出口存取。若只有部分網域失敗,也應查看網域規則、解析策略及是否有過期快取。FakeDNS 會回傳用於映射的虛擬位址,必須搭配流量接管與路由設定;單獨啟用可能引發其他問題。先恢復容易理解的基本 DNS 設定,再依 TUN 等使用情境逐項設定並測試。