Shadowrocket 自訂規則寫法與優先順序：由上而下比對及 FINAL 後備規則
從 DOMAIN-SUFFIX、IP-CIDR 的條件寫法開始，確認規則順序，再分辨 PROXY、DIRECT、REJECT 的用途。適合排查請求為何未採用預期策略，以及如何安排 FINAL，讓規則更容易理解和維護。
閱讀規則說明 →
官方手冊
App Store 正版核對
Shadowrocket 使用說明
適用於 iPhone / iPad 的 Shadowrocket 官方手冊。從 App Store 核對一次性買斷的用戶端，再匯入現有資訊，依規則分流檢查連線。
Shadowsocks
Trojan
Hysteria2
Global Routing
裝置與商店入口
先確認裝置，再查看購買入口
Shadowrocket 僅於 Apple 平台發行，唯一取得管道為 App Store。請先確認裝置相容性、目前的商店帳號與 App 身分，再進行購買和初次設定。
iPhone
前往 App Store 查看 Shadowrocket，核對開發者與 App ID 後再購買。首次開啟時，先熟悉 Home、Global Routing 和 Add Server；連線前準備好自己的訂閱或伺服器資訊。系統需求請以 App Store 頁面標示為準。
查看 iPhone 取得說明 →iPad
若已使用同一個 Apple ID 購買，請先到 App Store 的已購項目中尋找。iPhone 與 iPad 的通用購買條件、相容裝置及系統需求，請以 App Store 頁面標示為準；復原 App 後，還需另外檢查設定與連線資訊。
查看 iPad 取得說明 →分別核對搜尋結果與商店頁面
App 名稱相近，不代表是同一個 App。進入產品詳細頁後，請同時確認官方圖示、開發者 Shadow Launch Technology Limited，以及連結中的 App ID 932747118。下方商店按鈕會直接開啟此產品頁；開啟頁面不代表已完成購買，付款前仍須確認目前商店頁面顯示的價格與相容性。
若搜尋不到，請先查看目前用於購買的 App Store 帳號及其國家或地區，不要只憑裝置語言判斷商店所屬地區。產品連結中的商店路徑，也不等於目前帳號的購買地區。App 是否顯示、能否購買及付款提示，請以目前帳號實際顯示的商店頁面為準。
首次連線時出現的 VPN 設定授權，是系統為用戶端建立網路連線設定時的確認步驟。確認目前操作來自 Shadowrocket 後，再閱讀並處理系統提示。完成授權僅表示系統允許建立設定，不代表伺服器參數、訂閱狀態或規則已正確；後續仍須依教學檢查。
設定與連線
依使用情境了解核心功能
請先區分連線資訊、Global Routing 與設定檔。伺服器決定連線目標，路由模式決定處理方式，規則則決定個別請求採用的策略。
Rule：依序比對請求
規則分流可為不同請求選擇處理策略。在 Home 將 Global Routing 設為 Config 後，再到 Config 確認目前使用的設定檔。規則通常由上而下比對，符合條件後便採用對應策略；較明確的條件宜排在寬泛條件之前，FINAL 則放在末尾作為後備規則。PROXY、DIRECT 與 REJECT 是策略關鍵字，不是伺服器位址。修改前先保留副本，每次只改一處，再檢查實際請求命中的規則。以下使用 example.com 的片段僅說明語法，並非可直接使用的完整設定。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECTOn Demand：依條件建立連線
On Demand 可在指定網路條件下觸發連線，不能取代伺服器設定。先在 Settings 找到 On Demand，確認哪些 Wi-Fi、行動網路或網域條件需要觸發，再逐一檢查條件是否重疊。初次設定建議只啟用一個明確條件，切換網路後觀察連線狀態，確認符合預期再增加其他條件。手動關閉連線後若又自動連線，請先檢查 On Demand，而不是立即刪除設定。自動連線與 Rule 分流屬於不同環節：前者決定何時連線，後者決定連線後如何處理請求。
Settings → On Demand
Wi-Fi / Cellular / Domain
連線觸發條件 ≠ Rule 比對條件多種通訊協定：先選 Type，再填寫參數
Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等通訊協定。使用自己已有的伺服器資訊時，先在 Add Server 確認 Type，再依對應類型填寫 Host、Port 及驗證參數。各通訊協定的欄位並不通用，TLS、傳輸方式與憑證相關選項也應與伺服器端一致。不要反覆更換 Type 猜測協定；請依照已有的設定資訊逐項核對。項目能夠儲存，只代表輸入內容已獲接受，不代表遠端連線成功，仍須配合測試及實際存取確認。
Add Server
Type → Host → Port
Trojan / Hysteria2 / WireGuardSubscribe：匯入現有訂閱資訊
Subscribe 適合管理自己已有的訂閱項目。匯入前請確認網址完整，保留連結中的必要參數，避免複製時混入空格、換行或說明文字。匯入後先確認是否建立預期的伺服器項目，再選取其中一個進行連線測試。更新訂閱會重新整理遠端清單，不會自動修復遠端失效、驗證錯誤或所有本機規則問題。刪除或覆寫前，請確認哪些項目來自訂閱、哪些是手動新增。訂閱網址可能包含存取憑證，排查時請勿將完整網址放入截圖或公開紀錄。
Add Server → Type → Subscribe
匯入現有網址 → 更新項目 → 選擇伺服器
訂閱清單 ≠ 規則設定檔Config：確認目前生效的設定
設定檔用於管理 General、Rule、Hosts 等設定，伺服器清單與設定檔應分開理解。在 Config 匯入或編輯後，還要確認目前選用哪一份設定檔，並檢查 Global Routing 是否設為 Config。檔案只儲存在清單中，不代表其中的規則已參與處理。修改 DNS 或規則前，請保留可復原的副本，並記錄修改項目與預期結果。若要使用 iCloud 同步，請分別檢查系統的 iCloud 設定、App 內相關選項，以及另一台裝置上實際出現的內容；不要將同步視為完整備份或連線成功的證明。
[General]
bypass-system = true
dns-server = system
[Rule]
FINAL,DIRECT診斷工具：先定位問題，再修改
連線失敗時，先確認裝置本身能正常連上網路，再查看所選伺服器、Connectivity Test 與目前的測試方式。測試結果只反映該方法下的可連線性，不能單獨代表所有請求的存取結果。接著核對通訊協定參數、TLS 設定、系統時間與 Global Routing；必要時查看 Settings 中的 Diagnostics。Data 的流量統計適合觀察使用情況，不等於伺服器端的計費紀錄，也不能只憑流量變化判斷規則是否正確。每次只調整一個變數，並保留故障現象與測試條件，方便比較前後差異。
Connectivity Test
Settings → Diagnostics
網路 → 參數 → Global Routing → 實際請求Global Routing：先確認目前模式
Config 依目前設定檔中的規則處理請求；Proxy 會讓請求經由代理處理；Direct 則直接連線。日常需要規則分流時，應先檢查 Config 和目前使用的設定檔。暫時切換模式有助於縮小排查範圍，但切換後的結果必須與原本的測試條件對照，不能將單次存取成功解讀為所有規則都正確。
開始檢查前，記錄目前的伺服器、路由模式與設定檔名稱。若 Proxy 下可以存取，Config 下卻出現差異，應優先核對命中的規則、策略指向與 DNS 相關設定；若連線本身就失敗，則先檢查伺服器參數和基本網路。排查結束後，請恢復原定模式，避免暫時設定持續影響後續使用。
比較 Config、Proxy、Direct 的用途 →
正版與購買資訊
核對 App 身分，釐清購買內容
Shadowrocket 是閉源商業 App。App 身分、價格、相容性與購買條件，請以 App Store 產品頁為核對依據；操作入口則以目前 App 內顯示為準。
正版核對三要素
官方圖示、開發者名稱與 App ID 應同時相符。不要只看搜尋結果中的名稱，也不要單憑圖示顏色判斷；開啟詳細頁後先核對開發者，最後確認產品連結中的數字 ID。
開發者 Shadow Launch Technology Limited
App ID 932747118
取得管道 App Store
商店顯示狀況：先檢查目前的購買帳號
App Store 搜尋結果與 App 顯示狀況，可能因帳號所屬國家或地區而異。裝置顯示繁體中文，不代表購買帳號屬於特定商店地區；瀏覽器開啟的產品頁，也不一定與裝置目前用於購買的帳號商店相同。若搜尋不到或頁面顯示無法使用，請先閱讀商店提示，核對目前的購買帳號與國家或地區，再查看正版指南中的相關章節。
不要因為搜尋不到就直接認定 App 已無法使用，也不要把瀏覽器能開啟頁面視為裝置可以購買。請分別確認詳細頁是否顯示、購買按鈕是否可用，以及裝置是否符合相容性要求。若頁面顯示的身分資訊與本頁三項要素不同，請停止目前的購買步驟，返回正確的產品頁重新核對。
一次性買斷：購買的是用戶端
美國 App Store 參考價格為 2.99 美元，一次性付費；其他商店地區會以當地貨幣顯示，實際價格與購買條件請以 App Store 頁面為準。購買紀錄屬於完成付款的 Apple ID，日後更換裝置時應先確認此帳號。請勿將參考價格視為所有地區的固定價格，也不要只根據另一台裝置上的顯示推斷目前帳號的購買狀態。
現有訂閱的有效期限、伺服器驗證與伺服器端狀態，須與 App 購買分開檢查。App 可以正常開啟，不代表遠端服務仍有效；遠端項目連線失敗，也不表示需要重新購買用戶端。請先判斷問題屬於商店購買、App 設定或遠端連線，再進入相應的排查步驟，避免在不相關的地方反覆修改。
更換裝置與復原：分別確認 App 和設定
更換裝置或重新安裝後，先登入原購買帳號，再到 App Store 的已購項目中尋找 Shadowrocket。若看到價格按鈕，而不是預期的重新取得入口，請先確認用於媒體與購買項目的帳號是否正確，不要直接再次付款。購買紀錄、地區供應狀況與裝置相容性都可能影響頁面顯示，請以系統提示和商店紀錄為準。
重新取得 App 和復原設定是兩回事。App 復原後，請逐項確認伺服器清單、所選設定檔、Global Routing 和 On Demand；若使用 iCloud 相關功能，也要確認同步內容是否實際出現。不要因為看到 App 圖示，就認定原有設定都已復原。若涉及家人共享，請查看產品頁和家庭設定中的實際適用條件，勿將同一帳號復原與家庭成員使用混為一談。
App 更新：先保留設定，再確認變更
Shadowrocket 的取得與更新均透過 App Store 進行。可在系統商店設定中查看自動更新選項，並在 App 詳細頁查看更新紀錄。本手冊不固定列出特定版本號或更新日期；若介面入口和文字略有差異，請以目前 App 內顯示的選項為準，先確認功能所在頁面，再依相同操作目的尋找。
進行重要設定調整前，請保留目前可用的設定檔副本，並記錄所選伺服器與路由模式。更新或更換裝置後首次使用，建議先依已知條件完成一次連線驗證，再逐步恢復自動連線及其他設定。如此即使出現差異，也能分辨問題來自匯入資訊、規則選擇或網路環境變化，而不會因一次修改多個環節而失去比較依據。
使用前常見問題
先判斷目前卡在哪個環節，再查看對應說明。以下答案可直接展開閱讀。
已經購買，為什麼還不能直接連線？
購買只完成用戶端的取得。連線還需要使用者已有的訂閱或伺服器資訊，並正確選擇伺服器、Global Routing 與設定檔。請先確認 Home 是否有可用項目，再核對參數和系統 VPN 設定授權；付款完成不代表連線設定也已完成。
匯入訂閱後，還需要選擇 Config 嗎？
訂閱項目與規則設定負責不同工作。訂閱通常管理伺服器資訊，Config 中的設定則決定如何依規則處理請求。若需要規則分流，請確認 Global Routing 設為 Config，並檢查目前選用的設定檔；訂閱更新成功，不代表規則已生效。
Connectivity Test 有結果，為什麼實際存取仍有問題？
測試與實際請求可能使用不同的目標和處理條件。解讀測試結果時，須一併考量測試方式，並檢查請求命中的規則、DNS、TLS 及所選伺服器。請在相同網路條件下重現問題，每次只修改一項設定再比較結果，避免將測試可連線誤認為所有請求都能成功。
手動關閉後又自動連線，應先檢查哪裡？
先查看 On Demand 是否啟用，以及目前的 Wi-Fi、行動網路或網域條件是否仍符合。自動連線與手動開關可能同時影響目前狀態。記錄觸發情境，調整一項條件後再觀察，不要立即刪除伺服器或整份設定檔。
部落格文章預覽
規則與連線的專題說明
完成基本步驟後，可依目前遇到的問題繼續閱讀。先記錄現象與目前設定，再依專題文章中的檢查順序操作，不要同時套用不同問題的調整方法。
Shadowrocket Global Routing 怎麼選：Config、Proxy、Direct 三種模式的差異
比較三種模式如何處理流量，了解規則分流為何需要確認 Config。說明暫時切換模式的檢查用途，以及排查完成後應復原哪些設定，避免將暫時的測試狀態當成日常設定。
閱讀路由說明 →Shadowrocket 節點逾時與連線失敗排查順序：延遲測試、通訊協定參數、系統時間
先確認基本網路和測試條件，再檢查通訊協定參數、TLS 與系統時間。依固定順序逐步縮小範圍，分辨測試失敗、連線失敗與實際請求失敗，減少在多項設定之間反覆修改。
閱讀排查清單 →