01 · 系統連線層
無法啟動或立即中斷
先確認系統是否已建立通道，再檢查通道使用的伺服器。
區分「無法啟動」與「啟動後無法連線」
開啟 Home 中的連線開關後，觀察開關是否維持開啟，以及系統是否顯示 VPN 已連線。若開關立即跳回，問題通常出在系統授權、通道啟動或設定載入階段；若開關維持開啟但網頁無法開啟，請查看下一章。伺服器測試失敗不代表系統無法建立通道；反過來，系統顯示已連線也不代表遠端伺服器可用。先記下實際狀況，避免在權限問題上反覆更新訂閱。
首次連線時，iPhone / iPad 會要求允許加入 VPN 設定。確認提示是由剛才主動開啟的 Shadowrocket 發出，再依系統指示完成授權與裝置驗證。若先前取消提示，請回到用戶端重新連線；若一直沒有提示，請前往系統 Settings，確認是否已有 VPN 設定，以及裝置是否受到管理限制。系統需求以 App Store 頁面標示為準，不能只依裝置外觀或型號名稱判斷相容性。
檢查設定衝突與自動連線
暫時關閉其他正在執行的 VPN 連線，以及可能占用同類網路延伸功能的過濾工具，再單獨啟動 Shadowrocket。這麼做是為了減少同時控制系統網路路徑的元件，不代表特定功能一定有問題。若裝置由學校或公司管理，請勿自行刪除管理描述檔；先確認管理政策是否允許建立個人 VPN。無法變更的系統限制須由裝置管理員處理，修改節點參數無法繞過限制。
若手動關閉後又自動連線，先檢查 On Demand，不要直接認定開關故障。按需連線條件可能在切換網路或 App 發出請求時再次觸發。測試時記下原有條件，暫時停用自動連線，再手動連線一次。若關閉後系統仍顯示 VPN，請確認目前使用的是哪一項設定；狀態圖示相同，不代表連線一定由 Shadowrocket 建立。
以最精簡的設定找出啟動失敗位置
保留目前 Config 的副本，選擇一份結構簡單、來源明確且先前可用的設定進行比對。若只有某份 Config 會立即中斷，優先檢查最近加入的規則、腳本引用或不完整內容；若所有設定都無法啟動，先檢查系統權限與網路延伸功能狀態。每次只替換 Config 或 SERVER 其中一項，否則即使恢復正常，也無法確認是哪個步驟解決問題。不要同時更新遠端設定與重新啟動系統。
App 沒有回應時，可先結束用戶端前景程序並重新開啟，再試一次；仍無改善時，重新啟動裝置，以排除暫時性的系統網路延伸狀態異常。不要連續快速切換開關，啟動與停止都需要時間，反覆操作會讓狀態更難判斷。若系統顯示具體錯誤，請保留錯誤原文、發生時機與重現步驟；錯誤資訊通常比「連不上」更有助於找出原因。
連線恢復後，保留驗證結果
重新授權或還原設定後，先關閉 On Demand，手動連線與中斷各一次，再開啟先前無法載入的頁面。手動流程穩定後，再逐項恢復自動連線條件。若開關正常，但接著出現無法存取、逾時或解析錯誤，表示問題已進入下一層，請前往相應章節繼續排查，不要反覆刪除 VPN 設定。最後記下哪些設定可以啟動，以及停用哪些系統功能後狀況有所改變，方便日後還原原有環境。
02 · 請求路徑
連線後無法上網
先從中斷連線時的基礎網路開始，再比較 Global Routing 的三種狀態。
先確認基礎網路可正常使用
中斷 Shadowrocket，確認目前的 Wi-Fi 或行動網路本身可以正常連線。公共 Wi-Fi 可能需要先開啟認證頁面、接受使用條款或重新登入；尚未完成認證時，即使伺服器參數完全正確，也可能無法連線。請先完成網路認證，再啟動用戶端。若中斷連線後仍無法存取，請優先檢查路由器、訊號、流量限制與系統網路狀態，不要先修改規則檔。
確認基礎網路正常後，重新連線，只開啟一個確定可用的測試頁面，並記下是所有 App 都失敗，還是只有瀏覽器、特定 App 或網域無法使用。若只有一個 App 異常，請檢查行動數據權限、App 本身的網路設定與快取；若所有請求都受影響，再查看 SERVER、Global Routing 與 Config。不要以已載入快取的頁面當作成功證據；重新整理或開啟新的普通網頁，較容易進行有效比對。
用三種狀態劃分故障範圍
| 介面狀態 | 請求處理方式 | 排查用途 |
|---|---|---|
| Config | 依目前設定的規則選擇策略。 | 檢查規則比對結果與策略引用。 |
| Proxy | 主要請求使用所選的代理路徑。 | 縮小規則因素的影響範圍。 |
| Direct | 主要請求直接連線。 | 與目前的基礎網路路徑比對。 |
若 Proxy 可以存取、Config 不行，表示至少有一條代理路徑可用，應優先檢查 Config 的規則順序、策略名稱與最終回退。若 Direct 正常而 Proxy 失敗，先檢查所選伺服器與遠端連線，不要立即修改 DNS。三種狀態只是排查工具，無法涵蓋所有特殊設定；本機網路位址、DNS 請求與系統流量仍可能受其他設定影響，測試結束後請恢復日常所需狀態。
確認規則是否套用至正確策略
前往 Config，確認目前啟用的是預期檔案，而非只有將檔案下載至清單。規則通常依序尋找符合條件的項目，較前面的寬泛規則可能使後面的精確規則無法生效。以下片段僅用於說明順序，並非適用所有網路的完整設定。PROXY 必須指向目前設定中可用的策略；若檔案使用自訂策略名稱，請確認名稱存在且拼寫一致。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY若只有特定網域受影響，請查看該請求實際符合哪條規則，以及最後選用了什麼策略。符合 REJECT 的請求會依設定遭到拒絕，不能據此判定伺服器故障。修改時優先新增範圍明確的測試規則，不要直接刪除所有規則；驗證後再決定是否調整原有規則。如需了解比對順序，請參閱代理模式中的規則說明，避免長期保留暫時性的測試設定。
以可重現的比對測試收尾
若 Proxy 與 Config 都失敗，請改用自己已有且確認參數有效的伺服器，再換另一種基礎網路交叉測試。若只在一種網路失敗，檢查該網路的認證、UDP 可達性或本機限制；同一伺服器在不同網路都失敗，請前往節點逾時章節。若只有網域無法存取，請前往 DNS 章節。每次得出結論後，先還原無關設定；不要將多次測試留下的暫時開關疊加，形成新的故障來源。
03 · 遠端連線層
節點逾時與交握失敗
區分傳輸無法連線、驗證失敗與目標存取失敗，不要把所有錯誤都歸類為逾時。
先核對端點，再判讀測試結果
向服務商取得目前有效的伺服器資訊，核對位址、連接埠、協定與驗證欄位。訂閱中顯示的名稱只是辨識標籤，不代表伺服器位址，也無法證明節點仍有效。手動輸入時請檢查前後空格、全形符號與複製遺漏，尤其不要連同網頁說明文字一起貼上。若使用訂閱節點，先確認訂閱更新時間與目前節點屬於同一群組，避免修改未選取的項目。
Connectivity Test 的結果取決於測試方式與目標。單次測試失敗，可能是遠端連線失敗，也可能是測試目標無法存取；測試成功也只代表該次測試完成，不能取代持續下載或所有 App 的驗證。先在設定中確認目前使用哪種測試方式，再以實際網頁存取結果複核。不要直接比較不同測試方式產生的數值，也不要只憑一次結果判斷整條線路的長期品質。
依協定檢查必要欄位
Shadowsocks 請核對加密方式與密碼是否和伺服器端一致；VMess、VLESS 請核對相應的身分欄位與傳輸設定；Trojan 請核對密碼及 TLS 相關資訊。Hysteria2 使用 UDP 傳輸，若目前網路無法穩定傳送 UDP，即使 TCP 網頁正常也不代表它能運作。WireGuard 則須檢查金鑰、位址與允許的路由範圍。不能只改協定名稱，其他欄位也必須與伺服器端設定相符。
| 錯誤狀況 | 優先檢查 | 不宜直接推論 |
|---|---|---|
| 連線逾時 | 位址、連接埠、網路路徑與伺服器上線狀態。 | 不能直接判定密碼錯誤。 |
| 驗證失敗 | 身分欄位、密碼與訂閱有效狀態。 | 修改 DNS 無法修復驗證問題。 |
| TLS 交握錯誤 | 系統時間、SNI、憑證名稱與傳輸設定。 | 不應直接關閉憑證驗證。 |
不要用略過驗證來掩蓋 TLS 錯誤
伺服器位址、TLS 使用的名稱與傳輸層 Host 不一定相同，必須依伺服器端提供的資訊填寫，不要依顯示名稱猜測。若系統日期與時間明顯錯誤，憑證有效期判斷也可能失敗，請先開啟系統自動設定時間並確認時區。憑證名稱不符時，應核對 SNI 與伺服器憑證，不要把略過驗證當成一般解法；這會改變連線的信任界線，卻未必能修正真正的設定錯誤。
若同一台伺服器在 Wi-Fi 下逾時、行動網路正常，請保留相同的 SERVER 與 Config，只切換網路再測一次，確認是否能穩定重現。若該協定依賴 UDP，可與自己已有的其他傳輸方式比較，但不要隨意修改連接埠或切換至未經伺服器設定的協定。用戶端與伺服器必須相互對應，單方面調整無法憑空產生伺服器未開放的功能。
整理可供服務商處理的資訊
若切換網路後仍失敗，請向服務商提供協定、故障時段、錯誤類型與已完成的比對結果，請對方確認伺服器狀態與帳號權限。不要公開完整訂閱連結、密碼、私鑰或身分欄位。若需說明節點，可先提供顯示名稱或已遮蔽部分資訊的位址；只有在確認必要且管道可信時，才提交完整資料。本網站提供用戶端操作說明，不能取代伺服器端檢查，也不會依逾時狀況推薦其他服務。
修復後以相同目標重複存取，確認不只是測試按鈕恢復正常。若交握成功但網頁仍很慢，請前往速度章節；若遠端網域無法解析，請先閱讀 DNS 章節。保留最後有效的參數來源與修改項目；下次訂閱更新覆蓋手動變更時，才能判斷是伺服器端參數更新，還是本機暫時修正被還原。
04 · 匯入與更新層
訂閱失敗或清單空白
分別處理下載失敗、內容解析失敗與更新後節點無法使用。
確認連結類型與輸入位置
訂閱連結應向服務商取得，必須是供用戶端使用的訂閱網址，而不是帳號登入頁、訂單頁或瀏覽器收藏的管理頁面。依教學中的匯入步驟加入現有訂閱，並核對輸入位置與連結內容。複製時留意換行、空格與內容截斷；含特殊字元的網址不要手動刪除參數。QR Code 也可能只包含單一伺服器而非訂閱，匯入後請依實際內容判斷，不要只憑外觀分類。
訂閱網址通常包含存取憑證，應妥善保管。不要貼到公開留言、截圖或不明的線上轉換頁面，也不要在故障描述中附上完整連結。若需展示格式，只保留網域與路徑樣式，隱藏查詢參數中的敏感資訊。若連結已公開，請聯絡服務商重設相關憑證；只從本機刪除紀錄，無法撤銷已外洩的存取權限。
先區分下載錯誤與解析錯誤
更新時若直接顯示連線失敗、網域解析失敗或逾時，代表用戶端尚未取得預期內容，請先檢查基礎網路、DNS 與訂閱伺服器的可達性。若已收到回應卻無法匯入，請檢查回傳內容是否為用戶端支援的訂閱格式。帳號到期通知、網頁驗證頁面與拒絕存取頁面都可能以文字形式回傳，但它們不是節點清單，反覆重新整理也不會變成有效設定。
HTTP 狀態也須搭配回應內容判讀：權限相關錯誤通常需要核對連結或帳號狀態；請求過多時應停止連續重新整理，稍後再試；伺服器錯誤則須等候伺服器端恢復。不要把所有錯誤都統稱為「格式不相容」。若服務商提供不同用戶端的訂閱選項，請選擇明確適用於 Shadowrocket 的內容；不要只因名稱相近就使用其他設定格式，也不要隨意改寫網址參數。
保留舊清單，再更新一次
更新前先記下舊清單是否仍可使用，必要時備份手動伺服器設定。無法取得新內容，不一定代表已儲存的節點也同時失效；反過來，更新成功也不代表每個節點都能連線。先手動更新一次，觀察節點數量、群組與名稱是否如預期變化，再選一個項目驗證連線。不要連續點擊測試，這可能觸發伺服器的頻率限制，讓原本容易判斷的問題變得複雜。
更新後清單空白，請檢查帳號是否有效、伺服器是否回傳空內容，以及是否有篩選條件隱藏項目。若只有部分項目消失，可能是伺服器調整了內容，也可能是匯入解析失敗；請將回應類型與錯誤提示提供給服務商確認。不要先刪除整個訂閱群組，以免同時失去舊清單與比對資訊。手動修改的節點也可能在下次更新時被覆蓋，請先確認它是訂閱項目還是本機項目。
恢復自動更新前，先驗證連線路徑
若服務商的訂閱入口只能透過特定網路路徑存取，請先使用現有可用連線完成一次更新，並記下當時的 Global Routing。沒有可用節點時，不要強迫唯一的訂閱更新路徑也經過失效的代理。不同設定可能影響訂閱請求的路徑，請依實際記錄與結果判斷，不要假設所有訂閱請求一定直連或一定經過代理。
手動更新穩定後，再檢查開啟時自動更新的設定與觸發時機。自動更新失敗時，請保留手動成功與自動失敗時的環境差異，例如網路尚未就緒、認證頁面未完成或 App 剛切回前景。詳細操作請參閱Shadowrocket 訂閱更新方法。最後確認清單已取得、內容已解析，且節點實際可連線。
05 · 效能與傳輸層
速度慢與間歇性卡頓
分別測量等待時間、傳輸速度與穩定性，不要用單一延遲數值解釋所有使用感受。
先把「速度慢」描述成可重複測試的現象
網頁等很久才開始顯示、載入後下載緩慢、影片反覆緩衝，以及網路偶爾完全停頓，是不同問題。等待第一個回應可能與解析、交握和目標伺服器有關；持續傳輸速度則也受線路頻寬、封包遺失與裝置狀態影響。記下固定目標、固定操作與大致觀察時段，再進行比對。不要把不同網站、不同檔案大小或不同時段的結果放在一起，據此判斷節點突然變快或變慢。
先暫停系統更新、雲端同步與其他大量傳輸工作，確認裝置沒有明顯過熱，再測試相同目標。速度測試本身也會占用頻寬，不要同時執行多項測試。若問題只出現在特定 App，請檢查該 App 的內容伺服器、快取與背景下載；其他 App 正常時，瓶頸未必在用戶端。測試記錄也應寫明 Global Routing 與 SERVER，避免把直連目標誤當成代理效能證據。
依序比對本機網路、遠端線路與協定
使用相同伺服器與設定，分別在 Wi-Fi 和行動網路測試。只有 Wi-Fi 速度慢時，請靠近無線基地台，檢查路由器負載與目前頻段的干擾，並與同一網路上的一般連線比較。只有行動網路慢時，觀察訊號變化、流量限速與移動狀態。若中斷用戶端後同樣緩慢，應先處理基礎網路；代理無法補回本機連線已損失的容量，也無法讓壅塞的網路恢復穩定。
基礎網路穩定後，使用自己已有的其他伺服器進行比對。若只有一個端點速度慢，可能與該伺服器負載、出口路徑或通往目標的連線有關；若所有端點都只有特定網站速度慢，也應將目標服務本身納入排查。節點名稱中的地區標籤不等於實際路由，地理位置較近也不一定較快。先保留測得的差異，再向服務商詢問線路狀態，不要依名稱判斷品質。
了解延遲、封包遺失與傳輸量的差異
低延遲有助於互動操作，但不代表下載速度一定快。封包遺失會觸發重傳，網路抖動則會讓即時通訊與影片緩衝更明顯；短時間測試不一定能涵蓋這些問題。以穩定的日常工作重複驗證，比只看清單中的單一數值可靠。不要在持續下載期間反覆切換伺服器，既有連線可能尚未結束，新舊請求混在一起後很難判斷各自使用哪條路徑。
Hysteria2 使用與 QUIC 相關的傳輸機制，在某些網路條件下的表現會與 TCP 路徑不同，但前提是目前網路能穩定傳送 UDP。不能只因協定名稱就保證速度，也不要把所有速度問題都歸因於加密。調整傳輸參數時，請以伺服器端要求與用戶端支援項目為準，先保存原值，再逐項驗證。協定基礎可參閱Hysteria2 協定說明，不要複製不適用於目前伺服器的參數。
只調整已確認問題所在層級的參數
MTU 不合適可能造成小型請求成功、大量傳輸停頓，但不是所有卡頓的通用解釋。只有在問題可以穩定重現，且已排除其他層級後，才依伺服器或網路環境要求小幅調整，並記錄原值。任意大幅調低 MTU 會增加額外負擔；同時修改 DNS、MTU 與協定，則無法判斷是哪項調整帶來改善。對行動網路的偶發抖動，保留不同時段的測試結果，比只調整一次更有參考價值。
最後以實際使用情境驗收：同一頁面是否能穩定開啟、同一段內容是否持續傳輸，以及切換網路後能否恢復。暫時變快不代表根本原因已解決，至少要重測原本失敗的情境。完整的分層記錄方式請參閱小火箭速度慢的逐層排查。若等待時間主要集中在網域解析階段，請接著閱讀下一章，不必先更換所有伺服器。
06 · 名稱解析層
DNS 失敗與網域異常
分別檢查目標網域、伺服器網域與加密 DNS 端點的解析路徑。
先確認是哪個網域解析失敗
DNS 會將網域名稱轉換為連線所需的位址。需要解析的可能是要造訪的網站、代理伺服器本身，或 DNS over HTTPS 使用的端點網域。若伺服器網域解析失敗，代理尚未建立；若目標網域解析失敗，代理連線可能已經建立。先從錯誤記錄分辨是哪個對象，再判斷要檢查基礎網路 DNS、目前 Config 的 DNS 設定，還是遠端解析路徑。
「網域無法開啟、IP 位址可以開啟」只能作為線索，不能單獨證明是 DNS 故障。HTTPS 網站通常還需要正確的網域與憑證名稱，直接輸入位址可能顯示不同頁面或憑證錯誤。較可靠的做法是查看該請求的解析錯誤、解析耗時與回應狀態，並與同一網域在正常網路下的結果比較。不要為了測試而關閉憑證驗證，也不要將暫時取得的 IP 長期寫入所有存取規則。
系統 DNS、自訂 DNS 與 DoH 的適用範圍
系統 DNS 通常會依目前網路設定運作，方便配合區域網路與認證環境，但解析結果可能隨 Wi-Fi 切換而改變。自訂 DNS 會將解析交給指定服務，必須確認目前網路確實能連線至該服務。DNS over HTTPS 透過 HTTPS 傳送解析請求，但仍需要可連線至端點的網路路徑；啟用 DoH 不代表遠端代理已可用，也不保證所有區域網路內部名稱都能解析。
若 DoH 端點的網域又依賴尚未建立的代理才能解析，可能形成循環依賴：建立代理需要解析伺服器，解析卻又被要求透過代理完成。排查時先恢復可完成初始解析的路徑，再逐項驗證加密 DNS。不要任意將伺服器位址改成網路上找到的 IP；端點位址、憑證名稱與 SNI 的關係必須符合伺服器端要求，否則可能從解析錯誤變成交握錯誤。
檢查規則與解析之間的關係
DOMAIN、DOMAIN-SUFFIX 依據請求對應的網域資訊判斷；IP-CIDR、IP-CIDR6 與 GEOIP 則依位址相關條件判斷。需要位址的比對可能涉及解析，因此調整規則順序也可能改變結果。以下僅列出規則範例，位址範圍只供文件說明，不代表實際服務；請搭配目前 Config 的策略定義與實際命中記錄理解，不要將片段直接當成完整 DNS 設定。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
IP-CIDR6,2001:db8::/32,DIRECT,no-resolve
FINAL,PROXYno-resolve 用於相關 IP 規則時，表示不會為符合該規則的項目主動進行網域解析，不是關閉所有 DNS。若要依網域明確分流，可優先使用範圍清楚的網域規則，再確認是否仍需要位址規則。不要為了避開單次解析失敗，就把所有網域交給寬泛的關鍵字規則；這容易造成誤比對，使其他正常請求也被導向不合適的路徑。
留意快取、IPv6 與區域網路名稱
修改 DNS 後，App、系統或用戶端可能仍保留舊的解析結果與既有連線。先中斷相關連線並重新發出請求，再查看新記錄，不要只重新整理已建立連線的頁面。若網域同時回傳 IPv4 與 IPv6，其中一條路徑無法連線也可能造成間歇性失敗。請確認失敗請求實際使用的位址類型，再決定是否針對目前網路調整；不要把停用 IPv6 當成所有裝置的固定最佳化方式。
印表機、路由器管理頁與公司內部網域可能依賴本機解析方式。公共 DNS 不保證能解析這些名稱；區域網路存取異常時，請檢查本機網段與解析路徑是否受到代理設定影響。每次只還原一項 DNS 設定，確認一般網域與內部名稱都符合需求後再結束測試。更詳細的取捨請參閱Shadowrocket DNS 設定說明，將 DNS 選擇與故障處理分開進行。
07 · 背景與資源層
耗電異常與背景活動
在相近使用條件下比較實際活動，先找出持續重連與大量傳輸。
先了解系統電池用量統計
系統電池頁面顯示的是所選時段內的用量占比，不代表軟體的固定耗電量。其他 App 使用較少時，背景網路元件的占比可能上升，即使實際耗電沒有明顯增加。比較時盡量維持相近的螢幕使用時間、訊號、充電狀態與傳輸工作，並記錄裝置是否發熱。不要只憑單次百分比認定耗電由更新造成，也不要在剛完成系統轉移或照片同步時下結論。
代理執行時會處理其他 App 的網路流量，系統歸因這些活動的方式可能與使用者直覺不同。先查看是否有雲端備份、影片播放、App 更新或個人熱點分享持續傳輸，再查看用戶端的 Data 與連線記錄。用戶端記錄與系統統計可能採用不同時段，不能直接將兩者總量相減來判斷流量異常。需要比較時，請從明確的起始時間開始觀察，並使用一致的觀察時段。
排除持續失敗與自動重連
遠端無法連線時，反覆交握、解析與重新連線會消耗額外資源。若記錄中同一錯誤密集重複，請先修復伺服器、DNS 或驗證問題，不要尋找「省電協定」來掩蓋故障。訊號微弱也可能增加無線通訊耗能，可在訊號穩定的 Wi-Fi 環境下使用相同設定進行比較。若只有一台伺服器持續重連，請保留錯誤資訊，再用自己已有且有效的伺服器驗證。
檢查 On Demand 的觸發條件是否與目前網路反覆衝突。例如網路在多個基地台間切換，或認證狀態不斷變動，可能使連線頻繁建立與中斷。測試時先記下原有條件，暫停自動連線，手動連線一段時間觀察；再逐項恢復條件，找出造成重複動作的項目。尚未確認自動行為前，不要頻繁強制結束 App；這無法說明根本原因，也可能使下次觸發時重新執行完整連線流程。
將診斷功能與日常設定分開
排錯時啟用的詳細記錄、大範圍連線記錄或高頻測試，在沒有需求時不應長期保留。這些功能可能增加處理與儲存負擔，尤其在請求量很大時。排查完成後，請恢復適合日常使用的記錄層級，關閉暫時新增的週期性測試，並保留必要且已遮蔽敏感資訊的結果。不要只靠大量關閉功能就宣稱耗電問題已解決；請記下停用了哪些功能，以及前後是否能穩定重現差異。
頻繁更新訂閱也可能增加網路請求，是否需要調整應依實際觸發頻率判斷。先確認是否每次開啟都更新，以及失敗後是否反覆重試，再依需求減少無效操作。遠端 Config 定時更新與訂閱更新是不同流程，須分開檢查。若設定包含自己不了解的腳本或額外處理，請先備份並以簡單設定進行比對，再決定是否保留，避免讓未知處理長期在背景執行。
建立可比較的觀察時段
在相近的網路與日常工作下，分別觀察目前設定與精簡設定。保持螢幕亮度、熱點狀態與下載工作一致，避免一邊看影片、一邊比較閒置耗電。先進行較短的比對，確認沒有持續錯誤後，再延長至有代表性的日常使用時段。若裝置明顯發熱或電量下降同時伴隨基礎網路異常，也應檢查系統其他背景工作，不要只觀察 Shadowrocket。
恢復設定後，檢查網路切換、鎖定螢幕後喚醒，以及 On Demand 是否符合需求。只在前景測試穩定，不代表背景狀態也正常。若要回報問題，請提供電池統計的時間範圍、當時使用的網路、是否持續傳輸與重複錯誤類型，並隱藏訂閱及伺服器憑證。停用用戶端後裝置若仍異常發熱或耗電，請繼續檢查系統與硬體狀態，避免長期將獨立問題歸因於代理連線。
08 · 變更與復原層
更新後異常與設定復原
先列出同時發生的變更，再分別驗證 App、系統、訂閱與 Config。
時間接近不代表存在因果關係
App 更新後首次連線失敗，可能同時遇到系統升級、訂閱到期、伺服器參數變更或遠端 Config 更新。先列出最近變更的項目，並記下更新前最後一次正常使用時的環境。不要只因為「剛更新」就刪除設定；同一時段的伺服器端變更也可能造成相同現象。使用目前設定在另一個網路重新測試，再以簡單設定驗證，通常更容易區分 App 啟動問題與遠端連線問題。
先確認目前啟用的 Config 與 SERVER 是否符合預期，檢查 Global Routing 是否變更，以及 On Demand 是否重新觸發。若 App 可以正常開啟但無法存取，請沿用前面的請求路徑檢查；若 App 無法開啟、系統網路延伸功能報錯或持續閃退，請先保存可取得的診斷資訊，再從系統層著手復原。尚未記錄錯誤前不要連續重新安裝，否則有價值的現場資訊與手動參數可能一併遺失。
備份內容不只有訂閱網址
訂閱可以重新取得伺服器項目，但不一定包含本機手動節點、策略選擇、規則修改與其他個人設定。備份前先確認涵蓋範圍，優先保存自己有權持有的原始資料與 Config 副本。備份檔也可能包含密碼、身分欄位或訂閱憑證，請存放在受保護的位置，不要上傳至公開空間。只截取節點名稱清單，通常不足以完整還原參數。
復原時先匯入最基本的一台伺服器或一份訂閱，驗證連線後再還原 Config 與其他設定。一次還原整份備份，可能連同造成故障的舊設定一起帶回。若恢復某項設定後故障立即出現，請保留該項目前後的差異並繼續檢查；不要繼續匯入其他內容，以免模糊問題範圍。無法判斷的遠端設定變更，應向提供該設定的一方確認，不要直接刪除不了解的欄位。
依平台進行受控更新
iPhone / iPad 請前往指定的App Store 產品頁確認 App；開發者為 Shadow Launch Technology Limited，App ID 為 932747118，系統需求以 App Store 頁面標示為準。Mac、Windows、Android 與 Linux 版 Shadowrocket 安裝檔請從本站全平台下載頁取得，實際安裝檔位於本站 /dl/shadowrocket/ 路徑；不要透過不明提示跳轉更新。
安裝遭系統阻擋時，先確認檔案確實來自本站，且適用於裝置架構。Mac 請依「關於本機」選擇 Apple 晶片或 Intel；若出現無法驗證開發者的提示，請在系統「隱私權與安全性」中確認「仍要打開」。Windows 的 SmartScreen 可在確認來源後，選擇「更多資訊」與「仍要執行」。Android 請依系統提示，允許目前安裝來源安裝未知 App；安裝完成後可撤銷權限。受機構管理的裝置仍須遵守管理員政策。
Linux 請選擇與系統相符的 deb、rpm 或 AppImage；AppImage 執行前需要授予執行權限。Mac 若提示 App 已損毀，確認來源並將 App 移至 Applications 後，可依下載頁說明使用下方指令移除隔離屬性。此操作只適用於指定 App，不要套用至整個資料夾。各平台的完整限制與操作請參閱安裝放行說明，無須為了更新而關閉整個系統的安全機制。
xattr -cr /Applications/Shadowrocket.app復原後重新驗證原本失敗的情境
完成更新或復原後，不只確認 App 能否開啟，也要驗證連線、訂閱更新、規則命中與網路切換。iPhone / iPad 版在 App Store 一次性付費 $2.99；Mac、Windows、Android、Linux 版免費。用戶端取得費用與既有線路服務分開計算，還原 App 不代表服務商帳號權限也已恢復。若使用最精簡設定仍能穩定重現異常，請保留系統環境、錯誤原文與操作順序，再透過 App 內提供的支援管道提交已遮蔽敏感資訊的資料。
09 · 平板與網路切換
iPad 專項與交叉驗證
平板上的購買記錄、設定資料與網路環境，須分別確認。
已取得 App 不代表設定會自動出現
iPhone 與 iPad 使用同一筆購買記錄時，請在正確的 App Store 帳號中查看已購項目；但購買記錄與設定資料是兩回事。另一台裝置已有訂閱，不代表目前的 iPad 自動取得相同的伺服器與 Config。首次在平板使用時，請依快速入門教學重新確認匯入、Global Routing 與連線授權，不要將清單空白誤認為 App 失效或購買未完成。
iPhone / iPad 版在 App Store 一次性付費 $2.99；Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。用戶端買斷費用不等於線路方案費用；服務商對帳號、裝置數量或同時連線的限制，請向服務商確認。若手機正常而平板失敗，先檢查是否允許同時連線，不要重複購買用戶端，也不要把帳號權限問題當成 iPad 專屬的網路故障。
將「同一個網路」確認到實際連線方式
手機可能使用行動網路，而 iPad 連接 Wi-Fi，看似同時上網，實際出口卻不同。交叉測試時，請確認兩台裝置的連線方式、所選 SERVER 與 Config，並盡量使用相同的測試目標。只有這些條件接近，測試結果的差異才有參考價值。若 iPad 使用手機熱點，流量還會經過熱點分享與手機的網路連線，不能直接等同於手機 App 的連線路徑。
在校園、飯店或辦公室 Wi-Fi 上，iPad 可能需要個別完成認證。先中斷代理，開啟一般網頁確認認證狀態，再建立連線。若只能存取區域網路、無法連上外部目標，請檢查是否尚未登入；若外部目標正常，但印表機或共享裝置無法使用，請檢查區域網路路由與本機名稱解析。不要為了解決印表機存取問題，就永久將所有請求改為 Direct；請保留範圍明確的本機規則。
鎖定螢幕、分割畫面與前後景切換
鎖定螢幕後暫時沒有新流量，不一定代表通道中斷。重新喚醒螢幕時，先查看系統 VPN 狀態，再發出新請求，區分連線是否維持、自動重新連線或 App 本身恢復較慢。分割畫面或台前調度會改變前景 App 的排列方式，不能只因 Shadowrocket 不在目前視窗就認定代理已停止。若確實只有喚醒後才失敗，請記下當時是否切換 Wi-Fi、是否觸發 On Demand，以及需要哪些步驟才能恢復。
僅支援行動網路的型號，還須確認系統中該 App 的行動數據使用權限，以及目前的數據方案是否可用；僅支援 Wi-Fi 的型號則應集中檢查無線網路與熱點路徑。系統版本、裝置管理政策與省電設定也可能造成兩台裝置表現不同。不要直接照搬另一台裝置的所有系統設定，先找出與症狀相關的差異，再逐項修改。系統需求以 App Store 頁面標示為準，不要依螢幕尺寸推測支援情況。
透過交叉比對表整理可執行的結論
| 比對結果 | 優先檢查方向 | 下一步 |
|---|---|---|
| 只有 iPad 失敗 | 本機授權、Config、時間與裝置限制。 | 以最精簡設定重新驗證。 |
| 兩台裝置只有在同一個 Wi-Fi 下失敗 | 認證、路由器與目前網路路徑。 | 更換連線網路，保持伺服器不變。 |
| 同一台伺服器在不同裝置、不同網路都失敗 | 伺服器端狀態與參數是否有效。 | 向服務商確認。 |
轉移設定後若只有部分 App 無法連線，請檢查是否遺漏自訂策略、手動規則或 DNS 設定。QR Code 與單一節點分享通常不代表完整 Config，成功匯入也不代表規則已同步。先逐項確認兩台裝置實際啟用的內容，再比較結果；遮蔽憑證的截圖只能協助辨識介面，不能取代設定差異檢查。涉及敏感資料時，不要為了方便比對而公開完整匯出檔。
結束排查前，恢復暫時關閉的自動連線條件，刪除明確不再需要的測試規則，並保留一份已驗證的設定與簡短記錄。記錄應寫明失敗條件、有效處理方式與尚未解決的範圍，而不是只寫「重新啟動後好了」。若要繼續查閱，連線問題請回到本頁前兩章，訂閱問題請回到訂閱章節；常見操作問題可參閱新手常見問題。下次遇到相同症狀時，就能根據現有資訊繼續排查，不必重新嘗試所有開關。