官方手冊 · 功能與設定

Shadowrocket 設定詳解

先在 Home 確認伺服器,再於 Global Routing 選擇 Config。確認連線正常後,再調整 DNS 與 On Demand。本頁依「是什麼、在哪裡、如何設定、注意事項」說明常用功能,方便逐項檢查,避免一次更動所有選項。

日常分流:Config 伺服器入口:Home 排查順序:伺服器 → 規則 → DNS

Global Routing 三種模式

Global Routing 決定流量的整體處理方式,不會補齊伺服器參數。在 Home 開啟 Global Routing,可看到 Config、Proxy 和 Direct。中文說明分別是設定檔、代理與直連;實際操作時仍請依英文介面用語選取。初次使用時,先選擇自己已有且參數完整的伺服器,再決定連線模式;切換模式無法修正錯誤密碼、失效訂閱或無法連線的伺服器。

日常使用通常選擇 Config,讓目前設定檔中的規則決定流量路徑。遇到「部分網站可用、部分無法使用」時,可暫時切換 Proxy 和 Direct 進行比對:Proxy 可協助判斷所選伺服器能否處理請求,Direct 則可確認目前網路能否直接連線至目標。每次只切換一個選項並重新送出請求,測試後再切回 Config。

介面選項流量處理方式適用時機注意事項
Config(設定檔)依照目前 Config 中的規則,選擇 PROXY、DIRECT 或其他已定義的策略。日常依網域、位址或地區進行規則分流。先確認實際啟用的設定檔及規則順序。
Proxy(代理)讓交由客戶端處理的流量走代理連線。暫時比對伺服器連線狀況,區分規則問題與伺服器問題。仍須依賴所選伺服器;未交由客戶端處理的系統或應用程式流量不在此判斷範圍內。
Direct(直連)讓交由客戶端處理的流量直接連線。確認目前網路能否直接連線至目標。Direct 不代表關閉客戶端連線開關,也不代表停止 On Demand。

閱讀 Global Routing 三種模式的使用說明 →

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

規則類型決定「比對什麼」

在 Config 中開啟目前的設定檔並檢查規則項目。DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對網域後綴及其子網域;DOMAIN-KEYWORD 比對網域中的關鍵字。IP-CIDR 和 IP-CIDR6 依 IP 網段比對;GEOIP 則依 IP 位址所屬地區比對。

優先使用範圍明確的條件。DOMAIN-KEYWORD 可能比對到非預期的網域;USER-AGENT 取決於能否取得相應的請求資訊,不適合作為適用於所有加密流量的通用識別條件。

策略決定「比對後如何處理」

PROXY 表示使用代理連線,DIRECT 表示直接連線,REJECT 表示拒絕相應請求。設定檔也可能引用自訂策略名稱;該名稱必須已在設定檔中定義,不能只修改單一規則末尾的文字。

規則通常依序比對,具體條件應排在較廣泛的條件之前;FINAL 用於前面的規則都未命中時,決定最後的處理方式。排查時先確認命中的項目,不要只檢查檔案中是否出現某個關鍵字。

在 Config 中修改與驗證

先保留目前設定檔的副本,再修改單一規則並儲存;回到 Config 確認已啟用剛才編輯的檔案,接著在 Global Routing 選擇 Config。以下片段僅示範規則語法,example.com 是教學用網域範例,並非可直接涵蓋所有連線需求的完整設定檔。

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

第一條規則將範例網域及其子網域交由 PROXY 處理;第二條讓符合相應地區 IP 位址的請求走 DIRECT;最後一條則處理其餘請求。網域規則與 IP 位址規則的判斷依據不同,DNS 回傳的位址也可能影響後續 IP 規則的結果。因此,「同一網站換網路後命中不同規則」不一定表示規則沒有儲存,應搭配解析結果與連線紀錄檢查。

ConfigGlobal RoutingPROXYDIRECT

Subscribe 與 Add Server

管理項目分為伺服器、訂閱與設定檔:伺服器儲存連線參數,訂閱儲存伺服器清單的更新網址,Config 則儲存分流規則。三者用途不同,請勿將訂閱網址填入伺服器網域欄位。

Subscribe:匯入現有訂閱

在 Home 使用新增入口,選擇 Subscribe 類型,輸入自己已有的訂閱網址及方便辨識的名稱,儲存後執行更新。匯入完成後回到 Home,確認伺服器清單是否出現,再選取其中一個進行 Connectivity Test。

更新訂閱可重新取得遠端清單,但不會自動修復連線。更新失敗時,先確認網址是否完整、是否仍有效,以及目前網路能否連線至訂閱網址。不要反覆刪除再新增,以免遺失原有群組與備註。

Add Server:新增單一伺服器

開啟 Add Server,先選擇與現有資訊相符的協定,再填寫位址、連接埠及驗證欄位。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等協定所需欄位各不相同;只有在自己取得的參數明確包含該項目時,才依相應要求填寫。

TLS、傳輸方式及伺服器名稱等欄位必須彼此相符。不要因為某個選項看起來較常見就自行替換。支援的類型請以目前客戶端的類型清單為準;填寫完成後先儲存,再回到 Home 選取該項目。

單一分享連結可透過剪貼簿匯入或 Scan QR Code 處理,但請先確認內容是伺服器分享資訊,還是訂閱更新網址。不要將帳號頁面網址、含登入狀態的網頁網址,或不完整的 QR Code 文字直接當作 Subscribe 內容。

查看訂閱更新、多訂閱整理、排序與備份手冊 →

多種協定與伺服器選擇

協定說明客戶端與伺服器如何通訊,不代表連線一定更快。HTTP、SOCKS5 與其他協定也應依現有伺服器資訊選擇;協定不相符時,即使位址與連接埠可以連線,也可能無法完成驗證或傳輸。整理清單時,可利用用途、協定或群組備註區分伺服器,避免因測試結果相近就誤以為參數相同。

Connectivity Test 測試的是目前測試方法下的回應結果。單次逾時不能單獨證明伺服器失效,單次成功也不代表所有目標都能連線。先對同一台伺服器重複測試,再實際開啟目標頁面,最後搭配規則與 DNS 判斷問題所在。

On Demand 按需連線

On Demand 會依系統網路條件觸發連線,不是用來檢查伺服器是否可用的開關。請在客戶端顯示的 On Demand 入口檢查條件與總開關;實際位置及支援條件依目前平台介面為準。設定前,先以手動連線確認伺服器、Config 和 DNS 都能正常運作,再啟用按需連線,避免將基本連線故障與自動觸發行為混為一談。

  1. 記下目前的手動連線狀態與所選伺服器,並確認實際連線成功一次。
  2. 進入 On Demand,檢查現有條件。若介面提供網路類型或 Wi-Fi 條件,請依實際需求逐項設定,避免同時新增多組彼此重疊的條件。
  3. 啟用後切換至要驗證的網路,觀察系統連線狀態,並重新開啟目標應用程式進行連線。
  4. 如需保持中斷狀態,先停用 On Demand,再中斷目前連線;只關閉 Home 的連線開關,之後仍可能再次觸發條件。

如果出現「剛關閉又重新連線」,應先檢查 On Demand,而不是反覆刪除系統連線設定。若切換網路後沒有觸發,請確認條件是否符合、系統是否允許建立連線,以及客戶端儲存的伺服器是否仍可使用。各系統對背景執行的管理方式不同,不應將手動開啟應用程式後的結果視為背景觸發結果。

Data 流量統計與連線觀察

Data 可用來查看客戶端記錄的流量,協助判斷請求是否經過目前連線,以及操作前後是否有產生資料。請在 Data 或目前平台對應的統計入口查看上傳、下載與連線紀錄;實際分類及統計範圍以介面標示為準。排查時先記下目前數值,只執行一次目標操作,再返回查看變化;比起同時開啟多個應用程式,這樣更容易判斷。

Data 的統計不等於服務商的計費紀錄,也不等於系統的全部網路用量。背景應用程式、重試請求、連線耗用及計量範圍差異,都可能造成數值不同。如需核對遠端用量,請使用自己現有服務的用量紀錄,不要只依客戶端累計數值推算。

如需重設統計,先確認介面顯示的統計週期,並保存排查所需紀錄;若目前介面提供重設功能,再依提示操作。重設只適合重新觀察本機數值變化,不會重設遠端用量。分享 Data 或連線紀錄前,請遮蔽伺服器位址、訂閱網址、驗證欄位及可能揭露個人瀏覽內容的資訊。

Settings 常用項目

Settings 包含執行偏好與系統整合選項。先保留可正常使用的設定,每次只調整一個項目;修改後使用相同伺服器、相同目標與相同網路重新測試。部分 DNS 或連線參數也可能由目前 Config 控制,請先確認實際生效來源,不要同時修改設定檔與 Settings。

DNS:網域名稱解析

是什麼:DNS 會將網域名稱轉換為連線所需的位址;即使伺服器可以連線,解析失敗仍可能導致目標網站無法開啟。

在哪裡、如何設定:在 Settings 的 DNS 相關入口及目前 Config 中檢查現有設定。先確認是否手動指定解析伺服器,以及目前網路能否連線至該伺服器,再依現有設定需求調整。不要同時填入多組來源不明、用途各異的位址。

注意事項:DNS 設定不是通用的加速開關。修改後重新送出請求,必要時重新建立連線,以排除舊快取的影響。若只有部分網域異常,也應一併檢查規則命中情況、解析位址與目標服務狀態。

Test Method:測試方法

是什麼:Test Method 決定 Connectivity Test 使用的檢測方式,不直接代表實際瀏覽體驗。

在哪裡、如何設定:進入 Settings,找到 Test Method,並從目前客戶端提供的選項中選擇測試方式;若介面允許設定測試目標,請使用自己能確認可連線且適合檢測的目標。回到 Home,重新測試同一批伺服器。

注意事項:不同測試方式檢查的層級不同。僅能建立底層連線,不代表驗證、DNS 及目標頁面都能正常使用。比較伺服器前,應統一測試方法與網路條件,不要混用不同時間或不同目標的測試結果。

Today Widget:快速操作

是什麼:Today Widget 提供系統支援範圍內的快速查看或操作入口,減少進入客戶端的步驟。

在哪裡、如何設定:若目前 iPhone / iPad 版本提供 Today Widget,請在 Settings 檢查相關選項,再前往系統的元件編輯入口加入客戶端實際提供的元件。可執行的操作以元件顯示內容為準。

注意事項:元件顯示內容可能需要重新整理。若找不到預期的入口,請先確認目前系統和客戶端是否仍提供該類元件,不要直接套用其他版本的位置。快速操作也無法略過系統連線授權。

iCloud 同步:跨裝置設定

是什麼:iCloud 同步可在支援此功能的裝置間同步客戶端列出的資料,不等同於完整的系統備份。

在哪裡、如何設定:先確認系統已登入自己的 iCloud 帳號,並允許相關存取權限,再到 Settings 檢查 iCloud 同步選項。啟用前請保留本機設定檔副本,並逐項核對目前介面標示的同步範圍。

注意事項:不要在兩部裝置上同時編輯同一份內容。先在一部裝置儲存並等待同步完成,再到另一部裝置確認;訂閱驗證資訊屬於敏感資料,備份與同步前應先了解其儲存位置及帳號存取權限。

Diagnostics 與故障排查順序

Diagnostics 可用來收集連線與執行線索。在 Settings 中尋找 Diagnostics 或目前版本對應的診斷入口,先記錄問題發生時的網路、所選伺服器、Global Routing 模式及目標操作,再使用介面提供的工具檢查。診斷結果應與實際請求相互對照;缺少發生時間與操作背景的紀錄,很難判斷是哪個環節出了問題。

  1. 先檢查伺服器:在 Home 確認選取的項目,核對位址、連接埠、協定及驗證欄位,再執行 Connectivity Test。成功匯入訂閱只代表成功取得清單,不代表每台伺服器都能連線。
  2. 再檢查模式:使用 Proxy 與 Config 比對同一個目標。若 Proxy 可用但 Config 無法使用,優先檢查規則命中情況與自訂策略引用;若兩者都無法使用,再檢查伺服器與解析狀況。
  3. 單獨檢查 DNS:確認故障是否集中在特定網域,並查看解析錯誤。不要同時更換伺服器、DNS 和規則,否則無法判斷是哪項修改產生影響。
  4. 最後檢查系統條件:檢查連線授權、On Demand 條件及網路切換行為。必要時停用自動觸發,先確認手動連線結果穩定且可重現。

在 Diagnostics 匯出或複製資訊前,先檢查內容是否包含訂閱憑證、伺服器驗證資訊及個人瀏覽紀錄。排查通常只需要錯誤類型、操作順序與相關設定,不需要完整的敏感連結。問題排除後,請恢復日常使用的 Config,並逐項還原測試期間所做的變更。

連線開關已開啟,為什麼網頁還是無法開啟?

開啟開關代表客戶端正在嘗試建立或維持連線,不代表目標請求一定成功。先確認伺服器並執行 Connectivity Test,再以同一個目標比對 Proxy 和 Config,最後檢查 DNS。若只有一個應用程式異常,也請重新啟動該應用程式的連線,並檢查其網路狀態。

修改規則後,為什麼 Data 看起來仍走舊路徑?

先確認 Global Routing 設為 Config,而且目前選取的是剛編輯的設定檔。既有連線可能沿用先前的路徑;重新送出請求後,再查看對應的新連線紀錄。不要根據累計流量的變化,直接判斷某條新規則是否命中。

取得客戶端後,會自動出現可用伺服器嗎?

需要匯入自己已有的訂閱或伺服器資訊。客戶端一次性買斷 ≠ 連線服務方案。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。客戶端的取得方式與連線至既有服務所需的資料分開管理。

依首次連線順序查看使用教學 →