設定檔閱讀順序
先決定 Global Routing 的運作方式，再檢查 Config 中的規則。使用 Config 時，請求會依規則排列順序逐一比對，符合的第一條規則決定所用策略；PROXY、DIRECT 與 REJECT 代表不同處理結果，並非三種協定。下方範例用於說明語法，不適合直接套用於所有網路。
伺服器協定、驗證資訊與傳輸參數必須彼此相符。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 所需欄位各不相同，新增時應依現有資料選擇 Type，而不是輪流更換協定來猜測連線方式。請向服務提供者取得訂閱；匯入後仍須測試連線。
在 Home 開啟 Global Routing，依需求選擇 Config、Proxy 或 Direct。Config 依據目前設定檔中的規則分流；Proxy 以代理方式處理流量，適合用來確認所選伺服器是否可用；Direct 則直接連線至目標，不適合用來測試代理伺服器。日常需要依規則分流時，請確認已選取 Config，並檢查目前啟用的設定檔。切換後重新送出請求，再參考 Logs 判斷實際連線路徑；既有長連線可能仍沿用先前路徑，不能只看頁面是否已開啟來判定切換結果。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECTOn Demand 會依系統條件觸發連線，與 Global Routing 的用途不同，也不會取代設定檔中的規則。先在 Settings 查看相關選項，再依目前的網路使用需求設定。初次使用時，建議先手動連線並確認可以正常存取，避免把伺服器參數錯誤誤判為自動連線失效。啟用後，手動中斷與系統再次觸發連線的結果可能不同；排查時可暫時關閉此功能，記錄手動連線結果，再恢復原設定。可用條件與授權狀態以裝置畫面顯示為準。
# On Demand：決定何時建立連線
# Global Routing：決定流量如何處理
# Config 中的 Rule：決定請求使用的策略
[Rule]
DOMAIN,api.example.org,DIRECT
FINAL,PROXY請向服務提供者取得訂閱。使用 Subscribe 匯入前，請確認已複製完整網址並保留原有查詢參數；網址中的驗證資訊屬於敏感資料，不應出現在公開截圖中。匯入後先確認清單中是否出現預期項目，再選取一項測試連線。更新訂閱只會刷新來源中的伺服器資訊，不代表目前 Config 的規則也會同步變更。更新失敗時，請分別確認網址是否有效、目前網路能否連上來源，以及服務提供者提供的內容是否適用於此用戶端；不要反覆新增同一份訂閱。
# Subscribe 管理伺服器資訊來源
# Rule 決定請求採用哪種策略
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTConfig 用於檢視與管理設定檔。閱讀時先釐清 General、Rule、Host 與 URL Rewrite 各自的用途，不要把規則填入伺服器驗證欄位。修改前先保留可用的副本，每次只調整一類內容；儲存後確認目前選取的仍是目標設定檔。更換裝置時，可搭配設定檔匯出與 iCloud 同步準備還原，但應逐項確認伺服器、規則與本機設定是否齊全，不能假設同步後所有狀態都已還原。範例僅用於說明結構，實際使用前仍須依現有網路環境填入有效參數。
[General]
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Host]
example.org = 192.0.2.10Rule 依書寫順序比對請求；符合某條規則後便採用該行策略，不再繼續尋找後方相似的規則。DOMAIN 用於完整網域，DOMAIN-SUFFIX 適合涵蓋網域及其子網域，IP-CIDR 用於指定 IP 位址範圍，FINAL 則處理前面都未符合的請求。範圍較小的例外規則通常應排在範圍較大的規則之前。排查時先找出實際符合的規則，再判斷策略是否符合預期；僅確認設定檔中有某一行，無法證明請求一定會套用該行。修改後重新送出目標請求，並查看日誌中的比對結果。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYHost 用於記錄網域與 IP 位址的對應關係，適合在確定目標位址時設定。它處理的是名稱解析，不負責選擇代理策略，因此不能用一筆對應取代 Rule 中的 DIRECT 或 PROXY。修改前請確認位址仍有效，尤其留意切換網路後，原本的內部網路位址可能無法連線。遇到特定網域異常時，應一併檢查 Host 對應、DNS 結果與符合的規則，逐項排除。此處的保留位址僅供文件範例使用，不是真實服務位址，也不應用來覆蓋尚未確認的網域。
[Host]
example.org = 192.0.2.10
[Rule]
DOMAIN,example.org,DIRECT
FINAL,PROXYURL Rewrite 會依運算式比對請求網址並執行相應處理，與規則分流的用途不同。撰寫前先確認協定、網域與路徑範圍，再決定重新導向目標與狀態碼。運算式範圍過廣，可能影響同一網域中原本正常的請求；建議先從單一測試路徑開始，並保留可還原的副本。處理加密請求時，也須考量請求是否可見及相關安全設定；加入一條規則不代表一定會生效。下方以範例網域說明重新導向格式，測試時請選擇自己有權管理的目標。
[URL Rewrite]
^http://example\.com/ https://example.com/ 302Proxy Group 可將策略選擇整理成供規則引用的群組，讓 Rule 專注判斷請求所屬範圍。使用前請確認群組名稱與規則中的引用完全一致，且群組內有可用選項。手動選擇類型的群組適合明確指定出口；其他群組類型則須依實際需求確認其運作方式與檢測條件，不要與協定種類混淆。如果規則比對正常但仍無法連線，請進一步檢查群組目前選取的伺服器。下方是手動群組的語法範例，其中引用的 PROXY 仍須依賴現有伺服器設定，不會自動提供連線服務。
[Proxy Group]
Reading = select,PROXY,DIRECT
[Rule]
DOMAIN-SUFFIX,example.com,Reading
FINAL,DIRECTScan QR Code 可讀取現有設定的 QR Code，但仍須檢查辨識結果。掃描前請確認內容來自自己的設定資料；讀取後核對 Type、Host、Port 與驗證欄位，再儲存並測試。相機權限由系統管理，若無法掃描，請先檢查權限設定與 QR Code 是否清晰，不要直接修改協定參數。QR Code 可能包含完整連線憑證，應比照訂閱網址妥善保管，避免公開分享。成功新增只表示用戶端已讀取資訊，不代表目標伺服器可連線；後續仍須選取伺服器、開啟連線並確認實際請求結果。
# 匯入後核對伺服器欄位
# 再用明確規則驗證請求路徑
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECTLogs 適合確認請求目標、符合的規則與連線結果；Data 則用於觀察一段時間內的流量使用情況，兩者用途不同。診斷時先記下問題發生時間，再對目標送出一次請求，依序檢查網域解析、規則比對、策略選擇與連線結果。Connectivity Test 可作為連線狀況的參考，但不能取代實際使用應用程式進行存取測試。準備分享診斷資料時，請遮蔽訂閱網址、驗證欄位與私人存取紀錄，只保留與問題相關的片段。單次測試結果只反映當下狀況，不宜據此推論長期狀態。
# 對照 Logs 中的目標與符合的策略
[Rule]
DOMAIN,api.example.org,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT需要逐行說明？請閱讀規則與設定欄位參考 →。初次匯入現有資料，可先依照入門指南完成連線與測試，再調整規則。
裝置與取得方式
Shadowrocket 僅透過 App Store 取得。購買前請查看產品名稱、開發者與 App ID；系統需求及購買適用範圍以 App Store 頁面標示為準。已購買的使用者可先查看自己的已購項目，再確認是否需要重新購買；目前登入商店的購買帳號，也應與用於裝置設定同步的帳號分開核對。
核對商店資訊後購買並安裝，新增現有伺服器或訂閱，再依系統提示允許新增 VPN 設定。先手動連線並確認目標請求正常，再設定 On Demand。
查看 iPhone 取得說明 →使用購買時的同一個 Apple ID 查看已購項目，並依商店顯示取得應用程式。安裝後仍須核對本機伺服器、目前的 Config 與系統授權，不能只因另一部裝置連線正常就認定設定無誤。
查看 iPad 取得說明 →Mac / Apple TV 也可透過同一個 App Store 取得；相容性、系統需求與購買適用範圍以 App Store 頁面標示為準。
購買確認在 App Store 中進行；新增 VPN 設定則在裝置系統中操作，兩者分屬不同步驟。安裝完成不代表已建立連線，允許系統設定也不代表伺服器資訊一定正確。首次開啟後，請先檢查現有設定是否齊全，再選取伺服器並開啟連線。若系統顯示設定授權提示，請了解用途後再確認，並依裝置指示完成測試；若暫時取消，可返回用戶端重新操作。
兩部裝置也需要分別測試。相同訂閱可以提供一致的伺服器資訊，但目前網路、Config 選擇與本機權限可能不同。建議先在一部裝置完成最基本的可用設定，記錄所用協定與模式，再於另一部裝置逐項檢查。切換 Wi-Fi 與行動網路後若結果不同，請維持相同測試目標，只變更網路條件，方便判斷問題出在網路連線能力或本機設定。
初次使用可從入門指南開始：準備現有訂閱或伺服器資訊，選擇相應的匯入方式，檢查 Global Routing，開啟連線，最後透過實際請求與 Logs 進行測試。若已有設定，但部分目標的連線路徑不符預期，再查看設定欄位參考，核對規則順序、策略與網域對應。將安裝、連線與分流分開檢查，可避免同時修改多項設定而難以判斷問題，也方便保留可還原的設定副本。
正版與購買資訊
Shadowrocket中文文件是 Shadowrocket 的官方網站與官方手冊。這是閉源商業應用，購買、安裝與更新均透過 App Store 管理；本手冊說明用戶端操作，不提供、銷售或推薦節點或訂閱。購買前請先核對商品資訊，連線前則須確認自己已有有效設定。
在 App Store 搜尋 Shadowrocket 後，請先進入產品詳情頁，不要只憑搜尋結果中的名稱判斷。確認開發者為 Shadow Launch Technology Limited，再比對本站使用的官方圖示，最後確認產品頁網址中的 App ID 是 932747118。名稱相似不代表是同一項商品，請以詳情頁資訊為準。本站的取得說明與商店連結皆指向此產品頁。
圖示是辨識線索之一，但不能取代另外兩項核對。若搜尋結果與預期不同，可從正版下載頁前往指定產品頁，再確認目前商店頁面顯示的購買資訊。閱讀評價或功能介紹前，請先確認開啟的是正確商品；準備購買時，再核對顯示金額與系統相容性。商店資訊可能變動，請以 App Store 頁面標示為準，不要根據舊截圖推斷目前狀態。
同一項產品在不同店面可能有不同的顯示狀態與貨幣。搜尋不到時，請先確認拼字，並檢查目前 App Store 帳號所屬店面及產品頁提示。無法購買、裝置不符合相容性要求與付款未完成，分別需要不同處理方式，不要一概視為應用程式安裝失敗。價格、系統需求與購買適用範圍均以 App Store 頁面標示為準；本手冊不能取代商店的最終資訊。
請區分裝置登入狀態與商店購買狀態。查看購買紀錄時，請確認目前使用的帳號就是當初完成購買的帳號，並檢查交易是否確實完成。若頁面顯示重新取得的選項，可依系統提示繼續；若仍顯示價格，請先檢查購買紀錄與帳號資訊，避免將帳號差異誤認為購買失效。保留商店交易紀錄有助於核對；公開詢問時則不要附上帳號、帳單或付款資料。
買斷用戶端 ≠ 購買線路方案。美國店面標價參考為 2.99 美元，各店面會以當地貨幣顯示，實際金額以 App Store 頁面標示為準。一次買斷是購買用戶端，不會自動在 Home 新增可用伺服器，也不會產生訂閱網址。請向服務提供者取得現有訂閱；新增現有伺服器時，則依其協定、位址、連接埠與驗證資料填寫。匯入前確認資料完整，匯入後仍須測試連線。
訂閱更新失敗與應用程式購買是否成功是兩回事。購買紀錄由 App Store 管理；訂閱內容及有效性則由服務提供者提供。排查時先確認問題發生在哪個環節：無法取得應用程式，請檢查商店；清單中沒有預期項目，請檢查匯入方式；已有項目但無法連線，請檢查伺服器參數與網路；只有部分請求異常，再檢查規則與解析。依環節逐一排查，比反覆重新安裝更容易保留線索，也能降低設定遺失的風險。
可透過同一個 Apple ID 的已購項目尋找已購買的 Shadowrocket；iPhone 與 iPad 的購買適用範圍以 App Store 頁面標示為準。更換裝置或重新安裝時，請先還原應用程式，再處理伺服器與設定檔。家庭共享是否適用，也請查看商店頁說明與帳號設定；某部裝置已安裝應用程式，不代表另一部裝置也有相同的購買狀態。還原時若出現商店提示，請先完成相應的帳號核對。
設定方面，可事先確認是否已開啟 iCloud 同步，並準備必要的設定檔匯出副本。同步與匯出的涵蓋範圍應分開確認，尤其要核對目前的 Config、手動修改的規則與伺服器資訊是否齊全。還原後先查看清單，再檢查所選伺服器、Global Routing 與系統授權；完成一次實際請求測試後，再啟用自動連線條件。備份可能含有驗證資料，請存放於自己可控的位置；分享排查資料前，先移除敏感內容。
應用程式更新透過 App Store 管理，可依裝置的商店設定使用自動更新或手動檢查。介面與選項以實際安裝的應用程式顯示為準。更新前請保留重要設定；更新後先檢查現有連線與常用目標，不必只因介面位置改變就重建所有設定。更新訂閱、編輯 Config 與更新應用程式屬於不同變更，請分別記錄，方便發生問題時回顧近期調整，而不是一次更換所有內容。
日常維護時，可保留一份已測試可用的設定副本。需要調整分流時，先寫下目標網域與預期策略，再修改對應規則，儲存後重新送出請求。若結果不符預期，先查看符合的第一條規則，確認是否被較早的廣泛規則涵蓋，再檢查策略引用的伺服器或群組。確認測試通過後再進行下一項修改；若未通過，則還原此次變更。Host 對應與 URL Rewrite 的小範圍測試也適用相同流程。
延伸閱讀
以下三篇文章分別介紹購買前辨識、首次連線與換機還原，可依目前需求選讀，不必一次修改所有設定。文章中的操作均以已有設定為前提；涉及價格、相容性與購買範圍時，仍請回到 App Store 產品頁確認。
從搜尋結果進入商品詳情，逐項確認 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。說明名稱相似時應先查看哪些資訊，以及確認購買前須核對的商店資訊。
閱讀核對說明 →依初次使用順序說明透過 Subscribe 匯入、授權 VPN 設定、選擇伺服器與切換連線。釐清「已新增」、「已連線」與「請求測試正常」的差異，並說明何時再設定 On Demand，方便逐步檢查。
閱讀入門問答 →分別檢查應用程式購買還原與設定移轉，整理 iCloud 同步、匯出副本及還原後測試的順序。更換裝置後，先核對清單、目前的 Config 與授權狀態，再恢復日常使用的自動連線設定。
閱讀移轉步驟 →