Shadowrocket 疑難排解

Shadowrocket 支援 iPhone 與 iPad，系統需求及購買適用範圍請以 App Store 頁面標示為準。在 iPad 上使用原購買帳號登入 App Store，先查看已購項目，再確認產品詳細頁中的相容性。iPad 的顯示空間與部分列表排列可能不同，操作時仍可依 Home、Add Server、Config 和 Global Routing 等介面名稱定位。安裝完成後，請確認伺服器列表與目前設定；已購買 App 不代表訂閱資料也已自動移轉。

首次啟用連線時，系統可能會詢問是否允許 Shadowrocket 加入 VPN 設定。這是用戶端建立系統網路通道所需的授權步驟，與購買驗證或更新訂閱無關。確認提示是由 Shadowrocket 發出後，依系統指示允許並完成裝置身分驗證；不要向他人提供裝置解鎖資訊。若先前曾取消，可返回用戶端重新嘗試連線，並在系統 Settings 的 VPN 相關頁面檢查設定狀態。完成授權後，仍須選擇有效伺服器並確認路由模式。

先依固定介面名稱定位：Home 查看伺服器列表與連線狀態，Add Server 新增現有伺服器資訊，Subscribe 用於訂閱類型，Config 管理設定檔，Global Routing 選擇整體路由方式。系統提供的 App 語言設定入口與可選語言，請以裝置 Settings 和目前 App 顯示為準；若沒有可切換的選項，可繼續依照這些英文名稱操作。不要只憑按鈕位置判斷功能，不同裝置的版面可能不同，修改前先確認欄位名稱。

先準備向你的服務商取得的訂閱，或備妥現有伺服器的完整參數；再透過 Add Server 匯入或填寫，並返回 Home 確認列表中確實出現資料。接著選擇要使用的伺服器，確認 Global Routing；若需要規則分流，也要確認目前啟用的 Config。最後開啟連線並完成系統授權，再以實際連線結果驗證。資料尚未匯入前不要反覆切換開關，也不要一次修改多個進階選項，否則難以判斷問題出在哪個步驟。

開啟 Shadowrocket 的 App Store 產品詳細頁，查看相容性欄位；系統需求一律以 App Store 頁面標示為準。更新也請透過 App Store 完成；先確認裝置有足夠可用空間、網路可以正常連上商店，並核對購買帳號。不要只因教學中的介面與目前裝置不同，就認定安裝有誤；介面可能因裝置與 App 更新而改變。更新前先備份必要設定，更新後再確認目前的 Config、伺服器選擇與連線狀態，避免把設定變動誤認為訂閱失效。

先確認使用的是向你的服務商取得的完整訂閱網址，而不是帳號登入頁、說明頁或遭截斷的分享文字；檢查複製時是否混入空格、換行或標點。接著確認裝置日期與時間，並確認目前網路可以連上服務商的訂閱網址。若出現驗證失敗或內容無效的提示，請向服務商確認網址效期、存取權限與輸出格式。不要將含有驗證資訊的完整連結貼到公開討論區；排查時保留錯誤提示即可，無須公開訂閱內容。

在 Add Server 中先選擇與伺服器端一致的 Type，再依該協定要求填寫位址、連接埠與驗證欄位。不同協定也可能需要 TLS、傳輸方式、Server Name 或其他附加參數，不能只複製位址與連接埠就認為資料完整。欄位值請以現有伺服器資料為準，不要依協定名稱猜測密碼、加密方式或開關狀態。儲存後返回 Home 確認項目存在，再進行連線測試；若失敗，優先逐欄比對，不要反覆更換協定類型。

在 Home 找到對應的訂閱群組，使用該群組提供的更新功能；實際入口請以目前介面顯示為準。更新前記下目前使用的項目，更新後確認是否完成、群組內容是否變更，以及原項目是否遭到改名或移除。更新訂閱會讀取服務商目前回傳的內容，無法保證每個舊項目都會保留。若連線選擇有變，請重新選取有效項目再測試；不要為了重新整理而重複匯入同一網址，以免留下多個內容相近的群組。

先展開對應群組，檢查搜尋、篩選或隱藏設定是否限制了顯示；再確認剛才更新的是目標訂閱，而非另一組資料。若群組確實為空，請查看更新結果，並向服務商確認訂閱效期與目前回傳內容。匯入成功只代表匯入流程已完成，不表示每個項目都有效，也不保證服務商每次都回傳相同數量。刪除群組前先保留可還原的資料，避免排查顯示問題時遺失原網址；不建議連續重複匯入來試錯。

Subscribe 通常用於取得與更新伺服器項目，Config 則用於管理規則及相關設定；兩者不能簡單視為同一項更新作業。更新伺服器訂閱後，應另外確認目前啟用的 Config 及其來源，不能因此認定規則也已同步。實際匯入內容取決於資料本身的格式。修改或替換 Config 前先備份，啟用後再確認 Global Routing 是否設為 Config，並檢查重要規則與 FINAL；只在列表中看到檔案，不代表該檔案已生效。

Global Routing 有三種模式：設定檔 Config、代理 Proxy、直連 Direct。Config 會依目前設定中的規則決定連線策略，適合需要規則分流的情況；Proxy 會讓由用戶端處理的連線使用所選代理；Direct 則採直接連線。請依實際需求選擇，不要把 Proxy 當成解決所有連線問題的開關。排查時可先記下原設定，再暫時切換作為對照；驗證完成後恢復原設定，並區分介面中的 Proxy、Direct 與規則策略關鍵字 PROXY、DIRECT。

先確認 Home 已選取有效伺服器，再查看系統是否仍在等待 VPN 設定授權或裝置身分驗證。接著檢查 Settings 中是否有其他正在啟用的 VPN 設定、裝置管理限制或組織政策；受管理的裝置應依管理規範處理。記下用戶端顯示的具體錯誤，再嘗試關閉連線並重新開啟 App。不要一開始就刪除所有系統設定或重置網路；確認影響範圍並保存必要資訊後，再考慮進一步檢查系統。

連線狀態只表示通道已建立，不代表目標網站、伺服器與 DNS 都正常。先關閉連線，確認基本網路可以瀏覽一般網頁；再啟用連線，檢查所選伺服器與訂閱是否有效。記下 Global Routing 和目前的 Config，分別測試不同目標，判斷是全部失敗還是部分失敗。必要時切換 Wi-Fi 與行動網路進行比對。每次只變更一個變數；若只有在 Config 模式下失敗，優先檢查命中的規則與 DNS，不要立刻刪除整份設定。

先確認 Global Routing 設為 Config，再確認目標設定檔已啟用。規則通常由上而下比對，第一個符合的項目會決定策略，因此前面的寬泛規則可能先於後面的精確規則生效。檢查 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 等條件是否符合實際目標，並確認策略拼寫及引用有效。FINAL 應放在規則末尾，用來處理前面未命中的連線。修改後以新建立的連線進行驗證；既有連線可能仍沿用原本的處理結果。不要只憑一次連線就判定整份規則失效。

先在系統電池頁面比較相近時段的使用情形，同時考量螢幕使用時間、訊號強弱、實際傳輸量與網路切換。頻繁重新連線、持續大量傳輸、密集測試或長時間記錄詳細日誌，都可能增加處理負擔。確認 On Demand 設定是否符合需求，減少不必要的重複測試；為診斷而暫時開啟的詳細記錄，使用後請恢復原設定。協定名稱本身無法直接決定耗電高低，應在相同網路與工作情境下比較；不要只因 VPN 狀態持續顯示，就認定用戶端運作異常。

Connectivity Test 用於輔助判斷特定測試條件下的連線狀況，不代表所有網站、App 與傳輸方式都能正常使用。Data 中的流量紀錄也須搭配統計範圍與重設狀態解讀，不能取代服務商的用量或效期紀錄。測試通過但目標無法存取時，請繼續檢查目標網域、規則命中與 DNS；測試失敗但部分內容可正常存取時，則確認測試目標本身。向服務商回報時，請說明網路類型、無法存取的目標與錯誤情形，並遮蔽訂閱網址及驗證欄位。