Shadowrocket 官方手冊

Shadowrocket 代理模式與常用設定

連線已啟用,不代表所有請求都會經過代理。先在 Home 確認 Global Routing,再視需要檢查規則、伺服器或 On Demand 連線條件。

以下以 iPhone / iPad 的介面用語為索引。其他平台請以客戶端實際顯示的選項與入口為準。

HOME / GLOBAL ROUTING

Global Routing 的三種常用模式

日常依規則區分流量時選 Config;暫時驗證代理路徑時選 Proxy;想確認目前網路能否直接連線至目標時選 Direct。在 Home 開啟 Global Routing,選取對應模式後返回 Home,確認顯示的模式與連線開關。這項設定會改變連線的處理方式,不會更換伺服器,也不等同於關閉連線開關。

介面選項連線處理方式適用時機
Config(設定)依目前設定中的規則,決定符合條件的請求使用哪種策略。日常分流;確認特定網域是否符合預期規則。
Proxy(代理)由客戶端接管的連線都經由代理,不逐條依規則決定直連或代理。在伺服器維持不變的情況下,暫時驗證代理路徑。
Direct(直連)由客戶端接管的連線不經代理伺服器轉送。以相同目標確認目前網路的直連狀況。

排查時固定使用相同網路、位址與伺服器,每次只切換一種模式,並重新送出請求。若 Proxy 可以連線,但 Config 不行,先查看實際命中的規則,尤其是涵蓋範圍較廣的規則與回退策略。若 Direct 和 Proxy 都失敗,光是切換模式無法判定原因,還需檢查網路、網域解析或目標服務。測試結束後請恢復原模式,避免暫時設定影響日常使用。

CONFIG / RULE

規則分流:比對範圍與策略

規則由比對條件與處理策略組成。在 Home 選擇 Config 模式,再前往 Config 確認目前啟用的設定檔。編輯前先保留可還原的副本,並將範圍較精確的條件排在範圍較廣的條件之前。規則通常依序比對;前面的規則一旦符合,後面更精確的規則也不會取代它。

常見比對類型

  • DOMAIN 比對完整網域;若只針對單一主機,不必擴大到整個網站。
  • DOMAIN-SUFFIX 比對指定網域及其子網域;DOMAIN-KEYWORD 比對網域中出現的字串,比對範圍較容易超出預期。
  • IP-CIDR 和 IP-CIDR6 分別比對 IPv4 與 IPv6 網段;GEOIP 依據目標 IP 的地理位置資料比對,不以網域後綴為依據。
  • FINAL 放在規則末尾,用來處理前面都未命中的連線。修改這項規則會影響所有未個別列出的目標。

策略與順序範例

PROXY 會將符合條件的連線導向代理路徑,DIRECT 會直接送出連線,REJECT 則會拒絕符合條件的連線。以下僅示範規則順序,並非通用設定:在同屬 example.com 的請求中,個別列出的主機會先符合第一行,其餘符合後綴條件的請求才會符合第二行。

DOMAIN,assets.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

同一個頁面可能會連線至登入、圖片與 API 等不同網域。若頁面部分內容載入失敗,先確認是哪個請求失敗,再檢查對應網域是否符合前面的規則,不要直接放寬整個網域後綴。儲存修改後,確認啟用的確實是剛編輯的設定,再以新請求重新測試。更多比對範圍請參閱規則關鍵字說明。

HOME / SUBSCRIBE / ADD SERVER

訂閱與伺服器管理

若同一訂閱會一併管理多台伺服器,請使用 Subscribe;只有單台伺服器的連線參數時,可使用 Add Server 手動新增。訂閱連結請向你的服務商取得。在 Home 的新增入口選擇相應方式,匯入後確認清單中是否出現預期項目,再選取要使用的伺服器。清單中出現項目只代表匯入完成,不表示伺服器已可使用。

手動新增時,先依現有資料確認協定類型,再逐項填入位址、連接埠及該協定要求的驗證欄位。不同協定顯示的欄位不盡相同;若缺少某項資料,請先確認原始參數,不要填入其他協定的值。若使用 Scan QR Code 匯入現有 QR Code,完成後仍須確認新增項目的協定與名稱。

更新訂閱後,先確認目前選取的項目仍在清單中,再使用 Connectivity Test 檢查是否可連線。建議為手動新增項目與訂閱項目設定容易辨識的備註,以便更新或刪除時確認操作對象。測試結果僅反映所選測試方式與當時的網路狀況;即使測試成功,仍應開啟實際要使用的服務確認。訂閱網址可能包含存取憑證,排查時只分享已移除敏感欄位的資訊。詳細步驟請參閱伺服器管理手冊。

SETTINGS / ON DEMAND

On Demand 按需連線

On Demand 決定何時依條件自動建立連線;Global Routing 則決定連線建立後如何處理請求。前往 Settings 檢查 On Demand。啟用前先手動連線一次,確認系統連線權限、伺服器與目前的分流設定都能正常運作,避免自動觸發失敗與伺服器本身無法使用的情況混淆。

先為 Wi-Fi 或 Cellular 設定所需條件,再從目前的網路切換至另一種網路,然後返回 Home 查看結果。若介面支援依 Wi-Fi 網路設定不同條件,輸入網路名稱後請透過該網路實際測試,不要只因儲存成功就認定條件已生效。切換前後都要確認連線狀態,並送出新的請求;已開啟頁面的快取或先前建立的連線,無法用來判斷剛才的切換是否觸發。

若手動中斷連線後又自動連上,先確認目前網路是否仍符合 On Demand 條件。若要對照測試一次不自動重新連線的情況,可先關閉 On Demand,再手動中斷連線。測試結束後恢復原設定,並確認一次網路切換。這樣可區分自動觸發與手動切換的行為。

DATA / TRAFFIC

Data 流量統計

Data 用來查看累計上傳與下載流量,不是即時速率,也不是服務商的計費帳單。開啟 Data 後,先確認目前的統計維度:依伺服器查看時,比較的是各伺服器名下記錄的流量;依應用程式查看時,比較的是客戶端可歸類至各應用程式的流量。兩種檢視方式回答的問題不同,不必要求每個項目都能一一對應。

要驗證某次操作時,先記下讀數與單位,再只開啟一個目標頁面;操作完成後回到相同檢視畫面查看增量。清除統計資料前,先記下仍需要的讀數,清除後再記錄新的觀察起點。快取、背景請求與連線重複使用都會影響增量;伺服器讀數沒有明顯變化,不能單獨證明請求經由 DIRECT 傳送。若要確認特定請求的路徑,還須一併檢查 Global Routing 與可用的診斷記錄。各項統計的計算方式請參閱Data 流量統計說明。

SETTINGS / CHECKLIST

Settings 常用項目

DNS:確認生效位置

DNS 會將網域解析為連線所需的位址。請在 Settings 檢查 DNS 相關選項,並前往 Config 確認目前設定是否另行指定解析方式。需要調整時,先記下原值,每次只修改一處,再以相同網域送出新請求。解析成功只代表取得位址,不等於已成功連線至目標;若問題仍未解決,請繼續檢查分流策略與伺服器。

Test Method:統一測試條件

Test Method 會決定 Connectivity Test 使用哪種方式檢查連線。在 Settings 找到 Test Method 並選定測試方式後,返回 Home 對同一台伺服器重新測試。比較多次結果時,盡量維持網路與測試方式一致;若變更了測試方式或目標,就不要直接比較兩次數值來判斷伺服器變快或變慢。

Today Widget:確認快速入口

Today Widget 可在系統支援的小工具區域提供快速入口。前往 Settings 確認 Today Widget 項目,再依系統提供的方式新增或管理小工具。操作小工具後,返回 Home 確認 Shadowrocket 的連線開關與 Global Routing;快速入口的顯示狀態無法用來確認某個請求符合了哪條規則。

iCloud:確認同步內容

透過 iCloud 在裝置間同步時,先在 Settings 確認同步選項與目前允許同步的內容,並確認兩台裝置使用的是預期的 iCloud 帳號。啟用同步前,保留需要的本機副本;同步後逐項確認設定檔、選取的設定與伺服器。請勿將同步狀態視為完整備份,也不要假定連線狀態會隨設定一併移轉。

Diagnostics:記錄可重現的問題

Diagnostics 可協助判斷問題出在解析、分流或連線。前往 Settings 查看 Diagnostics 中可用的資訊;記下目前網路、Global Routing、使用的伺服器與失敗時間,再重現一次問題。優先查看與該次請求時間相符的記錄,避免將切換網路前的錯誤當成目前問題的原因。分享給他人前,請移除訂閱連結、驗證欄位及不必要的存取記錄。

若同時啟用了多項設定,排查時先恢復至可手動連線的狀態,再逐項重新啟用。每恢復一項設定,就以相同目標進行測試,才能分辨哪些變更確實影響連線。首次設定可依使用說明的順序完成。