Shadowrocket · 官方手冊
Shadowrocket 疑難排解
先確認問題發生在哪個步驟，再檢查相應設定。購買與安裝請以 App Store 頁面為準；匯入與連線則以使用者已有的訂閱或伺服器資訊為前提。展開問題即可查看排查順序。
App Store · 購買紀錄
正版核驗與購買
先核對產品頁，再確認自己的購買帳號。價格、相容性與購買適用性皆以商店頁面為準。
在 App Store 搜尋不到 Shadowrocket，先檢查什麼？
先從下載指南開啟 Shadowrocket 的 App Store 產品頁，再確認目前 App Store 登入帳號的國家或地區。搜尋不到不代表裝置不相容，也可能是目前商店未顯示此 App。若產品頁顯示無法使用，請先閱讀提示並確認帳號地區；如需變更，請依 Apple 帳號的國家或地區設定流程辦理，並先處理帳戶餘額、有效訂閱及家庭群組限制。是否可購買，請以目前商店頁面為準。
如何確認開啟的是 Shadowrocket 正版產品頁？
請一併核對 App 名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、官方圖示，以及產品頁網址中的 id932747118。App ID 為 932747118，圖示應與本站使用的官方圖示一致；請勿只憑搜尋結果中的名稱判斷。購買前也請查看產品頁的相容性與價格欄。系統需求以 App Store 頁面標示為準，取得與更新皆透過 App Store 完成。
換機或重新安裝後，需要再次購買嗎？
先使用原購買帳號登入 App Store，在帳號頁面的已購項目中尋找 Shadowrocket。找到後依商店顯示的重新下載按鈕操作，通常不必再次購買。若仍顯示價格，請先核對媒體與購買項目使用的帳號、原購買紀錄及目前商店，不要直接再次付款。重新下載 App 與復原設定是兩回事；原裝置上的伺服器資訊和設定需另外留存，不能假設會隨購買紀錄自動復原。
一次買斷包含哪些內容？
一次買斷是購買 Shadowrocket 用戶端的使用資格。用戶端一次買斷 ≠ 線路方案；購買 App 不會自動取得伺服器資訊或訂閱。美國商店定價為 2.99 美元，各商店以當地貨幣標示，實際價格請以付款前的 App Store 頁面為準。後續設定須以使用者已有的訂閱或伺服器資訊為前提；本站不提供、不販售、不推薦節點或訂閱，也不處理相關服務費用。
在哪裡確認 iPad、Mac 與 Apple TV 的購買適用性？
請先查看同一個 App Store 產品頁上的相容性與購買說明。iPhone 和 iPad 是本手冊主要說明的操作裝置；Mac、Apple TV、Apple Vision 的裝置支援、系統需求及購買適用性，皆以 App Store 頁面標示為準。要在其他裝置上取得 App，請先使用自己的原購買帳號查看已購項目；家庭共享是否適用，也請以商店頁面和家庭設定為準，不要直接假設在某一裝置購買後，所有裝置都適用。
Home · Settings · VPN
安裝與首次開啟
安裝、匯入與系統授權是不同步驟。先確認 App 能正常開啟，再檢查連線條件。
iPhone 安裝完成後，首次開啟應先做什麼？
先確認 App 能正常開啟，再準備已有的訂閱或伺服器資訊。透過 Home 中的新增入口完成匯入，確認選取的伺服器與 Global Routing，再嘗試開啟連線。首次建立連線時，系統可能會要求新增 VPN 設定；確認是由 Shadowrocket 發起後再授權。安裝完成不代表網路已設定妥當，也不代表所有請求都會經過代理。系統需求以 App Store 頁面標示為準。
新增 VPN 設定時出現的系統提示是什麼意思？
這是系統要求確認是否授權建立 VPN 設定，並非購買提示。允許後，Shadowrocket 才能透過系統網路延伸功能建立連線，並套用所選的路由設定。請先確認提示是在 App 內開啟連線時出現，再依系統要求驗證。若先前拒絕授權，可返回 App 再試一次，並檢查系統 Settings 中的 VPN 設定狀態；若受到裝置管理限制，請洽裝置管理者確認可允許的設定，反覆切換開關無法解決問題。
iPad 可以安裝嗎？操作方式和 iPhone 有哪些不同？
可先在 iPad 的 App Store 開啟相同的產品頁，確認裝置符合相容性要求；系統需求以 App Store 頁面標示為準。使用自己的原購買帳號時，請先從已購項目重新下載。iPad 的橫向版面和可視範圍可能與 iPhone 不同，但仍可依 Home、Config、Settings 等英文介面詞找到相應功能。匯入後請重新檢查目前的伺服器與設定，不要只因帳號相同就認為連線設定已完整移轉。
介面是英文，該如何對照手冊？
本手冊保留英文介面名稱，方便直接尋找。Home 用來查看伺服器與連線狀態，Config 用來管理設定檔，Settings 用來檢查設定，Data 用來查看流量統計。Global Routing 中的 Config、Proxy、Direct 分別代表依設定檔分流、代理與直連三種模式。看到 Add Server 或 Subscribe 時，請依手冊的匯入步驟操作；不要將頁面名稱 Config 與 Global Routing 中的 Config 選項混為一談。
連線開關無法開啟，或開啟後立即關閉，該怎麼辦？
先確認已完成系統 VPN 授權，再確認選取了有效的伺服器。暫時關閉其他正在執行的 VPN 連線，檢查系統是否有裝置管理限制，然後再試一次。若先前修改過設定，請先記下目前設定，再切換至已知可用的設定進行比對。重新啟動裝置後仍無法連線，可查看 App 日誌中的設定或連線錯誤。不要一開始就刪除 App；刪除前請先保存已有的訂閱網址、伺服器資訊與設定，避免排查時遺失資料。
Subscribe · Add Server · Scan QR Code
訂閱與節點匯入
分別確認匯入成功與連線成功。以下步驟僅用於檢查使用者已有的訂閱或伺服器資訊。
Subscribe 匯入失敗，應依什麼順序檢查？
先確認使用的是自己已有的訂閱網址，並檢查複製時是否混入空格、換行或漏掉參數。接著確認目前網路能否連上該網址，以及回傳內容是否為用戶端可識別的訂閱資料，而非登入頁面、錯誤訊息或一般網頁。再確認訂閱是否已失效，以及原提供者是否變更網址或格式。瀏覽器能開啟連結只代表收到回應，不表示內容正確；排查時請勿將完整訂閱網址貼到公開頁面。
使用 Add Server 手動新增時，哪些欄位最容易填錯？
先選擇與現有伺服器資訊相符的協定，再逐項核對位址、連接埠與驗證欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等協定所需欄位各不相同，不能只更改協定名稱，卻沿用其他協定的參數。若伺服器使用 TLS，也請依原始資料核對 server name 等相關項目。位址欄通常填寫主機名稱或 IP，不應填入完整網頁網址；請勿憑猜測修改加密方式、驗證資料或傳輸設定。
Scan QR Code 匯入成功，為什麼還是無法連線？
Scan QR Code 成功只代表已識別 QR Code 內容並建立項目，不代表伺服器目前可用。匯入後開啟該項目，核對協定、位址、連接埠與驗證資訊，再選取項目執行 Connectivity Test。若逾時，分別檢查目前網路、伺服器狀態及參數是否過期；若測試有回應但網頁仍無法開啟，再檢查 Global Routing、DNS 與實際請求的路由結果。QR Code 可能包含認證資料，分享截圖前請先移除。
更新訂閱後項目有所變動，如何避免誤刪原有設定？
更新前先記下目前選取的項目與訂閱群組，必要時保留本機設定副本。更新後檢查項目數量、名稱是否變動，以及目前使用的伺服器是否仍在列表中，再重新選取可用項目進行測試。訂閱更新會依回傳內容更新所屬項目，但不能假設手動修改一定會保留；重要的自訂設定請另外記錄。Subscribe 的伺服器列表與 Config 的規則設定應分開檢查，不要以為更新訂閱也會同步更新所有規則。
如何判斷訂閱是否失效？提交排查資訊時要隱藏哪些內容？
先記錄問題發生在取得訂閱、解析內容或連線至伺服器的哪個階段，再查看 App 提示。若網址回傳驗證錯誤、空白內容或格式錯誤，應向原提供者確認訂閱是否有效、格式是否正確；不能只因某個伺服器逾時，就判定整份訂閱失效。提交排查資訊時，只保留必要的錯誤文字、協定和操作步驟，並隱藏完整訂閱網址、驗證參數、密碼及 QR Code。需要比對資料時，請使用已去識別化的內容，不要公開可直接使用的憑證。
Global Routing · Connectivity Test · DNS
規則分流與疑難排解
分別檢查系統連線、伺服器回應、網域解析與規則比對。使用同一個目標進行比對，才能判斷設定變更是否有效。
Global Routing 中的 Config、Proxy、Direct 該怎麼選？
Config 模式會依目前設定中的規則分配請求，適合已確認規則內容後日常使用；Proxy 模式會將交由用戶端路由處理的請求以代理方式處理，可用來比對規則是否影響連線；Direct 模式會使用直連路徑，可用來檢查原始網路。選擇 Config 前，請先在 Config 頁面確認已啟用的檔案。這三種模式決定路由方式，無法修正錯誤的伺服器參數；排查完成後，請恢復自己的正常設定。
顯示已連線，但網頁無法開啟，應先檢查哪一項？
顯示已連線只代表系統已建立連線，不保證伺服器、DNS 和規則都正常。先確認目前網路本身能否開啟一般網頁，再測試目前使用的伺服器；接著用同一個目標頁面比對 Proxy 與 Config。只有 Config 失敗時，請檢查命中的規則策略和所選設定；兩者都失敗時，繼續核對伺服器參數、DNS 與日誌。每次只變更一項設定並記錄結果，避免同時改動多處而無法判斷原因。測試完成後請恢復原本的路由模式。
Connectivity Test 正常，為什麼實際連線仍失敗？
Connectivity Test 的結果取決於測試方式與目標，只能表示該次測試收到回應，不代表所有網域、協定和請求都能正常通過。先確認實際連線使用的是同一台伺服器，再查看規則是否將請求分配至 DIRECT、PROXY 或 REJECT。若只有特定網域失敗，請檢查 DNS 解析、目標網站狀態及相關規則；若所有頁面都無法開啟，優先檢查實際代理連線與驗證參數。不要把單次延遲測試結果當成整體網路正常的證明。
DNS 解析失敗或網域無法開啟，該如何排查？
先查看日誌是否出現解析錯誤，並記錄目前設定使用的 DNS。檢查解析服務能否透過目前網路或路由連線，再比對近期是否修改過 DNS、Host 或相關規則。一次只還原一項已知可用的設定，重新建立連線後測試同一網域；不要連續填入多個不熟悉的解析位址。直接連線至 IP 只能作為有限的比對方式，因為網站可能依賴網域和 TLS；即使 IP 有回應，也不代表整個網頁能正常開啟。
規則似乎沒有生效，該檢查設定檔還是伺服器？
先確認 Global Routing 設為 Config，再到 Config 檢查目前啟用的檔案。規則通常依序比對，最先符合的規則會決定策略；DOMAIN-SUFFIX、GEOIP 等條件，以及 FINAL 兜底規則的位置，都會影響結果。接著查看日誌中的實際請求與策略，確認規則指定的代理策略有可用伺服器。只切換伺服器不會自動修正規則順序。用來說明語法的 example.com 是示範網域，不應視為適用所有網站的通用規則。
耗電增加、速度變慢或更新後出現異常，該如何排查？
先在相同網路、使用相同伺服器並連線至相同目標的情況下比對，排除背景下載和訊號變化的影響。查看是否啟用了頻繁測試、詳細日誌或 On Demand，視需要調整並觀察；不要只憑系統電池頁面單次顯示的用電比例判斷原因。更新後先重新建立連線，檢查目前設定與授權狀態，再逐項還原近期變更。若異常持續，請保留已去識別化的日誌與重現步驟，繼續參閱疑難手冊排查；重新安裝前請先保存設定，避免資料遺失衍生新問題。