Shadowrocket
故障排查指南

先區分「開關一開就關閉」與「開關保持開啟，但請求失敗」。前者優先檢查 VPN 設定與系統管理限制；後者請看下一章，不要反覆刪除 App。

建立可重複驗證的起點

關閉 Shadowrocket 的連線開關，暫時停用其他會接管網路的 VPN 設定，再用瀏覽器開啟原本可直接瀏覽的網頁。公共 Wi-Fi 可能需要先登入網頁完成認證；看到 Wi-Fi 圖示不代表已連上網際網路。若原始網路本身無法上網，請先完成認證、重新連線或洽詢網路管理員；此時更換伺服器或調整規則都無法解決底層連線問題。記下目前使用 Wi-Fi 還是行動網路，以及故障前是否更換網路、還原設定或修改系統設定。

準備一份簡要紀錄：裝置類型、網路類型、開關是否能維持開啟、發生問題的具體操作，以及錯誤訊息原文。不要只寫「不能用」，因為匯入失敗、連線失敗和網頁無法開啟的排查方向不同。測試期間固定使用一台已知伺服器和同一個目標網頁，並關閉不必要的下載工作。若同時更換伺服器、設定與網路，即使恢復正常也無法判斷是哪一步奏效；下次遇到類似情況仍得從頭測試。

重新確認 VPN 設定授權

在 iPhone 或 iPad 首次啟用連線時，系統會詢問是否加入 VPN 設定，請由裝置使用者閱讀提示並確認授權。若之前曾取消，請回到 Shadowrocket 再次開啟，並留意是否出現系統對話框。接著在系統 Settings 中查看 VPN 設定，確認清單中有對應項目。各系統版本的設定路徑可能不同，可使用設定搜尋；不要因為舊教學中的選單名稱不同，就認定設定一定不存在。若裝置由公司或學校管理，描述檔可能限制新增 VPN，請洽管理員確認權限，不要反覆重新安裝以規避管理政策。

授權後若開關仍立即關閉，請先重新啟動裝置再測試。只有在確認舊 VPN 項目屬於 Shadowrocket，且已備份 App 內資料後，才考慮移除該系統設定，再由 App 重新申請建立。系統的 VPN 設定與 App 內的伺服器、Subscribe、Config 不屬於同一層；刪除其中一項不代表其他資料已備份。不要一次移除所有描述檔，也不要刪除用途不明的憑證或裝置管理項目。

排除自動觸發與連線衝突

檢查 On Demand 是否依網路條件自動連線或中斷。為避免自動策略影響測試，先記下原有條件，暫時停用自動觸發，只用手動開關測試。若手動連線正常，再逐項恢復原條件，確認問題是否只在特定 Wi-Fi 名稱或網路切換時發生。系統可能儲存多個 VPN 項目，請確認目前實際啟用的是哪一個；不要把狀態列的連線圖示直接當成 Shadowrocket 已正常處理網路請求的證據。

若 App 無法開啟或啟動後立即退出，請先儲存可匯出的設定、確認裝置剩餘空間，並透過客戶端下載頁確認取得方式。iPhone / iPad 版請從 App Store 取得，系統需求以 App Store 頁面標示為準。Mac、Windows、Android、Linux 的安裝與系統允許步驟也集中在下載頁；遇到連線故障時，不要任意改用來源不明的安裝檔。確認 App 能穩定開啟、開關也能保持開啟後，再檢查網路層。

先比較 Direct 與 Proxy 的結果，再判斷是否只有 Config 失敗。連線圖示只代表系統存在 VPN 工作階段，不代表每個目標請求都能成功。

用三種模式縮小故障範圍

先保留目前 Config 的副本，選取一台使用者已有且參數可供核對的伺服器。在 Global Routing 中依序測試設定模式 Config、代理模式 Proxy、直連模式 Direct；每次切換後都重新送出同一個網頁請求。Direct 用來觀察不經所選代理伺服器時的存取結果，Proxy 用來檢查該伺服器處理請求的情況，Config 則會將規則判斷納入連線流程。這些模式的比較是診斷方式，不代表必須長期固定使用其中一種；測試結束後，請恢復符合實際需求的設定。

若 Direct 正常、Proxy 失敗，優先檢查伺服器狀態、協定參數與遠端連線能力。若 Proxy 正常、Config 失敗，優先檢查設定是否已啟用、規則順序與策略指向。若三種模式都失敗，先確認目標網頁本身是否可用，再檢查原始網路與 DNS。有些 App 會沿用既有連線，因此切換模式後請關閉舊頁面再重新開啟；必要時結束該 App 的目前工作階段後再測試，避免舊連線造成結果與目前模式不一致。

檢查目前使用的設定，不只看設定清單

在 Config 中確認實際啟用的是哪份設定。清單中有檔案，不代表目前正在使用；從訂閱匯入伺服器，也不代表已切換至預期的規則設定。開啟目前使用的檔案，檢查 Rule 區段並由上往下閱讀。通常第一條符合的規則會決定請求去向，因此較寬泛的規則若排在前面，後面的精確規則可能無法生效。修改前先複製檔案，並以容易辨認的名稱命名副本，避免混淆原始設定與測試設定。

以下片段僅用於說明比對順序：指定網域先交由 PROXY 處理，區域網路位址走 DIRECT，其餘請求由 FINAL 處理。PROXY 所指向的實際伺服器或策略仍須在目前環境中有效；片段本身不會建立伺服器。GEOIP 判斷也仰賴位址與相關資料，不能據此推斷網域在所有網路環境中都會得到相同結果。不要直接用範例覆蓋包含必要本機規則的完整設定。

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

只有部分網頁失敗時，查看規則比對紀錄

若大多數網頁正常，只有特定網域或 App 失敗，請查看對應請求實際符合的規則、最終策略與錯誤訊息。同一個頁面可能同時載入主網域、圖片網域與 API 網域；若首頁文字已出現但圖片持續載入，通常不能簡單歸納為「整個連線中斷」。先找出失敗的是哪個網域，再判斷是否需要調整單一規則。遇到 REJECT 規則時，應確認規則的用途，不要直接刪除所有拒絕規則；原始設定可能用來阻擋特定類型的請求。

存取區域網路裝置、印表機與內部網頁時，先確認目標位址屬於目前所在網路，並檢查請求是否被送往遠端代理。Wi-Fi 的裝置隔離也可能阻止裝置互相連線，新增一條 DIRECT 不一定能解除此限制。若只有特定 App 顯示網路錯誤，也要檢查它的系統網路權限與服務狀態。問題排除後，使用相同目標再次測試 Config，並撤銷只為診斷而新增的暫時規則，只保留必要的最小修改。

逾時只表示某項測試未能在等待時間內完成。問題可能發生在位址解析、傳輸連線、協定交握或遠端請求階段，請先確認測試類型與錯誤訊息原文。

先判斷是單一伺服器還是所有伺服器

在 Home 對既有伺服器執行 Connectivity Test，記錄哪些項目失敗，再選其中一項實際瀏覽網頁。不同測試方式檢查的環節也不同：連接埠成功建立連線，不代表驗證資訊正確；網頁測試成功一次，也不能保證所有目標請求都正常。若只有一項失敗，優先核對該伺服器參數與遠端狀態；若所有項目同時失敗，先檢查目前網路、網域解析、裝置時間與共用的傳輸設定，不要逐一重建所有伺服器。

情況允許時，使用同一台裝置改連另一個已知可用的網路，並維持伺服器與測試目標不變。若結果隨網路改變，問題較可能出在本機網路至伺服器的路徑，或目前網路對相應傳輸方式的處理。不要因某次切換成功就認定設定完全正確；仍要記錄原網路是否需要認證、是否經過路由器過濾，以及問題是否只在網路繁忙時發生。可重複觀察到的差異，比偶然成功更有助於診斷。

逐欄核對既有設定

開啟 Add Server 對應的編輯頁面，依照使用者已有的伺服器資料，逐項核對協定類型、位址、連接埠與驗證資訊。伺服器位址應填入主機名稱或位址欄位要求的內容，不要連同網頁連結路徑一起貼上；連接埠必須與伺服器端的監聽連接埠一致。密碼、UUID、金鑰與其他驗證欄位屬於不同協定的參數，不能互相替代。複製貼上後留意前後空格、換行與全形標點，尤其從聊天訊息或文件複製時，外觀相似的字元也可能造成交握失敗。

VMess、VLESS、Trojan 等設定應依實際伺服器要求，檢查 TLS、傳輸方式與相關欄位；並非每份設定都需要相同選項。使用 WebSocket 時，路徑與 Host 必須符合伺服器約定，並保留路徑的大小寫與開頭斜線。使用 Hysteria2 或 WireGuard 時，也要考量目前網路如何處理 UDP；TCP 探測有結果，不能證明 UDP 資料傳輸同樣順暢。若不確定具體欄位，請向原設定提供者確認，不要憑經驗套用其他伺服器的參數。

檢查系統時間與交握環節

系統日期或時區不正確，可能影響憑證有效期判斷，也可能干擾依賴時間的驗證流程。請在系統中啟用自動設定日期與時間，確認顯示正確後重新連線。若出現憑證名稱不符或憑證過期錯誤，請核對伺服器名稱、SNI 與遠端憑證，不要關閉驗證來掩蓋問題。位址可連線但交握持續失敗時，通常比單純逾時更能提供線索；請完整記錄錯誤提到的是憑證、驗證還是傳輸回應。

完成本機核對後，若某台伺服器在多個正常網路環境中仍穩定失敗，可將協定類型、錯誤階段、測試時段與已去識別化的錯誤訊息提供給原有服務商，請其檢查監聽、驗證與服務狀態。不要公開密碼、UUID、完整訂閱網址或設定 QR Code。更多測試順序請參閱伺服器逾時、協定參數與系統時間排查。確認修改有效後再儲存，避免將失敗的嘗試長期留在設定中。

訂閱更新分為發出網址請求、取得內容、辨識格式與更新清單等階段。更新成功不代表伺服器可用；伺服器連線失敗也不代表訂閱網址失效。

確認網址完整且仍有存取權限

從使用者原有服務商的管理頁面重新複製訂閱網址，確認查詢參數沒有遺漏、未被通訊軟體截斷，前後也沒有多餘空格。網址中的權杖通常等同存取憑證，不應出現在公開截圖、客服單標題或網頁留言中。若曾重設訂閱網址，舊網址可能已失效；請改用本人帳戶目前提供的網址，不要重複更新舊項目。複製後先在 App 中檢查欄位內容，不要將包含私人權杖的網址傳送至線上轉換或檢測網站。

若請求回覆未授權或禁止存取，請檢查帳戶登入狀態、存取權限與訂閱是否已重新產生；若提示找不到資源，請確認路徑完整。回應狀態只能提供排查方向，實際含義仍以使用者原有服務商的說明為準。若網址是由暫時轉址產生，複製到的可能是登入頁而非訂閱內容。不要只因瀏覽器能開啟某個頁面，就認定該網址一定能被 Subscribe 辨識；瀏覽器工作階段與 App 請求所帶的狀態可能不同。

無法取得內容時，檢查存取路徑

若更新一直等待或顯示網路錯誤，先確認訂閱網域能否解析，以及目前 Global Routing 會讓該請求走哪條路徑。某些情況下，更新請求需要經過一台已可用的伺服器，但目前清單中的伺服器恰好全都失效，於是形成「需要更新才能連線、需要連線才能更新」的循環。處理前先保留舊清單，選用使用者已有且確認可用的連線方式，或改在能直接存取訂閱網址的網路環境更新。不要為了打破循環而任意匯入不明設定。

同時檢查裝置時間與 HTTPS 憑證錯誤。若只在公共 Wi-Fi 失敗，請先關閉連線並完成網路認證，再重新取得內容；若網路回傳的是認證頁面，App 取得的就不是訂閱內容。可記錄回應是否為空、是否重新導向或是否回傳網頁文字，但不要公開完整回應，因為其中可能包含伺服器位址與驗證資訊。網路路徑恢復後再更新一次即可；連續快速點擊無法修復遠端權限或內容問題，反而會讓觀察結果混雜。

有取得內容卻無法辨識時，檢查格式

匯入對象可能是伺服器訂閱、單筆分享資訊或完整設定檔，三者用途不同。請使用符合內容類型的匯入入口，並以服務商提供給 Shadowrocket 的格式為準。若回傳內容是登入頁面、帳戶通知、錯誤說明或其他目前入口無法辨識的文字，即使下載完成也會匯入失敗。不要手動刪除看不懂的前綴，或任意變更編碼來「修復」內容；這可能破壞原本正確的驗證參數，也會讓後續排查失去原始依據。

更新後若只出現部分伺服器，先確認原訂閱是否本來就只包含這些項目，再檢查是否有目前設定無法辨識的欄位或篩選條件。匯入項目名稱相同，不代表參數完全一致；尤其手動新增項目與訂閱項目並存時，請確認目前選取的確實是剛更新的項目。修改訂閱產生的伺服器前，先複製成獨立測試項目，因為後續更新可能覆蓋手動修改；不要把暫時變更誤認為已同步至遠端。

更新成功後仍應選取一台伺服器執行 Connectivity Test，再用實際網頁驗證。若取得與辨識都正常，只有所有伺服器連線失敗，排查重點應回到協定參數或遠端服務，而不是繼續更換訂閱入口。客戶端一次買斷不等於線路方案；取得客戶端的費用與使用者既有服務的權限是不同事項。iPhone / iPad 版 App Store 售價為 $2.99，一次性付費；Mac / Windows / Android / Linux 版免費。購買客戶端不會自動產生可匯入的訂閱內容。

延遲、網頁首次開啟時間與持續下載速度是不同指標。不要只依單一延遲數值判斷速度，也不要在多個變數同時變動時比較結果。

將「速度慢」拆解成可觀察的階段

先描述具體情況：輸入網址後長時間一片空白、頁面文字已出現但圖片載入慢、下載開始正常後速度持續下降，還是鎖定螢幕或切換網路後斷線。首次開啟較慢可能與 DNS、建立連線及 TLS 交握有關；持續傳輸緩慢則可能與頻寬、封包遺失、遠端負載或目標服務有關。若只有單一 App 或網站變慢，先和其他目標比較，避免將目標服務限速、帳戶限制或頁面資源問題都歸咎於 Shadowrocket。

固定裝置、網路、伺服器、Global Routing 與測試檔案，關閉其他裝置或 App 的大量傳輸工作，再進行少量重複測試。比較直連與代理路徑時，應選擇兩條路徑都能正常存取的目標，否則失敗結果沒有速度比較的意義。記錄大致時段與具體表現，不要用單次結果概括全天狀況；Wi-Fi 干擾、家用網路負載與遠端繁忙程度都可能隨時間改變。測試目的是找出瓶頸，不是追求看似漂亮的單次數值。

依序檢查本機網路、傳輸路徑與遠端目標

先關閉連線，確認本機網路是否穩定；在 Wi-Fi 訊號較好的位置重新測試，避免隔牆、頻道壅塞或路由器負載造成影響。若同一台裝置直連也明顯變慢，應先處理本機網路。若只有代理路徑緩慢，再比較使用者已有的其他伺服器，並維持目標不變；若多台伺服器存取同一目標都變慢，也要考慮目標本身的限制。手機過熱、低耗電模式與大量背景同步也會影響整體使用體驗，請在裝置狀態相近時進行對照。

低延遲不等於高傳輸量。短時間探測只交換少量資料，可能無法反映長時間傳輸中的壅塞與重傳；反之，距離較遠的伺服器雖然交握等待較久，持續傳輸不一定較差。不要為追求最低測試值而頻繁切換，導致 App 連線不斷重建。觀看影片、即時通話與下載檔案，應分別觀察緩衝、連續性與實際傳輸表現，不要把某一類用途的結果直接套用到所有情境。

依斷線發生的條件檢查

若只在 Wi-Fi 切換至行動網路時斷線，舊連線可能無法沿用，新的請求需要重新建立。請先等待連線恢復，再重新開啟目標頁面；若每次切換後都無法恢復，記錄開關狀態、On Demand 條件與伺服器連線錯誤，再查看對應章節。若斷線與特定 Wi-Fi 有關，請確認該網路是否定期要求重新認證、進入省電狀態或限制長連線。不能只因「過一會兒就斷線」便推斷密碼錯誤，因為驗證錯誤通常會在建立連線時出現。

若小型請求正常，但大型檔案或特定頁面持續卡住，可進一步檢查封包遺失、傳輸方式與路徑上的分片問題；不要直接套用網路上流傳的固定 MTU 數值。不同網路、協定與通道封裝的額外負擔各不相同，不合適的調整可能讓原本正常的流量也受影響。只有在故障條件可穩定重現、已保存預設值且了解相關設定用途後，才逐項測試；調整沒有改善就還原，避免留下無法解釋的長期參數。

用規則紀錄釐清「部分內容很慢」

在 Config 模式下，頁面主文件、圖片與 API 可能分別符合不同策略，因此請查看速度慢的請求所用網域與最終路徑。若只有某條規則對應的策略較慢，先確認其指向的伺服器是否仍有效，不要直接把所有請求都改為 Proxy。連線紀錄中反覆出現的失敗、重試與重新解析，通常比單次測速更能解釋實際使用時的延遲。完成診斷後，停止不必要的壓力測試並恢復日常設定；同時執行多項測速會占用頻寬，也會影響後續觀察結果。

DNS 故障不只是「有沒有回傳位址」。還需要檢查由誰發出查詢、使用哪條解析路徑、回傳哪些位址，以及連線最後選用了哪個位址。

先確認解析失敗的跡象

若瀏覽器顯示找不到伺服器，或連線紀錄指出網域解析失敗，先確認網域拼寫、原始網路與目前設定中的 DNS 選項。若多個無關網域同時失敗，優先檢查解析器是否可連線；若只有單一網域失敗，則要考慮網域本身的紀錄、快取與對應規則。使用位址可以連線、使用網域卻失敗，這是排查線索，但不能據此下完整結論：HTTPS 服務通常需要正確的主機名稱與憑證，直接在瀏覽器輸入位址可能得到不同結果，不能簡單據此判定伺服器正常或異常。

檢查 Config 中是否有自行新增的 DNS 項目、靜態對應或特定網域的特殊處理。先儲存副本，再與原始設定比較；不清楚用途的設定不要一次全部替換。系統層級的 DNS 描述檔、路由器設定與 App 自己的解析路徑也可能同時存在，實際由哪一方處理特定查詢，需要透過紀錄確認。只看到系統中設定了某個解析器，不代表所有代理請求一定會使用它；同樣地，App 內的設定也不一定會套用到裝置上的每一種請求。

避免解析與連線互相依賴

若解析服務本身使用網域，而存取該服務又依賴尚未建立的代理路徑，啟動時可能形成依賴循環。先確認伺服器位址如何解析，再確認解析器本身如何連線，最後檢查目標網域的查詢路徑。排查時可先恢復已知可用的基本設定進行驗證，不要同時疊加多種加密解析選項與複雜分流。每個解析器都有自己的網路連線條件；增加更多位址不一定更可靠，也可能讓故障情況變得難以預測。

使用加密 DNS 時，請確認協定、位址格式、連接埠與憑證名稱符合設定要求，並確認目前網路能連到對應服務。一般 HTTPS 網頁可以開啟，不代表特定解析端點一定可用。若請求需要經過代理，所指向的策略也必須有效；若走直連，則應驗證直連路徑。不要以關閉憑證驗證來應付時間錯誤或名稱不符，請先修正裝置時間與位址，再確認問題是否消失。

區分位址類型、規則與快取

同一網域可能同時回傳 IPv4 與 IPv6 位址。若其中一種位址類型的連線路徑異常，可能會出現首次等待很久、部分請求失敗而其他請求成功的情況。請查看實際選用的位址與錯誤，確認失敗發生在解析階段還是連線階段；不要一遇到問題就永久停用 IPv6。規則中的 IP-CIDR 與 IP-CIDR6 對應不同位址類型；依位址判斷的規則也可能因解析結果不同而改變比對結果，單看網域規則通常不足以解釋所有連線路徑。

修改 DNS 或規則後，舊快取與重複使用的連線可能仍影響結果。先重新送出請求，必要時重新連線 VPN 或重新啟動正在測試的 App，再比較紀錄；不要在快取尚未更新時連續修改多組設定。區域網路的內部網域可能只有所在網路的解析器能辨識，強行改走外部解析路徑反而會失敗。使用家用或辦公室內部服務時，應一併檢查網域解析與區域網路路由，確認解析出的內部位址能從目前網路連線。

最後驗證時，請測試一般網頁、先前異常的網域，以及需要存取的內部服務。每個目標都記錄解析是否成功、最終策略與存取結果。確認恢復後，清除只供測試使用的靜態對應與暫時規則，避免位址變更後再次失效。DOMAIN-SUFFIX、IP-CIDR 與 FINAL 的設定關係，可參考設定說明；若只想確認常見錯誤的含義，請查看疑難排解。

先查看同一時段的螢幕使用情況、網路活動與連線錯誤，再判斷耗電來源。系統電池頁面顯示的耗電歸因，不等於客戶端額外消耗的總電量。

選擇可比較的觀察時段

在系統電池用量頁面查看異常發生的時段，區分螢幕開啟時的高負載與待機時的持續活動。播放影片、下載檔案、同步照片與更新 App 都會產生流量；透過 VPN 傳輸的網路活動也可能影響系統的耗電歸因。不要只看百分比就下結論：該比例可能代表所選時段內的相對占比，不一定等於裝置總電量減少的相同數值。記錄裝置是否發熱、訊號強度與實際使用內容，才能建立有意義的對照。

進行對照時，盡量維持亮度、網路、App 使用情況與時長相近，分別觀察連線開啟與關閉時的表現。不要拿一次閒置待機與一次長時間播放影片相比，也不要為了測試而持續點亮螢幕或反覆測速。行動網路訊號弱、Wi-Fi 經常斷線，以及裝置正在處理大量背景工作，都可能大幅增加耗電。若關閉連線後異常仍持續，應擴大檢查系統與其他 App，而不是繼續修改規則。

先檢查重複失敗，再檢查設定複雜度

查看是否有相同網域持續失敗、伺服器反覆重新連線或訂閱不斷更新的情況。短時間內大量重試可能同時消耗網路與處理資源，應先處理造成重試的根本原因，例如伺服器驗證失效、DNS 請求無法完成，或某個 App 持續存取遭拒的位址。不要只隱藏紀錄了事，因為紀錄消失不代表重試已停止。可暫時關閉正在大量送出請求的 App，再觀察連線活動是否明顯減少，藉此確認流量來源。

確認是否啟用了不必要的頻繁測試、過於密集的自動更新或額外診斷紀錄。測試間隔與紀錄選項應依實際需求設定，沒有適用於所有裝置的固定最佳值。排查結束後，請關閉為診斷而暫時啟用的詳細紀錄，避免長期累積資料並增加處理負擔；必要資訊匯出後妥善保存，並刪除含私人位址的暫存檔案。若裝置儲存空間不足，也應處理系統儲存問題，不要把 App 反應遲緩一概視為網路耗電。

依網路條件檢查 On Demand

On Demand 可依條件觸發連線，設定不當時，網路變化或多項條件交替成立可能造成反覆動作。先記下每項條件的對象、順序與動作，再暫時停用自動觸發，以手動連線觀察一段相近的使用時間。若手動連線穩定，但恢復某項條件後頻繁重新連線，請優先檢查該條件是否與其他條件重疊，或是否依賴經常變動的網路狀態。不要同時新增與刪除多項條件，否則很難判斷真正造成影響的是哪一項。

若需要長時間維持連線，應先確保所選伺服器在日常網路中穩定，不要靠自動觸發反覆補救持續失敗的連線。回家、離開辦公室網路，以及 Wi-Fi 切換至行動網路，都是值得觀察的情境。記錄每次切換後開關是否維持、請求是否恢復，以及是否出現反覆重試。若裝置或網路受管理，也要考量系統政策造成的中斷與重新連線，不要把所有自動變化都歸因於 App 內設定。

確認何時停止排查並還原設定

若暫停異常 App 的請求、修正伺服器錯誤或調整一項自動條件後，裝置溫度與待機表現恢復，請在相同條件下再次測試，確認改善可重複出現。若耗電仍明顯異常，可重新啟動裝置並檢查系統正在執行的背景工作；重啟後立即出現的短期波動不應視為長期結論。充電時發熱也可能來自系統充電與工作排程，應與未充電且使用強度相近的情況分開記錄。

排查結束後，請恢復必要的規則與連線策略，撤銷暫時啟用的全流量代理、詳細診斷與高頻測試。留下簡短結論即可：異常時段、相關請求、有效修改與複測結果。沒有可重複的證據時，不建議清除所有設定或重置整台裝置；這些操作成本高，也可能刪除有助於診斷的資訊。若需要進一步詢問，請使用下一章的去識別化紀錄清單描述問題，不要傳送包含完整訂閱內容的備份。

更新後先核對目前使用的伺服器、Config 與系統權限；若 iPad 的結果與其他裝置不同，請比較網路與參數，不要假設同一帳戶中的裝置狀態完全一致。

比對更新前後狀態，不急著重新安裝

調整前先匯出可保存的伺服器與設定資料，確認備份檔案用途清楚，並保留目前設定的副本。備份可能包含敏感內容，請存放在本人可控的位置，不要公開上傳。更新後先確認選取的伺服器是否有變動、Global Routing 是否符合預期、目前 Config 是否仍為原檔，以及系統 VPN 設定是否存在。不要把 App 更新與訂閱自動變更混為一談：兩者可能恰好發生在相近時段，應分開檢查。

若舊設定在更新後出現異常，先使用使用者已有且參數明確的一台伺服器進行最基本的連線測試。基本測試成功，表示底層連線仍可運作，接著再逐項恢復原設定中的規則、DNS 與自動觸發選項；若基本測試也失敗，則回頭檢查系統權限、原始網路與協定參數。不要為了驗證複雜設定而連續覆蓋多個檔案；務必保留可還原的原始檔，並清楚記錄目前測試的檔案名稱。

確認取得來源與首次開啟時的系統允許

iPhone / iPad 版請透過 App Store 更新或重新取得，並核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。系統需求以 App Store 頁面標示為準；重新安裝前請確認資料已備份。iPhone / iPad 版 App Store 售價為 $2.99，一次性付費；Mac / Windows / Android / Linux 版免費。已購項目的復原與帳戶地區問題，請參閱重新取得說明；不要混淆客戶端取得狀態與既有訂閱的存取權限。

其他平台的安裝檔由下載頁透過本站 /dl/shadowrocket/ 路徑提供。Mac 請在「關於這台 Mac」確認是 Apple 晶片或 Intel，再選擇對應安裝檔；首次出現無法驗證開發者的提示時，請在系統「隱私權與安全性」中核對後選擇「仍要打開」。Windows 若遇到 SmartScreen，請確認本站提供的取得路徑後，再查看「其他資訊」與「仍要執行」；受管理的裝置應遵守組織政策。Android 請依系統提示，允許所用瀏覽器安裝未知 App，完成後可撤銷該權限。詳細步驟請參閱安裝與允許設定對照表。

iPad 專項：比較網路、設定與使用情境

同一份訂閱在 iPhone 正常、iPad 異常時，先確認兩台裝置是否真的連上同一個網路，而不是一台使用行動網路、另一台使用 Wi-Fi。公共網路可能要求每台裝置分別認證，手機已完成認證不代表平板也已完成。比對選取的伺服器、協定欄位、Global Routing 與目前 Config，確認不是一台保留舊清單、另一台已經更新。裝置之間可以同步部分資料，不代表所有本機設定與系統權限都始終一致。

只有 Wi-Fi 功能的 iPad 無法直接透過行動網路進行對照；情況允許時，可改連另一個已知可用的 Wi-Fi，或使用本人裝置提供的熱點。保持伺服器與目標網頁不變，觀察問題是否隨網路改變。使用分割畫面時，一側 App 正常不代表另一側 App 的請求使用相同網域或連線路徑，請分別記錄實際目標。連線到內部網頁或印表機時，也要確認目前 Wi-Fi 允許裝置互相存取，不要把區域網路隔離誤判為規則錯誤。

若只在鎖定螢幕、長時間閒置或重新喚醒後發生問題，先查看開關是否仍維持開啟、網路是否需要重新認證，以及 On Demand 是否在喚醒後再次觸發。重新送出一個新請求再判斷，不要只根據舊頁面停留的載入提示下結論。若需要重新建立 VPN 設定，請先完成備份，並只處理用途明確的項目。iPad 不需要另外猜測一套協定參數；同一台伺服器仍應符合原有服務資料，差異應從裝置網路與本機狀態逐步查找。

整理可重現問題的去識別化紀錄

若問題仍未解決，請整理裝置與系統類型、網路類型、開關狀態、Global Routing、發生問題的操作、錯誤訊息原文，以及已完成的對照測試結果。說明「何時開始、哪些目標受影響、關閉連線後是否恢復」，比只說更新後無法使用更有幫助。截圖應遮住訂閱權杖、驗證欄位、QR Code 與不打算公開的伺服器位址；也不要直接傳送完整備份。恢復後請依快速入門教學重新執行匯入、連線與驗證，並記下這次有效的步驟，供下次查閱。