V2Ray 故障排除
連線、訂閱與用戶端設定

無法上網：先確認問題出在哪個環節

「用戶端顯示已連線，但網頁打不開」只代表介面進入執行狀態，不等於已成功與遠端完成握手。完整連線路徑包括應用程式、系統代理或虛擬網路介面、本機入站、出站設定、遠端服務及目標網站。先找出請求停在哪個環節，比不斷更換設定更有效。選定一個能穩定重現問題的目標，再準備一個目前網路通常可直接開啟的網站做對照。

恢復直連，確認基本網路

桌面端先關閉系統代理，再中斷用戶端連線；Android 則先中斷用戶端建立的 VPN。確認已連上 Wi-Fi、閘道可正常使用，必要時先完成公共 Wi-Fi 的網頁認證。若關閉代理後對照網站仍無法開啟，先檢查網路登入、裝置時間、路由器及電信業者網路，不要把基本連線問題歸咎於協定。公共 Wi-Fi 的認證頁通常需要在直連狀態下完成。

如果直連恢復正常，重新啟動用戶端，但暫時只保留一種流量接管方式。不要同時使用其他代理、VPN，或會改寫網路設定的加速工具。桌面端先用本機代理測試，確認出站正常後，再啟用需要額外權限的接管模式。如此可分辨「遠端連線失敗」和「流量未進入用戶端」，避免兩種問題互相干擾。

確認選取的設定與本機監聽

在 v2rayN 中確認目前啟用的伺服器就是要測試的項目，而不是只在清單中反白了另一列。更新訂閱後，啟用中的設定可能已變更；啟動前先檢查位址、連接埠及傳輸選項。接著查看日誌，確認是否出現本機入站啟動成功的紀錄。若提示連接埠遭占用，請找出占用的程式，或修改用戶端連接埠並同步更新應用程式設定，不要一再重新啟動。

本機 SOCKS 連接埠以用戶端實際顯示的數值為準，只有確認該連接埠是 10808 時，才使用下列範例。Windows 可在終端機執行 curl.exe，macOS 和 Linux 通常使用 curl。指令明確指定代理，可排除瀏覽器是否讀取系統代理的變數；請區分目標網站回傳的 HTTP 錯誤與連線失敗。

curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 30 -I https://example.com/

如果收到 HTTP 回應標頭，代表這次請求至少通過本機代理並連到遠端，但不代表所有網站都能使用。若顯示無法連線至本機位址，請確認用戶端是否已啟動，以及監聽協定是否相符。如果本機連線成功後才出現遠端錯誤，請繼續檢查出站日誌。不要把 SOCKS 連接埠填入只接受 HTTP 代理的欄位，兩者不能只靠連接埠號碼互換。

利用路由對照確認請求的去向

本機代理測試成功、瀏覽器卻無法使用時，優先檢查瀏覽器代理擴充功能、獨立 DNS 設定及快取。只有部分網站無法使用時，可暫時切換成代理優先路由做對照，測試後再恢復原設定。此處的「代理優先」是指改變出站選擇，不代表所有應用程式都會自動接入；流量是否進入用戶端，仍取決於系統代理、應用程式設定或虛擬網路介面。

如果切換路由後恢復正常，請檢查原規則是否誤將目標導向直連、是否命中封鎖出站，以及規則集是否成功載入。規則通常依序比對，前面的寬泛規則可能會蓋過後面的細項。不要直接清除所有規則；先備份，再縮小範圍，以單一目標網域測試。企業內網、區域網路裝置和公共網站各有不同的存取需求，長期使用單一全域模式並非妥善的修復方式。

用測試結果結束本輪排查

至少重新測試直接連線、明確指定代理，以及日常應用程式存取這三條路徑。明確指定代理可用、應用程式卻不行，請查看系統代理章節；所有出站連線都逾時，請查看節點逾時章節；只有網域相關請求異常，請查看DNS 章節。保留可正常運作的設定副本，移除測試時新增的臨時規則，再逐項恢復需要的功能。

節點逾時：分辨連線、握手與目標回應

逾時表示尚未等到結果，不是故障原因。同一個「連線失敗」提示，可能是遠端連接埠無法連線、TLS 握手未完成、傳輸路徑錯誤，也可能是目標網站一直沒有回應。先開啟用戶端日誌，讓失敗操作只執行一次，再查看同一時間段最早出現的錯誤。之後連續出現的連線關閉紀錄通常是連帶結果，不應先入為主地當成根本原因。

依日誌發生階段判斷

若日誌同時出現 dial tcp 和逾時，通常應檢查位址、遠端連接埠及網路連通性；若出現 connection refused，可能是目標連接埠沒有服務，或連線遭主動拒絕。若已進入 TLS 階段，先檢查伺服器名稱、憑證驗證及裝置時間。日誌只能指出可疑範圍，不能只憑一個短語就斷定遠端服務已離線，還需要透過網路對照確認。

若用戶端內建測試失敗，但實際網頁能開啟，請檢查測試目標是否本身無法連線，以及測試是否經過相同的出站路徑。TCP 建立連線、代理握手與網頁請求測試的衡量項目不同，不應直接混為一談。反過來說，簡單的連線測試成功，也不能證明驗證、加密或應用程式層的存取都正常。

逐項核對協定與傳輸參數

對照可信來源提供的原始設定，核對協定、位址、連接埠、使用者識別碼、加密選項及傳輸類型。WebSocket 必須符合路徑及伺服器要求的 Host；gRPC 則必須符合服務名稱。TLS 的伺服器名稱可能與連線位址不同，不要任意將兩者視為相同。能在位址列開啟某個網站，不代表該網站上的代理服務使用相同入口。

使用 VLESS 與 REALITY 等組合時，伺服器要求的公鑰、短識別碼、伺服器名稱及流控選項，都必須符合用戶端功能與設定。不要因名稱相似就把參數複製到另一種傳輸方式，也不要把更換核心當成補齊參數的方法。匯入訂閱後若有欄位缺漏，先確認用戶端是否支援該格式，再向設定提供者確認完整資訊。

裝置時間錯誤可能導致憑證驗證失敗，也可能影響部分驗證流程。先啟用系統自動設定時間並確認時區，再重新測試。不要為了避開錯誤而長期關閉憑證驗證；這會改變連線的安全性，也常掩蓋伺服器名稱填錯的問題。只有在明確且受控的測試中才應檢查相關選項；恢復使用前，請重新啟用正常驗證設定。

交叉比對網路與設定

保持同一設定，分別在目前網路和另一個可信任的網路測試；再保持目前網路不變，改用另一個已知可用的設定。前一種比對用來判斷本機網路差異，後一種則用來判斷遠端服務或單一設定是否有問題。測試時記錄是否更換 DNS、是否仍有其他 VPN，以及失敗是否只發生在 IPv6 路徑，避免把多項變更當成單一結論。

網域同時回傳 IPv4 和 IPv6 位址時，其中一種位址的連線路徑異常可能造成等待。先從日誌確認實際連線的位址，再暫時比對不同位址族，不要永久停用整個系統的 IPv6。若伺服器位址使用網域名稱，也要確認解析結果符合服務提供者預期；若解析到錯誤位址，應依 DNS 問題處理，而不是調高所有逾時門檻。

處理遠端服務無法使用與重試問題

若多個互不相關的網路都只有同一項設定失敗，且參數與有效期限已確認，問題可能出在遠端服務或設定權限。提供經遮蔽的第一筆錯誤、發生時間及網路對照結果，不要傳送完整訂閱。頻繁重試無法修復伺服器監聽或帳戶限制，反而可能觸發更多限制。等待確認期間，可改用已驗證的備用設定，並保留原項目供後續比對。

訂閱失敗：分辨取得、解析與設定使用階段

訂閱更新包含三個獨立階段：從網址取得內容、將內容轉換為用戶端設定，以及選取其中一項建立連線。更新成功只代表前兩個階段完成，不保證每項設定都能連線；連線失敗也不代表必須重新新增訂閱。先確認介面回報的是網路錯誤、格式錯誤，還是匯入後清單為空，再依相應情況處理，避免刪除仍可使用的舊項目。

確認連結類型與存取憑證

HTTP 或 HTTPS 訂閱網址通常會回傳一組可更新的設定；vmess://、vless:// 等分享連結通常代表單一節點。將單一節點連結填入訂閱網址欄位，可能會造成取得失敗；把訂閱文字當成一般網頁網址複製，也可能遺失查詢參數。先查看來源頁面的說明，再選擇「訂閱群組」或「從剪貼簿匯入」等相應功能。

檢查複製的內容是否包含前後空格、換行、通訊軟體附加的標點，或遭截斷的查詢字串。訂閱網址中的存取權杖應視同密碼，不要貼到公開檢測網站，也不要在共用裝置上直接開啟。若網址曾經外洩，請透過服務提供者重設存取憑證；只從用戶端刪除紀錄，無法撤銷他人已取得的網址。

分享連結與訂閱網址的操作差異，請參閱分享連結與訂閱的差異。手動匯入單一節點只適合臨時測試，無法自動更新訂閱。長期使用時，請為群組設定清楚名稱，區分手動項目與訂閱項目，避免下次更新後誤以為設定遭到異常修改。

確認取得失敗發生在哪個階段

查看更新日誌中的 HTTP 狀態碼與網路錯誤。若是驗證或權限相關回應，先確認帳戶、網址及有效期限；若是請求過多的回應，請停止連續重新整理並稍後再試。伺服器回傳成功狀態，但內容無法解析時，取得的可能是登入頁、維護頁或網路認證頁，而非設定內容。判斷時要一併參考狀態碼和內容類型，不要把所有失敗都歸因於用戶端版本。

若直連無法取得訂閱，但現有代理仍可使用，且用戶端提供相關選項，可嘗試透過現有代理更新。反之，若代理本身已失效，強制透過代理更新會形成依賴循環：取得新設定依賴舊設定，而舊設定又需要更新。先確認目前使用的更新路徑，必要時改用可用的直連網路或經驗證的臨時連線。

處理內容格式與相容性問題

取得內容成功但匯入失敗時，請確認訂閱提供的是用戶端可辨識的分享連結集合，而非其他類型用戶端專用格式。不要將任意 YAML、網頁原始碼或經過二次包裝的文字當成通用訂閱。部分分享格式支援的參數會因用戶端和核心功能而異；能顯示項目名稱，不代表所有傳輸欄位都完整保留。

先在獨立的測試群組中匯入一個來自相同來源的分享連結，確認位址、協定及傳輸設定是否完整。如果單一連結可用、整組卻失敗，再檢查訂閱內容與轉換方式；如果匯入同一連結後就缺少欄位，應優先確認格式支援情況。不要使用來源不明的線上轉換服務處理私人訂閱，因為轉換過程會接觸網址及存取憑證。

更新後重新確認啟用的設定

訂閱更新後，原先選取的項目可能已重新命名、取代或移除。重新確認啟用的伺服器與群組，啟動連線並查看日誌。若更新前可用、更新後卻失敗，請比對協定與傳輸參數，不要只比對顯示名稱。伺服器調整也可能需要新的設定欄位，舊版用戶端未必能完整解析；需要更新用戶端時，請前往下載中心依平台選擇安裝檔，並先閱讀遷移說明。

恢復正常後，只保留必要的更新頻率，確認手動項目不會遭到覆蓋，並記錄這次使用的取得路徑。如果同一訂閱只有少數項目異常，請前往節點逾時章節繼續排查，不必反覆重建整個群組。回報問題時應提供已遮蔽的狀態碼、解析錯誤及用戶端名稱，不得包含完整網址、使用者識別資訊或未處理的訂閱內容。

網速慢：分別檢查解析、連線與傳輸

網頁遲遲無法顯示、影片播放途中停頓和大型檔案下載緩慢，通常不是同一類問題。前者可能耗時在 DNS 解析與握手，後者則較可能與持續傳輸速率、封包遺失或伺服器負載有關。先選定固定目標，在相近時段使用同一個應用程式重新測試，記錄是連線開始前等待太久，還是連線後持續緩慢。不要直接比較不同網站、檔案和網路的測試結果。

建立可重複的測試條件

關閉背景的大量傳輸工作，確認 Wi-Fi 訊號及本機網路穩定，再使用已知可用的設定測試。筆記型電腦可在條件允許時改用有線網路比對；手機則可比較 Wi-Fi 與行動數據。每次只變更一項，並持續測試直到能重現原本的症狀。用戶端顯示的連線測試結果不代表保證頻寬，也不能單獨說明長時間傳輸是否穩定。

如果只有某個網站速度慢，而其他目標正常，先考慮目標網站負載、內容傳遞路徑及帳戶限制。代理出口變更可能使網站選擇不同的內容伺服器，導致相同設定在不同網站上的表現差異很大。不要因單一網頁載入緩慢就更動所有本機參數；先用另一個瀏覽器，或同一網站的其他內容確認問題範圍，再決定是否調整出站設定。

分辨初始回應慢與持續傳輸慢

首次開啟速度慢、第二次明顯改善時，請檢查 DNS 快取、TLS 工作階段建立及瀏覽器連線重用。若每次都在解析階段等待，調整路由和傳輸並行數未必有幫助。若解析迅速但握手一再失敗，請回到逾時章節核對傳輸參數。持續傳輸速度逐漸下降時，應觀察網路封包遺失、遠端負載及本機資源，而不是盲目縮短 DNS 逾時時間。

可用終端機查看單次請求各階段的累計耗時。下列範例同樣要求本機 SOCKS 連接埠實際為 10808；這只能協助觀察請求階段，不是測速工具。透過代理連線時，部分解析與握手耗時可能包含代理通道的建立時間，不能直接將某個欄位視為遠端 DNS 的獨立耗時，更不能用單次結果替設定排名。

curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 30 -o /dev/null -sS -w "connect=%{time_connect}\nfirst_byte=%{time_starttransfer}\ntotal=%{time_total}\n" https://example.com/

這個指令適用於通常具備這些終端工具的 macOS 和 Linux 環境。Windows 可使用 curl.exe，並將輸出檔案改為 NUL。對照測試必須使用相同目標和相同代理路徑。若等待第一個位元組的時間變長，只能說明需要進一步找出請求處理階段，無法證明本機、代理服務或目標網站其中一方必然有問題。

檢查本機負載與額外處理

開啟系統工作管理工具，觀察用戶端、核心程序及其他程式的 CPU、記憶體與磁碟使用量。持續高負載可能來自詳細日誌、過多規則處理，或與其他應用程式爭用資源。排查時先將除錯日誌恢復為一般等級，暫停不必要的工作，再重新測試。不要一次關閉所有系統安全功能；若有明確的封鎖紀錄，應針對相關程式和提示處理。

多工複用、並行連線與傳輸參數並非數值越大就越快。這些設定會改變連線複用方式，也可能受到伺服器實作限制。如果不確定來源要求，先使用設定的預設值；要測試某個選項時，保留原值並一次只比較一項。若變更後出現卡頓或斷線，請還原設定，不要繼續堆疊更多「最佳化」選項，讓後續排查失去基準。

路由、位址族與網路切換

分流錯誤可能讓原本可直連的資源繞道，也可能使應走代理的連線不斷失敗並重試。查看目標實際使用的出站，再修正規則。IPv4 與 IPv6 路徑差異、虛擬網路介面的 MTU 不符，也可能呈現小型請求正常、大型回應停滯的狀況；只有找到相符證據時才進行相關測試，不要只因「網速慢」就直接修改系統 MTU。

如果切換網路後問題消失，請保留同一設定繼續觀察，再檢查原網路的 Wi-Fi 品質、閘道負載及存取限制。如果多個網路都只有特定出站速度慢，請將目標、時段及已遮蔽的日誌提供給服務提供者。修復結果應以相同工作能穩定完成為準，而不是某個測速數字變好；最後恢復暫時關閉的功能，並清除測試時新增的特殊路由。

DNS 問題：確認解析來源與路由如何配合

DNS 會將網域名稱轉換為位址，但用戶端中可能不只一個解析入口。系統解析器、瀏覽器的加密 DNS、代理協定攜帶的網域名稱，以及核心為路由比對而發起的解析，可能同時存在。某個網頁能開啟，不代表所有解析請求都按預期處理。開始排查前，先釐清目標：修復解析失敗、避免解析到錯誤位址，或限制特定請求的出站路徑。

確認問題是否確實發生在解析階段

查看日誌是否出現解析逾時、沒有結果，或 DNS 伺服器無法使用的紀錄。系統指令能解析網域，只代表系統採用的路徑可用，不代表代理核心使用相同的解析器。不要直接用 HTTPS 網站的純 IP 位址開啟來判斷 DNS，因為憑證和伺服器名稱通常仍取決於原網域；無法透過純 IP 存取，並不能證明該位址無法連線。

在明確指定的 SOCKS 測試中，socks5h 通常會將網域交由代理端處理；一般 SOCKS 用法則可能先在本機解析。兩種方式的結果差異，可用來判斷解析路徑，但還必須搭配用戶端出站日誌。若瀏覽器啟用自己的加密 DNS，系統解析測試與網頁結果也可能不一致；測試前應先記錄該選項的狀態。

了解 domainStrategy 的作用範圍

路由中的 domainStrategy 控制比對網域與 IP 規則時是否需要解析。它不是 DNS 出口開關，也無法單獨確保解析請求經過代理。以下範例是合法的路由物件片段，僅供理解欄位使用；其中沒有定義入站、出站和 DNS 伺服器，不能直接當成完整設定執行，更不應覆蓋圖形化用戶端產生的全部內容。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

AsIs 通常依現有網域資訊比對，不會為 IP 規則主動解析；IPIfNonMatch 會在網域規則未命中時嘗試解析，再繼續比對；IPOnDemand 則可能在遇到相關 IP 規則時發起解析。實際支援情況依所用核心而定。上例也需要可用的地理資料，以及名為 direct 的出站；欄位名稱必須與實際設定相符。

因此，遇到 DNS 異常時，不能只把策略改成看似更積極的選項。先檢查網域規則是否涵蓋目標、解析器是否可連線，以及 DNS 伺服器本身的連線會走哪個出站。增加解析次數可能讓等待更明顯，也可能改變規則比對結果。每次修改後都要同時確認目標位址和實際出站，而不是只看網頁是否偶然恢復。

處理解析伺服器的相依性循環

使用 HTTPS DNS 服務時，服務網域也可能需要先解析；如果解析依賴代理，而代理伺服器位址又依賴相同的 DNS，就會形成啟動相依循環。解決方法是明確設定啟動階段的解析路徑與存取規則，並依核心支援的方式設定引導解析，而不是任意將所有解析器改成同一個位址。也要確認目前網路允許連線至所選服務。

中國大陸與海外網域的分流解析，必須讓 DNS 選擇、路由規則及目標存取出口彼此一致。若將網域交給不適合的解析器，可能取得無法使用或路徑不理想的位址；解析請求誤走直連，也可能偏離預期。詳細欄位搭配方式請參閱DNS 分流解析設定，先了解相依關係，再套用至目前使用的用戶端。

快取、洩漏檢查與最後驗證

修改解析設定後，瀏覽器、作業系統和核心可能仍保留舊快取。先重新建立用戶端連線並關閉舊網頁，再依作業系統提供的方式清除快取；不要把刪除設定目錄當成清除快取。內網網域也可能需要公司或家用網路提供的解析器，不應一律改用公共 DNS，否則公共網站恢復正常後，內網資源反而可能無法使用。

檢測頁面顯示的解析出口只是目前測試的樣本，無法證明所有應用程式都採用相同路徑，也不能只憑伺服器所在區域判斷是否洩漏。應一併檢查瀏覽器 DNS 選項、用戶端日誌及不同應用程式的測試結果；若要檢查系統設定，請參閱DNS 洩漏檢測與設定。修復後分別測試公共網域、內網網域及 IPv6 情境，並保留清楚可解釋的解析路徑。

系統代理無效：確認應用程式是否確實接入

系統代理是一組供應用程式讀取的設定，不是強制轉送系統所有連線的機制。在 v2rayN 中啟用自動設定，通常只是將本機代理位址寫入系統相應位置；核心是否正常監聽、應用程式是否遵循設定，以及路由最後選擇哪個出站，仍是不同環節。因此，「已開啟設定」和「目標流量經過代理」之間，仍須透過可觀察的請求確認。

先測試本機代理，再確認系統設定

依照無法上網章節中的明確指定代理指令進行測試。指定後可以成功，代表本機入站和該次出站大致可用；此時不要繼續更換節點，應檢查系統代理位址、連接埠及應用程式行為。確認主機欄位指向本機迴路位址、連接埠與用戶端目前設定一致，並確認應用程式欄位要求的是 HTTP 代理還是 SOCKS 代理；兩種協定不能混用。

如果曾修改用戶端連接埠，也要同步更新系統設定和應用程式的個別設定。有些程式只會在啟動時讀取代理設定，修改後需要完全結束程式再重新開啟；只關閉視窗不一定會結束背景程序。測試時先使用沒有獨立代理擴充功能的瀏覽器設定，排除擴充功能覆蓋設定的可能。確認正常後，再逐一恢復擴充功能及個別設定，找出衝突來源。

依桌面平台確認設定來源

在 Windows 中，使用者介面的代理設定不代表所有背景元件都會使用相同代理來源。若瀏覽器正常、某個服務卻失敗，應查閱該程式的說明，不要直接全域改寫其他代理子系統。macOS 應確認修改的是目前使用的網路服務；切換連線方式後，舊設定可能不再適用。Linux 則要區分桌面環境設定與終端機環境，兩者通常各自獨立。

終端機中的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 與 NO_PROXY 可能覆蓋或補充應用程式行為，實際效果取決於工具的實作。尤其要檢查排除清單是否包含目前測試的網域。排查時以單次指令明確指定代理，比直接寫入全域環境更容易還原；尚未確認效果前，不要修改所有終端機啟動檔。

區分系統代理與虛擬網路介面接管

有些應用程式不遵循系統代理，或使用系統代理模式未涵蓋的連線方式。此時才需要評估用戶端提供的虛擬網路介面接管功能，而不是只將路由改為全域就認定問題已解決。啟用此類模式可能需要管理員權限、介面元件及正確路由；也可能與其他 VPN、虛擬機器網路或組織網路政策衝突，應先確認基本代理功能正常。

使用接管模式時，必須避免代理出站流量又被送回用戶端，造成迴圈。用戶端通常會自動產生相關排除與介面規則，但手動修改閘道或路由可能破壞這些設定。如果一啟用便完全無法上網，先停用並恢復原本連線，再檢查介面啟動與路由日誌。不要不斷新增靜態路由「試試看」，否則關閉用戶端後仍可能留下獨立的網路問題。

區域網路分享也是另一種情境。本機迴路位址只指向本機，其他裝置無法透過自己的迴路位址連線到這台電腦。確實需要分享時，應確認監聽位址、裝置實際位址及防火牆範圍；不要為了讓連線成功，就將代理連接埠公開至所有可存取的網路。如果目前只是在本機排查問題，請維持最小監聽範圍，減少額外變數。

清除殘留設定並恢復可檢查的狀態

用戶端異常結束後，系統可能仍指向已停止的本機連接埠，造成軟體關閉後網路也無法使用。先在系統設定中關閉失效代理，再啟動用戶端並重新套用設定。如果設定立刻又被改回，請檢查是否有其他代理軟體、瀏覽器擴充功能或受管理政策持續寫入。組織管理的裝置應遵守管理要求，不要試圖強制覆寫政策。

最後分別使用一個遵循系統代理的應用程式、一個明確指定代理的指令，以及一個需要個別設定的程式進行驗證。三者結果都應能由各自設定解釋，不要只看系統匣圖示。恢復流程請參閱v2rayN 首次安裝與設定檢查；記下目前有效的連接埠，避免之後更換設定時將應用程式接入問題誤判為節點故障。

用戶端當機：分別檢查介面、核心與設定

啟動後立即退出、視窗無回應，以及連線後核心停止，涉及不同程序和日誌。先確認介面是否仍在、系統匣程序是否存在，以及錯誤發生在開啟軟體、讀取設定，還是啟動連線時。不要一開始就刪除資料目錄或反覆覆蓋安裝；這可能會遺失可用設定，也會抹去有助於判斷問題的現場資訊。先備份，再建立最小重現條件。

確認安裝檔與執行環境

桌面平台優先選用 v2rayN，並前往下載中心確認平台與處理器架構。Windows 桌面版與傳統 WPF 版使用不同介面入口，不能因其中一個異常就混用資料檔；macOS 須區分 Apple Silicon 與 Intel；Linux 則要同時符合處理器架構與發行版套件格式。能解壓縮套件，不代表系統就能執行其中的程式。

若系統提示缺少執行元件，請依目前安裝說明補齊所需環境，不要從不明彈出視窗下載所謂的修復工具。macOS 出現來源或權限提示時，先確認檔案來源，再透過系統提供的安全性設定處理；不要把全域關閉防護當成一般步驟。Linux 應根據套件管理工具回報的相依資訊處理，不要將所有啟動問題都歸因於檔案權限。

若採用解壓縮後執行的方式，請完整解壓縮至目前使用者可寫入的固定資料夾，不要直接從壓縮檔預覽中啟動。路徑若受到同步工具、受控資料夾或其他程式占用，可能導致設定無法寫入。先改在權限明確的本機資料夾測試，再檢查安全軟體的具體紀錄。若出現隔離提示，請確認受影響的項目，不要為了略過尚未釐清的錯誤而關閉所有防護。

分辨介面異常與核心退出

介面仍可操作，但連線後立刻停止時，先查看核心日誌中的第一筆啟動錯誤。常見原因包括連接埠被占用、目前核心不支援某個欄位、參照的檔案不存在，或地理資料載入失敗。若日誌顯示設定解析錯誤，切換系統代理也無濟於事，因為入站可能根本沒有啟動。請還原最近修改的欄位，再用先前可用的設定測試。

介面本身無法開啟時，請檢查系統事件紀錄或用戶端啟動日誌，留意問題是否與讀取特定資料檔、視窗狀態或寫入資料夾有關。保留原始資料夾，在不覆蓋原資料的前提下，使用獨立測試資料夾啟動最小環境。新建的空白環境能執行，只能說明問題較可能與舊資料或設定有關，不能據此斷定所有舊設定都已損壞。

安全地縮小設定問題範圍

先關閉用戶端並確認背景程序已結束，再將設定、訂閱紀錄及必要日誌複製至受控的備份位置。測試環境只匯入一項已驗證的設定，暫時不匯入複雜的自訂路由與外部規則。若最小環境運作穩定，再分批恢復訂閱、路由及其他設定，直到問題再次出現。透過逐步恢復可找出觸發項目，不必重建整套設定後仍不清楚原因。

切換核心前，必須先確認設定是否支援。Xray 與 V2Fly 是不同的核心實作，不能假設所有欄位都完全通用；某些傳輸方式或安全選項在另一個核心中可能需要不同處理。切換後若立即出現不支援欄位的錯誤，請切回原核心，或依該核心支援的功能重新建立設定。不要把圖形介面中相同的選項名稱視為完全相容的證據。

排查資源耗盡與遷移異常

若執行一段時間後才當機，應觀察記憶體、磁碟空間及日誌檔案的成長情況，而不只是檢查啟動參數。磁碟空間不足可能影響設定儲存；持續記錄除錯日誌也會增加磁碟負擔。若問題與大量匯入或特定規則有關，先用縮小後的項目重新測試，並保留可重現問題的最小樣本。日誌可能包含位址和使用者識別資訊，分享前務必逐項遮蔽。

更新後首次出現異常時，先保存舊資料備份及遷移錯誤紀錄。不同程式狀態或資料格式不應直接覆蓋；若要回復舊版，應使用與原環境相符的備份，避免舊程式讀取已遷移的資料。修復後，完整測試啟動、匯入、連線、退出及再次啟動，確認不僅能暫時開啟，也能穩定儲存設定並正常使用。

行動裝置專項：VPN 權限、分應用與背景執行

Android 優先使用 v2rayNG；若需要 V2Fly 核心，再評估 v2flyNG。兩款用戶端的設定與核心功能不能只因介面相似就視為相同。行動裝置除了遠端連線，還涉及系統 VPN 授權、分應用規則、背景限制及網路切換。先讓螢幕保持亮起，在前景完成一次連線，再處理鎖定螢幕後斷線的問題，可減少同時出現的變數。

安裝架構與 VPN 授權

安裝失敗時先確認處理器架構、系統需求、儲存空間及既有應用程式是否衝突。大多數較新的手機可選擇 arm64；若無法確認架構，再考慮通用套件。不同套件不代表不同帳戶權限。若系統提示簽章衝突，不要直接解除安裝舊應用程式；先匯出必要設定並確認備份可用，因為解除安裝通常會刪除應用程式的私人資料。下載入口統一見Android 下載。

首次建立連線通常需要系統授予 VPN 權限。若先前拒絕了提示，請回到用戶端重新連線並確認授權流程；若裝置受工作設定檔或組織政策管理，也可能有額外限制。系統通常只允許同一使用者環境中的一個 VPN 服務保持啟用；其他 VPN、部分本機過濾工具或加速工具可能已占用此位置，連線前應確認目前由哪個服務接管。

系統狀態列出現 VPN 圖示，只代表服務已建立，無法證明遠端代理握手成功。請同時查看用戶端日誌並送出一次網頁請求。若啟用了「永遠開啟 VPN」或「封鎖未使用 VPN 的連線」，用戶端停止後可能無法直連，這是系統政策造成的結果；排查基本網路時應先確認這些設定，避免把預期中的封鎖誤判為網路完全故障。

分應用規則與個別應用程式故障

只有一個應用程式無法存取時，先檢查分應用規則是否包含該程式。不同介面的清單可能代表「只代理所選項目」或「略過所選項目」，相同的勾選動作可能有相反效果。確認目前模式及其說明，修改後重新建立連線，再完全關閉目標應用程式並重新開啟。不要只因清單中看得到應用程式名稱，就認定流量一定會經過代理；仍須根據存取結果與日誌判斷。

部分應用程式使用獨立 DNS、持續連線或特殊傳輸方式，表現可能與瀏覽器不同。先比較同一網路下其他應用程式是否正常，再檢查相關出站是否支援 UDP 等流量。不要因瀏覽器可用就直接清除目標應用程式的所有資料，否則可能遺失登入狀態與本機檔案。優先重新建立連線、檢查應用程式的網路權限，再評估是否有明確理由清除快取。

鎖定螢幕後斷線與背景限制

前景使用正常、鎖定螢幕後失效時，優先檢查系統電池最佳化、背景活動權限及手機廠商的省電設定。依實際需求允許用戶端在背景執行，再鎖定螢幕測試。不要一次放寬所有應用程式的限制；只調整相關用戶端，並留意耗電量與連線穩定性。部分裝置也提供自動啟動或背景工作管理功能，名稱各有不同，目的都是避免 VPN 服務遭非預期終止。

分辨服務已停止與連線仍在、但網路請求失敗。前者通常會伴隨 VPN 圖示消失或程序重新啟動；後者則應查看重新連線、DNS 或遠端逾時日誌。系統記憶體不足也可能回收程序，尤其是同時執行大量應用程式時。記下發生時段與系統狀態，再減少背景工作重新測試，比一再更換節點更容易判斷是否為裝置資源問題。

網路切換後的復原與問題回報資訊

在 Wi-Fi 與行動數據之間切換後，原有連線和解析快取可能暫時失效。先等候用戶端重新建立連線，再發出新請求；若持續失敗，請中斷並重新連線一次，確認是否取得新的網路路徑。若問題只在某個 Wi-Fi 網路發生，請檢查網頁認證及該網路的存取限制；若只在行動數據發生，則應對照位址族、DNS 與伺服器連通性，不要直接照搬桌面端的所有設定。

遇到小型網頁正常、大型回應停滯時，可進一步檢查路徑與 MTU，但應先保留預設值並記錄可重現的條件。任意調低參數可能暫時掩蓋問題，也可能增加額外負擔。跨裝置移轉設定時，請手動匯入並逐項核對協定支援、路由、連接埠及平台差異；不要將桌面端的檔案路徑、系統代理方式或權限設定原樣套用到手機。

最後的問題紀錄應包含用戶端名稱、裝置系統、使用的網路、前景或鎖定螢幕狀態、分應用模式及已遮蔽的第一筆錯誤。連線問題請接著查看節點逾時，解析問題請查看DNS 問題；若要重新建立操作基準，請返回入門指南。修復後，請完成前景存取、鎖定螢幕後恢復及網路切換三項測試，再恢復日常使用設定。