Shadowrocket 功能介紹
分流、連線與診斷設定

規則由「比對項目」與「命中後的處理方式」組成。DOMAIN 精確比對完整網域；DOMAIN-SUFFIX 比對指定網域及其子網域；DOMAIN-KEYWORD 依網域中的關鍵字比對；IP-CIDR 與 IP-CIDR6 分別比對 IPv4、IPv6 位址範圍；GEOIP 則依位址歸屬資料庫比對。各類規則參照的資訊不同，網域規則不能直接取代位址規則。

PROXY、DIRECT、REJECT 是處理策略，不是規則類型：分別代表交由代理處理、直接連線及拒絕連線。規則通常由上而下檢查，命中第一條後即生效，因此具體規則應排在範圍較廣的規則之前。FINAL 為前面都未命中的流量提供預設處理方式，應放在規則末尾。

[Rule]
DOMAIN-SUFFIX,ads.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

範例中，ads.example.com 會先命中 REJECT，不會落入後方的 example.com 範圍。該網域範圍內的其他流量使用 PROXY，指定的私有位址範圍使用 DIRECT，其餘流量則由 FINAL,DIRECT 處理。範例僅用於說明語法，不代表這些網域對應的連線服務可用，也不能直接取代完整設定檔。

修改時一次只調整一項判斷條件

先保留原設定檔，在 Config 編輯副本的 [Rule] 區段，儲存後確認已選取該檔案，再返回 Home 使用 Config 測試。修改後重新發出目標請求，避免將舊連線的結果誤認為新規則的效果。若實際策略與預期不同，請查看請求記錄，確認應用程式實際使用的網域與目標位址。一個頁面可能同時連線至多個網域，不能只為網址列中的網域設定一條規則，就認定所有請求都會套用相同策略。

On Demand 會依設定條件要求系統建立連線，適合需要在特定網路環境下自動連線的情況。它與規則分流負責的工作不同：On Demand 管理連線觸發條件，Global Routing 與 Config 則決定連線後的流量處理方式。啟用 On Demand 不會自動補上訂閱、選取可用伺服器或修正規則。

首次設定前，請先關閉自動觸發，手動完成伺服器選擇、VPN 設定授權與連線確認。確認基本連線正常後，再進入 Settings 的 On Demand，依頁面實際提供的網路條件設定連線行為。不同裝置與應用程式狀態下，可用選項可能不同，請依目前介面逐項確認，不要直接照搬不適用的操作路徑。

設定後，分別在需要觸發與不需要觸發的網路環境中測試，觀察是否依預期建立連線，再確認一次目標是否可用。若手動中斷後又自動連線，請先檢查 On Demand 條件與系統中的相關 VPN 設定；若切換網路後連線失敗，先在新網路手動測試伺服器，不要立刻增加更多觸發條件。

自動連線不代表伺服器一定持續可用。網路切換、驗證失效或訂閱資料變更都可能影響連線結果。排查期間可暫時關閉 On Demand，避免自動重新連線干擾對照測試；測試完成後，再恢復原先需要的條件。

不需要一次修改 Settings 中的所有選項。先保留預設行為並建立可用的基準，再依明確問題調整。部分功能也會受到目前 Config、系統權限或裝置環境影響；找不到選項時，請先確認應用程式內的介面，不要將其他裝置的選單位置視為固定路徑。

DNS：網域解析與規則判斷的基礎

DNS 會將網域解析為位址，相關行為可能同時受 Settings 與目前設定檔的 [General] 區段影響。排查時先確認實際生效設定檔中的 DNS 參數，再檢查網路是否能連線至指定的解析服務。不要疊加多個來源的參數後只修改其中一處，否則很難判斷是哪項設定造成結果改變。

若只有部分網域連線失敗，先比較其他網域及不同網路下的結果，再檢查 DNS 解析結果與規則命中情況。一次只調整一項，重新建立連線並發出新請求。某個位址可連線，不代表網域解析整體正常；盲目更換 DNS 也無法解決驗證失敗或伺服器無法連線的問題。

Test Method：了解 Connectivity Test 的測試範圍

Test Method 決定 Connectivity Test 使用的測試方式。在 Settings 中找到這個選項，查看目前可選方式，再以相同方法比較各項目。若介面允許設定測試目標，請使用已知可連線且符合測試要求的目標，並在比較期間維持相同條件。

不同測試方式測量的階段不同，結果不適合直接橫向比較。測試成功不代表所有網站都能連線，逾時也可能是測試目標或目前網路所致。請先確認測試方式與目標，再檢查伺服器位址、連接埠及驗證資料；不要只因單次測試結果就反覆切換項目。

Today Widget：快速操作與狀態查看

Today Widget 適用於系統支援的小工具情境。請先在應用程式中確認相關設定，再透過系統提供的編輯入口加入。可使用的位置與操作方式取決於系統支援情況，請以裝置實際顯示為準；系統需求請以 App Store 頁面標示為準。

首次設定、編輯伺服器與檢查規則仍應在應用程式內完成。小工具中的狀態適合快速查看；若顯示未即時更新或連線結果不符，請開啟 Home 確認目前的伺服器與連線開關，不要連續點按快速操作。

iCloud 同步：跨裝置使用前先確認資料範圍

iCloud 相關功能可在支援範圍內同步應用程式資料。進入 Settings 檢查同步開關，並在系統設定中確認相應的 iCloud 權限與可用空間。實際同步項目請以應用程式介面說明為準，不要將應用程式購買記錄、伺服器資料、連線狀態與歷史統計都視為相同的同步內容。

首次啟用前，請保留重要設定；在另一部裝置上逐項確認資料是否完整，再進行本機修改。雲端資料已出現不代表系統 VPN 授權也已完成，仍須在目標裝置上自行確認。伺服器與訂閱可能包含驗證資訊，啟用同步前請確認所用帳號與裝置均由本人妥善管理。

Diagnostics：針對單次失敗收集線索

Diagnostics 可用於查看或產生排查所需的診斷資訊。發生問題時，請從 Settings 中對應的入口進入，依目前介面提供的方式記錄一次重現過程。先記下網路環境、Global Routing 模式、所選伺服器與目標，再執行一次操作；比起混合多次切換後的記錄，這樣更容易判斷問題。

請區分連線建立失敗、網域解析失敗與目標請求失敗。分享記錄前，請隱藏訂閱網址、伺服器驗證資訊及個人請求內容，只保留排查所需的片段。Diagnostics 僅提供輔助資訊，無法取代正確的伺服器資料，也不能只憑單一提示推斷所有原因。