V2Ray 常見問題
設定與連線排查

Project V 是相關代理工具的生態背景，V2Fly 與 Xray 則是不同的核心專案。核心負責協定連線、路由與流量轉送；圖形化客戶端則提供訂閱管理、伺服器選擇及設定介面。桌面平台可使用 v2rayN；Android 可使用採用 Xray 核心的 v2rayNG，或採用 V2Fly 核心的 v2flyNG。支援哪些協定，取決於實際使用的核心及其版本，不能只看客戶端名稱判斷。遇到相容性問題時，先記下客戶端與核心資訊，再確認伺服器所需的功能。

客戶端提供本機代理介面與核心執行環境，伺服器設定仍須另外匯入。訂閱網址通常會提供一組設定，分享連結通常對應單一設定，請使用各自的匯入入口。安裝完成後，先準備有權使用的訂閱網址或分享連結，再匯入並選擇伺服器。清單空白不代表安裝失敗，開啟系統代理也不會自動產生伺服器。請勿在公開截圖或求助內容中貼出訂閱網址，其中可能含有可直接存取訂閱內容的憑證。

系統代理會引導遵循系統代理設定的應用程式，將請求送至本機監聽連接埠，但不保證所有程式都會被接管。路由模式則處理已進入核心的流量，決定由代理、直連或阻擋。TUN 透過虛擬網路介面接收符合接管條件的流量，涉及路由、DNS 與權限設定。三者作用層級不同。排查時，先確認應用程式流量是否進入客戶端，再查看符合哪條路由，最後檢查出口連線；不要把開啟系統代理當成所有流量都已走代理。

不能直接畫上等號。TCP 測試主要確認能否連上目標位址與連接埠，無法完整驗證驗證資訊、傳輸參數或網頁存取。真實連線測試較接近實際請求，但結果也會受測試網址、DNS、目前路由與網路狀態影響。要判斷是否可用，請選擇伺服器後透過實際應用程式連線，並查看同一時間的客戶端記錄。不要只依最低延遲排序，就認定連線正常；若測試成功但網頁無法開啟，先檢查應用程式的代理入口與網域解析，再確認伺服器參數。

先確認複製的是完整分享連結，包含 vmess://、vless://、trojan:// 或 ss:// 等協定前綴，而不是網頁網址或訂閱網址。移除前後空白、聊天軟體附加的說明文字及多出的換行，再使用從剪貼簿匯入的功能。若仍失敗，查看匯入提示，分辨是格式無法解析，還是目前不支援該協定。不要為了匯入成功而任意修改編碼內容、驗證欄位或傳輸參數；請重新取得原始連結，並確認目前的客戶端與核心支援該設定。

在 v2rayN 的訂閱群組設定中新增群組，輸入方便辨識的名稱與完整訂閱網址，儲存後執行該群組的訂閱更新。Android 客戶端也應先儲存訂閱，再執行更新，而不只是新增群組名稱。新增網址不代表已取得設定。更新完成後，檢查結果提示、群組篩選條件與伺服器清單；若回傳內容是登入頁、錯誤頁或一般網頁，客戶端就無法產生有效設定。此時請確認網址是否已過期，以及回傳內容是否為客戶端支援的訂閱格式。

2015 年後推出的主流 Android 手機通常可優先選擇 arm64，最終仍應以裝置實際支援的應用程式架構為準。universal 包含多種架構元件，通常檔案較大，適合不確定裝置架構時使用；這不代表支援更多協定功能。若安裝 arm64 時顯示不相容，先確認系統版本與架構，再嘗試通用版。更新既有客戶端時，應維持相同的應用程式來源與簽章。不要直接解除安裝來迴避更新錯誤，請先備份必要設定，以免遺失訂閱群組與手動新增的伺服器。

桌面版先查看記錄，確認問題發生在權限申請、虛擬介面建立，還是路由設定階段，再依客戶端要求授權；若需要提高權限，請使用作業系統提供的授權流程。Android 首次建立連線時，通常需要確認系統的 VPN 連線要求，也要檢查是否有其他應用程式占用該連線。不要反覆切換多個流量接管工具。先關閉衝突項目，確認一般代理連線正常，再單獨啟用 TUN。授權後仍無法使用，應檢查虛擬介面、服務元件與路由錯誤，而不是繼續更換節點。

若主要使用會遵循系統代理的瀏覽器，可先啟用自動設定系統代理，再選擇符合需求的路由規則，例如繞過中國大陸。若要確認某個目標是否受到分流影響，可暫時切換至代理出口較集中的規則進行比較，完成後再恢復原設定。模式名稱可能因版本而異，請以實際規則為準。所謂全域模式通常是指流量進入核心後的路由選擇，不代表會自動接管所有應用程式。不讀取系統代理設定的程式，應另外設定本機代理位址，或確認相容性後使用 TUN。

先開啟客戶端的參數設定，查看目前的 HTTP、SOCKS 或混合監聽連接埠，再於應用程式中選擇相應的代理類型，位址通常填入 127.0.0.1。請勿把伺服器的遠端連線連接埠填成本機連接埠，也不要假設所有版本使用相同的預設值。修改監聽連接埠後，確認核心已成功重新載入，並同步更新應用程式設定。僅在本機使用時，請關閉允許區域網路連線的選項；若確實需要讓其他裝置連線，也要確認監聽位址、防火牆與存取控制，避免對不受信任的網路開放入口。

訂閱中的伺服器通常由遠端內容管理，更新時可能遭到替換、刪除或重建，手動修改不一定會保留。需要長期保存的自訂設定，應另存於客戶端支援的獨立群組，並記下修改原因。更新前確認訂閱範圍，避免誤動其他群組。若某個參數每次更新後都會還原，請勿持續修改訂閱項目；應檢查客戶端是否提供本機覆寫設定，或向設定提供者確認原始參數。備份檔也可能包含訂閱憑證，請妥善保管。

先確認請求已進入核心，並檢查目前啟用的路由設定，不要只看編輯視窗中的規則。規則通常依序比對，前面的廣泛規則可能讓後續的細項規則無法執行。以單一目標發出請求，再根據記錄中的目標、符合的規則與出口資訊判斷；記錄內容會依核心與記錄層級而異。也要確認規則資源可正常使用，網域策略符合預期。調整時一次只改一項並記下原值；測試後關閉不必要的除錯記錄，避免累積包含瀏覽紀錄的檔案。

先確認訂閱網址完整且尚未過期，並檢查裝置時間是否正確，再查看更新記錄。連線逾時、憑證錯誤、驗證失敗與內容解析失敗是不同問題。若目前的代理本身無法使用，透過代理更新也可能失敗；若客戶端提供相應選項，可嘗試直連更新。若直連無法存取訂閱網址，就需要可用的連線途徑。不要反覆將同一網址貼到第三方轉換頁面。若伺服器已回傳內容但解析失敗，應確認回傳格式，而不是繼續調整本機監聽連接埠。

先確認本機網路可正常連線至常用直連服務，再檢查裝置時間、伺服器位址、連接埠與設定有效期限。分開查看 TCP 測試與真實連線測試：前者失敗時，優先檢查位址解析、網路路徑與遠端連接埠；前者成功但後者失敗時，再檢查驗證資訊、TLS、SNI、傳輸路徑與核心相容性。使用同一個網路，逐一測試少量設定，不要一次大量測試伺服器，以免影響判斷。需要求助時，記下錯誤類別與發生時間；分享記錄前，請隱藏位址、訂閱網址與驗證資訊。

顯示已連線，可能只代表本機核心或 VPN 介面已啟動，不代表遠端請求成功。先確認應用程式送出請求時，記錄中是否出現對應連線；若沒有，檢查系統代理、應用程式的個別代理設定或 TUN 接管狀態。若有記錄，再分辨是 DNS 解析失敗、連線逾時、驗證錯誤，還是路由選錯出口。若只有特定網域無法連線，應檢查該網域的解析與規則，不必重裝客戶端。暫時停用其他代理工具，並以單一應用程式重新測試；每次只調整一項設定，才能找出問題出在入口、解析或遠端出口。

先確認 v2rayN 正在執行、核心沒有啟動錯誤，且系統代理設定中的本機位址與連接埠和客戶端一致。瀏覽器可能使用個別代理或擴充功能設定，請確認這些設定沒有覆蓋系統設定。退出後無法上網時，開啟作業系統的代理設定，查看是否仍指向已關閉的本機監聽連接埠；清除不再使用的代理設定後再試。若有其他軟體正在修改系統代理，先確認由哪個工具負責管理。之後退出前可先使用客戶端的清除系統代理功能；不遵循系統代理的應用程式仍須個別檢查。