代理模式與常用設定

Global Routing：Config、Proxy、Direct

功能說明：Global Routing 決定進入 Shadowrocket 處理範圍的請求採用哪種路由方式。Config 對應配置，Proxy 對應代理，Direct 對應直連。這與 Home 的連線開關是不同概念：選擇模式不代表連線已建立，也不能取代伺服器參數檢查。模式名稱描述的是流量處理方式，不代表網路品質等級。

位置與用途：在 Home 開啟 Global Routing 查看目前選項。需要依目標區分處理方式時，使用 Config；想暫時排除規則影響、檢查所選伺服器是否可用時，可使用 Proxy；想確認不經代理伺服器的連線狀況時，可使用 Direct。切換前記下原本選項，測試後再恢復。

設定方式：初次使用時，先在 Home 選取伺服器，再進入 Global Routing 選擇所需模式，返回 Home 開啟連線，並依系統提示允許加入 VPN 設定。接著以同一目標測試連線。若從 Proxy 切換至 Config 後才出現異常，應先檢查配置，而非立刻重新填寫所有伺服器參數。

注意事項：Proxy 不代表裝置上的所有通訊都一定經過代理；系統服務、區域網路、排除路由與 App 行為都可能影響實際路徑。要確認特定請求的處理結果，請查看連線記錄與命中規則。Direct 也不是「中斷」按鈕；若要停止用戶端處理連線，請操作 Home 的連線開關。

Rule：比對條件與處理策略

功能說明：一條規則通常由類型、比對內容與策略組成。DOMAIN 用於完整網域名稱，DOMAIN-SUFFIX 用於網域及其子網域，DOMAIN-KEYWORD 依網域中的關鍵字比對。GEOIP 使用 IP 位址歸屬資料，IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 網段。USER-AGENT 適用於可取得相應請求資訊的情境，不能視為適用於所有 App 的識別方式。

位置與用途：在 Config 確認目前使用的配置，再查看其中的 Rule。PROXY 表示交由代理策略處理，DIRECT 表示直接連線，REJECT 表示拒絕請求。Global Routing 中的 Proxy、Direct 是全域模式名稱；規則中的 PROXY、DIRECT、REJECT 則是比對後採用的處理策略，請留意大小寫與使用情境。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
GEOIP,CN,DIRECT
FINAL,PROXY

設定方式：先備份目前配置，在 Rule 中將範圍較小、意圖明確的規則放前面，範圍較大的規則放後面，最後以 FINAL 處理先前未比對到的請求。上述範例中，example.com 及其子網域會先比對 PROXY；未命中的請求才會繼續往下判斷。範例網域僅用於說明語法，不代表可用的代理伺服器。

注意事項：規則通常由上往下判斷，先比對到的規則會影響最終結果。範圍過廣的 DOMAIN-KEYWORD 可能誤擋正常網域，太早出現的網段規則也可能覆蓋後續的特殊規則。測試時請保持 Global Routing 為 Config，並核對命中規則；只看頁面能否開啟，無法證明流量採用了預期策略。完整欄位與順序範例請見規則與配置參考。

Subscribe 與伺服器管理

功能說明：伺服器項目會儲存單次連線所需的位址、連接埠、協定與驗證參數；Subscribe 則儲存用戶現有訂閱的取得位置，用來更新一組伺服器資訊。訂閱與 Config 是不同類型的資料：更新訂閱是維護伺服器清單，配置檔則決定 DNS、規則及其他處理方式；匯入其中一種，不代表另一種也已設定完成。

位置與用途：在 Home 查看伺服器與訂閱群組。手動輸入通常從 Add Server 開始；匯入現有訂閱時選擇 Subscribe，並填入服務提供者給的完整連結。Scan QR Code 適用於已有的 QR Code，Import from Cloud JSON 用於相應格式的資料。使用前請先確認匯入內容的類型，避免把一般網頁網址誤當成訂閱連結。

1. 確認現有資訊對應 Shadowsocks、VMess、VLESS、Trojan 或其他實際使用的協定，勿憑名稱猜測類型。
2. 訂閱方式請保留完整連結，包括必要的查詢參數；手動設定則逐項填寫位址、連接埠、驗證資訊及 TLS 等參數。
3. 儲存並執行更新，確認 Home 出現預期項目，再選取伺服器進行 Connectivity Test。
4. 為不同來源群組加上容易辨識的備註，更新前後核對數量變化與失效項目，避免重複匯入相同來源。

注意事項：訂閱更新可能會覆蓋由該訂閱管理的項目，手動修改的伺服器請另外記錄。刪除訂閱前先確認所屬群組，勿一次清空整份清單。訂閱連結通常包含個人存取憑證，不應直接貼在公開求助截圖中。若節點清單為空，先確認連結有效性、現有服務狀態與回傳格式，再決定是否重新匯入；完整操作請見快速入門。

On Demand：按需連線

功能說明：On Demand 可依網路條件觸發或維持用戶端連線。它處理的是「何時連線」，Rule 處理的則是「連線後如何處理請求」，兩者不能互相取代。啟用 On Demand 不會自動修正伺服器參數，也不會將所有流量改為 PROXY；實際分流仍由 Global Routing 與目前配置決定。

位置與用途：在 Settings 查看 On Demand 相關選項。可用條件與系統行為以目前裝置顯示的項目為準；部分版本可能允許區分網路類型或指定網路。請先看清楚各條件的意義，再決定是否儲存，不要把未顯示的選項當成必填項目。

設定方式：先手動連線並確認可以正常使用，再啟用 On Demand，逐項設定需要自動連線的條件。儲存後，從 Wi-Fi 切換至行動網路，再切回原網路，觀察 Home 的連線狀態與實際請求。若要暫時停止自動重新連線，應先關閉相關 On Demand 條件，再關閉連線，避免剛關閉後又被系統條件觸發。

注意事項：公共網路可能需要先登入認證頁面；若自動連線影響登入，可暫時停用 On Demand，完成登入後再恢復。切換網路後短暫等待不一定是規則故障，請先確認用戶端是否已重新建立連線。長期使用前，建議測試鎖定螢幕、喚醒與切換網路三種情境，而非只在目前 Wi-Fi 下檢查一次。

Data：查看流量統計

功能說明：Data 顯示用戶端能記錄的流量與連線活動，可用來觀察一段時間內是否持續傳輸、上傳與下載是否異常，以及某項操作是否產生請求。這是用戶端側的觀察結果，不是服務提供者的計費帳單，也不應直接據此推斷訂閱剩餘流量。

位置與用途：開啟 Data，先查看統計範圍、起算條件與目前可用的分類。若介面提供依伺服器或時間查看的選項，比較時應維持條件一致。例如比較更換伺服器前後的資料時，須同時記錄所選項目與操作時間，否則容易把累計值誤認為單次連線的用量。

使用方式：排查問題時先記下目前數值，停止無關的背景下載，再執行一項明確操作，例如開啟網頁或下載自己的測試檔案。返回 Data 查看數值變化，並搭配連線記錄檢查目標位址與處理策略。若要重設統計，先保存仍需參考的資訊，再使用介面提供的重設功能。

注意事項：系統背景活動、重試與連線本身的開銷都可能影響統計；DIRECT 請求是否計入特定分類，須依實際統計口徑判斷。流量增加只代表發生了傳輸，不能單獨證明目標內容已完整載入。若遇到「有流量但網頁打不開」，請繼續檢查 DNS、TLS、伺服器可用性及命中策略，不要只憑累計數據判斷服務正常。

Settings：DNS 與 Test Method

DNS：先檢查目前配置，再調整解析設定

功能與位置：DNS 會將網域名稱解析為 IP 位址。相關選項可在 Settings 與目前 Config 的 DNS 欄位中查看；同名設定的實際作用也取決於配置內容，不要只修改 Settings 而忽略目前啟用的配置。網域規則是否命中、位址規則採用何種結果，也可能與解析過程有關。

設定方式：修改前先保存原值，確認故障是所有網域都無法連線，還是只有少數目標異常。一次只調整一個解析相關選項，再以相同目標重新測試並查看解析結果。若使用加密傳輸的解析方式，請確認目前網路與所選路由能連到該解析服務。需要固定網域對應時，應先了解 Host 的用途，不要長期以臨時位址取代正常解析。

注意事項：更換 DNS 無法解決密碼錯誤、連接埠錯誤或訂閱失效。快取也可能導致修改後未立即生效；重新測試前，請關閉並重新建立相關連線，必要時使用介面提供的快取處理功能。涉及特定配置欄位與範例時，請逐項參照配置欄位中的說明，不要同時替換整份配置與解析設定。

Test Method：區分測試成功與實際可用

功能與位置：Settings 中的 Test Method 會決定 Connectivity Test 採用的檢測方式。不同方式檢查的層級不同：連接埠能建立連線，不代表驗證、TLS 與目標網站都能正常使用；以請求為基礎的測試也會受到測試目標本身狀態影響。

設定與注意事項：依目前版本提供的測試方式選擇，保持測試目標與網路環境一致，再比較同一組伺服器。單一項目測試失敗時，請檢查伺服器參數與測試目標，不要只憑一次結果就刪除項目；測試成功後仍應開啟連線進行實際操作。顯示的耗時僅適合在相同測試條件下比較，不等於下載速度，也不代表所有網站的回應狀況。

Today Widget 與 iCloud 同步

Today Widget：使用捷徑後仍須確認狀態

功能與位置：Today Widget 是系統允許時提供的快速檢視或操作入口。先在 Settings 查找相關選項，再依裝置目前系統提供的方式新增元件。不同系統版本的元件形式、新增位置與可操作內容可能有所不同；此功能並非所有平台都有的共通入口。

設定與注意事項：先在 Home 完成伺服器選擇與首次連線，再新增元件並測試實際操作。元件顯示的狀態可能尚未更新，點選後應返回 Home 確認目前伺服器、Global Routing 與連線結果。若元件未出現，先確認系統支援與 App 設定，無須為了單一捷徑入口刪除現有配置。

iCloud：同步範圍與還原順序

功能與位置：iCloud 相關選項用於同步或從雲端匯入目前版本支援的資料，並取決於裝置上的 iCloud 狀態與相關權限。App 購買記錄、用戶端資料與訂閱服務是不同事項；登入同一個 iCloud 不代表已取得所有訂閱，也不表示所有平台都會自動顯示相同的伺服器清單。

設定方式：在 Settings 檢查同步選項，確認目前裝置允許 Shadowrocket 使用 iCloud，並閱讀介面說明的同步範圍。首次啟用前先保留本機配置；在另一部裝置匯入或同步後，核對配置名稱、伺服器群組與啟用狀態，再開啟連線。若遇到同名內容，先比較實際欄位，避免以空白資料覆蓋現有內容。

注意事項：同步不等於獨立備份，刪除或修改也可能同步到其他裝置。含有訂閱網址或驗證資訊的資料應妥善保管，匯出檔案不要放在公開目錄。跨裝置排查時，先檢查帳號、權限與網路，再檢查 App 內容；不要反覆刪除所有資料，試圖強制觸發同步。

Diagnostics：逐層定位問題

功能與位置：Diagnostics 是收集診斷線索的入口，可在 Settings 尋找目前版本提供的工具。它可以與 Home 中的 Connectivity Test 及連線記錄互相補充：前者協助觀察網路與用戶端狀態，後兩者分別用來檢查伺服器測試結果與個別請求。診斷資訊用於縮小問題範圍，單一錯誤訊息不代表整份配置都已損壞。

1. 確認基本網路。檢查目前網路是否已完成認證，以及一般直連是否正常；若網路本身無法使用，請先恢復網路連線。
2. 確認伺服器資訊。核對位址、連接埠、驗證欄位與現有服務狀態，並使用 Connectivity Test 取得相同條件下的測試結果。
3. 確認路由模式。記下 Config 下無法連線的目標，暫時切換至 Proxy 進行比對；若結果不同，再檢查 Rule 與所選策略。
4. 確認解析與交握。分別檢查 DNS 結果、TLS 相關參數與連線錯誤，不要將解析失敗與驗證失敗混為一談。
5. 重現後再記錄。清楚記下操作順序、使用的網路、目標網域、目前模式與可見錯誤；測試完成後恢復原設定。

注意事項：一次只修改一類設定。若同時更換伺服器、DNS 並替換 Config，即使恢復正常，也難以判斷原因。分享記錄或截圖前，請遮蔽訂閱連結、密碼、驗證欄位、個人位址與其他敏感資訊；保留錯誤類型及必要的相關資訊即可。若只有特定目標無法連線，先針對該目標排查，不要直接重設整套環境。