Shadowrocket 官方網站 · 官方手冊

Shadowrocket故障排除指南

先確認故障發生在哪一層,再修改相應設定。連線開關、伺服器、訂閱、規則與 DNS 應分別驗證,每次只變更一項條件。

初次設定請先依快速入門教學完成匯入、選擇與連線;本頁供已完成基本操作後查閱。以下內容均以使用者已有自己的訂閱或伺服器資料為前提。用戶端一次買斷 ≠ 線路方案,購買 App 與連線服務是否可用是兩回事。

01 / CONNECTION SWITCH

連線開關無法維持開啟

按下開關後立即跳回關閉、系統授權未完成、連線短暫出現後中斷,是三種不同狀況。先開啟 Shadowrocket,停留在 Home,確認目前選取的是一筆參數完整的伺服器,而非空白的訂閱群組。記錄開關跳回前是否出現提示,以及系統設定中對應 VPN 的連線狀態。此時先不要更換 DNS 或大量修改規則,因為通道尚未建立,後續設定不足以解釋故障。

先確認系統授權與選取項目

首次啟動連線時,系統可能會要求允許加入 VPN 設定,並透過裝置解鎖方式確認。若取消、離開對話框或未完成確認,連線可能無法繼續。返回 App 重新操作,完整閱讀系統提示後再決定是否允許。若裝置已儲存相關設定,請在系統設定中搜尋 VPN,確認目前設定是否存在,以及是否對應本次使用的 App。系統設定的入口可能隨系統版本改變,請以裝置實際顯示為準,不必套用固定的選單層級。

若沒有出現授權提示,先確認 App 沒有停留在尚未儲存的編輯畫面。返回 Home,重新選取現有伺服器,再試著連線一次。只有一筆失敗記錄,不足以判定設定已損壞;也應記下目前網路類型、是否剛從另一個網路切換,以及裝置時間是否設為自動。時間明顯錯誤可能影響後續憑證驗證,但不要透過關閉憑證驗證來規避問題。

排除自動連線與設定衝突

暫時停用 On Demand,再測試手動開關。此功能會依條件觸發連線;若排查期間仍持續生效,手動中斷後可能又自動連線,看起來像是開關失靈。也請檢查裝置是否有其他正在運作的 VPN 設定或組織管理的網路政策。只停止自己明確知道且可調整的連線,不要刪除來源不明的管理描述檔;受管理的裝置應由管理單位確認允許使用的網路設定。

接著保持目前伺服器不變,分別在可正常連上網際網路的 Wi-Fi 與行動網路上重試。若問題只出現在需要網頁認證的 Wi-Fi,先中斷 Shadowrocket,完成該網路的登入或使用條款確認,再返回 App 連線。若所有網路都在相同階段失敗,而系統授權也已完成,應優先檢查目前伺服器參數、設定解析提示與 App 記錄,不要把切換網路本身當成修復結果。

最後再重建系統設定

先完整結束本次連線,再重新開啟 App;若問題仍在,可重新啟動裝置後再測試。若確定需要移除並重新加入對應的 VPN 設定,請先確認伺服器與設定已妥善保存,且能重新完成授權。移除系統 VPN 項目不等於復原訂閱,也無法修復伺服器端故障。不要一開始就重新安裝:本機資料未必能自動取回,而且重新安裝會抹去有價值的故障現況。

本章的通過條件:手動連線時不再立即跳回關閉,系統中的對應連線狀態能維持,且不會持續重複出現授權提示。若仍然失敗,請簡短記錄「按下後多久跳回、對話框原文、網路類型、是否啟用自動連線」。同一錯誤在兩種網路上重複出現,比只說「開關打不開」更容易判斷問題;若有購買或安裝來源方面的疑問,可先查看正版驗證說明。

02 / CONNECTED BUT OFFLINE

顯示已連線但無法上網

系統顯示 VPN 已連線,卻無法開啟網頁時,應將「通道已建立」與「請求成功」分開判斷。一次網頁存取可能依序經過網域解析、規則比對、伺服器連線及目標服務回應,任何一層失敗都可能呈現載入轉圈。先選定一個平常能正常開啟的頁面作為固定測試目標,並記下完整錯誤類型;不要一直更換網站,否則每次測試的目標和存取條件都不同,難以比較。

建立直連與代理兩組對照

先中斷 Shadowrocket,確認目前網路本身能否開啟測試頁面。若中斷後仍然失敗,應先處理 Wi-Fi 登入、行動數據權限、路由器或目標服務問題。若基礎網路正常,再連線並檢查 Global Routing。短暫測試時保持伺服器不變,只改動這一項;測試完成後恢復原本需要的模式,避免長期保留用於定位的暫時設定。

介面選項主要行為判斷用途
Config依目前設定的規則決定請求處理方式規則、策略群組與設定選擇是否正確
Proxy透過代理路徑處理測試請求目前代理路徑是否可用
Direct透過直接連線路徑處理測試請求作為路徑差異的輔助比對

若 Proxy 可以連線而 Config 不行,請優先檢查目前啟用的 Config、命中規則及相應策略,不要立即認定伺服器失效。若 Direct 可用而 Proxy 失敗,則應轉而檢查選取的伺服器、協定參數及代理路徑。請注意,連線狀態下的 Direct 測試與完全中斷 App 並不相同:解析設定等條件可能仍有差異,因此只能作為輔助證據,不能取代基礎網路測試。

檢查實際命中的規則

確認 Config 清單中實際啟用的是預期檔案,而非剛匯入但尚未選取的另一份。規則通常依序比對,較早命中的項目會影響後續處理;因此只在檔案末尾新增規則,未必能改變既有比對結果。查看請求記錄時,應一併核對目標網域、命中規則與最終策略。若設定使用策略群組,也要查看群組內目前選取的項目;群組名稱正確不代表其中指向可用的伺服器。

以下是用來說明順序的精簡規則片段,不是完整設定,也不應直接覆蓋正在使用的檔案。第一條只比對範例網域,第二條處理指定的私有位址範圍,最後一條則是在前面的規則都未命中時採用的收尾策略。實際排查時,請在備份副本中進行最小幅度修改,並確認修改位於目前啟用的設定中。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

區分全部失敗與單一服務失敗

若所有頁面都無法使用,先檢查共通路徑:伺服器、解析與預設策略;若只有一項服務異常,再檢查該服務的網域、登入狀態、目標端限制及其使用的其他連線。一個頁面可能會連線到多個網域,首頁成功不代表其中的圖片、登入介面或媒體請求也走相同路徑。不要只因頁面主體能顯示,就認定所有規則都正確。

每輪測試都應重新建立目標連線;必要時先關閉再重新開啟對應頁面,以減少沿用舊連線造成的誤判。恢復正常的標準是目標頁面及重要功能都能使用、記錄中的策略符合預期,而且再次測試仍能成功。若現象只出現在某個 App,請先檢查該 App 自己的網路權限與快取,再檢查 Shadowrocket;常見概念可參考常見問題,避免把 App 登入錯誤誤認為連線故障。

03 / SERVER TIMEOUT

伺服器逾時與協定參數

解讀 Connectivity Test 結果時,應一併考量測試方式。逾時表示本次測試未能在限定條件下取得預期回應,並不代表已證明伺服器永久無法使用;測得回應,也不代表實際瀏覽網頁一定成功。先保留測試方式與錯誤提示,再使用同一筆伺服器進行實際請求。若測試成功但實際服務失敗,繼續檢查目標、規則與解析;若兩者都失敗,再逐項核對伺服器入口與協定參數。

從位址、連接埠與認證開始

開啟對應項目的編輯頁,逐項比對位址、連接埠與協定類型,以及自己的原始伺服器資料。位址欄不應混入不屬於該欄位的路徑或多餘空格,連接埠則應與服務端實際監聽的連接埠一致。透過訂閱匯入的項目也可能因連結過期或資料變更而過時;先確認原始資料是否仍有效,不要反覆修改用戶端,直到偶然成功一次。

認證欄位應與目前使用的協定完全相符。Shadowsocks 需確認加密方法與密碼;VMess、VLESS 等需核對使用者識別資訊及服務端要求的傳輸設定;Trojan 則需確認密碼及安全連線相關參數。不同協定中看似相似的欄位,不能直接互相套用。複製時請留意全形符號、換行與前後空格,但不要把完整認證資料傳給他人;只需說明欄位是否相符。

參數層級核對項目常見現象
入口位址、連接埠、目前解析位址無法建立連線或連線等待逾時
認證密碼、使用者識別資訊、加密方法已連上伺服器,但請求無法完成
TLS服務端要求的名稱、憑證與裝置時間安全連線驗證失敗
傳輸傳輸類型、路徑及相關主機欄位交握失敗或建立後立即中斷

區分 TLS 與傳輸錯誤

伺服器位址、TLS 使用的名稱,以及傳輸所需的主機欄位可能各不相同,但都必須根據你的伺服器資料填寫,不要自行猜測。出現憑證錯誤時,先校正裝置時間,再核對名稱與服務端憑證狀態。不要把略過驗證當成一般修復方式;即使暫時改變錯誤提示,也沒有解決身分驗證不符的根本原因,還會降低安全連線的可靠性。

若服務端使用特定傳輸類型,用戶端的路徑、主機欄位及相關開關都必須與之相符。欄位缺漏可能導致入口已建立連線,後續交握卻失敗。先還原原始資料中的參數再測試,不要同時嘗試多種路徑與安全選項。錯誤從逾時變成明確的認證或交握提示,也是有效進展,表示失敗階段已經改變。

判斷網路路徑與伺服器端限制

保持項目不變並切換網路;若只在其中一種網路失敗,請記下網路類型與協定傳輸特徵。部分協定依賴 UDP,而不同網路對這類流量的處理方式可能不同,但不能只憑一次失敗就確認原因。Hysteria2 的背景資訊可參考Hysteria2 協定基礎;排查仍應以實際錯誤與可重複的網路比對為依據。

若你自己的其他有效項目在同一網路正常,而目前項目在多種網路上都失敗,請向原有服務提供者確認伺服器監聽、認證與服務狀態。只有用戶端記錄,無法直接確認遠端程序是否正在執行,也無法修復服務端設定。回報時提供已遮蔽敏感資訊的失敗階段、發生條件與測試結果即可,不必公開完整訂閱內容。修復後請以實際請求重新測試,並確認重新連線仍然成功,避免將偶然通過的測試誤認為問題已排除。

04 / SUBSCRIBE

訂閱匯入與更新失敗

訂閱更新通常分為取得連結內容、辨識格式及取代本機項目幾個階段。無法取得內容、無法辨識內容,以及更新成功但伺服器無法使用,分別是不同問題。先確認提示屬於哪一類,再處理對應階段。使用者已有的訂閱連結應來自自己的原始資料;訂閱是設定資料的入口,不是 App 購買憑證。更新訂閱也不是更新 Shadowrocket App,兩者應分開操作。

核對連結,但不要公開憑證

檢查 Subscribe 項目中的位址是否完整,尤其是問號後的參數。某些分享方式可能截斷連結,或在末尾附上中文標點、說明文字與換行。請從原始來源重新複製,並逐段比對目前儲存的內容。不要只因網域相同就認為位址一致,路徑或參數不同也可能指向完全不同的內容。以下位址僅用來展示結構,不能作為實際服務使用,也不是可點選的取得入口。

https://example.com/sub?token=xxxx

完整訂閱連結可能具有存取權限,處理時應像密碼一樣謹慎。不要將連結提交到陌生的轉換頁面,也不要在回報截圖中顯示。若要確認連結是否過期,可查看自己的服務管理頁面或聯絡原有服務提供者。重新複製連結後,先更新現有訂閱並核對結果;不要連續建立多個同名群組,否則之後很難分辨目前選取的是舊資料還是新資料。

依取得、格式、項目三個層次定位

取得階段失敗時,請檢查目前基礎網路、網域解析及連結的存取條件。有些連結必須透過特定網路路徑才能連線;此時請記錄更新是在中斷連線還是連線狀態下進行,並在其他條件不變時比對結果。網頁能開啟登入頁面,不代表訂閱介面能傳回 App 所需的內容。如果實際取得的是網頁、錯誤說明或身分驗證頁面,繼續重試通常不會讓它自動變成伺服器清單。

無法辨識格式時,請確認複製的是訂閱位址,而非管理面板位址或網頁分享位址。不要任意修改回傳內容的編碼,也不要刪除看不懂的欄位;先確認原有服務提供者提供的格式是否適用於 Shadowrocket。若能匯入但只出現部分項目,可能與資料格式、項目有效性或參數辨識有關。請保留舊資料並逐項比對,不要直接刪除整個群組。

更新成功後,檢查選取項目與引用

更新可能會變更伺服器名稱、群組內容或可選項目。若目前選取項目引用了已移除的項目,可能看起來像是「更新後就不能用」。返回 Home 檢查目前選取項目,再查看 Config 中是否有依名稱引用的策略或群組。先用更新後仍有效的項目進行直接測試,再恢復複雜規則,藉此區分資料變更與規則引用錯誤。

手動更新穩定後,再考慮啟用開啟 App 時自動更新等設定。自動更新不保證每次開啟都能取得新資料;結果同樣受網路、連結有效期限及回傳內容影響。頻繁重複更新也可能觸發原有服務的請求限制,請遵循對方提供的更新要求;失敗時保留提示並等待適當時間,不要用連續點按取代診斷。詳細操作可參考訂閱更新教學。

本章的驗收應完成一整套流程:儲存正確連結、手動更新成功、確認項目有所變更、重新選取伺服器並實際瀏覽目標。若舊項目仍可使用但更新失敗,可先保留可用狀態,再排查更新入口;若更新正常但所有連線都失敗,請前往伺服器逾時章節。回報時說明「取得失敗」、「辨識失敗」或「更新後連線失敗」,比只說「訂閱壞了」更有助於定位。

05 / PERFORMANCE

速度慢與連線不穩

速度慢可能是首次開啟頁面延遲、持續傳輸速度慢、影片間歇停頓,也可能是 Wi-Fi 切換後短暫失去連線。這些現象不應混為一談。先用一句話描述症狀,例如「每次首次開啟都要等一段時間,但開始傳輸後正常」,再選擇相應的檢查方向。回應時間、傳輸量與穩定性是不同指標,不能用一次 Connectivity Test 概括整體體驗。

建立可比較的測試條件

固定裝置、網路、伺服器與目標內容,並關閉大量背景傳輸,再重複相同操作。基礎網路測試應先在中斷 Shadowrocket 後完成;若此時也很慢,請優先檢查訊號、路由器負載及網路本身。比較不同時段時,應記錄條件變化,因為目標服務與遠端路徑的負載也會改變。不要直接以不同時間、不同網站的表現評價同一筆伺服器。

若只有 Wi-Fi 速度慢,請靠近無線基地台重新測試,並確認裝置是否處於訊號微弱或網路擁擠的環境。若行動網路穩定,而同一個 Wi-Fi 經常中斷,應先將問題範圍縮小到無線網路;反之則檢查行動訊號、裝置數據設定與網路切換時機。不要一開始就重置所有網路設定,這會一次改變太多條件,也可能清除既有網路資訊,讓後續比對失去依據。

依等待發生的階段分流檢查

首次開啟較慢、後續正常時,請優先觀察解析與建立連線的過程。若每個新網域都需要等待,但同一頁面重新整理較快,可能與 DNS 或初次交握有關;快取也可能造成類似差異,因此需要多次驗證。若頁面很快開始載入,但大檔案持續傳輸不穩,應留意鏈路封包遺失、遠端負載、目標端限速及本機同時進行的流量,而非只調整解析設定。

只有一個 App 速度慢時,先檢查它實際請求的目標及命中規則。媒體、圖片與登入介面可能使用不同網域,某個環節採用不同策略會讓整體體驗不一致。切換 Global Routing 進行短時間比對時,應重新建立目標連線,避免舊工作階段沿用原路徑。若 Proxy 穩定而 Config 不穩,請檢查策略群組是否自動切換,以及同一項服務的不同網域是否分配到不同出口。

運用流量統計輔助,不要把讀數當成結論

Data 可協助觀察流量出現在哪些伺服器或 App 相關項目中,但統計範圍、連線重用與系統行為都會影響讀數。它適合用來確認「請求是否經過預期位置」,不適合只憑一個數字判定遠端頻寬。具體說明可參考Data 頁面統計解讀。記錄流量時,也應註明測試時段,避免把先前連線累積的數值當成這一輪的結果。

不要因為「可能比較快」就任意修改協定參數。服務端要求的傳輸方式、加密方法與安全設定,首先必須相符。特別是涉及 UDP 的協定,應依目前網路能否穩定承載相關流量來判斷,沒有適用於所有網路的固定最佳選項。若只有特定協定在某個網路上反覆失敗,請保留相同網路下其他有效連線的比對結果,再向原有服務提供者確認。

最後應在實際使用情境中驗收,例如連續瀏覽同類頁面、完成一次檔案傳輸,或切換網路後重新開啟頁面。不能只憑某一瞬間的高讀數判定測試成功,也應確認重複操作時沒有明顯卡頓。若問題集中在特定時段或目標,記下時段與目標類型即可,不要無止盡增加用戶端設定。確認問題來自遠端或基礎網路限制後,繼續修改本機規則通常無法改善根本原因。

06 / DNS AND ROUTING

DNS 解析與規則路徑

DNS 會將網域轉換為可連線的位址,但網域能解析不代表位址可連線;位址可連線也不代表安全連線與 App 請求一定成功。常見現象包括網域解析錯誤、首次存取等待、只有部分網域失敗,以及規則出現非預期結果。先記錄錯誤是否明確提及解析,再檢查目前啟用的設定與 DNS 設定來源;不要把所有無法開啟網頁的狀況都歸因於 DNS。

確認目前生效的解析來源

查看目前 Config 與相關 DNS 設定,確認使用的是系統解析、自訂解析,還是包含 DNS over HTTPS 的方案。不要只查看剛編輯的檔案,也要確認該檔案確實已啟用。若設定中存在多處解析選項,應先了解彼此的覆寫關係,再進行修改;同時檢查裝置上是否有組織管理的解析設定。多種來源疊加時,表面上只修改一項,實際請求路徑卻可能完全沒變。

先保存原始設定,再以最簡單且已確認可運作的解析方式建立基準。DNS over HTTPS 需要連線至其服務端點,因此本身也依賴可用的連線與正確的名稱驗證。若將解析服務的連線路徑安排在尚未建立的代理路徑上,可能形成相互依賴。不要為了解決單一網域失敗,就接連加入多個解析位址,否則逾時與回退過程會更難觀察。

區分網域規則與位址規則

DOMAIN、DOMAIN-SUFFIX 等規則依據網域資訊比對;IP-CIDR、IP-CIDR6、GEOIP 等則涉及位址比對,兩類條件的適用時機不同。某條位址規則生效,不代表前面的網域規則正確;反過來,網域規則命中也不保證最後取得的位址適用目前路徑。先透過請求記錄確認實際命中項目,再判斷問題來自解析結果,還是規則將請求送往不合適的策略。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

這段範例只用來說明規則類型與順序,不代表適合所有環境。此處的精確網域規則與後綴規則有覆蓋關係,實際設定只應保留確實需要的項目。FINAL 是收尾策略,不是修復解析的開關。排查時可在副本中縮減為與目標相關的最少規則,先觀察目標的處理路徑,再逐條還原原設定;每還原一組就重新測試,方便定位衝突。

避免以不等價的測試下結論

直接在瀏覽器輸入某個位址,不能簡單取代透過原網域存取。安全連線通常需要正確的主機名稱,網站也可能依此區分服務;因此「輸入位址後無法使用」不能單獨證明網路不通。也不要把其他裝置查到的解析結果長期寫入設定,遠端位址可能改變,不同網路的可用路徑也可能不同。請優先檢查實際請求中的錯誤與解析記錄。

修改 DNS 後,舊連線與快取可能仍影響結果。先中斷並重新連線,再關閉目標頁面後重試;必要時重新啟動對應 App。不要只因重新整理一次頁面仍無變化,就認定修改無效;也不要不斷清除整部裝置的設定。若只有一個網域失敗,請確認網域拼寫、目標服務狀態及其他網路上的結果;若所有網域都失敗,再檢查解析服務是否可連線及設定來源。

涉及區域網路名稱、裝置探索或單位內部網域時,也應考量這些名稱是否只能透過目前網路提供的解析方式取得結果。將所有解析統一導向另一條路徑,可能讓外部網頁正常,卻無法使用內部服務。請依實際需求設計最精簡的例外,而非關閉所有規則。系統 DNS、自訂 DNS 與 DNS over HTTPS 的差異,可繼續閱讀DNS 設定比較,再回到本章以相同目標進行驗證。

07 / BATTERY AND BACKGROUND

耗電異常與背景連線

排查耗電時,應先區分持續傳輸、反覆重新連線與單純維持連線。系統電池頁面中的 App 占比是特定統計時段內的相對數值,不代表某個開關必然消耗固定電量;不同時段的螢幕使用、訊號品質與背景活動都會影響結果。先記錄異常發生時段、裝置是否發熱,以及是否剛完成大量同步,再判斷 Shadowrocket 的連線行為是否與耗電同時出現。

在相同條件下建立觀察時段

選擇相近的使用方式,分別記錄連線開啟與關閉時的裝置狀態。比對時盡量保持螢幕亮度、網路、背景工作與使用時間一致;不要拿待機狀態和持續觀看媒體直接比較。若中斷連線後裝置仍明顯發熱,請檢查系統更新後的處理程序、照片同步、大量檔案傳輸等其他活動。VPN 連線承載流量,不代表流量來源一定是代理用戶端本身。

查看 Data 與請求記錄,確認閒置時是否仍有大量持續請求,或同一目標是否在短時間內反覆失敗。自動重新整理頁面、雲端同步及其他 App 的背景工作,都可能讓連線持續運作。先辨認流量來源,再決定是否調整該 App 的背景行為;不要為了降低統計占比就直接刪除正在使用的設定,否則會失去判斷實際流量路徑的依據。

處理反覆重新連線,不要掩蓋問題

若記錄顯示連線不斷建立又中斷,請先檢查網路訊號與目前伺服器的穩定性。在訊號微弱的環境中反覆重試,不只影響使用體驗,也會增加裝置負載。保持設定不變,在穩定的 Wi-Fi 下觀察;若恢復正常,再檢查原網路的訊號與切換狀況。若在多種網路上都反覆斷線,請依伺服器逾時章節核對認證、傳輸與遠端狀態,不要只把問題歸因於電池。

On Demand 可能在符合條件時重新觸發連線,因此手動中斷後再次連線,不一定是異常。需要進行比對測試時,先暫時停用相關自動連線條件並記錄原設定,測試結束後再還原。若條件在兩種狀態間來回變動,可能導致頻繁觸發;應明確設定希望在哪類網路連線、在哪類網路保持中斷,不要同時保留互相矛盾的條件。

減少診斷負擔與無效請求

詳細記錄適合短期定位,不適合在問題解決後繼續保留不必要的高強度診斷。若先前手動開啟額外記錄或頻繁測試,取得所需證據後應恢復一般使用狀態。也請檢查訂閱自動更新、策略測試與自行設定的定時操作是否過於頻繁;這些操作是為了取得必要資訊,不是更新越密集就越穩定。

若裝置鎖定後仍有資料傳輸,系統維持必要連線可能是正常行為;若沒有預期中的工作,卻持續出現大量失敗請求,就應找出請求來源或錯誤的重試循環。失敗後少量重新連線,不等於持續異常,必須結合觀察時段判斷。不要只根據某一刻的溫度或電量變化,就認定 App 長期耗電。

完成調整後,應在與基準相同的網路及使用條件下再觀察一輪,確認重新連線次數減少、異常請求停止,同時實際存取仍正常。若關閉用戶端後耗電情形仍持續,問題範圍應轉向系統或其他服務。回報支援時可提供統計時段、螢幕使用情形、網路類型與已遮蔽敏感資訊的活動特徵;無須提供完整瀏覽記錄,也不要公開含有認證資訊的設定。

08 / CHANGE AND RECOVERY

更新後異常與設定復原

遇到「更新後不能用」,首先要釐清更新的是什麼:App Store 中的 App、系統、訂閱內容,還是 Config 檔案。這些變更可能剛好發生在同一天,但影響的層次不同。App 更新不會自動修復已過期的訂閱;訂閱更新也不代表規則引用仍然有效。先列出從最後一次正常使用到首次發生異常之間的變更,只記錄實際操作,不要只因時間接近就認定某項變更必然是原因。

先保留現況,再建立最精簡設定

繼續修改前,先儲存目前設定副本、選取的伺服器名稱與 Global Routing 狀態。備份檔案本身可能含有敏感資訊,請存放在自己能掌控的位置。已有備份時,也要確認它對應的時間點與包含內容;伺服器清單、規則檔案與系統 VPN 授權並不是同一類資料。不要以為備份其中一項,就一定能完整還原可用狀態。

先重新啟動 App 並重新建立連線,確認異常是否仍存在。接著保持目前有效的伺服器不變,以簡化路徑測試實際存取;若 Proxy 正常但原 Config 失敗,應優先檢查設定解析、規則順序與策略群組引用。若所有路徑都失敗,再檢查伺服器、授權與基礎網路。精簡測試的目的在減少變因,不是建立一份長期取代所有需求的新設定。

依變更類型分別檢查

訂閱更新後發生異常,先確認目前選取的項目是否仍在更新後的清單中,以及原有策略群組是否引用已變更的名稱。Config 更新後發生異常,請檢查匯入提示、啟用中的檔案與收尾規則,確認新檔案沒有另存為未啟用的副本。若設定來自你原有的來源,可保留新舊兩份進行比對;每次只還原部分設定,避免整份覆寫回可能已損壞的內容。

App 或系統更新後發生異常,先確認系統中的 VPN 授權是否仍可正常使用,以及裝置是否正在進行其他更新後處理。不要只因一次連線失敗就立即清除所有網路設定。若問題能穩定重現,請記錄具體步驟與錯誤原文,並在 App Store 頁面查看目前的 App 說明及相關資訊。App 的取得與更新均透過 App Store;來源核對請參閱正版取得頁。

復原時逐項驗證,不要一次覆蓋

使用備份復原時,先確認備份中的伺服器資料仍有效。舊設定即使語法正確,其中的位址、認證或引用也可能已經變更。建議先復原必要伺服器並測試,再復原核心規則,最後才還原自動連線及其他選用行為。每一步成功後都記錄狀態;若下一步失敗,就能把範圍縮小到剛還原的內容,不必從頭猜測所有設定。

最近發生的變更優先檢查項目復原後驗收方式
訂閱更新目前項目、名稱引用、認證資料更新後的項目可正常實際存取
Config 取代啟用中的檔案、規則順序、策略群組目標請求命中預期策略
App 或系統更新系統授權、連線記錄、網路條件重新連線並再次開啟後皆正常

只有在必要資料已儲存、了解復原步驟,且一般排查無法繼續時,才考慮重新安裝。重新安裝無法修復遠端伺服器失效,也無法讓已過期的連結重新有效。已購 App 的復原與本機設定復原應分開處理:前者關係到 App Store 購買記錄,後者則仰賴自己的備份。不要以為重新取得 App,就能自動還原所有本機設定。

若問題仍未解決,請整理最精簡的重現說明:裝置類型、網路類型、最後一次正常狀態、發生過的變更,以及精簡設定後的測試結果。刪除其中的憑證與無關記錄,不要傳送完整的日常流量記錄。復原成功的標準應包括重新開啟 App、切換網路後重新連線、目標服務正常,以及自動連線條件符合預期;只有目前工作階段暫時可用,還不足以證明復原已完成。

09 / IPAD CHECKLIST

iPad 專項檢查與驗收

iPad 的基本連線流程與 iPhone 相同,但使用情境常涉及大螢幕多工、不同 Wi-Fi、區域網路裝置及跨裝置移轉。遇到問題時,不要直接套用另一台裝置的結論;同一份訂閱在另一台裝置可用,只能表示部分條件可能正常,不能證明本機已啟用相同設定。系統需求、相容性與購買適用性均以 App Store 頁面標示為準,不要依裝置外觀推測支援情況。

將 App 取得與設定移轉分開處理

先確認 iPad 上安裝的是正確的 Shadowrocket。驗證正版時,請核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118;詳細入口請見iPad 取得說明。透過購買記錄取得 App,不代表另一台裝置上的訂閱、目前選取項目、規則與自動連線條件已同步。移轉後必須逐項核對,不要把空白清單誤認為購買未生效。

若使用自己的備份匯入設定,先確認檔案完整,並檢查本機實際啟用的項目。清單中出現伺服器名稱,不代表目前已選取該伺服器;匯入 Config 也不代表已啟用。建議在 iPad 上重新完成一次基本流程:選取有效項目、手動連線、存取固定目標,再恢復規則與自動連線。首次授權仍須在本機完成,不能以其他裝置已獲授權取代。

檢查本機網路與權限差異

部分 iPad 只有 Wi-Fi 連線,排查時未必能以行動網路作為比對條件。可改用自己有權使用的另一個網路測試,但應先確認該網路本身可正常使用。連線至校園、單位或公共 Wi-Fi 時,請先中斷 Shadowrocket,完成必要的網頁認證;受管理的裝置也可能有組織設定,應向管理單位確認,不要自行移除相關設定。

若網頁正常但無法連線區域網路裝置,請檢查目標位址是否屬於目前區域網路,以及相關 App 是否具有所需的區域網路權限。列印、螢幕鏡像與裝置探索不一定只依賴一般網頁請求,不能用外部頁面的存取結果取代測試。確認規則是否為相應私有位址安排合適路徑;但只新增一條位址規則,也未必涵蓋探索機制與裝置本身的權限要求。

處理多工與網路切換

使用分割畫面或切換 App 後發生異常,請先回到 Shadowrocket 查看實際連線狀態,不要依據先前停留的頁面畫面判斷。頁面可能保留舊內容,目標 App 也可能重用既有工作階段。重新送出一個請求,觀察記錄是否出現並核對策略;若沒有新請求,請檢查目標 App 是否仍在載入或已暫停,避免把服務未送出請求誤判為代理未轉送。

鎖定畫面喚醒、切換 Wi-Fi 或離開無線基地台後短暫失敗時,請等網路穩定後再重新建立目標連線。若每次喚醒都反覆斷線,請記錄是否啟用 On Demand、原網路是否需要重新認證,以及同一網路上的基礎存取是否正常。暫時停用自動連線進行一次手動比對後,應還原原有條件,不要為了排查而長期保留不符合使用需求的狀態。

完成本機完整測試後,再恢復日常使用

先在 Safari 中以固定測試頁面驗證基礎存取,再測試實際遇到問題的 App,最後驗證區域網路或多工情境。每一步都記錄成功條件;若某類服務失敗,保留前面已通過的基準繼續排查,不要重新調整所有項目。需要查看概念時可參考術語手冊;需要重新走過完整操作流程時,請回到快速入門教學。

最終驗收應包括在本機重新開啟 App、手動重新連線、實際使用目標服務,以及切換常用網路後再次存取。若只有這台 iPad 失敗,請保留本機授權、網路、設定與權限方面的差異記錄;若自己的多台裝置使用同一伺服器時都失敗,應將檢查重點轉向伺服器或訂閱狀態。依此順序整理證據,可減少重複匯入與反覆重新安裝,也能讓後續回報明確聚焦在可處理的故障層級。