官方手冊 · 設定

Shadowrocket 功能與常用設定

先確認流量採用哪種處理方式,再調整規則、連線條件與診斷選項。每次只修改一項,並保留可還原的原始設定。

  • Home · 連線與伺服器
  • Config · 設定檔與規則
  • Settings · 一般選項

Global Routing:設定、代理與直連

用途與位置:Global Routing 位於 Home,用來選擇目前連線的整體處理方式。設定檔對應 Config,代理對應 Proxy,直連對應 Direct。它決定如何套用設定檔中的規則與伺服器,並非獨立的連線品質開關;即使選好模式,仍須確認連線開關、系統 VPN 設定權限及目前使用的伺服器。

設定方式:在 Home 開啟 Global Routing,依使用目的選擇模式。已有可用的規則設定檔時,通常先選 Config;若要暫時排除規則比對的影響,可切換至 Proxy 作為對照;若要觀察目前網路直接連線的結果,可使用 Direct。切換後請重新送出目標請求,必要時關閉再開啟目標 App,避免沿用舊連線。

模式與介面名稱 主要行為 適用的核對情境 優先檢查項目
設定檔 Config 依照目前生效設定檔中的規則與策略處理請求。 日常依目標分流,或確認特定規則是否符合。 設定檔是否生效、規則順序、策略指向。
代理 Proxy 整體採用代理方式處理,不依 Config 中的一般分流規則選擇。 對照測試目前伺服器與目標之間是否連通。 目前選取的伺服器、協定參數、目標是否可連線。
直連 Direct 整體透過目前網路直接連線。 建立直接連線的基準,排除伺服器路徑的影響。 本機網路、DNS 解析、目標服務狀態。

注意事項:Direct 不代表從系統移除 VPN 設定,Proxy 也不保證所有 App 的各種連線都能成功。DNS、既有連線及實際設定仍可能影響觀察結果。排查完成後,請將 Global Routing 設回實際需要的模式,避免忘記對照測試時做過的變更。

Config 與規則分流:先比對條件,再確認策略

用途與位置:規則分流會依網域、位址等條件,決定請求使用 PROXY、DIRECT、REJECT 或設定檔中定義的策略。設定檔在 Config 中管理;若要讓規則正常參與分流,須同時確認目前生效的設定檔,以及 Global Routing 是否選用 Config 模式。僅匯入設定檔,不代表它已經啟用。

設定方式:先備份原設定檔,再檢查規則區。DOMAIN 比對指定網域,DOMAIN-SUFFIX 比對網域後綴,DOMAIN-KEYWORD 依關鍵字比對。IP-CIDR 與 IP-CIDR6 分別表示位址範圍,GEOIP 則依位址歸屬資料庫判斷;這些條件不能與網域條件混為一談。規則通常依序比對,應將較具體的條件放在較廣泛的條件之前,並檢查最後的 FINAL。

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

這段內容僅示範規則語法,不能直接取代現有的完整設定檔。範例中,第一條指定網域,第二條指定另一個網域後綴,第三條示範以關鍵字拒絕請求;未符合前述條件的請求,最後會交由 FINAL 指定的策略處理。實際使用時,還須確認設定檔中有對應的策略名稱,且引用的伺服器可正常使用。

注意事項:即使條件比對正確,策略指向錯誤仍可能導致結果不如預期。USER-AGENT 等條件也取決於請求是否包含可辨識的資訊,不適合當成涵蓋所有連線的通用判斷方式。若要確認規則是否命中,請配合連線記錄查看目標、符合的規則及最終策略;不要只憑網頁能否開啟,推斷規則是否生效。

Subscribe 與 SERVER:管理既有連線資訊

用途與位置:Home 的 SERVER 區域可檢視及選取伺服器,Add Server 用來新增連線資訊;Subscribe 則用來管理使用者既有的訂閱。訂閱通常是一組可更新的伺服器記錄;Config 則是影響規則及其他行為的設定檔,兩者用途不同。匯入伺服器清單,不代表所有分流規則都已設定完成。

設定方式:請以已有自己的訂閱或伺服器資訊為前提,依快速入門說明匯入。手動新增時,在 Add Server 選擇與原始資料相符的類型,再填入位址、連接埠及驗證欄位;使用 Scan QR Code 時,請確認掃描內容來自自己準備匯入的資料。儲存後返回 Home,核對名稱、類型及目前選取狀態,再執行 Connectivity Test。

Shadowsocks、VMess、VLESS、Trojan 等協定所需欄位各不相同。請依原始資料逐項填寫,不能只靠變更類型轉換協定。TLS、傳輸方式及伺服器名稱等選項也須與伺服器端設定一致;某個欄位看似可留白,不代表目前的連線方式不需要它。

注意事項:更新 Subscribe 前,先確認其中是否有需要保留的本機調整;更新後再次檢查清單與選取項目。請勿公開訂閱網址、QR Code,或含有驗證欄位的截圖。Shadowrocket 是付費 App,一次性購買 App 不等於線路方案;本站不提供、銷售或推薦節點與訂閱,僅說明如何匯入及管理既有資料。

On Demand:依條件觸發連線

用途與位置:On Demand 可依條件決定何時嘗試建立連線。它與手動開啟 Home 的連線開關不同,連線可能由系統依已儲存的條件觸發。請前往 Settings 尋找 On Demand 相關設定,並依目前 App 顯示的網路條件與選項核對;實際位置及可用項目以 App 介面為準。

設定方式:先在手動連線狀態下確認可以正常連線,再設定按需條件。分別記下希望觸發的網路情況與例外情況,儲存後逐一切換至對應網路測試。驗證時除了查看 Home 的連線狀態,也要實際連線至固定目標,確認符合條件後使用的是預期伺服器與 Global Routing 模式。

注意事項:On Demand 無法修正伺服器參數或規則錯誤。若手動中斷後又重新連線,請先檢查按需條件,不要立刻反覆刪除系統設定。修改前記下原有條件;若遇到頻繁連線或切換網路後狀態異常,可暫時停用 On Demand,改以手動連線作為排查基準,確認原因後再逐項恢復條件。

Data:查看流量,不代表連線品質

用途與位置:Data 用來查看 App 記錄的流量資訊。進入 Data 後,先確認頁面採用的時間範圍、方向及分類方式,再比較數值。上傳、下載、單次連線與累計記錄代表的意義各不相同;App 顯示的數據也不應直接視為電信帳單或其他服務的計費依據。

設定與查看方式:若要觀察單一操作造成的變化,可先記下目前數值,再執行一項任務,例如只載入一個固定頁面,接著返回 Data 比較差異。如果介面提供清除或重設統計資料的操作,請先確認是否需要保留歷史記錄,再進行操作。在相同網路與相同任務下比較前後數值,比起隨意比較不同時間的總量,更容易判讀。

注意事項:流量數值有變化,只能表示曾有資料交換,不能證明所有請求都成功,也不能證明規則比對正確。背景工作、重試及網路切換都可能影響統計。若要判斷速度變慢或耗電異常,還須一併參考使用時間、連線記錄及系統電池資訊;不要只因累計數字增加,就修改 DNS 或更換所有規則。

DNS:確認解析路徑與設定來源

用途與位置:DNS 會將網域解析為連線所需的位址。可在 Settings 及目前 Config 的 DNS 設定中檢查相關選項;實際生效方式也取決於設定檔內容。若網域無法連線、不同網路的結果不一致,或連線記錄中的位址異常,應先確認目前解析設定的來源,再決定是否修改。

設定方式:先記錄目前是否沿用系統解析設定、是否指定解析伺服器,以及設定檔中是否還有其他 DNS 參數。需要自訂時,請使用自己確認可連線的解析服務,並依該選項的要求填入正確格式。使用 DNS over HTTPS 時,也須確保其服務位址本身可建立連線;採用加密傳輸不代表解析路徑自然符合每一項分流需求。

注意事項:每次只變更一種解析方式,保留原值,並使用同一個網域重複驗證。不要同時修改 DNS、Global Routing 與伺服器,否則難以判斷是哪項變更產生效果。直接連線至某個位址的結果,也不能直接等同於以網域連線,因為 TLS 與目標服務可能依賴網域。更多解析路徑說明請參閱 DNS 設定詳解。

Test Method 與 Connectivity Test:分清測試項目

用途與位置:Test Method 是 Settings 中與測試方式相關的設定;Connectivity Test 則是 Home 中用來執行連線測試的入口。前者決定如何測試,後者用來開始測試。查看結果前,先確認測試涵蓋哪一段連線;一次測試顯示的時間,不等於所有網站的載入速度。

設定方式:開啟 Test Method 確認目前方式,並依 App 提供的選項及測試說明選擇。若所選方式需要目標位址或其他參數,請先確認格式正確且目標可連線。返回 Home 執行 Connectivity Test;比較結果時,測試方式、目標與網路都應保持一致。若要對照另一種方式,先記錄原結果再修改。

注意事項:測試成功不代表驗證後的每個請求、DNS 解析及目標服務都正常;測試失敗也可能只是測試目標無法連線。若伺服器測試有結果但網頁無法開啟,請接著檢查 Global Routing、DNS 及目標對應的規則。若只有切換網路後失敗,請重新測試並記錄網路類型,不要將不同條件下的結果混在一起比較。

Today Widget 與 iCloud 同步:分別確認入口與資料

Today Widget:系統元件入口

用途、位置與設定方式:Today Widget 提供 App 以外的快速檢視或操作入口。先在 Settings 確認相關設定,再到系統支援的元件編輯位置查看是否能加入 Shadowrocket。元件形式、可顯示內容及可用操作,視裝置系統與 App 實際支援情況而定;系統要求以 App Store 頁面標示為準。

注意事項:元件顯示狀態與主 App 更新狀態之間可能有時間差。若要確認目前連線狀況,請返回 Home 查看並實際送出請求驗證。若找不到元件,先正常啟動一次 App,再檢查系統元件清單及相關權限;不必為了加入元件而修改已確認正常的伺服器參數。

iCloud 同步:先確認範圍,再處理覆寫

用途、位置與設定方式:iCloud 相關設定可在支援範圍內同步 App 資料。先確認系統的 iCloud 是否可用,再進入 Settings 查看 App 提供的同步選項與說明。首次啟用前,分別儲存各裝置上需要保留的設定,確認同步涵蓋哪些項目後,再執行介面提供的操作;不要預設所有伺服器、統計資料或系統權限都會一併轉移。

注意事項:同步不能取代歷史備份。若兩部裝置都曾修改設定,請先比較內容,不要反覆切換同步開關嘗試「重新整理」。更換裝置後,App 購買記錄、設定資料與系統 VPN 設定權限是不同項目,須分別確認。iPhone 與 iPad 的介面可能不同,同步結果仍應逐項檢查。

Diagnostics:依據資訊定位設定問題

用途與位置:Diagnostics 及相關診斷入口可用來收集或查看排查所需資訊,可在 Settings 中尋找。診斷不是要開啟所有選項,而是針對明確症狀,確認問題出在哪個步驟:連線未建立、測試失敗、網域解析異常,或是規則將請求導向非預期的策略。

設定與使用方式:先記下問題重現時間、網路類型、Global Routing、目前伺服器及目標網域,再透過介面提供的入口查看診斷資訊。只重複一次可穩定重現的操作,並記錄錯誤發生位置與提示。若要比較設定,請以原本能正常運作的副本為基準,每次只修改一個參數,驗證後再決定保留或還原。

注意事項:診斷資料可能包含伺服器位址、連線目標及驗證相關資訊。分享前請逐項檢查,移除訂閱網址、驗證欄位及個人連線記錄;不要直接公開完整設定檔。啟用較詳細的記錄後,請只在本次排查所需期間使用;結束後恢復原有記錄設定,並清除不再需要的敏感資料。

本頁說明設定用途與核對方式。若已遇到明確故障,可繼續閱讀 問題診斷,依開關、連線、訂閱、速度或 DNS 等症狀逐步排查。App 僅在 Apple 平台發行,唯一取得管道為 App Store;相容性、系統需求及購買適用性以 App Store 頁面標示為準。

下載 Shadowrocket