Shadowrocket 疑難排解指南

01 / CONNECTION

開關無法開啟：先檢查系統授權

如果點選 Home 的連線開關後立即恢復關閉、系統授權提示反覆出現，或始終看不到預期的連線狀態，請先依本節排查。此時先不要更換伺服器：開關能否建立連線，與遠端伺服器能否回應是兩回事。先確認裝置可透過目前的 Wi-Fi 或行動網路瀏覽一般網頁，再關閉 Shadowrocket 開關，從最基本的系統授權開始檢查。如果裝置已無法連上任何網路，應先處理裝置網路，不要在 App 內反覆切換策略。

確認首次授權與系統狀態

首次啟用時，系統可能會要求允許加入 VPN 設定。依照系統提示確認後，返回 Home 再試一次。如果先前曾取消提示，請檢查裝置系統設定中與 VPN 相關的設定狀態，再回到 App 重新觸發授權；系統設定的選單位置可能因裝置介面而異，不必拘泥於固定路徑。看到系統層級的連線標示，只代表設定已啟用，不表示伺服器已可使用；下一步仍須實際開啟網頁確認。

如果點選開關後完全沒有系統反應，請先結束 App 並重新開啟，再檢查系統是否有待處理的授權提示。重新啟動裝置後再試，有助於分辨暫時性的系統狀態與持續存在的設定問題。每次測試前，記下開關是「無法維持開啟」，還是「已開啟但網頁無法載入」；後者應前往下一章檢查路由與伺服器，不必反覆撤銷已完成的授權。

排除連線設定的影響

確認系統授權後，在 Home 檢查目前選取的是否為使用者已有且資訊完整的伺服器或訂閱項目。若誤選空白項目、已刪除的參照或過期設定，介面可能仍允許操作開關，卻無法建立可用連線。若近期匯入過多個設定，請暫時只保留這次要測試的項目，記下原有設定名稱後再調整；不要一邊修改 Global Routing、一邊重新匯入訂閱，否則無法判斷是哪項變更生效。

也請檢查 On Demand 是否設有適用於目前網路的觸發條件。例如規則要求在特定 Wi-Fi 環境中斷線，而裝置目前剛好連到該網路，手動操作可能會與自動條件互相覆蓋。可先暫停 On Demand 自動觸發，再手動開啟並觀察狀態；測試完成後依照記錄還原。如果裝置由公司或學校統一管理，系統對 VPN 設定的限制也可能影響操作；請向裝置管理單位確認允許範圍，不要反覆加入相同設定。

02 / ROUTING

連線後無法上網：分別檢查網路、伺服器與規則

如果開關能維持開啟，但瀏覽器或其他 App 無法載入內容，請先分別檢查「裝置與目前網路的連線」、「裝置與所選伺服器的連線」，以及「請求如何依規則處理」。關閉連線後，使用相同網路開啟平時可瀏覽的頁面：若仍無法載入，請先檢查 Wi-Fi 或行動網路本身。若關閉連線後正常、開啟後失敗，再到 App 檢查伺服器與 Global Routing。測試時請使用相同頁面，避免因網站本身狀態不同而得到錯誤結論。

透過 Global Routing 縮小範圍

Global Routing 中的 Config、Proxy、Direct 代表不同的路由方式。Config 依照設定中的規則決定如何處理；Proxy 讓請求優先經過所選代理；Direct 則直接連線。先記下原本的選項，再短暫切換進行比較，測試後還原。Direct 可連線但 Proxy 不行，請優先檢查所選伺服器及其參數；Proxy 可連線但 Config 不行，請優先檢查規則順序、策略名稱和 FINAL；三種方式都失敗，則應先檢查裝置網路、系統連線狀態及測試目標。比較結果僅用於找出原因，不代表應長期維持測試設定。

確認所選項目與問題範圍

返回 Home，確認選取的伺服器是否來自預期的訂閱或手動設定。訂閱更新後，舊項目的名稱、排序或可用狀態可能改變；清單中有許多項目，不代表目前選取的項目仍可連線。改選另一個使用者已有且先前正常的伺服器，重做相同測試：只有一個項目失敗時，請檢查該項目的位址、連接埠和伺服器端狀態；所有項目都失敗時，再檢查共用的網路、設定檔與 DNS。不要只憑單一延遲數值判斷所有網頁都能順利載入。

如果只有一個網站無法開啟，請分別記錄網域、發生時間及 Global Routing 下的測試結果。Config 與 Proxy 的結果不同，通常值得檢查對應的 DOMAIN、DOMAIN-SUFFIX 或 FINAL；瀏覽器正常但特定 App 失敗，則應確認該 App 發出的請求是否使用預期的網域。若無法確定目標網域，先使用 App 內可用的診斷資訊定位，再修改一條規則重新測試。首次連線的完整流程請參閱使用說明；常見問題的簡答請見問答。

03 / SERVER

伺服器逾時：分辨測試失敗與實際無法使用

如果伺服器清單顯示逾時、Connectivity Test 未得到預期結果，或選取伺服器後頁面長時間沒有回應，請依本節排查。測試結果只反映特定時間與網路下的一次檢測，不等同於所有 App 的實際連線狀況。先確認目前網路本身可用，再於同一網路、同一位置重測一次；若測試目標與日常使用的目標不同，結果也可能不同。不要只因一次逾時就刪除整組訂閱。

先檢查輸入資訊

手動新增伺服器時，請逐項核對協定類型、伺服器位址、連接埠及所需的驗證資訊。位址多一個空格、連接埠位數輸入錯誤，或協定與伺服器端設定不一致，都可能造成逾時。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等協定所需參數各不相同；請依照使用者自己持有的伺服器資訊逐欄核對，不要把一種連線的參數套用到另一種協定。使用 Scan QR Code 匯入時，也要檢查匯入後的項目是否與原始資訊相符；成功掃描只表示內容已被辨識。

如果項目來自已有訂閱，請先確認上次更新是否成功，再確認目前選取的是更新後仍有效的項目。訂閱更新可能變更伺服器位址或項目順序，清單中也可能保留舊的手動副本。為避免混淆，可記錄名稱、群組和來源，並只測試一個明確的項目。若涉及密碼或權杖，請勿將完整資訊貼到公開討論區；排查時只需確認欄位是否一致，不必公開欄位的實際內容。

透過交叉測試找出共同原因

保持伺服器不變，分別在 Wi-Fi 與行動網路下測試一次；再保持網路不變，測試另一個使用者已有的伺服器。如果只有一個伺服器在兩種網路下都逾時，請優先檢查該項設定及伺服器端狀態。如果同一批伺服器只在某一種網路下失敗，先檢查該網路的連線條件、驗證頁面與 DNS。如果所有伺服器在不同網路下都失敗，再檢查系統連線狀態、訂閱內容及共用設定。交叉測試時每次只改變一個條件，才能得到可供確認的結論。

延遲測試有助於找出明顯沒有回應的項目，但數值低不一定代表網頁載入速度快。建立連線後，還有網域解析、規則比對及目標網站回應等步驟。若測試有結果但網頁持續無法開啟，請前往路由排查與DNS 排查；若長時間逾時且輸入資訊無誤，使用者應向自己持有資訊的提供者確認伺服器端狀態。選擇伺服器時如何解讀測試結果，也可參閱延遲、地區與協定類型。

04 / SUBSCRIBE

訂閱匯入與更新失敗：依序檢查連結、網路與內容

本章僅討論使用者已持有的訂閱連結。匯入失敗、更新時顯示失敗，以及更新後清單沒有變化，是三種需要分開判斷的狀況。先確認操作對象是 Subscribe 類型的訂閱，而非單一伺服器資訊或設定檔；這些項目在 App 中用途不同。複製連結時，請檢查首尾空格、遺漏字元及意外換行，尤其是從訊息分段複製的位址。連結中的驗證資訊屬於使用者的敏感資料，不應放在公開截圖或求助內容中。

確認連結目前是否仍能取得內容

匯入前先確認裝置網路可用；若網路本身未連通，自然無法取得訂閱。如果先前可更新、現在卻失敗，請檢查使用者持有的原始連結是否遭到替換、驗證資訊是否變更，再向資訊提供者確認連結是否有效。不要不斷新增同名 Subscribe 項目來「重試」；這會留下多個來源相似的群組，之後難以確認選取的是哪一份。保留原有項目、記下錯誤提示後，再手動更新一次，較容易比較結果。

連結可開啟，不代表內容一定能正確解析。如果更新有回應，但清單為空或項目內容明顯異常，可能是回傳格式與匯入方式不相符，也可能收到的是錯誤提示而非伺服器資料。請確認複製的是訂閱入口，而不是介紹頁或登入頁的位址；也不要把一般網站頁面的位址直接填入 Subscribe。如果使用 Import from Cloud JSON 或匯入設定，請依內容類型選擇相應入口，不要一律當作訂閱連結處理。

處理更新前後清單不一致

手動更新後，請查看項目是否加入預期群組，再確認實際選取的伺服器。更新可能變更名稱與排序；即使清單出現新項目，若仍選取舊的手動項目，連線狀況也不會自動改善。如果曾設定開啟 App 時自動更新，請先手動更新一次測試：若手動更新成功但自動更新不穩定，可留意開啟 App 時網路是否已連通，以及短時間內是否切換過 Wi-Fi 與行動網路。自動更新只安排取得內容的時間，不會修復無效連結或無法解析的資料。

若有多個已有訂閱，請先依來源區分群組，暫時只更新其中一個，再比較項目名稱與數量的變化。重複項目可能來自多次匯入，也可能是不同訂閱回傳了相同伺服器；刪除前請先確認來源，避免誤刪仍在使用的設定。相關操作請參閱訂閱更新失敗的排查方法與多個訂閱的整理方式。如果只有一個手動伺服器失效，不必為了排查它而更新所有訂閱。

05 / PERFORMANCE

網頁載入速度緩慢：確認慢在哪個環節

「速度慢」至少包含三種不同狀況：網頁開始載入前等待很久、頁面開啟後持續傳輸緩慢，或只有特定 App／網站速度慢。先記錄是哪種狀況，再確認問題發生於 Wi-Fi、行動網路，還是兩者都有。使用同一台裝置和同一個測試頁面，分別在關閉與開啟連線時測試。如果目前網路本身壅塞，只調整 Shadowrocket 無法改善基礎網路問題。請避免選用內容頻繁變動的頁面測試，否則兩次結果難以比較。

分辨建立連線與載入內容

點選連結後長時間沒有顯示任何內容，可能與 DNS 解析、建立連線或伺服器回應有關；頁面已顯示，但圖片載入緩慢，則較適合檢查持續傳輸與目標網站狀態。使用 Connectivity Test 查看所選項目的基本回應，再以實際瀏覽結果進行測試。測試數值只反映檢測過程，不代表影片、圖片或大型檔案的完整使用體驗。如果只有某個網域速度慢，請記錄它在 Config、Proxy、Direct 下的差異，避免全域切換影響其他原本正常的請求。

比較使用者已有的多個伺服器時，請維持網路和目標頁面不變，每次只更換一個伺服器。地區距離、伺服器負載、協定設定及目標網站回應都可能影響結果；不能只看名稱中的地區字樣或單次延遲測試判定效能。如果所有伺服器在同一個 Wi-Fi 下都變慢，但行動網路較穩定，應優先檢查該 Wi-Fi 的實際傳輸速度、訊號與連線狀態。如果只有一個伺服器持續緩慢，再檢查該伺服器資訊及伺服器端狀態。

檢查規則造成的路由差異

Global Routing 設為 Config 時，請求會依規則決定路由。範圍過廣的 DOMAIN-SUFFIX 規則，可能將原本應使用 Direct 的請求交給 PROXY；反過來，也可能讓原本預期經由所選伺服器的目標改走 Direct。先找出速度慢的網域，查看實際命中的第一條有效規則，再在不影響其他規則的前提下小幅修正。不要直接刪除所有規則後只憑一次速度測試下結論，因為這會改變大量無關請求的處理方式。

如果只有 App 切至背景一段時間後，首次瀏覽速度較慢，請分開觀察重新建立連線所需時間與持續傳輸速度。On Demand 條件、網路從 Wi-Fi 切換至行動網路，以及裝置從休眠狀態恢復，都可能讓第一次請求和後續請求表現不同。連續測試兩次並記錄差異：若只有第一次較慢，應優先檢查連線觸發條件與網路切換；若每次都慢，再比較伺服器和 DNS。更多選擇方式請參閱伺服器延遲與實際體驗。

06 / DNS & RULES

DNS 與規則異常：從網域一路查到最終策略

常見狀況包括特定網域無法開啟、不同網路下結果不同，或 Config 失敗但 Proxy 正常。DNS 負責將網域解析為位址，規則則負責決定如何處理請求；兩者彼此相關，但不是同一項設定。先確認輸入的網域正確，再用先前可穩定開啟的頁面進行比較。如果只有特定網域異常，請記錄完整網域、目前網路、Global Routing 及命中的規則；若所有網域都異常，應先依前面的網路與伺服器章節排除共同問題。

了解由上而下的規則比對

設定規則會依由上而下的順序檢查；命中後便依對應策略處理，後續規則不會再接手這次比對。DOMAIN 用於比對完整網域，DOMAIN-SUFFIX 用於比對網域後綴，DOMAIN-KEYWORD 依關鍵字比對；IP-CIDR、IP-CIDR6 與 GEOIP 則用於比對位址相關條件。FINAL 負責處理先前未命中規則的請求，通常放在規則段最後。也請確認目前設定中存在所引用的策略名稱，不要直接將範例套用到策略群組不相符的設定。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

這段範例僅用來說明語法與順序：example.com 是示例網域，PROXY、DIRECT 是策略詞，不代表符合每位使用者的需求。如果將範圍較廣的 DOMAIN-KEYWORD 放在更精確的 DOMAIN 之前，後者可能永遠不會生效；若將 FINAL 提前，後續規則也無法發揮預期作用。修改前請先保存目前設定，每次只移動或修改一條規則。規則優先順序與最終處理方式的完整範例，請參閱規則比對順序與 FINAL。

分辨解析失敗與路由錯誤

瀏覽器顯示找不到網域時，請先比較關閉與開啟連線後的結果，再比較 Config、Proxy、Direct。如果同一網域在不同模式下結果不同，請檢查 DNS 設定與規則如何共同影響該網域；如果同一網路下其他網域都正常，不宜先重設所有設定。請依目前網路與既有設定需求檢查 DNS 設定：是否有已不適用的自訂位址、不同網路下的表現是否不一致，以及是否為特定網域設定例外。不要把「修改 DNS」當成所有逾時問題的通用解法。

使用 IP-CIDR 或 GEOIP 判斷時，也要留意規則是否能取得相應的位址資訊；只看網域文字，無法推斷最後會命中哪一條位址規則。如果規則看似正確，目標卻採用另一種策略，請檢查是否先命中 DOMAIN 類規則，以及前面是否已有範圍過廣的比對。找出原因後，請還原暫時用於測試的 Global Routing，重新以 Config 測試目標及另一個無關網站，確認修正沒有擴大影響。DNS 術語可繼續查閱概念速查。

07 / POWER

耗電異常：記錄觸發條件與背景活動

如果使用 Shadowrocket 一段時間後，裝置續航表現明顯異於平常，請依本節排查。耗電會受到螢幕亮度、行動網路訊號、背景 App、網路頻繁切換等多種因素影響，不能只因連線圖示持續顯示，就歸因於某一項設定。先在裝置的電池使用資訊中查看同一時段各 App 與活動的占比，並記錄網路類型、是否在移動中及是否長時間維持連線。請選擇使用時間與情境相近的狀況進行比較，不要直接拿高強度觀看影片與待機狀態相比。

檢查反覆連線與自動觸發

如果耗電變化正好發生在頻繁切換 Wi-Fi 與行動網路時，請檢查 On Demand 是否針對 Wi-Fi、Cellular 或 Domain 設定了彼此重疊的條件。反覆連線、中斷與重新連線都會增加網路活動。先記下原有條件，暫停自動觸發一段時間，改為手動連線觀察；如果狀況消失，再逐條恢復條件，找出目前環境中頻繁執行的是哪一條。On Demand 用來設定「何時連線」，不是改善所有續航問題的總開關。

如果連線反覆中斷，同時出現伺服器逾時，應先檢查網路訊號與伺服器資訊。網路品質不佳時，反覆送出請求也會增加活動量；單純切換 Global Routing 未必能解決根本原因。可在穩定的 Wi-Fi 環境中，使用同一個已有伺服器測試，再與移動中的狀況比較。如果問題只出現在特定地點或移動路線，記錄網路切換的時間，比憑印象比較電量百分比更可靠。

檢查使用方式與重新測試結果

查看是否有 App 持續進行背景同步、媒體傳輸或大量資料請求；Shadowrocket 處理這些請求時的活動狀況，與 App 閒置時不同。可先暫停明確的大流量作業，在相近時段重新查看裝置電池資訊。不要為了測試而同時修改 DNS、訂閱和所有規則：即使耗電降低，也無法確定原因。需要比較時，請依照「記錄原有設定、單項調整、相同情境重測、決定是否還原」的順序進行。

如果裝置異常發熱或電量快速下降，即使關閉 Shadowrocket 連線後情況仍持續，問題可能不只與目前代理設定有關，應優先檢查裝置系統及其他正在執行的 App。如果關閉連線後恢復正常，請記下連線條件、網路類型和測試時間，再檢查是否頻繁重新連線、On Demand 條件及持續傳輸。排查目標是找出可重複的觸發條件，不是根據一次待機結果就斷定某個協定或規則一定比較省電。

08 / CHANGES

更新後發生異常：確認變動的是 App、設定還是網路

遇到「更新後無法使用」，請先確認更新了什麼：App Store 中的 Shadowrocket、裝置系統、已有訂閱內容，或自行維護的 Config 檔案，都會影響排查方向。先記下最後一次正常使用的情境，以及異常出現前進行過的操作；不要因為時間接近，就認定某項更新必然是原因。App 取得與更新請以 App Store 為入口；相容性與系統需求請以 App Store 頁面標示為準。如需確認商店中的開發者與 App ID，請參閱正版核驗說明。

比對更新前可確認的狀態

先測試不依賴 Shadowrocket 的裝置網路，再確認 Home 開關能否維持開啟，接著檢查目前選取的伺服器、Global Routing 與固定網頁。如果開關狀態與先前不同，請回到系統授權章節；如果開關正常但所有伺服器都失敗，請回到網路與路由章節。分層判斷比立刻刪除所有設定更穩妥，也能保留原始狀況供後續確認。

如果變動的是訂閱，請留意伺服器名稱、群組、位址或選取項目是否改變，不要只看「更新成功」提示。如果變動的是 Config，請檢查新規則是否排在舊規則之前、FINAL 是否仍位於適當位置，以及設定引用的策略名稱是否存在。若曾儲存原有設定，可先比較具體差異，再只調整與問題目標相關的項目。不要混合貼上不同時間取得的設定；重複規則與失效參照會增加判斷難度。

建立可還原的測試紀錄

調整設定前，先記錄原有選項，包括所選伺服器、Global Routing、On Demand 條件及自訂 DNS。每調整一項，就使用相同網路和相同頁面重新測試；若結果沒有改善，先還原該項，再檢查下一項。這樣即使問題最後是網路變動造成，也不會留下多項未經確認的設定修改。如果問題只出現在特定 App，還要分別測試瀏覽器與該 App，並記錄兩者是否使用相同網域或網路環境。

App Store 可顯示 App 相關資訊，但不要依據他人提供的固定版本數字判斷是否適用；請以自己裝置上的商店頁面與實際介面為準。裝置系統更新後若出現授權提示，請依系統提示操作，再重新測試開關。如果訂閱更新後出現異常，請優先依連結與內容排查。請分別記錄「更新操作」與「問題狀況」，才能準確判斷是哪個環節發生變化。

09 / IPAD

iPad 專項：分辨介面配置與連線狀態

iPad 與 iPhone 適用本手冊相同的基本排查順序，但畫面配置、網路連線方式和使用情境可能不同。不要只根據 iPhone 上某個按鈕的位置，在 iPad 上尋找完全相同的座標；請以 Home、Settings、Global Routing 等介面名稱及目前功能為準。先確認 iPad 可透過目前使用的網路瀏覽一般網頁，再檢查 Shadowrocket 開關、所選伺服器與路由模式。如果問題只發生在 iPad，應優先比較兩台裝置的網路與設定，不要直接認定其中一台的硬體故障。

確認網路類型與系統授權

有些 iPad 主要透過 Wi-Fi 使用，也有裝置會使用行動網路；實際可用的網路類型請以手上的裝置為準。iPad 連線失敗時，先確認 Wi-Fi 是否需要完成登入驗證，或裝置是否剛從其他網路切換過來。網路尚未連通時，Subscribe 更新、Connectivity Test 與網頁瀏覽可能同時失敗。連線授權仍須依照系統提示處理；如果開關無法維持開啟，請依授權排查逐項確認，不要把訂閱更新失敗當成唯一原因。

如果同一個已有伺服器在 iPhone 上可用、在 iPad 上卻無法使用，請確認比較的是相同伺服器資訊，而非只有相同名稱。兩台裝置可能保留了不同時間匯入的訂閱或手動副本；請核對協定、位址、連接埠及目前選取項目的來源。接著在同一個 Wi-Fi 下測試兩台裝置，盡可能排除網路差異。如果 iPad 使用另一個 Wi-Fi，請先明確記錄網路差異，再確認設定是否一致。

檢查大螢幕操作與自動連線條件

iPad 切換橫向或直向畫面，或使用多視窗時，介面元素可能重新排列，但不會改變 Global Routing 中 Config、Proxy、Direct 的意義。修改設定後，請返回 Home 確認選取項目，再瀏覽相同目標頁面重新測試；不要因清單位置改變而誤選另一個伺服器。如果只有裝置喚醒後無法瀏覽，請檢查 On Demand 對目前 Wi-Fi 或 Domain 設定的觸發條件，並比較手動開啟是否正常。手動連線正常但自動連線不如預期時，應優先檢查觸發條件，而非先修改所有伺服器參數。

更換裝置後的已購項目取得與首次開啟步驟，請參閱iPad 取得說明；系統需求與相容性請以 App Store 頁面標示為準。如果另一台裝置與 iPad 的訂閱內容不同，請分別確認各自的匯入與更新結果；不要假設在一台裝置上修改設定會自動套用到另一台。最後以「相同網路、相同伺服器資訊、相同目標頁面」進行比較；確認這些條件後，才能分辨 iPad 專項問題與一般網路或伺服器故障。