V2Ray 常見問題與故障排除

V2Ray 屬於 Project V 代理工具生態系，V2Fly 延續相關核心的開發；Xray 則是另一條獨立發展的核心路線。v2rayN 是用來管理伺服器、訂閱、路由與本機代理的圖形化用戶端，實際連線由選用的核心負責。遇到設定欄位或協定無法辨識時，先確認用戶端目前呼叫的核心及其版本，不要只看視窗上的用戶端名稱。不同核心的 JSON 設定也不宜直接混用，尤其要核對傳輸、安全設定與路由欄位。

Windows、macOS 和 Linux 桌面版可使用 v2rayN；Android 通常可先選用採用 Xray 核心的 v2rayNG。若現有設定明確依賴 V2Fly 的行為，再考慮 v2flyNG。這三款用戶端都會將訂閱或伺服器參數交由核心執行，但介面選單、支援的協定與進階欄位並不完全相同。選擇時先確認作業系統，再核對伺服器使用的協定與傳輸方式。更換用戶端前，請先保存訂閱網址與必要設定；不能直接把另一款應用程式的整個資料目錄當成可匯入的設定。

用戶端安裝完成，只代表本機管理介面與執行環境已準備就緒，不會自動建立可用的伺服器連線。你還需要匯入有權使用的訂閱網址，或填寫伺服器位址、連接埠、使用者識別碼及相關傳輸參數。訂閱是分發一組伺服器設定的入口，並非用戶端本身；訂閱是否有效、伺服器是否可連線，也取決於對應服務。請先確認設定來源與有效期限，再匯入並選取要使用的伺服器。請勿將含有存取憑證的訂閱網址貼到公開留言、截圖或線上轉換工具。

系統代理會引導遵循系統設定的應用程式，將請求傳送到本機代理連接埠；部分終端機程式與應用程式不會讀取這項設定。路由分流則是在流量進入核心後，依網域、IP 或其他條件決定要走代理、直連或封鎖。TUN 模式透過虛擬網路介面接管符合條件的流量，通常會涉及系統網路權限、路由表與 DNS。排除問題時，先用一般本機代理確認伺服器可以連線，再分別啟用系統代理或 TUN。不要同時變更這三類設定，否則很難判斷問題出在哪一層。

多數較新的 Android 手機可選擇 arm64 安裝包；universal 通用包包含多種架構，通常檔案較大，適合無法確認裝置架構時使用。不能只依手機購買年份判斷：有些裝置的處理器支援 64 位元，但安裝的系統或應用程式執行環境仍可能是 32 位元。可查看裝置規格或可信的系統資訊頁面；若 arm64 安裝包提示架構不相容，請改用通用包。若出現簽章衝突，問題就不在架構，請先確認已安裝應用程式的來源與應用程式識別碼，備份設定後再處理安裝衝突。

請貼上完整的訂閱連結，而不是服務管理頁首頁、付款頁面或登入後的瀏覽器頁面網址。在 v2rayN 中開啟訂閱群組設定，新增群組並儲存網址，再執行更新訂閱；在 v2rayNG 中也要先儲存訂閱群組，再更新對應群組。複製時請檢查網址前後是否有空白、換行，或查詢參數遭到截斷。若記錄顯示回傳 HTML，通常是取得了登入頁或錯誤頁，請重新取得正確連結。不要反覆更換編碼方式來掩蓋網址問題，也不要公開含有存取憑證的完整連結。

先確認 Linux 發行版使用哪種套件管理方式：Debian、Ubuntu 及其衍生版本通常選 deb；Fedora 等 RPM 系發行版通常選 rpm。接著執行 uname -m 查看架構：x86_64 對應 x64，aarch64 通常對應 arm64。套件格式與處理器架構是兩項獨立條件，兩者都必須符合。請使用發行版的軟體安裝程式或套件管理器安裝，讓相依性正常處理；若提示缺少相依套件，先查看具體套件名稱。不要強制忽略相依性繼續安裝，也不要為了一般使用而長期以 root 身分啟動整個桌面用戶端。

先關閉 TUN，確認一般本機代理可以正常連線，再處理系統授權。Linux 需要可用的 TUN 裝置，以及建立虛擬介面、修改路由所需的權限；授權方式請依目前 v2rayN 版本的提示與發行版機制處理，不要隨意替不明程式設定高權限。Windows 請依用戶端提示授權相關操作；macOS 請在系統設定中檢查對應的網路或 VPN 授權。Android 需要確認系統 VPN 要求，而且通常無法與另一個占用 VPN 通道的應用程式同時執行。完成授權後重新啟動連線，並查看記錄中失敗的具體操作。

先更新訂閱，選擇與目前核心相容的協定，再使用用戶端提供的真實連線測試確認握手結果，不要只憑名稱或地區判斷。一般延遲測試與真實連線測試的探測路徑可能不同，單一測試結果不能取代實際連線。將伺服器設為目前使用的伺服器後，啟用所需的代理入口，連線至明確的 HTTPS 網址，再查看記錄是否出現相應請求。首次確認期間請保持路由模式不變，也不要連續切換伺服器與 DNS；先建立一條可重複驗證的成功路徑，之後才方便比較其他設定。

終端機程式不一定會讀取桌面環境的系統代理。先在用戶端確認本機 HTTP 或混合監聽連接埠；若確認是 10808，可用 curl -I -x http://127.0.0.1:10808 https://example.com 明確指定代理進行測試。若只有 SOCKS 監聽，請改用符合該監聽類型的參數，不能直接套用 HTTP 寫法。需要暫時設定環境變數時，可在目前的終端機設定 http_proxy 與 https_proxy，測試完成後再清除。明確指定代理後測試成功，但一般 curl 仍失敗時，通常應檢查程式讀取代理的方式，而不是立刻更換伺服器。

優先使用用戶端提供的路由預設，再視需要新增少量自訂規則。區域網路與私有位址應符合直連出口規則；指定網站可用網域規則比對，不要只填網站首頁解析出的單一 IP，因為同一網站可能會呼叫多個子網域或內容傳遞網路位址。規則通常依序比對，實際行為也會受所用核心影響；請將較具體的例外規則放在適當位置。儲存並套用規則後，可透過記錄確認流量命中了哪個出口。DNS 解析策略也會影響依 IP 比對的規則，因此不要同時大幅調整 DNS 與路由。

優先使用用戶端內建的匯出或備份功能；若需要複製設定目錄，請先完全結束用戶端，避免複製到尚未寫入完成的檔案。至少保留訂閱群組、手動新增的伺服器、自訂路由，以及確實需要的 DNS 設定。備份可能包含使用者識別碼、密碼或訂閱存取憑證，請存放在安全可控的位置。更換裝置後，先還原伺服器資訊，再確認監聽連接埠、系統代理與 TUN 權限；這些與系統環境相關的設定不應直接照搬。跨用戶端遷移時，優先重新匯入訂閱，不要直接覆寫整個應用程式資料目錄。

先確認訂閱網址完整、服務仍有效，再查看更新記錄中的錯誤類型。逾時表示連線路徑未能在限定時間內完成；網域解析失敗時，請檢查目前使用的 DNS；HTTP 401 或 403 則應確認存取授權、網址是否失效，以及伺服器端限制。若用戶端提供透過代理更新的選項，請先確保目前的代理伺服器可用；代理已失效時仍依賴它更新訂閱，可能陷入循環。可分別測試直連與現有可用代理，每次只變更一項設定。若記錄中出現敏感連結，分享錯誤資訊前請先遮蔽憑證。

先確認裝置本身可以正常連上網路，再檢查伺服器網域、連接埠、協定及傳輸參數是否與設定來源一致。手動填寫的 TLS serverName、WebSocket path 等欄位若有誤，即使連接埠已建立連線，也可能在握手階段失敗。查看用戶端記錄，分辨解析失敗、連線逾時、連線遭拒與 TLS 錯誤；同時確認系統時間正確。可改用已知可用的設定或另一個網路進行對照，但每次只更換一項條件。不要因單次逾時就認定伺服器已停機，也不要為了連線而隨意停用憑證驗證。

顯示已啟動通常只代表核心程序開始執行，不代表伺服器握手或網站連線成功。先透過明確指定本機代理的請求進行測試，確認本機連接埠與伺服器連線；接著檢查瀏覽器是否使用系統代理，最後檢查路由與 DNS。若明確指定代理後測試成功，但瀏覽器仍無法連線，請優先檢查瀏覽器擴充功能、獨立代理設定與快取連線。若只有特定網域無法連線，請檢查對應的路由比對結果與 DNS 記錄。只有在啟用 TUN 後才出現問題時，先關閉 TUN 進行對照測試，並確認是否與其他 VPN 或網路過濾程式衝突；不要同時啟用多套流量接管工具。

Linux 的代理設定可能來自桌面環境、應用程式本身的設定或程序環境變數，沒有任何單一開關能保證所有程式都採用相同的連線方式。先確認系統代理位址是否為本機迴圈位址，連接埠是否與用戶端的 HTTP 或混合監聽一致，再透過明確指定代理的請求確認監聽正常運作。若瀏覽器設定了獨立代理或擴充功能，請分別檢查；已經執行的應用程式可能需要重新啟動。終端機也要檢查 http_proxy、https_proxy、ALL_PROXY 與 NO_PROXY 是否互相衝突。確實不支援代理的應用程式，可在了解權限與路由影響後再考慮使用 TUN。