V2Ray 故障排除指南

無法上網：先釐清故障層級

「用戶端已連線」通常只表示代理服務已啟動，不代表所有網站都能正常存取。每次請求都會經過應用程式的代理入口、本機監聽、路由判斷、網域解析、伺服器連線與目標網站。任何一層出錯，都可能讓瀏覽器一直轉圈。排查時先確認故障範圍：所有應用程式都無法連線、只有瀏覽器出問題，還是只有特定網站無法開啟。不同範圍應優先檢查的設定也不同，不宜一開始就重裝或反覆更換節點。

分別測試停用與啟用狀態

在 v2rayN 中先清除系統代理，再停止代理服務；若已啟用虛擬網卡模式，也請另外關閉。Android 裝置則停止 VPN 連線。接著開啟平時可直接存取的網站，確認目前網路是否需要登入驗證。校園、飯店或公共 Wi-Fi 可能須先完成驗證，啟動代理無法取代網路登入。停用後仍無法上網，請先處理 Wi-Fi 連線、閘道或網路帳戶，再回頭檢查用戶端。

基礎網路恢復後，啟動用戶端並選擇設定完整的伺服器。檢查日誌是否出現設定載入失敗、監聽失敗或處理程序結束等訊息。v2rayN 圖形介面仍開啟，不代表核心處理程序持續執行；Android 通知列出現服務通知，也不能取代實際連線測試。若按下啟動後日誌立即報錯，請先檢查本機服務，不必繼續更換網站測試。服務穩定運作後，連線結果才有比較意義。

確認應用程式是否進入代理入口

桌面端啟用系統代理後，使用會遵循系統代理設定的瀏覽器開啟固定頁面，同時查看存取日誌。若完全沒有新請求，問題較可能出在瀏覽器設定、代理擴充功能或應用程式本身的連線方式。若日誌已有請求，但顯示連線失敗，表示入口大致正常，接著應檢查對外連線。Android 裝置還要確認個別應用程式設定：被排除的應用程式不會經過 VPN，即使其他應用程式可使用代理，該應用程式仍可能直接連線。

為了排除路由設定的影響，可暫時切換至會將待測流量送往代理出口的規則模式，再開啟同一頁面。請注意，部分用戶端的「全域」只代表路由選擇，不是接管系統流量的開關；流量若未進入用戶端，切換路由也不會生效。若測試模式可正常存取、原模式卻不行，請檢查網域規則、規則順序與預設出口。測試完成後請恢復日常規則，避免長期保留診斷用的臨時設定。

保留一份最小可用設定

若先前曾成功連線，請優先復原最近一次修改，而不是一次重設所有設定。新增的路由、DNS、虛擬網卡與瀏覽器擴充功能，請分別停用並測試。記下哪個步驟讓連線恢復，再單獨重新設定相關項目。剛匯入新訂閱時，也不要立刻刪除舊群組；保留舊設定作為對照，有助判斷是用戶端通用設定改變，還是新伺服器參數有異。

復原標準應包含頁面內容完整載入、重新開啟瀏覽器後仍能存取，以及停止用戶端後網路能恢復至預期狀態。只憑一次成功連線，還不足以確認所有問題都已排除。若要重新建立操作基準，請參閱匯入訂閱與首次連線教學；設定概念的差異可查看常見問題，避免混淆系統代理、路由模式與核心啟動。

節點逾時：區分連線與交握

逾時表示某個階段未能在等待時間內取得結果，不能單憑這點判定伺服器已離線。用戶端的測試功能可能測量 TCP 連線，也可能透過代理向測試網址發出請求，兩者代表的意義不同。即使連接埠可連線，後續驗證或傳輸仍可能失敗；測試網址暫時無法使用，也可能讓正常設定被判定為逾時。因此應結合實際連線與日誌中的階段判斷，不要只因清單上的單次測試結果就刪除設定。

先核對伺服器項目與裝置時間

開啟目前伺服器的編輯畫面，確認位址、連接埠、協定、傳輸方式與安全設定都來自同一份設定。複製貼上時可能混入空格，也可能把訂閱網址誤填到伺服器位址欄。除非欄位明確要求完整 URL，位址欄通常不應包含網頁路徑或協定前綴。連接埠、使用者識別資訊與密碼應依照設定提供者給的內容填寫，不要參考其他項目猜測。更新訂閱後，也請確認目前選取的仍是有效項目。

接著檢查作業系統的日期、時間與時區。時間明顯不準可能影響憑證驗證及部分協定的驗證流程。啟用系統自動校時後，重新啟動一次代理服務，再重現相同請求。若日誌提示憑證尚未生效或已過期，請先釐清是本機時間錯誤，還是伺服器憑證有問題。不要以略過憑證驗證來掩蓋錯誤；這會改變安全性，也無法修正錯誤的伺服器名稱或連線位址。

依照日誌指出的失敗階段處理

出現連線遭拒，通常表示目標主動拒絕連線，或目標連接埠沒有相應服務；出現網路無法連線，應檢查本機網路、位址類型與路由。等待一段時間後逾時，可能與傳輸路徑封包遺失、伺服器沒有回應或本機安全軟體攔截有關。若已進入 TLS 交握階段，應優先核對伺服器名稱、安全類型與傳輸參數。不同核心的錯誤訊息可能不一樣，判讀時請保留完整上下文，不要只截取最後一個英文單字。

VLESS 與 REALITY 設定還需核對公鑰、短識別碼、伺服器名稱，以及該項目要求的其他欄位。WebSocket 應檢查路徑與 Host；gRPC 則需檢查服務名稱。這些值不是可互換的裝飾項目，位址與連接埠相同也不代表設定相同。部分訂閱轉換可能遺失欄位，遇到這種情況應重新取得完整設定，不要逐一嘗試網路上找到的參數組合。

交叉測試網路與設定

維持相同伺服器、目標頁面與用戶端設定，分別使用兩種可用網路測試。若只有一種網路失敗，請留意該網路的解析、位址類型、驗證與連線路徑；若所有網路都失敗，但其他項目正常，則應優先檢查目前的伺服器或參數。反之，若同一台裝置上的所有項目都失敗，另一台裝置卻正常，應先檢查本機代理入口、時間、核心狀態與安全軟體，而不是認定所有伺服器同時故障。

協定支援也取決於目前的核心，以及用戶端產生設定的方式。匯入成功只代表用戶端能辨識連結，不保證所選核心能執行所有欄位。切換核心前，先確認該項目需要的協定與傳輸方式都受支援，並保留原設定，再使用相同請求驗證。關於核心家族與設定相容性，請參閱Xray 核心與 V2Fly 核心的差異。切換失敗後應復原設定，不要在狀態未明時繼續疊加修改。

若需請設定提供者協助處理，請說明失敗發生在建立連線或交握階段、是否只在特定網路出現，以及其他項目是否可用。提供已移除敏感資訊的錯誤文字即可，不要公開完整訂閱或帳戶參數。復原後再測試一次實際頁面並重新連線，確認不是偶然成功；清單中的測試結果只能作為參考，不能當成唯一判斷依據。

訂閱失敗：分別檢查取得與解析

更新訂閱至少包含取得內容、解析內容與寫入群組三個步驟。無法下載通常與網址或網路有關；成功取得卻沒有項目，可能是回傳內容不符合用戶端格式；更新後已有項目卻無法連線，則應改查伺服器設定。釐清這三種情況，可避免反覆刪除群組而遺失資料。開始操作前，請先記下群組名稱、更新方式與錯誤時間，並保留仍可使用的舊設定。

確認網址仍是訂閱入口

重新複製訂閱網址時，請確認沒有漏掉尾端參數，也沒有帶入通訊軟體插入的空格、換行或標點符號。訂閱入口不同於帳戶登入頁面；後者即使能在瀏覽器開啟，也不能直接當成訂閱內容匯入。部分入口需要有效的帳戶狀態或授權參數，帳戶失效、網址重設或流量額度變更都可能影響回傳結果。請在原本的管理入口確認狀態，不要將網址提交至來路不明的線上轉換頁面。

錯誤碼有助縮小問題範圍，但不宜過度解讀。未授權或禁止存取通常與權限或入口限制有關；找不到資源可能是網址已變更；伺服器錯誤則可稍後再試。即使回傳成功，也不一定代表取得的是設定內容，有時實際收到的是登入頁、驗證提示或維護頁面。若用戶端日誌顯示解析 HTML 失敗，應先確認請求被導向何處，不必立刻更換核心，因為這個步驟尚未用到核心。

確認訂閱更新使用哪條網路路徑

訂閱下載可能直接連線，也可能透過現有代理，實際方式取決於用戶端提供的更新選項。若目前網路可直接連上訂閱入口，請先嘗試直接更新；若入口必須透過代理存取，就必須先有可用的設定。所有設定都已失效，卻又必須透過這些設定更新訂閱，就會形成循環。此時可改用能連上入口的網路，或透過原有管理管道取得有效設定，不要反覆按下更新按鈕，期待狀態自行改變。

若使用代理更新，請確認選取的伺服器能正常開啟一般網頁，而且本機監聽連接埠沒有變更。有些環境也可能對訂閱請求回傳網路驗證頁，因此「瀏覽器能開啟其他網站」不代表問題已排除。使用同一個入口，分別測試直接更新與透過代理更新，只保留成功的方式。兩種方式都失敗時，再檢查帳戶狀態與伺服器回應，避免把網路路徑問題誤判為訂閱格式損壞。

解析成功後檢查群組與篩選條件

更新完成但清單看起來是空的，請先清除搜尋欄與類型篩選，再切換至對應群組。部分用戶端會記住上次選取的群組，新項目可能已寫入其他群組，因此沒有顯示。若更新後項目數量有變化，請比較別名、位址與協定，不要只憑排序判斷內容是否消失。訂閱提供者調整內容時，舊項目可能被替換，用戶端也可能重新排列清單；請再次確認目前選取的伺服器。

格式相容性應從原始來源處理。某種連結即使能複製出來，也不代表目前用戶端能辨識其中所有協定與傳輸欄位。匯入時若明確提示不支援，請查看對應用戶端的支援範圍，或向提供者索取相容的訂閱格式。不要為了消除錯誤而任意刪除安全欄位；項目即使出現在清單中，也可能因缺少參數而無法連線。Android 的詳細匯入流程可參閱匯入訂閱教學。

復原後請檢查群組的自動更新設定，避免多個重複群組在不同時間互相覆蓋。先手動完成一次更新，再選取一個項目連線並開啟固定頁面，最後確認舊群組是否仍有保留價值。不要以頻繁重新整理取代排查；過度頻繁的請求可能觸發入口限制，也會讓錯誤發生的時間更難判讀。若訂閱已能正常取得，但連線仍逾時，請接著閱讀節點逾時章節，此時不必再調整訂閱更新方式。

速度緩慢：分階段找出瓶頸

網頁載入緩慢可能發生在網域解析、首次連線、頁面資源載入或持續傳輸階段。開啟網站前長時間空白，與開始下載後傳輸速度偏低，是不同類型的問題。清單中的延遲測試主要反映特定請求的回應時間，不能直接代表頻寬、穩定性或所有網站的表現。排查時應固定一項實際工作，例如開啟同一頁面或下載同一個公開檔案，再觀察哪個階段明顯變慢。

先排除本機網路與背景流量

保持裝置位置不變，先暫停系統更新、雲端硬碟同步及其他大量傳輸工作，並觀察 Wi-Fi 訊號與是否頻繁重新連線。共用網路上的其他裝置也可能占用出口。若直接連線本來就很慢，代理無法改善 Wi-Fi 干擾或本地出口壅塞。桌面裝置若能使用有線網路，可進行一次有線對照；Android 裝置則可比較 Wi-Fi 與行動網路，但測試時請留意流量用量，不必持續下載大型檔案。

每輪測試只變更一項條件。固定伺服器比較不同時段，可觀察負載變化；固定時段比較兩台伺服器，可觀察路徑差異；固定伺服器比較兩個網站，則可判斷是否為目標網站問題。不要一次切換伺服器、核心、路由與 DNS，再把速度變化歸因於其中一個開關。多次測試應記錄相同工作的表現與網路條件，避免受到瀏覽器快取、背景更新和偶發重試影響。

從日誌與資源使用量判斷成本

若頁面很快開始載入，但圖片或影片持續卡頓，請留意封包遺失、伺服器負載及目標網站的資源分發路徑。若第一次開啟很慢，之後重新整理卻明顯正常，應檢查解析、交握與連線重用。若只有特定網站速度慢，而同一伺服器存取其他網站正常，問題可能出在該網站與伺服器出口之間。此時切換本機協定參數未必有效，先交叉比較網站與伺服器更容易找出原因。

桌面端可透過系統工作管理員查看 CPU、記憶體與網路使用量。裝置資源不足、多個代理處理程序同時執行或虛擬網卡重複接管，都可能增加運作負擔。除錯日誌也會增加磁碟寫入，完成定位後應恢復一般日誌層級。Android 裝置還要留意發熱與省電策略：持續高負載可能導致系統調度改變；若問題只在螢幕關閉後出現，請改查行動裝置背景執行章節。

別用複雜設定取代測量

多路複用、並行連線與傳輸設定都不是通用的加速開關。是否有效取決於協定、伺服器支援、連線品質與請求類型；設定不相容也可能造成連線失敗。請先保留訂閱提供的原始參數，只有在測試目的明確時才調整一項，並記錄如何復原。尤其不要照抄與目前核心不相容的設定片段；欄位可能遭忽略，也可能導致啟動失敗。

路由也會影響效能。同一網站的頁面與資源可能使用不同網域，若規則將它們分配到不同出口，頁面載入表現就可能不穩定。可暫時讓待測網域使用相同出口進行驗證，再進一步調整規則，而不是長期將所有流量都改用相同方式處理。系統代理與路由的分工，請參閱系統代理模式詳解，先確認流量進入用戶端的位置，再比較各路徑的成本。

是否恢復應依原本的工作來判斷，而不是追求單一測試數字。常用頁面已能穩定開啟、連續傳輸不再中斷，就不必繼續疊加參數。若只有特定時段或伺服器持續緩慢，請記下可重現的條件，交由設定提供者檢查出口與負載。本機用戶端設定無法保證遠端連線容量有所改變；合理的排查結果也可能是確認瓶頸不在裝置上。

DNS 問題：找出解析發生的層級

DNS 會將網域名稱轉換為位址，但在代理情境中，解析不一定只由作業系統負責。瀏覽器可能啟用安全 DNS，用戶端可能有內建解析設定，遠端也可能接收網域名稱後自行解析。修改系統 DNS 後毫無變化，不代表設定沒有儲存；也可能是該請求根本沒有使用系統解析。排查前先確認發生問題的網域、時間與應用程式，再判斷由哪一層負責解析。

分辨解析失敗與連線失敗

若瀏覽器顯示找不到伺服器，或日誌出現解析錯誤，應優先檢查 DNS；若日誌已取得位址，但連線到該位址時逾時，則應繼續檢查連線路徑。不要將所有網域存取失敗都歸咎於 DNS。直接把網站網域換成 IP，也不是可靠的驗證方式，因為許多網站仰賴 HTTPS 伺服器名稱與虛擬主機；用位址存取可能遇到憑證錯誤或開啟其他網站，這些現象都無法證明原網域解析有問題。

先用相同網域測試兩個應用程式，確認是否只有瀏覽器失敗。瀏覽器的安全 DNS、代理擴充功能與獨立網路設定，可能會繞過系統路徑；可暫時恢復為遵循系統設定後重新測試。接著比較直接連線與透過代理連線的結果。若只有代理路徑失敗，請檢查用戶端使用的 DNS 伺服器是否可連線，以及 DNS 請求所走的出口；若兩條路徑都失敗，也要確認網域是否有效，以及目前網路是否已完成驗證。

檢查循環依賴與位址類型

常見的循環依賴之一是：連線至代理伺服器前必須先解析它的網域名稱，但 DNS 請求又被設定為必須經過尚未建立的代理。另一種情況是加密 DNS 伺服器使用網域名稱，但解析該名稱所需的引導路徑尚未設定。若啟動後連續發生解析失敗，應檢查是否有這類先後依賴。解決方式是為初始解析提供可用路徑，而不是無限制增加解析伺服器；具體欄位與引導機制應依目前核心支援的功能設定。

IPv4 與 IPv6 也應分開檢查。網路即使能回傳 IPv6 位址，也不代表裝置到目標的 IPv6 路徑穩定。若只有特定網路出現等待後才切回其他位址的情況，可在用戶端支援的範圍內暫時調整位址類型偏好，再用相同網域測試。只有結果明確顯示與位址類型有關時才保留修改；不建議只因一次失敗就在整個系統永久關閉某種位址類型，以免影響其他應用程式與本地網路服務。

讓解析策略與路由策略相互對應

以網域為條件的規則與以 IP 為條件的規則，符合條件的方式不同。以下是路由物件片段，用來說明先依網域與私有位址條件進行直連的結構；它不是完整用戶端設定，不能取代現有設定。此範例要求目前設定中已有名為 direct 的出口，且核心能讀取相應的規則資料。若用戶端會自動產生設定，應優先在圖形介面編輯等效規則，避免產生的檔案下次啟動時遭覆寫。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

AsIs 表示在路由階段依現有目標資訊比對，不會為了符合所有 IP 規則而主動將網域解析為位址；這不代表連線過程完全不需要 DNS。若規則使用 IP 條件，而入口提供的是網域名稱，是否觸發解析取決於路由策略。調整前請先釐清目的：是要修復網域解析，還是要讓特定 IP 規則生效。這兩種需求不能簡單用同一個「遠端 DNS」開關概括。

修改完成後，重新啟動代理服務並重新開啟測試應用程式；必要時依作業系統提供的方式刷新解析快取。瀏覽器、系統與用戶端可能分別保留快取結果，重新整理一次不一定能清除所有舊連線。請使用相同網域重複測試，並觀察錯誤是否從解析階段轉為連線階段。若解析已恢復，但目標仍無法存取，應繼續排查下一層，不要再更換 DNS。術語說明請參閱名詞解釋，先釐清解析伺服器、查詢路徑與路由出口的差異。

系統代理無效：確認接管範圍

系統代理會將代理位址寫入作業系統，供應用程式讀取，但不保證所有程式都會使用。路由規則只會處理已進入用戶端的流量。虛擬網卡則是另一種接管方式，需要另外設定權限、路由與 DNS。排查時先選定一種入口，不要同時啟用多種機制，再依應用程式是否遵循該入口決定下一步。用戶端顯示某種路由模式，不代表系統代理已正確設定。

先核對監聽位址與連接埠

先在 v2rayN 查看實際啟用的本機入口類型、監聽位址與連接埠，再核對作業系統的代理設定。HTTP 代理、SOCKS 代理與混合入口不能只憑連接埠外觀互相替代；應用程式要求哪種協定，就必須使用相應入口。若監聽位址是本機迴圈位址，就只能供目前裝置存取；不要只為了修復本機瀏覽器問題，就改為監聽所有網路介面，這會擴大可連線範圍。

若日誌顯示連接埠已被占用，請關閉舊的用戶端執行個體或其他代理程式後再啟動。也可透過圖形介面更換本機連接埠，但更換後必須同步更新所有手動設定的應用程式。系統代理可能由用戶端自動更新，但瀏覽器擴充功能、下載工具或開發軟體中的獨立代理設定不會自動同步。只更換用戶端連接埠、卻未更新應用程式，是「部分程式可用、部分程式失效」的常見原因。

釐清系統、瀏覽器與應用程式設定的優先關係

瀏覽器可能遵循系統設定，也可能使用擴充功能指定的代理或自動設定指令碼。請先暫時停用代理相關擴充功能，確認瀏覽器的網路設定沒有另外覆寫，再進行測試。有些程式不會讀取系統代理，必須在程式本身設定 HTTP 或 SOCKS 入口；另一些程式則透過獨立的網路服務連線。不能因為瀏覽器能連線，就推斷所有應用程式都會經過代理；也不能因某個應用程式直接連線，就判定系統設定完全失效。

Windows 的不同網路元件可能讀取不同的代理設定；macOS 的代理設定與目前網路服務有關，切換有線與無線網路後應再次核對；Linux 桌面環境中的代理設定也不代表所有程式都會自動採用。若問題只在登入系統後出現，請確認用戶端是否已啟動核心，以及系統代理是否指向仍在監聽的連接埠。自動啟動流程可參考Linux 安裝與桌面登入後自動啟動說明。

分別驗證代理入口與路由結果

使用固定網站發出請求，觀察存取日誌是否出現相應目標。沒有紀錄時，優先排查入口；已有紀錄但流量被分配至直連，請檢查路由；已有紀錄且代理出口報錯，則應檢查伺服器。日誌未啟用或應用程式重用了舊連線，也可能暫時看不到新紀錄；因此重新測試前，可先關閉測試頁面並重新開啟應用程式。判斷時應綜合多項線索，不要只因缺少某一筆日誌就認定流量沒有進入。

若同時使用虛擬網卡接管，請先關閉虛擬網卡，只保留系統代理進行對照；反過來測試虛擬網卡時，也要確認是否需要保留系統代理。雙重接管可能造成重複轉送、例外規則不一致或 DNS 路徑改變。虛擬網卡啟動失敗也可能與系統權限及驅動程式狀態有關，不能靠反覆切換路由模式修復。請依用戶端的實際需求授予權限，不要讓所有相關程式長期以高權限執行。

修復後請分別驗證啟用、停用與重新登入三種狀態。啟用時測試應用程式能進入代理；停用後應恢復預期的直接連線；重新登入後，連接埠與啟動狀態也應一致。若要讓區域網路中的裝置使用本機代理，應另外規劃監聽範圍、存取權限與防火牆規則，不要將此需求混入本機故障排查。系統代理與全域、繞過中國大陸規則的差異，可繼續參閱系統代理模式詳解。

啟動失敗與當機：保留錯誤現場

圖形介面無法開啟、介面正常但核心退出，以及使用一段時間後整個程式關閉，是三種不同問題。啟動失敗通常應檢查安裝檔、執行環境與權限；核心退出則優先檢查設定與連接埠；程式運作一段時間後當機，還需觀察資源使用量與觸發操作。請先記錄最後一次正常使用到首次出錯期間發生的變化，包括更新、搬移資料夾、修改設定與系統安全提示，不要直接刪除所有資料而失去線索。

確認平台、架構與安裝位置

桌面端建議優先使用 v2rayN，並在用戶端下載頁依作業系統與處理器架構選擇安裝檔。macOS 請區分 Apple Silicon 與 Intel；Linux 則要確認發行版套件格式與處理器架構。Windows 桌面版與傳統 WPF 版屬於不同介面分支，執行環境需求請以各自說明為準。套件格式相同不代表架構相同；安裝程式能否啟動與代理設定內容無直接關係，請先讓程式正常執行。

依照安裝檔類型完成安裝或完整解壓縮，不要直接從壓縮檔預覽畫面啟動，也不要只複製單一程式檔而漏掉相關資源。請將資料放在可正常寫入的位置，並檢查磁碟空間與資料夾權限。若安全軟體處理了程式，先查看系統紀錄，確認涉及哪個檔案及觸發原因，再依組織或裝置的安全規範處理。不要為了啟動代理用戶端而關閉整套系統防護，也不要從不明來源補齊遺失檔案。

區分介面問題與核心設定問題

若介面能正常開啟，但按下連線後立即停止，請先查看核心日誌。常見原因包括 JSON 語法錯誤、欄位不受支援、出口標籤不存在、規則資源無法讀取，以及監聽連接埠衝突。錯誤訊息通常會指出設定位置或相關欄位，請優先復原最近新增的設定。若問題是在更新訂閱後才出現，可用先前可用的項目對照，確認是某一項目無法產生設定，還是所有設定都無法運作。

以下是日誌物件片段，用來示範 Xray 與 V2Fly 設定中常見的日誌層級寫法，並非完整啟動設定。若用戶端提供圖形化的日誌層級選項，請透過介面調整。需要更多資訊時，可暫時啟用偵錯層級；重現一次問題並儲存相關片段後，請恢復一般層級。長期啟用詳細日誌會增加磁碟寫入，也可能記錄大量存取目標，不適合作為預設設定長期保留。

{
  "log": {
    "loglevel": "warning"
  }
}

手動編輯設定時，也要檢查引號、逗號與括號。標準 JSON 不接受註解或多餘的尾隨逗號；部分文件中的說明片段也不能直接拼成完整設定。暫時修改用戶端自動產生的檔案，可能在下次啟動時被重新產生的內容覆蓋，因此應優先使用相應的圖形設定介面。遇到不熟悉的欄位，不要只為了讓程式啟動就直接刪除，以免改變驗證、安全性或路由行為。

以可復原的方式隔離損壞設定

若懷疑使用者設定已損壞，請先完整退出用戶端並確認背景處理程序已結束，再備份設定資料夾。資料夾位置會因平台、安裝方式與資料模式而異，請透過用戶端說明或介面確認，不要照著網路上的固定路徑大量刪除檔案。備份後，使用獨立且乾淨的資料環境測試；若能正常啟動，再逐步還原訂閱、路由與介面偏好，確認是哪類設定引發故障。

升級後出現異常，不一定要立刻降級。請先確認套件是否完整安裝、舊處理程序是否仍在執行，以及新版介面是否支援原本的設定項目。需要復原版本時，請先保留升級前後的資料備份，避免不同分支反覆寫入同一份設定。重新安裝不一定會清除使用者資料，因此只重裝相同程式、卻不檢查設定，可能仍會遇到相同錯誤。用戶端選型與分支差異請參閱用戶端比較。

復原後，請依照原本觸發問題的操作重新測試，例如更新訂閱、切換伺服器、開啟路由設定或重新登入系統。回報問題時，請提供系統類型、架構、安裝方式與已移除敏感資訊的日誌，不要公開使用者資料目錄。若特定設定能穩定重現錯誤，請說明使用的協定與傳輸類型；若使用空白設定仍會當機，則應優先檢查執行環境與程式本身，避免將兩種問題混為一談。

Android 專項：權限、背景執行與網路切換

Android 裝置建議優先使用採用 Xray 核心的 v2rayNG；採用 V2Fly 核心的 v2flyNG 則可作為替代選項。行動裝置排查除了伺服器與訂閱，也要檢查 VPN 授權、個別應用程式規則、背景執行策略，以及 Wi-Fi 與行動網路切換。系統顯示 VPN 標誌，只代表已有相應連線，不代表代理伺服器能連上目標。請先確認目前實際使用哪個用戶端，再依本章順序逐項比對，避免多個應用程式的狀態互相干擾。

處理 VPN 授權與連線衝突

首次啟動連線時，必須確認系統彈出的 VPN 授權提示。未完成授權、誤按取消或受到裝置管理政策限制，都可能導致服務無法建立。Android 的一般應用程式 VPN 通道通常無法由多個同類應用程式同時接管，因此請先停止其他 VPN 工具，包括透過本機 VPN 實作過濾的應用程式，再啟動目前的用戶端。工作設定檔與受管理裝置可能另有使用限制，不能藉由更換節點繞過系統管理規定。

若已啟用「一律啟用 VPN」或「封鎖未經 VPN 的連線」，請先了解中斷時的行為：代理服務停止後，系統可能依設定封鎖其他網路存取。此時「停止後也無法上網」不一定代表網路故障。排查前先記錄原本的策略，再暫時調整並比較；完成後請恢復符合使用需求的設定。不要只看用戶端的按鈕狀態，也要到系統 VPN 設定中確認目前的連線歸屬與限制選項。

排查螢幕關閉後斷線與背景限制

螢幕亮著時可以連線，關閉一段時間後卻失效，請先檢查系統的電池最佳化與背景執行限制。不同裝置對「允許背景活動」、「自動啟動」與「電池最佳化」的命名各異，請依目前系統介面尋找相關設定。只為需要持續執行的用戶端授予適當權限，不要關閉所有應用程式的省電機制。設定完成後，分別測試螢幕開啟、螢幕關閉與重新開啟應用程式三種情況，並觀察服務通知是否消失或被系統重新建立。

數據節省模式與背景行動數據限制，也可能讓服務持續執行卻無法傳輸。請確認目前用戶端在所使用的網路下獲准連線，尤其留意從 Wi-Fi 切換至行動網路後的狀態。若每次切換後都要重新連線，請先確認是否有舊連線未重新建立或 DNS 路徑改變，不要立刻刪除訂閱。開啟飛航模式再關閉，只能用來重新建立網路連線作為對照，不是長期解決方式。

核對個別應用程式規則與本地網路行為

個別應用程式代理可能採用「僅包含清單」或「排除清單」，兩者的意義正好相反。修改清單後，應重新建立 VPN 連線，讓新設定生效，再分別使用清單內與清單外的應用程式測試。若瀏覽器能連線、其他應用程式卻不行，請先確認故障的應用程式是否進入 VPN，以及應用程式內是否另有代理或網路設定。單一應用程式的快取、帳戶連線或目標服務異常，也無法靠切換所有流量的路由準確判斷。

區域網路裝置無法存取時，請檢查本機位址是否被送進代理，以及用戶端是否提供略過區域網路的設定。印表機、家庭儲存裝置與路由器管理頁面都需要使用目前的區域網路路徑，遠端代理通常無法取代這條路徑。私有位址規則、系統 VPN 路由與應用程式本身的探索機制可能同時生效，因此請先停止 VPN 進行一次對照，再逐項恢復設定。不要將放寬區域網路監聽權限當成手機存取區域網路的通用解法。

安裝與復原後的驗證順序

請從Android 下載入口依裝置架構選擇安裝檔。安裝失敗時，先檢查儲存空間、系統安裝提示、處理器相容性與目前的安裝來源；不要立刻解除安裝，以免訂閱與自訂規則一併刪除。重新安裝前，請先透過用戶端支援的方式儲存必要設定，並妥善保管其中的帳戶資訊。通用版與架構專用版的選擇，應以裝置實際支援能力為準。

復原後，依序測試一般網頁存取、個別應用程式行為、螢幕關閉後持續執行與網路切換，每個步驟都使用同一台有效伺服器。若只有行動網路無法連線，請回到 DNS 與逾時章節對照網路路徑；若只有背景執行時出問題，請繼續檢查系統限制。三款用戶端的選型差異，請參閱三款用戶端差異比較。確認日常使用情境穩定後，再恢復自動更新及其他自訂設定，並保留一份可正常運作的設定，作為下次排查的基準。