本文適合已能手動連線，並希望依網路環境自動啟停的 iPhone 與 iPad 使用者。先區分 On Demand 與 Global Routing，再設定 Wi-Fi、行動網路和網域條件，最後透過切換網路與請求記錄確認結果。操作前提是使用者已有自己的服務商與訂閱。
1. On Demand 決定何時連線，不決定每筆請求的出口
Shadowrocket 的 On Demand 使用系統 VPN 隨選機制，在符合條件時建立或中斷連線。它處理的是連線時機。連線建立後，流量採用哪項策略仍由 Global Routing 與目前設定決定。系統顯示 VPN 已連線，不代表每筆請求都經過代理伺服器。
設定入口是 Settings → On Demand。伺服器選擇在 Home，規則設定在 Config。釐清這三處的用途，排查自動連線異常時，就不必反覆修改分流規則。實際顯示的選項視目前 App 介面與系統支援而定。
判斷方式：先確認連線，再確認出口
若尚未建立 VPN 連線，先檢查 On Demand 條件；若已連線但出口不符，則檢查 Global Routing 與命中的策略，別把兩個層面的問題混為一談。
2. 設定前先手動連線一次
自動化應以可用的連線為基礎。On Demand 無法修復伺服器位址、驗證資訊或失效的訂閱。先暫時關閉隨選連線，在相同網路下手動連線一次，再開始新增條件。
- 前往 Home，確認已匯入自己的訂閱。若需要更新，先完成更新，再確認要使用的伺服器仍在清單中。
- 點選目標伺服器左側的圓點，確認已設為預設選取。只開啟伺服器詳細資料但未選取是不夠的。
- 開啟 Home 頂端的連線開關。首次連線時，請依系統提示允許加入 VPN 設定。
- 執行 Connectivity Test，並造訪已知可連線的 HTTPS 網頁。若測試失敗，先排除手動連線問題。
- 前往 Config，確認目前使用的設定。再檢查 Global Routing；之後若要依規則分流，請選擇 Config。
- 保留目前可用的設定與既有 On Demand 條件記錄，再前往 Settings → On Demand 個別調整。
3. Wi-Fi 情境：依 SSID 分別設定連線與中斷
Wi-Fi 名稱通常指 SSID，不是路由器管理位址，也不是手機裝置名稱。先在系統 Wi-Fi 設定中確認目前名稱，再填入 On Demand 對應的 Wi-Fi 條件。名稱中的空格、大小寫與字元都要一致，請勿自行加入萬用字元。
以在家用網路自動中斷、連上其他 Wi-Fi 時自動連線為例，應先設定明確的家庭 SSID，再處理其他 Wi-Fi。以下說明設定目標與驗證方式，並非可貼入 Config 的設定語法。動作名稱與可編輯欄位以目前介面為準。
| 符合條件 | 目標動作 | 驗證方式 |
|---|---|---|
| 指定 SSID，例如 Home-WiFi | 中斷連線 | 連上該 Wi-Fi 後，確認 VPN 狀態是否符合預期 |
| 其他 Wi-Fi | 建立連線 | 切換至另一個可用的 Wi-Fi，確認是否自動連線 |
| 尚未完成登入的公共 Wi-Fi | 先完成網路驗證 | 確認系統登入頁面可開啟，再測試隨選連線 |
- 前往 Settings → On Demand，找到 Wi-Fi 條件，先只設定一個明確的 SSID。
- 為該 SSID 選擇所需的連線或中斷動作。若介面提供條件排序，請將特定 SSID 條件排在較寬泛的 Wi-Fi 條件之前。
- 儲存並啟用 On Demand。離開該 Wi-Fi 後再重新加入，觀察一次實際網路變更，不要只在原本的網路上反覆開啟頁面。
- 確認這項設定符合預期後，再新增其他 Wi-Fi 的處理條件。
SSID 只能辨識網路名稱，無法證明網路可信。不同地點可能出現同名 Wi-Fi。只有在清楚了解網路環境時，才設定自動中斷；不要只因名稱看起來熟悉，就降低連線要求。
4. 行動網路情境：與 Wi-Fi 條件分開驗證
行動網路條件僅適用於具備行動網路連線能力的裝置。只有 Wi-Fi 的 iPad 不會因新增此條件而取得行動網路。測試時請確認系統目前確實使用行動數據，避免裝置仍連著 Wi-Fi 而造成誤判。
- 在 Settings → On Demand 中設定行動網路對應的連線動作。保留已驗證的 Wi-Fi 條件，不要同時調整其他設定。
- 關閉系統 Wi-Fi，確認行動數據可用。等待網路切換完成後，觀察 VPN 狀態。
- 開啟新的 HTTPS 網頁，必要時執行 Connectivity Test。已開啟的頁面可能使用快取，不適合作為唯一判斷依據。
- 重新啟用 Wi-Fi 並加入已設定的網路，確認是否執行該 Wi-Fi 對應的動作。
- 若有自動重新連線或其他自動化設定，請逐一確認其作用，避免多個機制同時控制連線狀態。
5. 網域情境：連線觸發條件不是 DOMAIN-SUFFIX
網域隨選連線是由系統評估網域解析需求，並非檢查每個網頁的完整 URL。可用的網域條件、評估動作與附加檢查，請以 Settings → On Demand 目前提供的欄位為準。不要將 Config 的規則列貼入網域欄位。
系統可能根據 DNS 是否能解析、指定的解析伺服器或探測結果，判斷是否連線。因此，設定網域不一定會在每次造訪時建立新的 VPN。既有連線、DNS 快取及 App 自行採用的解析方式，都可能影響觀察結果。
| 設定位置 | 填寫內容 | 用途 |
|---|---|---|
| Settings → On Demand 的網域條件 | 網域，例如 example.com | 讓系統評估是否需要建立連線 |
| Config 中的 DOMAIN | DOMAIN,example.com,DIRECT | 為完整網域選擇請求策略 |
| Config 中的 DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,DIRECT | 為該網域及其子網域選擇請求策略 |
- 選擇自己有權存取且用途明確的實際網域。上表的 example.com 僅用來示範填寫格式。
- 在網域欄位填入網域本身，不要加上
https://、路徑、連接埠或查詢參數。 - 依介面支援的評估選項設定條件。若沒有相應的網域欄位，請勿用分流規則模擬連線觸發器。
- 測試前確認 VPN 沒有被其他 Wi-Fi 或行動網路條件提前連線，再開始新的網域連線測試。
- 分別記錄 VPN 是否建立、網域是否解析，以及請求是否成功。若失敗，依序檢查這三個環節。
直接造訪 IP 位址通常無法驗證網域觸發條件。瀏覽器使用快取位址，或 App 使用自行加密的 DNS 時，也可能不會經過預期的系統網域評估流程。若需要穩定的網路層級自動連線，請優先驗證 Wi-Fi 或行動網路條件，再新增網域條件。
6. 規則衝突：先檢查條件覆蓋，再檢查 Global Routing
常見衝突是特定條件被較寬泛的條件覆蓋，例如希望在家庭 Wi-Fi 上中斷連線，卻同時設定了適用於所有 Wi-Fi 的連線條件。若條件清單依序比對，請將特定例外排在一般條件之前。若介面依網路類別分別設定，請檢查各類別的動作，不要假設它們共用同一份規則清單。
- Proxy：適用於統一使用代理路徑的情境，不代表所有請求都由 Config 中的規則決定。
- Direct：表示採用直連模式。VPN 狀態不等於代理出口。
- Config：依目前設定處理流量。若要驗證 DOMAIN-SUFFIX、GEOIP、IP-CIDR、FINAL，請先確認選取此項。
- Scene：依已設定的場景處理流量。請檢查實際選用的場景設定，不要將它視為 Config 的同義詞。
以下僅為 Config 中 [Rule] 區段的語法片段，用於說明規則順序，並非完整設定，也不是 On Demand 設定。網域與網段僅供說明；請保留目前可用的設定，不要直接覆蓋。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,REJECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY請求會依規則順序比對，FINAL 用來處理未符合前面規則的請求。IP-CIDR 範例中的 no-resolve 表示不主動為該規則解析網域。自動連線成功後，若頁面遭 REJECT 拒絕，請調整對應規則，而非反覆開關 On Demand。
7. 常見問題與基本驗證記錄
手動關閉開關後，為什麼又自動連線？
先前往 Settings → On Demand 暫停隨選連線，再關閉 Home 頂端的開關。若只中斷連線但保留觸發條件，之後網路變更或再次評估時可能重新連線。若仍會重連，請再檢查其他自動連線設定。
同一個 Wi-Fi，為什麼有時連線、有時不連線？
確認實際 SSID，並檢查是否切換到名稱不同的另一個頻段網路。接著確認公共網路驗證是否已完成。先暫時移除其他條件，只保留這一項重現問題，避免把網路不可用誤判為條件失效。
VPN 已連線，為什麼目標網頁仍無法開啟？
在 Home 執行 Connectivity Test，確認目前伺服器可用。接著檢查 Global Routing 與 Config 的規則命中情況。若只有特定網域無法連線，再檢查 DNS 和 REJECT 規則，不要直接重建所有 VPN 設定。
設定網域條件後，重新整理網頁卻沒有觸發？
先確認沒有其他條件提前連線，再檢查網域欄位是否包含 URL 路徑。以新發起的連線進行測試，並確認系統 DNS 快取與 App 的解析方式。不能只憑一次重新整理就判定網域條件未生效。
每次測試至少記錄以下四項。只有在網路條件、連線狀態與請求結果能相互對照時，才能判斷自動化設定是否符合預期。建議一次只變更一個項目，確認後再加入下一項。
- 目前網路：實際 SSID，或目前使用的行動網路。
- 預期動作：應連線、應中斷，或等待網域條件評估。
- 實際狀態：系統 VPN 狀態，以及 Home 顯示的連線狀態。
- 請求結果：Connectivity Test 結果、新網頁是否開啟，以及對應請求採用的策略。
需要復原時，先停用 On Demand，再還原先前記錄的條件與目前設定。恢復手動連線並確認可用後，再逐項啟用自動化。依照這個順序，能分別處理伺服器故障、規則問題與連線觸發問題。