V2Ray 常見問題
訂閱與連線排查

先區分核心與介面。V2Ray 屬於 Project V 技術生態系；V2Fly 與 Xray 是相關的核心系列，負責協定處理、路由與網路連線。v2rayN 是桌面圖形化用戶端，v2rayNG 是 Android 圖形化用戶端，用來匯入設定並管理連線。v2flyNG 則是採用 V2Fly 核心的 Android 替代選擇。安裝用戶端不代表已取得伺服器設定，仍須匯入有權使用的訂閱或分享連結，再依服務提供者的指示連線。

先看內容用途，別只看連結外觀。安裝包用來安裝用戶端；節點分享連結包含單一伺服器設定；訂閱網址則用來取得並更新一組伺服器設定。若把訂閱網址貼到單一節點的匯入入口，可能會出現格式無法辨識的提示；把網頁登入網址當成訂閱網址，也可能只會取得網頁內容。請向服務提供者取得適用於目前用戶端的訂閱連結，再填入訂閱群組設定。訂閱網址可能含有存取憑證，請勿貼到公開討論區，也不要提交給不熟悉的轉換服務。

先釐清流量在哪一層處理。系統代理會通知遵循系統設定的應用程式，將請求交給用戶端的本機監聽連接埠；路由分流則決定進入核心的請求要直連、經由代理或封鎖；TUN 透過虛擬網路介面接管符合條件的流量。啟用系統代理不代表所有程式都會使用代理；啟用 TUN 也不代表所有目的地都會走代理，核心路由仍會生效。排查時先關閉 TUN，確認一般系統代理可以連線，再單獨測試 TUN，避免同時變更多層設定。

先確認已有有效設定。用戶端用來管理連線，不會因為安裝完成就自動取得可用伺服器。延遲測試只是特定測試方式在當下網路環境中的結果，不代表瀏覽網頁、下載或播放影片一定正常。TCP 測試主要反映連接埠是否連通；實際連線測試還會經過協定交握並連到測試目標。如果延遲數值正常但網頁無法開啟，請繼續檢查服務是否到期、系統時間、DNS 與路由。不要只憑單一延遲數值反覆切換核心，先用相同設定進行對照測試。

先查看裝置處理器與系統架構。較新的主流 Android 手機通常可選 arm64 安裝包，檔案通常比包含多種架構的 universal 安裝包小；若不確定架構、使用較舊裝置或遇到架構不相容，可嘗試 universal。處理器支援 64 位元，不一定代表裝置執行的是 64 位元系統，請以裝置系統資訊和實際安裝結果為準。如果仍顯示無法安裝，請檢查 Android 系統需求、可用儲存空間，以及是否已安裝簽章不同的同名應用程式。更換簽章前先匯出設定，不要直接解除安裝唯一可用的用戶端。

先選作業系統，再選處理器架構。Windows 桌面版採用跨平台介面，WPF 版則保留傳統 Windows 桌面介面，兩者的選單配置和部分功能入口可能不同，請勿混用兩個版本的設定截圖。macOS 可在「關於這台 Mac」查看晶片資訊，Apple Silicon 選 arm64，Intel 選 x64。Linux 依發行版選擇 deb 或 rpm，再確認裝置是 x64 還是 arm64。安裝包格式不能取代架構判斷；若無法啟動，先確認下載類型和目前版本的系統需求，再考慮重新安裝。

先開啟訂閱群組設定，確認訂閱網址已儲存至正確群組，再更新該群組的訂閱。只儲存網址不一定會立即載入伺服器清單。檢查網址是否含有空格、換行或通訊軟體附加的標點，也確認目前清單沒有篩選到其他群組。如果回傳內容是登入頁面、到期提示或網頁錯誤訊息，重複匯入也不會產生節點，請先處理訂閱權限。若只有單一分享連結，請使用「從剪貼簿匯入」入口；仍無法辨識時，向提供者確認連結格式及用戶端支援範圍。

先關閉 TUN，確認一般系統代理能否連線，避免把伺服器故障誤判為權限問題。Windows 請依用戶端目前版本的要求，以系統管理員權限或服務模式啟動；Linux 請檢查所需權限及 TUN 裝置是否可用；macOS 則依系統提示授權。排查時不要直接關閉整套系統防護。若仍無法建立虛擬網卡，請退出其他會接管網路的工具，再查看記錄中的具體錯誤。不同系統、安裝方式與核心的權限處理方式不盡相同，修復後應重新啟動用戶端，並再次確認路由是否恢復正常。

先判斷更新請求使用哪一條網路路徑。如果目前節點已失效，而訂閱更新也經由該節點，連線故障就會導致更新失敗，此時可嘗試「更新訂閱（不經代理）」。如果目前的直連網路無法連上訂閱服務，則應先選擇仍可用的節點，再使用經由代理更新的方式。兩種方式都失敗時，請檢查訂閱是否到期、裝置時間、伺服器回應及記錄，不要一再重建群組。設定自動更新間隔前，先手動更新成功一次；縮短間隔無法修復無效網址，還可能觸發伺服器的請求限制。

先確認程式是否遵循系統代理。支援手動代理的程式，應填入用戶端目前監聽的協定、位址和連接埠；同一裝置通常使用 127.0.0.1，連接埠以參數設定中的本機混合監聽連接埠為準，不要預設所有版本都是 10808。終端機工具可能會讀取 HTTP_PROXY、HTTPS_PROXY 或自身設定，需另外確認；修改後重新啟動終端機再測試。無法設定代理的應用程式才考慮使用 TUN。不要為了讓本機程式連線而啟用允許區域網路連線，這會擴大監聽範圍。

先確認請求確實進入目前的用戶端，再檢查啟用的是哪一套路由規則。規則通常會依序比對，前面的廣泛規則可能先符合；網域、IP 和程序規則的適用對象也不同。使用 IPIfNonMatch 時，只有網域規則未符合，才會解析目標 IP 並繼續比對 IP 規則；這不代表所有網域都會強制先解析。儲存後視需要重新啟動服務，並關閉目標應用程式的既有連線再測試。如果應用程式使用內建代理或繞過系統代理，只修改核心路由不會改變實際連線出口。

先使用用戶端提供的匯出或備份功能，記錄訂閱群組、本機監聽連接埠、路由選擇、DNS 設定和自訂設定。備份含有敏感資訊，應存放在自己能妥善控管的位置。更新時先退出用戶端，保留原有設定和可供回復的安裝方式，再確認新版本能否讀取設定。切換至 Xray 或 sing-box 核心前，請確認節點協定及自訂參數是否相容；相同欄位在不同核心中可能有不同要求。每次先測試一項變更，確認連線正常後，再恢復自動更新、TUN 等附加功能。

先關閉用戶端代理，確認一般網路可以連線，再檢查訂閱是否到期，以及裝置時間是否自動同步。使用同一個節點，比較目前網路和另一個可用網路，判斷問題是否與接入網路有關；一次只測試一個節點，避免大量測試掩蓋具體錯誤。接著查看記錄，分辨網域解析失敗、連線逾時、連線遭拒和交握失敗。連接埠可連通不代表協定參數正確，請核對位址、連接埠、傳輸方式及 TLS 設定。不要關閉憑證驗證來掩蓋時間或憑證問題，也不要因單次逾時就判定用戶端損壞。

先確認已選取有效伺服器，並在 v2rayN 中選擇自動設定系統代理。檢查本機監聽連接埠是否與系統代理設定的連接埠一致，再暫時停用瀏覽器代理擴充功能，避免覆蓋系統設定。若瀏覽器正常但終端機無法連線，請單獨檢查終端機環境變數；若兩者都無法連線，請查看用戶端是否收到請求。記錄中沒有請求，通常應繼續檢查入口與代理設定；若已有請求但出現錯誤，再檢查節點、DNS 和路由。退出用戶端後仍無法直接連線時，重新開啟用戶端並執行清除系統代理，再檢查系統是否留有手動代理設定。

先依記錄中的錯誤類型分別處理。連接埠被占用時，檢查是否重複執行用戶端，或同時啟動其他代理程式；在 Windows 可使用 netstat -ano 查找該連接埠對應的程序 ID，確認程序用途後再退出，請勿直接結束不明的系統程序。也可在參數設定中變更本機混合監聽連接埠，並同步更新手動代理設定。如果錯誤是 DNS 解析失敗，先確認伺服器網域能否解析，再檢查核心 DNS 與路由是否形成循環。不要同時修改連接埠、DNS 和節點參數；每次只改一項，並保留變更前後的記錄。

先查看系統是否限制 v2rayNG 的背景活動與電池使用，依裝置設定允許必要的背景執行，並檢查連線狀態通知。Android 的 VPN 連線可能被另一個同類應用程式取代，請確認目前負責接管連線的應用程式。切換 Wi-Fi 與行動網路後，先中斷連線再重新連線，並觀察記錄是否重新建立連線；若只有特定網路無法連線，請繼續檢查該網路的 DNS 與連線狀況。一開始不要清除應用程式資料，請先匯出設定。若持續斷線，記錄發生時間、網路類型及已移除敏感資訊的錯誤訊息，再進一步排查。