Shadowrocket 功能與設定

Global Routing：設定、代理與直連

Global Routing 決定連線開啟後採用哪種整體處理方式。在 Home 找到 Global Routing，進入後依目前需求選擇 Config、Proxy 或 Direct。這不是伺服器清單，也不是連線成功提示：選好模式後，仍須確認預設伺服器與主連線開關。若應用程式中還有更細部的設定選項，請一併檢查目前的 Config。

切換模式時的檢查方式

日常使用既有分流設定時，先選 Config，並在 Config 介面確認目前啟用的檔案。若某個目標無法正常連線，可暫時切換至 Proxy，以相同目標和伺服器進行比對；若 Proxy 可以連線、Config 卻不行，請優先檢查規則比對結果與策略指向，不要馬上更換所有連線參數。比對完成後，請切回原模式，避免將暫時的排查狀態當成長期設定。

Direct 不代表關閉客戶端。只要連線仍開啟，DNS、連線處理等行為仍可能受目前設定影響；若要判斷問題是否出在本地網路，請另外關閉主連線開關，並使用相同目標進行一次連線測試。每次只調整一個項目並記錄結果，才能分辨問題來自模式、伺服器或本地網路。

規則分流：比對條件與執行策略

規則分流將「比對哪些要求」與「比對後如何處理」分開設定。通常可在 Config 中開啟目前的設定檔，查看或編輯規則；只有採用相應的設定處理方式時，規則才會依其設定邏輯參與分流。修改前請先保留原始檔案的副本，並確認正在編輯的是目前啟用的檔案，而非名稱相似的另一份設定檔。

規則類型用來描述比對對象

DOMAIN 用於比對指定網域，DOMAIN-SUFFIX 用於比對網域後綴，DOMAIN-KEYWORD 用於比對網域中的關鍵字。網域後綴規則適合涵蓋一個網域及其子網域；關鍵字規則的涵蓋範圍較廣，可能比對到原本不打算處理的網域，因此條件應盡可能明確。

IP-CIDR 與 IP-CIDR6 分別用於描述 IPv4 和 IPv6 位址範圍，GEOIP 則依位址歸屬分類。網域連線是否需要先解析，以及解析後取得的位址，都可能影響位址類規則的結果。請勿將網域比對失敗與 DNS 解析失敗混為一談，也不要只看目標網站名稱就判斷實際套用的規則。

策略用來指定處理動作

PROXY 表示代理策略，DIRECT 表示直連，REJECT 表示拒絕。設定檔也可能引用自訂策略群組；此時還須檢查群組內最後選用的伺服器。規則通常依序比對，條件明確的規則應放在涵蓋範圍較廣的規則之前；若前面的規則都未比對成功，則由 FINAL 作為預設處理。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

以上為規則語法範例，並非完整設定。第二行的涵蓋範圍比第一行廣，目的是展示兩種比對方式；實際使用時，請依目標調整內容，並確認是否需要保留該關鍵字規則。每新增一條規則，就用明確的目標網域確認比對結果，再新增下一條，避免同時加入多種條件而難以找出問題。

Subscribe 與 Add Server：管理既有資料

Home 是選擇伺服器、查看群組及進行連線操作的主要位置。單一伺服器可透過 Add Server 填寫；已有訂閱則可從應用程式中 Subscribe 相關入口匯入。兩種方式都以使用者已持有有效資料為前提。訂閱是批次取得伺服器資訊的方式，不代表匯入後每個項目都能連線，也不代表購買客戶端就包含這些服務。

手動新增與掃描 QR Code 匯入

進入 Add Server 後，先確認 Type，再依資料填寫 Address、Port 及相應的驗證欄位。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等協定所需欄位各不相同，不能將某種協定的密碼或金鑰直接套用到另一種協定。可選參數請逐項比對既有資料；若不確定，請保留原值並向資料提供者確認。

若已有 QR Code，可使用 Scan QR Code 掃描，再確認匯入後的類型、位址與連接埠。掃描只是輸入方式，不能取代參數檢查。請為伺服器填寫容易辨識的備註，接著返回 Home 選取預設伺服器；確認選取狀態後，再開啟連線開關。清單中出現一筆資料，只能表示資料已儲存，不能據此認定連線已建立。

訂閱更新與敏感資料保護

請完整貼上既有的訂閱連結，避免開頭或結尾混入空格或換行。更新訂閱會重新取得清單內容，名稱、群組或項目可能隨資料變動；更新後請再次確認原先選取的伺服器是否仍在清單中。手動修改訂閱產生的項目之前，請先確認後續更新是否會覆蓋修改；必要時另行留存紀錄。

訂閱連結、密碼、私鑰與設定檔中的驗證資訊都應視為敏感資料妥善保存。排查問題時不必將完整連結傳給他人；可說明錯誤發生的步驟，並隱去帳號與驗證欄位。大量刪除、重新匯入或更換設定檔前，請先備份有效資料，避免將伺服器清單變動誤認為客戶端購買紀錄遺失。

On Demand：依條件觸發連線

On Demand 可依設定條件觸發連線，不是檢測伺服器品質的工具，也不會補上缺少的驗證參數。請在應用程式中進入 On Demand 相關設定，先檢查現有條件，再依實際需求調整；若目前介面的入口位置不同，可在 Settings 中尋找相應選項，並以應用程式顯示為準。

設定之前，請先以手動方式驗證連線：選取伺服器、開啟主開關並允許系統新增 VPN 設定檔，再確認目標是否能正常連線。若手動連線已失敗，請先處理伺服器、DNS 或網路問題，反覆啟用 On Demand 通常無法解決根本原因。手動驗證成功後，再檢查觸發條件，並在預計使用的網路環境中觀察實際結果。

切換 Wi-Fi 與行動網路、鎖定螢幕後再喚醒或更換網路時，連線狀態可能改變，請分別檢查。若連線剛中斷又重新連上，先確認 On Demand 是否仍處於啟用狀態，再檢查系統中是否有其他會影響 VPN 的設定。排查期間可暫時關閉 On Demand，改用手動開關；完成單一條件測試後再恢復設定。

Data：查看流量與連線線索

Data 用於查看應用程式記錄的流量資訊；具體分類、統計週期及可展開的內容，請以目前介面為準。進入 Data 後，先確認記錄的時間與統計範圍，再對照剛才進行的連線操作觀察變化。這有助於確認客戶端是否記錄到相關活動，但不應只憑累計數字判斷目前伺服器的速度或服務狀態。

需要比對時，請記下開始時間，關閉暫時不需要的背景工作，再連線至已知目標，之後返回 Data 查看相應變化。若介面提供連線詳細資訊，可進一步確認目標、處理策略及相關記錄。出現流量不代表目標頁面已成功載入；驗證失敗、重試或背景同步等活動，也可能產生資料傳輸。

Data 的統計方式可能與系統行動數據統計或既有服務帳戶中的用量紀錄不同，不能直接作為計費依據。清除紀錄前，請先保存排查所需資訊；分享紀錄時，請隱去目標中的個人識別資訊、帳戶資訊與伺服器資料。若主要問題是耗電，也請查看系統電池頁面及背景活動，不要只憑總流量下結論。

Settings：DNS、測試、元件與同步

Settings 集中常用設定與工具，但並非所有網路行為都由此處決定：目前的 Config 也可能包含 DNS 或其他相關參數。請先確認設定檔內是否已有相同類型的設定，再修改全域選項。不同裝置與系統可能顯示不同入口，以下依功能名稱說明位置，不假設所有裝置都有相同的選單路徑。

DNS：先確認解析問題，再調整設定

DNS 用於將網域解析為位址。請檢查 Settings 與目前 Config 中的 DNS 相關設定，記錄原始值與目前網路，再判斷是否有重複設定或相互影響。若伺服器位址使用網域名稱，建立連線前也可能需要先完成解析；因此，目標網站無法開啟與伺服器位址解析失敗，應分開檢查。

修改 DNS 時，每次只調整一個相關選項，並以同一個網域重複測試，觀察問題是否只出現在特定網路。不要因為某個解析位址很常見，就直接替換整份設定檔；加密解析也不代表所有連線都會成功。若調整後沒有改善，請還原原值，再繼續檢查路由規則、伺服器參數與本地網路。

Test Method 與 Connectivity Test：確認測試對象

Test Method 用於選擇相應測試所採用的方法，可在 Settings 中確認可用方式；Connectivity Test 則用於輔助檢查連線。不同方法測量的環節各不相同，伺服器回傳測試結果不代表每個網站都能連線。測試前請確認預設伺服器、網路環境與測試目標；比較結果時，請使用相同方法。

測試失敗時，先確認測試方法與目標是否適合目前伺服器，再檢查位址、連接埠及驗證參數。若測試顯示正常但實際連線失敗，請進一步檢查目標套用的規則與 DNS。不同測試方法的數值不可直接排列比較，也不能據此推斷穩定性或長期速度。

Today Widget：確認系統支援與顯示內容

Today Widget 是與系統元件相關的功能。請在 Settings 中查看相應設定，再前往系統提供的元件管理位置，確認是否可以加入以及能顯示哪些內容。入口與顯示功能會受系統支援情況影響，請以裝置實際顯示為準；元件未出現不代表伺服器故障。

元件適合快速查看或執行其提供的操作；若要確認目前選取的伺服器、路由模式或詳細錯誤資訊，仍應返回應用程式檢查。若元件與應用程式狀態暫時不一致，請先開啟應用程式重新整理並觀察，再檢查系統是否支援該元件，不必因此立即刪除既有設定。

iCloud：同步範圍與獨立備份

iCloud 相關功能可在符合支援條件時儲存或同步相應的設定內容。請在 Settings 中確認開關與應用程式說明，並確認裝置系統已允許應用程式使用 iCloud。同步前請先另行備份；在另一部裝置上開啟後，請檢查實際出現的檔案與內容，不要假設所有伺服器、金鑰與設定都會一併移轉。

App Store 的購買紀錄與 iCloud 中的設定是不同資料。還原已購買的應用程式，不代表所有連線資訊也都能還原；同樣地，設定同步完成也不能取代購買資格確認。準備換機時，可參考設定備份與移轉說明，先確認有可用的備份，再處理舊裝置上的內容。

Diagnostics：保留最小重現步驟

Diagnostics 用於收集或查看排查問題所需的診斷資訊；可用工具與輸出內容請以 Settings 中實際顯示的入口為準。請先記錄網路類型、Global Routing 模式、問題發生時間與操作步驟，再執行相應診斷。如此可將記錄對應到一次明確的失敗，避免在大量無關資訊中尋找原因。

診斷檔案可能包含網域、位址、裝置環境或設定線索，匯出與分享前請先檢查內容並隱去敏感資料。只需保留必要的錯誤資訊，不要公開完整訂閱連結、驗證欄位或私鑰。詳細的故障排查流程請參閱疑難手冊。

設定檢查順序：先建立基準，再逐項調整

功能設定應以明確目標為依據，例如「讓指定網域採用代理策略」或「只在特定網路條件下觸發連線」。請先保留目前可用的設定，並記錄伺服器、模式與 DNS 的初始狀態。不要同時更新訂閱、修改規則並更換解析方式，否則即使恢復連線，也難以判斷是哪個步驟發揮作用。

1. 確認輸入資料。在 Home 檢查伺服器是否存在，Type、Address、Port 與驗證欄位是否符合既有資料，並確認預設選取項目。
2. 建立手動連線基準。暫時排除 On Demand 自動觸發的影響，手動開啟連線，並以明確的目標確認目前狀態。
3. 確認 Global Routing。日常檢查分流時選擇 Config；需要比對時可暫時切換模式，完成後切回原模式並保留比對結果。
4. 檢查規則與解析。先確認目標是否套用預期規則，再檢查 DNS 與策略群組指向；每次只調整一個可能原因。
5. 重新檢查自動化與記錄。恢復所需的 On Demand 條件，搭配 Data 和 Diagnostics 檢查實際狀況，最後保留一份可用設定。

若目前連線已符合需求，不必為了使用更多設定而逐項啟用功能。保留容易理解、能夠驗證且可以還原的設定，比起疊加多個用途未確認的選項，更容易維護。本文屬於 Shadowrocket 官方手冊；購買與安裝入口請參閱App Store 說明，首次操作順序請見入門指南，若遇到特定錯誤，可前往常見問題查詢。