依故障現象分類，
而不是從頭猜。

「新增訂閱」只是記下了這個連結，本身不會自動拉取節點。需要再點進這條訂閱項目，點一次「更新」，Shadowrocket 才會真正去造訪連結、抓取節點資料。這是最常被誤認為「匯入失敗」的一步。

依順序排查：① 訂閱連結是否已過期或達到流量上限，需聯絡訂閱服務商確認；② 複製連結時是否帶了多餘的空格、換行或被截斷，重新複製一次確認是完整的一行；③ 用瀏覽器直接打開這個連結，看回傳的是正常的節點資料，還是登入頁／錯誤頁／空白頁。

如果開啟了 iCloud 自動同步，節點資料會保留一份 iCloud 端紀錄，僅在本機刪除不會清除這份紀錄。需要進入 Data → iCloud，找到對應伺服器節點，刪除 iCloud 端的備份和同步紀錄才能真正生效。

常見原因是螢幕反光或 QR 碼本身解析度不夠——把顯示 QR 碼的螢幕亮度調到最高，相機稍微拉遠一點對焦，通常能解決。如果反覆失敗，改用複製連結手動貼上的方式更穩妥。

通常是目前選中的節點連線逾時。回到節點清單，點右上角「測速」圖示重新測一遍延遲，換一個延遲正常（綠色／黃色）的節點重試，不代表軟體本身出了問題。

多數是目前節點不穩定或伺服器端異常，先切換到延遲較低的其他節點重試；如果訂閱裡所有節點都出現同樣情況，大概率是訂閱服務商那邊的問題，需要聯絡對方確認伺服器狀態，用戶端本身無法解決。

可能是之前誤點了「不允許」。進入系統「設定 → 一般 → VPN 與裝置管理」，檢查是否已經存在 Shadowrocket 相關的 VPN 設定紀錄並處於關閉狀態，或者刪除已有紀錄後重新打開 Shadowrocket 觸發一次新的授權請求。

如果手機長時間處於「低電量模式」，iOS 系統可能會限制背景網路活動，導致連線被動斷開——這是系統省電策略，不是軟體故障。如果需要連線穩定性優先，可以關閉低電量模式，或在系統「電池」設定裡為 Shadowrocket 調整相關限制。

先切換 Wi-Fi 和行動網路分別測試一次，排除目前網路本身的問題；再確認訂閱是否已過期。如果依然全部逾時，把 設定 → 延遲測試方法 改成 CONNECT 方式重新測試，這種方式比預設方式更接近真實連線過程，測出來的結果參考價值更高。

如果測速時全域路由處於 Configuration 模式，測速請求本身可能被規則判定為直連（比如測速用的網域恰好被設定成 DIRECT），導致測出來的延遲其實沒有經過節點。建議測速前暫時切換到 Proxy 模式，測完再切回來，避免規則干擾。

延遲反映的是「連線建立的回應速度」，不代表頻寬或實際吞吐量。延遲低但速度慢，通常是節點頻寬被多人共用導致壅塞，或者訂閱服務商本身的線路品質問題，可以換一個節點對比，如果普遍如此需要聯絡服務商。

先檢查系統「設定 → 你的 Apple ID → iCloud」裡是否已經允許 Shadowrocket 使用 iCloud 雲碟，以及 iCloud 雲碟本身是否已開啟；確認網路連線正常。如果設定都正常但仍然同步失敗，通常是 iCloud 服務本身暫時異常，可以嘗試手動刪除 iCloud 備份後重新同步一次。

進入 Config 頁面，點「還原預設設定」，即可還原到內建的 default.conf 預設規則檔。還原後再重新疊加自己需要的自訂規則，建議每次只改一小部分並測試，避免一次大幅修改導致難以定位問題。

如果開啟了「儲存到 iCloud」，先檢查系統 iCloud 設定裡 Shadowrocket 的 iCloud 雲碟權限是否正常；再用系統「檔案」App 打開 iCloud 雲碟裡的 Shadowrocket 目錄，確認 Modules 資料夾內檔案是否處於「未下載」狀態（iCloud 本機快取被清理時會這樣），等待自動下載或手動點一下下載即可還原。