V2Ray 常見問題
與疑難排解

先依裝置選擇圖形化用戶端，再了解核心。V2Ray 通常指 Project V 代理生態系中的核心專案；V2Fly 是其社群的延續，Xray 則是相關的核心專案。v2rayN 是適用於 Windows、macOS、Linux 的桌面用戶端，可管理設定、呼叫核心及設定代理；v2rayNG 則是採用 Xray 核心的 Android 用戶端。用戶端介面與核心屬於不同層級，介面能啟動不代表核心已在執行。排查時，請分別確認設定已匯入、核心已啟動，以及應用程式流量已經進入代理。

需要。先準備有權使用的伺服器設定或訂閱連結，再匯入用戶端。用戶端提供設定管理與流量轉送功能，本身不包含可連線的遠端服務。訂閱通常會將多個伺服器設定集中在同一個網址，更新後由用戶端產生項目；單一分享連結通常只包含一組設定。不要把服務商的登入頁面網址當成訂閱，也不要在公開討論區分享訂閱。訂閱可能包含存取憑證，截圖、記錄檔及求助內容都應遮蔽連結、使用者識別資訊與驗證資料。

先分清流量如何進入用戶端，再判斷進入後會走哪個出口。系統代理會向系統登記代理位址，只有遵循此設定的應用程式會使用；全域路由通常是將已進入核心的流量送往代理出口，並不代表會接管裝置上的所有程式。TUN 透過虛擬網路介面接收指定範圍內的流量，適合不讀取系統代理設定的應用程式，但會涉及權限、路由與 DNS。初次設定建議先用系統代理確認連線，再視需要測試 TUN，避免同時變更流量入口與路由規則。

先用實際要連線的網站或應用程式重現問題，再比較不同伺服器。延遲測試只反映特定探測方式及目標的回應時間，不等於持續傳輸速度，也無法直接代表所有網站都能正常使用。網頁載入還會受到 DNS、傳輸封包遺失、遠端出口、目標服務及本地網路影響。比較時請保持網路、路由模式與測試目標一致，每次只更換一台伺服器。若小型網頁正常、大型檔案下載緩慢，請優先檢查頻寬與封包遺失；若只有單一網站異常，則先檢查該網域的分流結果與目標服務狀態。

先確認裝置處理器與系統支援的應用程式架構。多數較新的 Android 手機可選 arm64，安裝包通常較小；不確定架構時可選 universal，因為它包含多種架構所需的檔案，容量也較大。處理器支援 64 位元，不代表系統一定允許安裝 64 位元應用程式，較舊的裝置尤其需要確認。若系統提示安裝包不相容，先檢查架構、系統版本與儲存空間，再考慮更換安裝包。更新既有用戶端時，也要留意套件名稱與簽章是否一致；若必須解除安裝後重裝，請先備份可匯出的設定。

Windows 使用者可先依下載頁的系統需求選擇桌面版；桌面版採用跨平台介面，適合從一致的操作流程開始使用。習慣傳統介面的使用者可選擇 WPF 版，並確認已安裝所需的執行環境。兩個版本的選單位置與設定名稱可能不同，不要只憑舊教學的畫面截圖就認定功能不存在。升級或更換版本前，請先關閉正在執行的用戶端、備份設定，並使用獨立資料夾測試，避免多個執行個體搶用本機連接埠。macOS 與 Linux 使用者應選擇對應平台的桌面安裝包。

先確認複製的是完整訂閱網址，移除前後的空格與換行，並檢查連結是否過期、已重設或需要重新授權。接著確認用戶端支援該訂閱格式；若下載到的是登入頁面、錯誤頁面或其他用戶端專用設定，通常無法解析出伺服器。若更新請求必須透過既有代理才能連線，請先選擇可用設定，再使用經由代理更新的選項。排查時保留原有群組，另外建立測試群組匯入，避免覆寫有效設定。記錄檔只需確認錯誤類型，分享前務必遮蔽完整訂閱網址。

先關閉 TUN，確認一般系統代理可以連線，再另外處理權限問題。Windows 請依用戶端提示安裝或啟動所需服務，必要時以系統管理員權限操作；macOS 與 Linux 請依各自版本說明完成系統授權或特權服務設定，不要直接套用其他平台的指令。Android 用戶端會使用系統 VPN 授權，首次連線時需確認授權提示。既有 VPN 或其他虛擬網路工具可能互相衝突，請先關閉後再測試。處理好權限後重新啟用 TUN，並檢查記錄檔是否已建立介面與路由，不要只看開關狀態。

先選擇可用的伺服器並啟用自動設定系統代理，再查看系統設定中的代理位址與連接埠是否和用戶端的監聽設定一致。使用遵循系統代理設定的瀏覽器開啟測試頁面，同時查看用戶端記錄檔或連線紀錄是否出現對應請求。若要更明確地驗證，可讓命令列工具明確使用本機代理連接埠，再與未使用代理時的結果比較；兩種測試驗證的是不同的流量入口。瀏覽器擴充功能、內建代理設定及快取都可能影響判斷。出口位址變更只能作為輔助證據，最好同時核對請求紀錄與路由結果。

先使用預設路由分流建立穩定基準，確認常用網站、區域網路裝置與工作應用程式都能正常連線。分流會依網域、位址與規則順序選擇直連或代理，適合日常混合使用；全域路由則較適合短時間確認故障是否由分流規則造成。若全域路由正常、分流卻有問題，請檢查目標網域符合的規則、DNS 解析結果及規則資源是否可用，不要長期依賴全域路由掩蓋問題。測試後請還原原有設定，並留意內網服務是否被錯誤送往遠端出口，以免影響列印、檔案分享或企業網路。

依訂閱來源建立獨立群組，為群組取容易辨認的名稱，也不要將同一訂閱重複匯入多個位置。更新前記下目前使用的項目與重要參數，更新後再確認選取的項目仍然有效，因為伺服器端可能會刪除、重新命名或調整設定。手動新增的設定盡量放在獨立群組，避免被訂閱更新取代。定期清理失效群組，但不要頻繁重設所有設定。使用自動更新時，確認目前網路可以連上更新來源；發生異常後先檢查更新時間與記錄檔，再決定是否重新匯入。

先備份現有設定，記下目前使用的核心及一組已確認可用的設定，再確認目標核心是否支援該設定的協定、傳輸方式與安全參數。用戶端提供切換選項，不代表所有設定都能直接通用；尤其要留意擴充欄位、DNS 設定及 TUN 實作的差異。切換後先用簡單路由與單一伺服器測試，確認連線正常後再還原自訂規則。若出現未知欄位或啟動失敗，請切回原核心並對照記錄檔，不要不斷刪除參數碰運氣。用戶端與核心的更新也應分開驗證，方便找出變更來源。

從本機、訂閱、伺服器與系統四個層面依序檢查。先確認裝置時間正確、網路可用，且核心啟動後本機連接埠確實正在監聽；接著更新訂閱，排除網址過舊、憑證過期或匯入不完整。然後核對伺服器位址、連接埠、傳輸方式與安全參數，並在同一網路下用另一組已知可用的設定比較。最後檢查防火牆、其他代理工具與虛擬網路是否衝突。單次逾時無法證明遠端服務已失效，重複測試時應保持目標與條件一致。記下首次出錯的時間與記錄檔中的錯誤類型，比反覆重裝更能協助定位問題。

先查看核心記錄檔，確認遠端連線確實成功，而不是只有啟用本機代理或 VPN 介面。接著檢查瀏覽器的請求是否進入用戶端：若沒有請求，請核對系統代理、瀏覽器個別設定與本機連接埠；若已有請求但連線失敗，再檢查路由、DNS 與伺服器狀態。若只有網域無法存取，優先檢查解析錯誤；若區域網路與所有網站都同時異常，請停用 TUN 後重測，並檢查路由衝突。先只保留一個代理入口與一個執行中的用戶端，排除其他工具的干擾，不要同時修改 DNS、連接埠與路由模式。

先保留舊設定，不要清空清單。既有伺服器仍可使用，只能代表代理連線正常，不表示訂閱網址仍有效。檢查訂閱是否已重設、到期或觸發請求限制，並確認裝置時間與憑證是否有錯誤。若直連更新失敗，可先選取可用伺服器，再嘗試透過代理更新；若經代理更新失敗，也請和直連結果比較，避免更新請求形成依賴。若伺服器端回傳登入頁面或格式已變更，請重新取得相容的連結。不要在短時間內連續重新整理；記下狀態碼與錯誤摘要，聯絡訂閱服務提供者時請遮蔽驗證資訊。

連接埠被占用時，先確認是否啟動了第二個用戶端執行個體，再使用系統網路工具找出占用該監聽連接埠的程序。確認程序用途後，關閉衝突程式，或在參數設定中改用未被占用的連接埠，並同步修改手動設定的瀏覽器及其他應用程式代理。不要終止來源不明的系統程序。若用戶端退出後無法直連，先前往系統代理設定關閉殘留的手動代理或自動設定網址，再確認 TUN 與其他 VPN 是否仍在執行。網路恢復後重新啟動一個用戶端進行驗證；之後盡量先清除系統代理，再正常結束用戶端。