Shadowrocket 疑難排解
先判斷是購買、匯入還是連線問題，再依序檢查。以下操作皆以使用者已有自己的訂閱或伺服器資訊為前提；每次只變更一項設定，並保留原始值以供比對。
- 4 類問題
- 20 項檢查說明
- 點選問題展開解答
PURCHASE
正版確認與購買
先確認產品與購買帳號，再處理搜尋、付款及已購項目復原問題。購買入口與設定來源是兩回事。
在 App Store 搜尋不到 Shadowrocket，先檢查什麼？
先從正版取得說明前往指定的 App Store 產品頁，並以 App ID 932747118 核對。若搜尋不到，請確認目前用於媒體與購買項目的 Apple 帳號所屬商店地區，再檢查「螢幕使用時間」中的內容與隱私權限制是否限制了 App 年齡分級。若能開啟產品頁但無法購買，請確認付款方式及帳號提示；搜尋結果不能用來判斷是否已購買。
如何確認 App Store 上的 Shadowrocket 是正版？
請在 App Store 產品頁核對三項資訊：App 名稱 Shadowrocket、開發者 Shadow Launch Technology Limited，以及網址中的 App ID 932747118；並確認圖示與本站展示的官方圖示相同。請勿只憑中文別稱或搜尋排序判斷。購買價格、相容性與更新紀錄以產品頁為準；確認無誤後，再於 App Store 購買與安裝。
一次買斷 Shadowrocket，包含連線服務嗎？
一次買斷客戶端 ≠ 購買連線方案。App Store 收取的是 Shadowrocket App 的購買費用；使用 App 須已有自己的訂閱或伺服器資訊。美國區價格約為 2.99 美元，各商店以當地貨幣顯示，實際金額請以購買頁面為準。本網站是官網與官方手冊，僅說明客戶端操作，不提供、不販售或推薦節點及訂閱。
換新裝置或重新安裝後，需要再次購買嗎？
請先確認 App Store 目前用於媒體與購買項目的 Apple 帳號，與當初購買 Shadowrocket 的帳號相同，再到已購項目或 App 列表中尋找並重新下載。若仍顯示價格，請先確認購買紀錄、商店地區及帳號狀態，勿急著重複付款。恢復 App 購買項目不代表 App 內設定也會復原；舊裝置上的訂閱、Config 與手動項目應另外備份，並確認復原結果。
商店地區不符，該從哪裡檢查與調整？
請在系統 Settings 的 Apple 帳號中開啟「媒體與購買項目」，查看帳號的國家或地區，而非只修改裝置語言或地區格式。若確實需要調整，請透過帳號頁面的國家或地區選項，依 Apple 提示確認餘額、現有訂閱及付款資料等條件。變更可能影響已購內容與付款方式；請先閱讀系統提示，產品供應情況仍以對應的 App Store 頁面為準。
FIRST OPEN
安裝與首次啟用
先確認裝置相容性與系統授權，再檢查 App 內項目。出現系統提示時，請先讀完再操作。
iPad 可以安裝 Shadowrocket 嗎？
可以。請先在 iPad 的 App Store 開啟同一個 Shadowrocket 產品頁，查看相容性欄；系統需求以 App Store 頁面標示為準。已購買的使用者，請先用原購買帳號確認已購項目。iPad 版面會隨螢幕尺寸與方向改變，但訂閱、伺服器參數與 Config 仍須分別確認；以為同一帳號購買 App 後，設定就會自動完整同步是不正確的。
首次開啟時，為什麼會要求加入 VPN 設定？
Shadowrocket 建立連線時，需要取得系統許可才能加入 VPN 設定；系統可能要求輸入裝置密碼或進行身分驗證。請先確認操作是由剛安裝的 Shadowrocket 發起，再依系統提示處理。這項授權只允許 App 建立相應的網路連線，不代表伺服器資訊已有效。授權後回到 Home，確認已選取的項目與 Global Routing，再開啟連線開關並測試實際連線。
Home 的連線開關無法開啟，或一開就關閉，該怎麼辦？
請先確認已有可用的伺服器項目且已選取，再確認首次 VPN 設定授權已完成。接著前往系統 Settings 的 VPN 管理位置，查看是否有設定衝突；暫停其他正在建立的 VPN 連線後再試。若仍立即中斷，請查看 App 內的錯誤提示，記下發生時間與目前網路。請勿反覆刪除設定，先保留既有參數，以便分辨是授權、設定或伺服器問題。
介面是英文，要如何對照使用說明？
本手冊保留 App 介面用語的英文原文，可依 Home、Config、Settings 與 Global Routing 對照查找，不必先變更語言才能操作。若要調整顯示語言，可在系統 Settings 查看 Shadowrocket 是否提供偏好語言選項；實際可選項目以裝置與 App 顯示為準。協定名稱及規則關鍵字仍維持英文，請勿將中文說明填入伺服器類型或規則欄位。
更新 App 前，應先備份哪些內容？
App 更新透過 App Store 完成。更新前，建議備份既有訂閱來源、手動伺服器參數及目前使用的 Config，並妥善保管其中的密碼或權杖。更新後先確認目前項目、Global Routing 與連線開關，再測試常用連線。可查看 App Store 的更新說明了解 App 變更；重新安裝不應是日常排查的第一步，以免遺失尚未備份的本機設定。
IMPORT
訂閱與節點匯入
分開檢查取得內容、解析項目與建立連線。匯入成功只是第一步，還須確認參數並測試實際連線。
既有訂閱匯入失敗，如何判斷是連結還是網路問題？
先確認既有訂閱連結是否完整複製，尤其是問號後的參數；移除前後空格、換行及通訊軟體附加的標點。確認加入的是訂閱入口，而非帳號管理網頁。接著檢查目前的基本網路能否正常連線，並確認訂閱來源仍有效。錯誤可能來自請求失敗或內容解析失敗；保留錯誤訊息即可，請勿公開包含權杖的完整連結。
訂閱新增成功，列表卻沒有伺服器項目，該怎麼辦？
新增訂閱入口不代表已成功取得有效項目。請先手動更新一次該訂閱，查看是否出現網路或解析錯誤，再確認來源實際回傳的是客戶端支援的訂閱內容，而非登入頁、到期提示或空白內容。檢查帳號是否有效及連結格式時，只需核對自己已有的資料。請勿重複新增相同連結來排查，以免留下多個難以區分的訂閱群組。
如何更新既有訂閱，同時保留可用的本機修改？
在 Home 找到對應訂閱，使用該項目的更新功能；完成後確認伺服器列表與目前選取項目，實際選單位置以 App 顯示為準。更新可能取代由訂閱管理的項目，因此請先記下自行調整過的參數，並將需要長期保留的手動項目分開管理。自動更新是否執行，取決於 App 設定與系統執行條件；排查時請以手動更新一次的結果為準。
Scan QR Code 掃描失敗，或辨識後無法連線，該怎麼辦？
先檢查系統相機權限、QR Code 是否完整清晰，以及掃描內容是否為支援的伺服器分享資訊。辨識出內容後，仍須確認協定類型、伺服器位址、連接埠及驗證欄位；掃描成功只代表已讀取內容，不代表連線已驗證。請逐項比對自己已有的資料，勿將 QR Code、密碼或權杖張貼到公開頁面；也不要把訂閱 QR Code 誤認為單一伺服器項目。
使用 Add Server 手動新增時，哪些參數必須一致？
在 Add Server 中，先選擇與既有伺服器資訊相符的協定類型，再填入位址、連接埠及該協定要求的密碼或其他驗證欄位。若資料包含 TLS、Server Name、傳輸方式或路徑，也要逐項填寫相符，不能只複製位址和連接埠。Shadowsocks、VLESS、Trojan 等協定的欄位意義各不相同；參數不明確時請核對原始資料，勿靠切換協定類型或關閉憑證驗證來試錯。
ROUTING & DIAGNOSTICS
規則分流與故障排查
連線狀態、規則比對與實際連線結果須分開確認。先記下目前設定，再以相同目標及網路條件重新測試。
Global Routing 中的 Config、Proxy、Direct 該如何選擇？
設定（Config）會依目前設定中的規則決定連線策略，適合已確認規則與預設策略的情況；代理（Proxy）主要用來以代理模式測試所選伺服器；直連（Direct）則用來以直連模式檢查基本網路。切換模式無法修正錯誤的伺服器參數。排查時先記下原本模式，一次只改一項，測試後再還原，避免誤以為切換模式就已修好規則或伺服器。
顯示已連線，但網頁仍無法開啟，該依什麼順序排查？
先中斷連線，確認基本網路可正常使用，再重新連線並確認目前伺服器與 Global Routing。接著查看連線紀錄，判斷請求是依 DIRECT、PROXY 還是 REJECT 處理，並確認是否只有特定網域無法連線。Connectivity Test 可協助檢查項目，但測試結果不代表所有網頁都能正常開啟。最後依錯誤資訊檢查驗證、DNS 與規則，每次只調整一項。
懷疑 DNS 設定導致網域無法開啟，該檢查哪裡？
先分辨是網域解析失敗還是連線建立失敗：查看對應請求的紀錄與錯誤提示，再確認目前 Config 中的 DNS 設定及相關覆寫設定。若最近修改過解析方式，請記下原值後逐項還原測試，避免同時更改伺服器與 DNS。不同網路的 DNS 可用性可能不同，應在目前網路環境下驗證；能連上某個 IP 位址，不代表使用 TLS 的網域也一定能正常連線。
規則未如預期生效，如何確認比對順序？
先確認 Global Routing 設為 Config，且目前啟用的是剛編輯的設定。接著從連線紀錄確認實際請求的網域、符合的規則與最終策略，並依設定順序檢查前面的規則是否已先符合。DOMAIN-SUFFIX 比對網域後綴，IP-CIDR 比對 IP 位址範圍，FINAL 則在前面的規則都未符合時作為預設處理。修改 REJECT 規則前，請先確認目標範圍，以免連同同一網域的必要請求一併拒絕。
持續連線時耗電增加，如何檢查 On Demand 與背景活動？
先在系統電池用量中查看同一時段的耗電情況，再確認是否有大量背景傳輸、頻繁重新連線或持續測試。On Demand 會依條件觸發連線，請檢查條件是否造成連線反覆建立，而不要把它當成省電開關。耗電量會受網路訊號、流量、協定及伺服器回應等多項因素影響，不能只憑協定名稱判斷；請維持相近的使用條件，逐項調整並比較結果。