Shadowrocket 故障排解

01 / VPN 設定與連線狀態

連線開關無法開啟或立即中斷

先區分未獲授權與連線後中斷

在 Home 開啟連線開關後，先觀察系統是否出現新增 VPN 設定的請求，以及開關是在授權前沒有反應，還是短暫連線後又回到 Not Connected。這兩種情況涉及不同環節：前者應檢查系統授權，後者還需確認目前設定能否啟動。先不要刪除伺服器清單。記下發生時間、使用的網路和畫面上的完整提示，避免把未確認的系統請求誤判為伺服器故障，也有助於日後重現問題。

首次允許新增 VPN 設定時，請在系統彈出視窗中確認，並依裝置要求完成身分驗證。若先前取消過請求，請返回 Shadowrocket 重新操作，並留意 App 是否仍在前景。接著到系統 Settings 搜尋 VPN，確認是否有對應設定，以及是否有其他連線正在使用。選單位置會隨系統版本而異，請以裝置實際顯示為準；受管理裝置也可能受到組織政策限制，遇到這種情況應先向裝置管理員確認權限範圍。

以最小幅度變更恢復連線環境

先關閉目前連線，再檢查其他已啟用的 VPN 或網路過濾功能，避免多個功能爭用同一連線環境。一次只暫停一項，測試後再恢復原狀。若在家中 Wi-Fi 可以連線、換到其他網路就不行，請接著確認該網路是否需要網頁認證。公共網路的登入頁尚未完成驗證時，連線請求可能一直失敗；先中斷連線並完成網路登入，再重新嘗試。登入頁無法開啟，不應直接判定為設定損毀。

確認至少有一筆欄位完整的伺服器記錄，並檢查目前選取的項目是否仍存在。更新訂閱或刪除群組後，原先的選取項目可能已經變更。若 App 明確提示設定欄位有誤，請依提示檢查最近修改的檔案，不要反覆點擊開關。暫時將新增的規則、重寫或其他選用設定還原至備份狀態，保留基本連線條件。這樣可以判斷故障來自啟動設定還是遠端連線，也能避免連原本正常的參數都被改亂。

若系統中還留有舊的 Shadowrocket VPN 設定，可先完成 App 內設定備份、停止連線，再移除對應的系統 VPN 設定，然後返回 App 重新觸發授權。這只會處理系統連線記錄，不會還原訂閱內容，也不保證能找回本機資料。不要一開始就刪除 App；若沒有備份，重新安裝可能連原有伺服器、規則和診斷線索都一併遺失，反而讓排查缺少比較依據。

開關自動切換時檢查觸發條件

若手動關閉後又自動連線，或切換網路時狀態立即改變，請檢查 On Demand 是否已啟用。它會依已設定的條件運作，不應和單次手動開關操作混為一談。為建立基準，可先記下條件並暫時停用，再分別測試一次手動連線與中斷。若狀態穩定，再逐項恢復條件，特別留意指定無線網路、行動網路與網域觸發條件之間是否有相反動作。詳細條件說明請參閱On Demand 設定文章。

03 / 伺服器與協定交握

伺服器逾時與連線遭重設

區分測試結果與實際服務存取

Connectivity Test 的結果，是在指定測試方式和目標下的一次觀察。出現逾時，可能是伺服器無法連線、測試目標沒有回應、協定交握失敗，也可能是目前網路影響了相關傳輸。先查看實際使用的測試方式和目標設定，再以真實網頁請求作比較。單次測試失敗不能單獨證明既有伺服器已失效；反過來，測試出現數值也不代表登入、影片或其他服務都能正常使用，兩者回答的問題並不相同。

先確認伺服器位址和連接埠來自使用者已有的有效資訊，並檢查複製時是否混入空格、換行或中文標點。位址欄位通常應填入主機名稱或位址本身，不應誤填整條訂閱連結。也要區分連線位址、TLS 的伺服器名稱與傳輸層的 Host：部分設定中三者可以不同，但必須符合服務端約定。不要為了「看起來一致」就把三個欄位改成相同值，以免破壞原本正確的路由或憑證驗證條件。

依協定核對整組參數

核對參數時，應以完整的一筆記錄對照原始資訊，不要從不同記錄拼湊欄位。傳輸方式、路徑、Host 和 TLS 的組合通常彼此相關：只修改其中一項，連線可能在建立後立即中斷。若記錄是從既有訂閱匯入，請先重新核對訂閱中的對應項目，再判斷是否需要手動編輯。VMess 等術語的定義可參閱術語手冊；此處表格只提供排查順序，不是完整的協定設定清單。

若出現憑證相關錯誤，也要檢查裝置日期與時間是否正確、系統是否有尚未完成的網路認證，以及伺服器名稱是否正確。不要把停用憑證驗證當成通用修復方式，這可能掩蓋位址填錯、憑證過期或名稱不符等問題。若既有資訊要求使用特定名稱，請向原資訊來源確認正確值。確認裝置時間與名稱後仍然出錯，請保留錯誤類別及發生時使用的網路，交由伺服器維護方檢查憑證鏈和服務端監聽狀態。

透過網路比較縮小遠端問題範圍

在條件允許且不會產生意外流量費用時，保持伺服器和測試目標不變，只在 Wi-Fi 與行動網路之間切換。若只在某種網路下逾時，問題較可能與該網路的解析、傳輸限制或路徑有關；若多種網路都失敗，應繼續檢查遠端服務狀態和驗證資訊。部分協定依賴 UDP，網頁可以直接連線，不代表該傳輸一定可用。不要在沒有依據時任意修改連接埠或傳輸方式，這些設定需要服務端配合。

若使用者已有多筆可用記錄，可用另一筆已知正常的記錄作單次比較，但不能據此評價整組服務品質。連續大量測試可能增加干擾，使暫時壅塞和實際設定錯誤混在一起。排查完成後，提供給伺服器維護方的資訊可包含協定類型、出錯階段、網路類型和已遮蔽敏感資訊的提示；不要在公開截圖中顯示密碼、完整識別資訊或訂閱網址。若驗證已成功，但只有特定目標失敗，請回到規則與 DNS 章節檢查，不要反覆重填驗證欄位。

05 / 傳輸量、延遲與目標差異

連線正常但速度緩慢

先把「速度慢」轉化為可比較的現象

速度慢可能表現為網頁首次開啟等待時間長、持續傳輸速度低、影片反覆緩衝，或互動請求偶爾卡住；這些現象不一定有相同原因。先記錄具體 App、目標網域、網路類型和發生階段，再以相同目標少量重複測試。Connectivity Test 的數值主要反映測試條件下的結果，不等同實際服務的傳輸速度；測試回應較快的記錄，也可能在前往目標服務的路徑上發生壅塞，因此不能只憑單項測試結果決定日常使用哪筆記錄。

先中斷連線，檢查基本網路是否穩定，留意 Wi-Fi 訊號、路由器負載，以及是否有其他裝置同時進行大量傳輸。行動網路也會受到訊號、所在位置和網路切換影響。測試期間保持裝置位置和網路不變，並暫停明顯占用頻寬的同步工作。若基本網路本身波動很大，應先恢復穩定的環境再評估代理路徑，否則每次結果的差異可能只是無線連線條件變動，與剛修改的設定無關。

區分解析等待與持續傳輸問題

若首次開啟某個網域很慢，但頁面開始載入後能持續傳輸，應優先檢查 DNS 與連線建立階段。若所有頁面都能很快顯示文字，但圖片和影片持續載入緩慢，則應進一步檢查目標路徑、遠端負載和實際分流結果。以不同類型的頁面比較時，請注意它們的內容大小並不相同；輕量頁面開啟很快，不代表所有服務都已恢復正常。瀏覽器快取也會影響體感，重新測試時請註明是首次請求還是已快取的內容。

在 Config 下檢查速度緩慢的請求是否走了預期策略。部分頁面會同時連線到多個網域，若主站走 PROXY、資源網域卻走 DIRECT，可能出現正文已顯示、圖片仍在等待的情況。請從實際請求記錄找出失敗的資源網域，再判斷是否需要新增規則，不要為了方便而擴大 DOMAIN-KEYWORD 的匹配範圍。規則過於寬泛會影響無關目標，造成多餘的轉送。指定網站的設定方式可參考DOMAIN-SUFFIX 與 FINAL 範例。

若 Proxy 和 Config 都很慢，請保持測試目標一致，並在同一網路下比較使用者已有的另一筆有效記錄。結果只能說明這次連線路徑有所差異，不能直接推論長期品質。伺服器負載、目標服務限速和跨網路路徑都可能隨時間變化。連續進行大量傳輸測試會額外耗用數據，也會影響其他請求，宜在有限次數內收集足夠資訊。若需要持續測量，請先確認自己的流量條件，避免排查本身成為新的頻寬負擔。

不要用任意修改參數取代實際證據

若連線長時間停頓、部分大型內容失敗但小型請求正常，可進一步檢查路徑與傳輸相關條件，但不宜盲目調整 MTU、並行數或協定參數。這些參數受網路和服務端條件限制，調高或調低都可能造成副作用。先保留預設值或已知正常值，並記下問題是否只在特定網路發生。只有取得明確錯誤線索，或維護方提供適用數值後，才進行單項比較，同時保留原值以便立即復原。不要照抄不相關情境中的設定。

裝置發熱、電量偏低、背景同步和目標 App 本身的解碼工作，也可能讓「頁面卡頓」看起來像網路變慢。可用另一個 App 開啟類似內容，比較問題是來自網路等待還是介面操作遲緩。若只有單一目標一直很慢、其他目標正常，也應考慮目標服務的狀態，避免不斷修改用戶端設定。修復後，請驗證常用頁面、持續傳輸和網路切換三種情境，確認改善不是短暫快取造成，再恢復日常設定和原有背景工作。

07 / 活動時間與重複連線

耗電增加與裝置發熱

先確認耗電比較條件一致

系統電池頁面顯示的 App 耗電比例，是所選時間範圍內的統計結果，不代表該 App 在所有情境下的固定耗電量。使用時間、螢幕亮起的前景操作、網路條件和其他 App 活動都會改變比例。先比較使用強度相近、網路相同的時段，並查看是否伴隨大量資料傳輸、反覆連線或裝置持續發熱。只看到比例升高，不能直接判定發生異常；其他 App 的用量減少，也會讓相同活動在總量中的比例上升。

記錄耗電是否從某次設定修改、訂閱更新、網路切換或 App 更新後開始，並區分螢幕開啟與待機狀態。待機時若仍持續有網路活動，先確認照片同步、檔案傳輸、影音播放等工作是否正在透過連線進行。用戶端處理其他 App 的資料會產生工作負載，但實際流量可能來自背景工作。檢查時先暫停明顯的大量傳輸活動，再觀察連線是否穩定，不要只根據單一統計名稱推斷所有耗電來源。

檢查 On Demand 與網路反覆切換

Wi-Fi 訊號微弱、與行動網路來回切換時，可能觸發重複交握與連線復原。若 On Demand 規則在兩種網路上設定不同動作，切換時也會進一步改變狀態。先在訊號穩定的位置保留單一網路作比較，記錄自動觸發條件後暫時停用，再觀察待機活動是否明顯改變。測試完成後恢復需要的規則。不要為了降低耗電而永久移除自己需要的連線條件，應先找出真正導致重複觸發的網路或規則組合。

若伺服器驗證持續失敗，或遠端連線反覆遭到中斷，裝置可能會不斷嘗試重新連線。應先依伺服器逾時章節排除錯誤，再評估耗電情況。只鎖定螢幕，並不會讓錯誤的驗證條件自行恢復。請查看記錄中是否在短時間內反覆出現同類錯誤，以及是否總在切換網路後發生；有規律的重試比單次電量變化更能說明問題。必要時停止目前連線，避免在不可能成功的條件下持續重試，並保留一段已遮蔽敏感資訊的記錄。

減少排查過程造成的額外活動

批次執行 Connectivity Test、頻繁自動更新訂閱和持續記錄詳細資訊，都可能增加排查期間的網路與處理活動。只在需要時啟用足以找出問題的診斷程度，取得線索後恢復日常設定。不要為了觀察耗電而同時執行多個循環測試，也不要連續重新整理大量目標頁面。若關閉這些暫時工作後恢復正常，應先調整測試頻率，而不是修改原本穩定運作的協定參數；診斷負載和日常連線負載應分開評估。

裝置發熱也會影響效能，讓網頁看起來變得卡頓。應先停止大量傳輸工作，待裝置恢復正常溫度後再比較。充電狀態、螢幕亮度和環境溫度也會影響觀察，測試時應盡量保持一致。不要只憑機身溫度就認定特定元件損壞。若中斷連線後仍持續異常，請查看系統電池頁面中的其他活動，並依裝置系統提供的說明處理，不要把所有裝置耗電問題都歸咎於某項網路設定。

復原驗證至少應涵蓋一次正常使用，以及一段在相近條件下的待機觀察。成功標準不是耗電比例必須降至某個固定數字，而是反覆重新連線已停止、背景工作符合預期，且在相同使用方式下不再異常發熱。回報時請提供統計時間範圍、網路類型、是否啟用 On Demand，以及是否執行過大量測試。不要公開完整流量記錄，因為其中可能包含瀏覽網域、伺服器資訊或私人活動；可先保留與異常時段相鄰且必要的片段。

09 / iPad 網路與多工情境

iPad 連線與復原專項

分開處理購買記錄復原與設定移轉

在 iPad 上恢復使用時，先確認 App Store 登入的是持有相應購買記錄的帳號，再依iPad 取得說明操作。系統需求與購買相容性以 App Store 頁面標示為準。重新取得 App，不代表舊裝置上的伺服器和 Config 會自動出現在新裝置上；購買記錄與使用者設定是兩回事。首次開啟後，應逐項確認既有訂閱、伺服器資訊和檔案是否完整，不要直接開啟連線開關，再依連線失敗判定復原過程出錯。

從其他裝置移轉設定時，應使用自己保存的有效備份或既有資訊重新匯入，並核對選取的伺服器、Global Routing 和目前的 Config。群組名稱相同，不代表內容完全一致；尤其要檢查位址、驗證參數和規則末尾的 FINAL。若只匯入伺服器清單，卻沒有相應規則檔案，Config 下的表現可能與舊裝置不同。請先依快速入門指南建立基本連線，再恢復較複雜的規則；比起一次移入所有選用設定，這樣更容易找出缺少的項目。

多個視窗不代表有多組獨立連線環境

iPad 的分割畫面與多視窗功能方便同時查看手冊和 App，但系統網路連線狀態仍需整體判讀。切換視窗、調整視窗大小或返回主畫面，不代表建立了另一組獨立 VPN 工作階段。診斷時固定使用一個瀏覽器視窗和一個測試目標，避免另一個視窗仍顯示快取頁面而造成矛盾印象。若一個視窗正常、另一個失敗，請先比較兩者瀏覽的網域、登入狀態和是否確實重新載入，再查看請求記錄；不要只根據視窗差異就推斷路由規則失效。

部分 iPad 僅支援 Wi-Fi，另有部分機型支援行動網路。若裝置沒有行動網路，可在自己有權使用的另一個無線網路上進行比較；但透過個人熱點連線時，上游網路本身也可能有所變動。保持伺服器和測試目標不變，並註明使用的連線方式。公共無線網路仍須先完成認證頁面；若鎖定螢幕後返回前景就無法存取，請先確認無線網路是否仍然連線，再檢查 VPN 狀態，不要立即刪除系統 VPN 設定。

鎖定螢幕、背景工作與受管理裝置

鎖定螢幕後下載暫停，不一定是連線故障；目標 App 本身的背景執行規則也會影響工作能否持續。先解鎖裝置，用瀏覽器發出一個新的小型請求，確認連線是否可用。若新請求成功但舊工作沒有繼續，請檢查原 App 的工作狀態；若所有新請求都失敗，再查看 On Demand、網路切換和伺服器重新連線記錄。不要把單一檔案工作暫停直接當成系統網路中斷，也不要一直亮著螢幕來掩蓋根本原因。

由學校、企業或其他組織管理的 iPad，可能受到 VPN 設定、憑證、網路過濾和修改權限限制。請確認系統是否明確顯示受管理狀態，並向管理員確認允許的使用方式。不要任意移除不理解的管理設定或憑證，以免影響必要業務和裝置權限。一般個人裝置也應先記錄既有系統設定，確認影響範圍後再操作。無法新增 VPN 的問題應回到授權章節排查，不能靠修改伺服器驗證參數解決。

iPad 與另一台裝置連上同一 Wi-Fi 後表現不同，仍應逐項比較裝置本身的系統時間、DNS、目前 Config 和伺服器選取項目；不能因為使用相同無線網路，就排除本機差異。瀏覽器隱私設定、已儲存的網路條件和目標 App 權限，也可能造成請求路徑或結果不同。測試應使用相同目標和相同存取操作，優先從 App 的實際請求記錄確認差異。若只比較兩個不同 App 的首頁，很難得出可靠的網路結論。