官方手冊 / Routing & Settings

Shadowrocket 代理模式與設定

需要依目的網址分流時,選擇 Config。暫時確認伺服器或比較目前網路時,再分別使用 Proxy 和 Direct。

以下操作以 iPhone / iPad 介面為例。Global Routing 決定如何處理請求;On Demand 則決定何時建立連線。請分別檢查這兩項設定。

01模式

Global Routing:Config、Proxy 與 Direct

在 Home 開啟 Global Routing,依照本次要驗證的項目選擇模式,再回到 Home 確認連線狀態。選擇 Config 前,先到 Config 確認目前使用的設定檔;選擇 Proxy 前,先確認 Home 中目前選取的伺服器。切換模式不會自動更換設定檔,也不會修正伺服器參數。

介面選項處理方式適用情境優先檢查項目
Config(設定檔)依目前設定檔中的規則決定處理策略。日常使用,需要部分請求經代理、部分請求直連。設定檔是否生效、規則順序及預設策略。
Proxy(代理)將由用戶端處理的請求交由代理路徑轉送。暫時確認同一目標是否可透過代理連線。目前選取的伺服器,以及伺服器參數是否正確。
Direct(直連)請求不經代理伺服器轉送。比較基本網路是否可連線,或暫時測試本機服務。系統網路是否正常;Direct 不代表關閉連線開關。

排查時請使用相同網路和測試網址;每次切換模式後,都重新送出請求。若 Proxy 可以連線、Config 卻不行,先檢查是否套用到非預期的規則,或 Config 是否使用了不同的策略與伺服器。若 Direct 也無法連線,先確認目前網路是否需要登入入口,再檢查目標服務是否可連線。測試完成後,切回日常使用的模式,避免長期保留臨時排查設定。

02規則

規則分流:先比對條件,再套用策略

規則會將請求特徵與處理策略寫在一起。在 Config 開啟目前使用的設定檔,查看規則區段並確認排列順序;接著回到 Home,將 Global Routing 設為 Config。若範圍較廣的條件排在前面,請求可能已先符合該規則,後續較具體的例外便不會生效。新增例外時,先找出可能涵蓋該例外的規則,再將例外排在該規則之前。

依請求特徵選擇規則類型

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
分別依完整網域、網域後綴及網域中包含的關鍵字比對。只處理單一主機時,優先使用 DOMAIN;要涵蓋主網域及其子網域時,使用 DOMAIN-SUFFIX。關鍵字可能比對到不相關的網域,修改後應確認實際命中範圍。
IP-CIDR / IP-CIDR6 / GEOIP
前兩項依 IPv4、IPv6 位址範圍比對;GEOIP 則依目標 IP 的地理資訊比對。網域解析出多個位址時,命中結果可能隨實際使用的位址而異。GEOIP 判斷的是 IP 的地理位置,不是網域後綴,也不是網站營運者所在地。
USER-AGENT / FINAL
只有在用戶端能取得相應請求欄位時,USER-AGENT 才適用,不能當作通用的應用程式識別條件。FINAL 用來為先前未命中規則的請求指定預設策略,應放在規則清單最後。

逐一驗證 PROXY、DIRECT 與 REJECT

PROXY 透過代理轉送,DIRECT 直接連線,REJECT 拒絕符合條件的請求。例如:

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

第一條規則讓單一主機直連,第二條處理其餘符合網域後綴的請求,第三條則處理未命中的請求。這些網域僅供示範,直接照用不會自動為實際服務建立規則。驗證時,分別選擇一個例外目標及一個應符合後綴規則的目標,重新送出請求後查看可用的連線記錄。若前者意外經代理連線,先確認網域是否完全相符,再檢查規則順序及目前啟用的設定檔。

03伺服器

匯入訂閱與管理伺服器

若已有服務供應商提供的訂閱網址,請在 Home 開啟 Add Server,選擇 Subscribe 並輸入該網址。儲存後,在 Home 確認匯入的項目,並明確選取本次要測試的伺服器。成功新增代表清單已建立,不代表清單中的每台伺服器都能連線。更新後若項目名稱或數量有變,請重新確認目前選取的項目,尤其留意原先使用的項目是否已遭移除。

若只有單一伺服器的參數,請在 Add Server 選擇與服務供應商資料相符的協定,再依介面填入位址、連接埠及該協定所需的驗證欄位。若已有 QR Code,可使用 Scan QR Code 匯入;儲存前仍須確認匯入後的協定與位址。即使兩份資料的位址和連接埠相同,不同協定所需的欄位也不能互換。欄位差異請參閱協定技術參考。

訂閱載入失敗時,先確認複製的是完整網址,並向原服務供應商確認網址是否仍有效;若清單已載入但無法連線,則檢查目前選取的項目及協定欄位。請勿混淆這兩種問題,反覆刪除再匯入。提供排查資訊時,請移除訂閱網址中的存取參數,並遮蔽密碼及金鑰。本網站不提供、銷售或推薦節點或訂閱。

04連線

On Demand:依條件建立連線

On Demand 會在符合設定條件時,讓系統嘗試建立連線;在不同網路間切換時使用,可減少手動操作。先在 Home 手動確認連線正常,再前往 Settings 開啟 On Demand,依介面提供的條件選擇要觸發連線的網路。設定完成後,切換一次 Wi-Fi 與行動網路,分別確認需要連線時能否成功連線,以及不應觸發時是否維持預期狀態。

On Demand 不會決定請求使用哪條路徑:建立連線後,流量仍由 Global Routing 及適用的設定規則處理。若手動中斷連線後,一切換網路就再次連線,請檢查 On Demand 是否仍啟用,以及條件是否涵蓋該網路。排查頻繁重新連線時,可暫時關閉 On Demand,在固定網路下測試手動連線,再恢復所需條件。如此可分辨問題是來自伺服器連線,還是網路切換時的觸發條件。

05統計

Data:查看流量與統計範圍

在 Data 查看用戶端記錄的流量。要判斷某項操作是否產生流量,先確認目前顯示的統計區間,以及上傳、下載數值;記下起始數值,執行一項明確操作後,再返回比較變化。進一步排查時,可讓裝置維持在同一網路,並減少同時進行的同步、下載或連線測試,避免將其他活動的流量算入本次觀察。

Data 顯示的是用戶端記錄,不是系統的行動數據帳單,也不等於服務供應商最終計算的用量。統計起點、納入的連線範圍及傳輸開銷都可能不同,不宜直接相減兩處的累計數字來判斷流量是否遺漏。若要確認某個網域是否經代理,應一併檢查目前模式、規則及診斷記錄;上傳或下載總量本身無法指出個別請求採用了哪種策略。

06設定

Settings:解析、測試、同步與診斷

DNS:確認有效的解析設定

DNS 會將網域名稱解析為位址。在 Settings 檢查 DNS 相關選項;使用 Config 時,也要確認目前使用的設定檔是否指定了解析設定。若網域無法解析,先保留原設定,再依網路環境或服務供應商提供的資料修改一個選項,並重新測試同一個網域。若區域網路中的內部名稱無法使用,請檢查目前的解析來源是否能辨識該名稱。成功解析出位址不代表目標連接埠可連線,後者需另外測試。

Test Method:統一測試條件

在 Settings 查看並選擇 Test Method,再回到 Home 執行 Connectivity Test。比較同一台伺服器前後的結果時,請維持測試方式、網路及測試目標一致;若介面允許編輯測試網址,請使用可正常連線且適合測試的目標。單次測試成功,只代表當下的探測成功,不代表所有實際服務請求都能連線,也不能將測試耗時視為下載速度。

Today Widget:從系統小工具存取

在 Settings 查看 Today Widget 相關選項,並確認系統目前是否提供可新增的小工具入口。新增後,可用它查看小工具提供的狀態或快速操作;若要確認 Global Routing、目前的伺服器或設定檔,仍請返回 Home 或 Config。若小工具未顯示,先開啟應用程式確認連線正常,再檢查系統是否提供該小工具入口;不必因小工具未顯示而重設伺服器。

iCloud:確認同步內容

若要在自己的裝置間同步,請在 Settings 查看 iCloud 選項,確認各裝置登入同一個 Apple 帳號,且系統允許應用程式使用 iCloud。依介面說明啟用所需項目,再到另一台裝置確認項目是否出現。同步前請備份重要設定,避免在兩台裝置上同時修改同一份內容。即使設定或伺服器資訊已同步,仍應逐台測試連線及 On Demand 條件。

Diagnostics:依故障情況蒐集資訊

在 Settings 開啟 Diagnostics,先記錄故障時間、網路類型及 Global Routing 模式,再重現一次具體問題。若記錄顯示解析失敗,先檢查 DNS;若已解析但連線逾時,確認目前伺服器與目標位址;若已建立連線但存取結果異常,再檢查命中的規則及策略。每次只修改一項設定,並重新驗證;分享記錄前,請遮蔽帳號、訂閱網址及其他敏感資訊。

依裝置取得 Shadowrocket

iPhone / iPad 版於 App Store 一次性付費 $2.99,系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版免費,安裝檔由本站 /dl/ 提供。

用戶端為一次性買斷,與連線方案無關。已取得應用程式的使用者可參閱首次連線教學。

取得應用程式