RULE-BASED ROUTING · APP STORE
適用於 iOS / iPadOS 的規則代理用戶端，App Store 正版一次買斷；本官方手冊說明既有設定匯入、規則分流與連線檢查。
DOMAIN-SUFFIX,example.com,PROXY
01 / RULE REFERENCE
先釐清「連線到哪裡」與「哪些請求使用這條連線」。伺服器記錄保存連線參數，Config 保存分流邏輯，Global Routing 則決定目前採用哪種處理方式。修改前先確認所在層級，避免把規則問題誤判為協定故障，也避免反覆替換原本可用的伺服器參數。
在 Config 中檢查 Rule 的排列順序。請求會由上往下比對，符合後交由對應策略處理；較具體的網域條件應排在範圍較廣的條件之前，FINAL 則作為末尾的預設處理。右側片段示範網域後綴、地理位置條件與最終策略，並非適用所有網路的完整設定。PROXY 仍需有可用的代理目標，DIRECT 則仍須由目前網路連上目標。修改後請查看連線記錄，確認實際符合的項目，不要只看頂端的連線開關。
DOMAIN-SUFFIX,example.com,PROXYGEOIP,CN,DIRECTFINAL,PROXY在 Settings 中檢查 On Demand，確認系統連線的觸發條件。它負責決定何時連線，不會決定特定網域最後採用哪項策略；後者仍由 Global Routing 與目前設定決定。建議先在手動連線狀態下驗證既有設定，再逐項加入按需條件，避免同時修改兩個層級而難以找出問題。停用連線後若系統再次嘗試連線，應先檢查此處的條件與系統 VPN 設定，不要立刻刪除伺服器記錄。
SettingsOn Demand在 Add Server 中依照既有伺服器資訊選擇 Type，再填入該協定要求的欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的驗證及傳輸參數各不相同，不能只更換協定名稱，其他內容照搬。匯入後仍須檢查位址、連接埠、驗證資訊及 TLS 等相關參數。協定是否可用取決於用戶端與伺服器兩端是否相符；選取協定名稱本身不會建立服務，也不代表既有連線一定可用。
請以使用者已持有自己的訂閱為前提，在 Add Server 中選擇 Subscribe 並填入既有連結。匯入完成後，先確認群組內容，再選取記錄測試連線；匯入成功只代表內容已讀取，不表示每筆記錄都能正常連線。更新前請保留必要備份，並留意遠端變更是否會取代本機記錄。訂閱內容與 Config 規則屬於不同設定層級；更新伺服器清單後，仍應確認目前設定引用的策略與實際選取的項目。
Add ServerTypeSubscribe在 Config 中選取並編輯要使用的設定，先辨認 General、Rule 與 Hosts 等區段，再處理具體問題。修改前保留一份可用副本，每次只調整一類內容，並確認所選設定確實生效。設定檔可能引用外部規則或資源；檔案存在不代表所有引用項目都已成功載入。使用 iCloud 同步時，也應在另一台裝置確認同步狀態與目前選取的設定；同步用於管理資料，不能取代復原前的人工檢查。
GeneralRuleHostsURL RewriteHTTPS Decryption先從 Home 的 Connectivity Test 開始，再搭配 Settings 中的 Diagnostics 與相關連線記錄檢查問題。測試結果會受測試方式及目前網路影響，不能以單次結果概括所有請求。先確認系統網路可用，再檢查伺服器參數、網域解析與規則比對，最後比較特定請求的表現。Data 可用來觀察流量變化，但不等同於服務供應商的帳單；分享診斷資料前，請遮蔽伺服器位址、驗證資訊及訂閱連結。
Connectivity TestDiagnosticsData設定、代理、直連三種模式分別對應 Config、Proxy、Direct。Config 依目前設定進行分流；Proxy 將一般請求交由選取的代理處理；Direct 則直接連線。排查時先記下原本的選項，再暫時變更一項進行比較。不要混淆 Global Routing 中的 Proxy 與規則中的 PROXY：前者是目前的運作模式，後者是規則符合後採用的策略關鍵字。
切換至 Proxy 後可以連線，切回 Config 後卻發生異常，通常應優先檢查規則、策略引用與解析路徑。兩種模式都失敗時，再核對伺服器參數與網路狀況。切換模式只能協助縮小排查範圍，無法修復失效的驗證資訊，也不能保證目標一定可連線。測試結束後請還原原本設定，避免暫時的排查狀態變成長期設定。
查看 Global Routing 與設定說明 →不要一開始就替換整份設定。先選定一個可重複連線的目標，記下問題發生時的網路、運作模式與伺服器選項，再查看它符合哪些規則。DOMAIN 對應特定網域，DOMAIN-SUFFIX 對應網域後綴範圍，IP-CIDR 則適用於位址範圍；目標條件不同，觀察到的比對結果也可能不同。
REJECT 會阻擋符合條件的請求，但以網域為單位判斷時，無法區分同一網域下不同用途的內容。若頁面主體正常，但圖片、登入或媒體功能異常，應檢查相關資源是否遭到誤擋。USER-AGENT 是否能比對，也取決於請求中是否有可供辨識的資訊；不要假設所有加密流量都能依此欄位判斷。規則越具體，越容易說明影響範圍並還原變更。
依症狀查看故障排除手冊 →02 / DEVICE & STORE
Shadowrocket 是 Apple 平台的付費用戶端，唯一取得管道為 App Store。購買前請在實際使用的裝置上開啟產品頁，確認目前商店是否顯示、售價及相容性。系統需求與購買相容性請以 App Store 頁面標示為準；不要只憑搜尋結果中的名稱判斷產品，也不要將手冊範例當成購買後的預設設定。
在 App Store 完成購買與安裝後，先開啟 Home，確認既有伺服器或訂閱的匯入方式。首次建立連線時，系統可能會要求加入 VPN 設定；請閱讀系統提示，確認要求由 Shadowrocket 發出後再授權。此授權用於建立系統網路連線，並不表示伺服器參數已驗證成功。
建議先在穩定的網路環境中完成匯入、選取與測試，再檢查切換網路後的狀況。若開關可以啟用但仍無法連線，請繼續檢查 Global Routing、選取的記錄與 Config，不要只是不斷點擊連線開關。
查看 iPhone 取得與首次啟用說明 →同一 Apple ID 的已購項目可用來尋找並重新下載 App，購買適用範圍請以 App Store 頁面標示為準。下載完成後，仍須檢查 iPad 上實際保存的伺服器記錄與目前設定；App 復原與設定復原是兩回事，不要因為圖示已出現，就以為所有連線資料都已移轉。
較大的顯示空間可能會改變列表與詳細資料的呈現位置，但 Home、Config、Settings 的檢查方式相同。使用 iCloud 同步資料後，請逐一確認選取的記錄、策略引用與目前運作模式，再開始測試連線。
查看 iPad 已購項目與設定說明 →按鈕會開啟 Shadowrocket 的 App Store 產品頁。商店顯示的當地貨幣價格、相容性與購買提示，才是目前操作的依據。若頁面無法顯示，請先檢查帳號所屬商店與產品供應狀況，避免將商店顯示問題誤判為裝置故障。
查看取得步驟 →第一步，準備使用者既有的訂閱或伺服器資訊，確認要使用 Subscribe、Scan QR Code 或手動 Add Server。第二步，匯入後選取特定記錄，核對 Type 與必填參數。第三步，確認 Global Routing 與目前 Config，再建立連線並存取實際目標。每一步只處理一個層級，便能分別判斷「內容未匯入」、「記錄參數不符」與「規則未符合」等問題。
尚未驗證基本連線前，不要同時加入大量規則、自動觸發條件及額外處理設定。先保留一份可重現的基本設定，再逐項加入所需功能。完整操作流程與常見失敗原因請參閱入門指南；遇到系統授權、連線逾時或解析異常時，請依照故障排除手冊的相關章節繼續檢查。
03 / PURCHASE FACTS
Shadowrocket 是閉源商業 App。本官方網站與官方手冊以可在 App Store 查證的產品資訊說明取得方式，不以名稱相似度取代身分確認。購買前請依序核對開發者、官方圖示與 App ID；安裝後透過 App Store 管理更新與已購項目，連線資料則由使用者依自己的實際設定管理。
932747118產品頁網址末尾的 id932747118 對應 App ID。圖示、開發者與 ID 應一併核對。
搜尋時可能會看到名稱或圖示相似的結果。請先進入產品詳細頁，確認開發者是否為 Shadow Launch Technology Limited，再比對本站顯示的官方圖示與產品頁 App ID。圖示有助於辨識，但光看圖示無法完成確認；開發者名稱與 App ID 是另外兩項必要檢查。確認三項資訊相符後，再查看價格、相容性與購買提示。
即使從已購項目進入，也建議確認 App 名稱與身分資訊，尤其是帳號中有多個名稱相近的 App 時。商店語言、搜尋排序或頁面版面變更，都不會改變辨識所需的三項資訊。手冊步驟用於說明檢查順序，實際按鈕位置請以目前的 App Store 介面為準。
產品是否會在目前商店顯示，與帳號所屬商店及產品供應情況有關。若無法開啟產品頁或搜尋不到，應先檢查目前登入的購買帳號及商店狀態，不要反覆重新安裝 App。不同店面會以當地貨幣顯示價格；本站引用的美國商店價格僅用於說明計費方式，付款前請以裝置實際顯示的金額為準。
如需調整帳號地區、付款方式或處理購買限制，請依照 App Store 目前的提示操作。不要將網頁能否開啟視為帳號一定可以購買的證明，也不要預設同一裝置上的 iCloud 登入狀態與 App Store 購買帳號是同一個帳號。復原已購項目時，請優先確認當時實際完成購買的帳號。
Shadowrocket 採一次買斷，美國商店標價為 $2.99，實際價格請以 App Store 頁面為準。買斷用戶端 ≠ 線路方案。購買 App 後，使用者仍須持有自己的訂閱或伺服器資訊；用戶端負責讀取連線參數、套用規則與處理請求，購買本身不會自動在 Home 加入可用伺服器。
本站不提供、不販售也不推薦節點或訂閱。手冊僅說明如何匯入使用者既有資料、確認欄位對應方式及找出失敗原因。若連線因遠端驗證失效、伺服器停用或服務權限變更而失敗，應檢查既有服務的資訊與狀態，無法靠再次購買用戶端解決。
更換裝置或重新安裝後，請使用原購買帳號登入 App Store 的已購項目，尋找 Shadowrocket 並確認產品後重新下載。若按鈕仍顯示價格，請先檢查購買帳號、商店與購買紀錄，不要直接再次付款。iPhone 與 iPad 的購買適用範圍，以及家人共享是否適用，均請以 App Store 頁面標示為準。
重新下載 App 不代表伺服器記錄與 Config 也已復原。移轉前請保留必要備份，移轉後核對 iCloud 同步結果、目前選取的設定與伺服器。確認資料齊全並完成連線測試後，再清除舊裝置中的相關內容。尋找已購項目的詳細路徑請參閱已購項目復原說明。
App 更新由 App Store 管理，版本資訊與更新紀錄請以產品頁為準。更新前保留可用設定，更新後先重複先前正常的存取步驟，確認伺服器選取、Global Routing 與 Config 都符合預期。若只有個別目標異常，優先檢查規則比對與解析結果；若所有請求同時失敗，再檢查系統網路、連線授權與既有伺服器狀態。
記下問題發生時的簡要狀況，比同時變更多項設定更有助於排查。記錄可包含使用的網路、運作模式、是否只有特定目標失敗及測試結果，但不應包含密碼、私鑰或完整訂閱連結。提供診斷資料前，請檢查截圖與文字中的敏感欄位；問題處理完畢後，移除暫時新增的測試規則與記錄設定，讓設定保持易於維護。
查看購買、復原與使用常見問題 →04 / TECHNICAL NOTES
以下筆記分別說明購買前的費用認知、既有 WireGuard 設定的參數檢查，以及 REJECT 規則的影響範圍。請依實際問題選擇閱讀方向：費用問題回到商店資訊，連線問題檢查協定欄位，只有部分頁面異常時再檢查規則。分開處理不同層級，才能保留清楚的排查依據。
說明一次買斷所代表的用戶端使用權、不同商店以當地貨幣標示的價格，以及用戶端費用與既有線路服務費用的差異。付款前先確認購買項目，不要將 App 安裝完成視為已具備連線資料。
閱讀說明 →以使用者既有的 WireGuard 設定為例，逐項說明身分資訊、Peer、位址範圍與 MTU 的作用。檢查時請區分本機與遠端參數，避免將設定可以儲存誤認為連線一定成功，並妥善保管私鑰。
閱讀說明 →從 DOMAIN-SUFFIX 與 REJECT 的組合出發，說明規則順序、符合條件與誤擋情形。以網域為單位的封鎖無法細分同一網域下的所有內容；加入規則後，應檢查登入、圖片與媒體請求是否受到連帶影響。
閱讀說明 →