官方手冊 · 功能與設定

Shadowrocket 代理模式與常用設定

先確認 Global Routing,再檢查規則、伺服器與 DNS。以下以 iPhone / iPad 介面路徑為例,說明各項設定的用途、操作順序與驗證方式。

Shadowrocket 提供 iPhone / iPad / Mac / Windows / Android / Linux 版本;各平台的設定入口請以實際介面為準。

Global Routing:設定、代理與直連

iPhone / iPad:在 Home 查看目前模式。日常分流請使用 Config,暫時測試時再切換至 Proxy 或 Direct。

這是什麼:Global Routing 決定請求採用哪種路由方式。它與連線開關、SERVER 中選取的伺服器分屬不同層次:開關決定是否啟用連線,模式決定如何選擇路徑,伺服器則是代理連線可能使用的目標。只更換 SERVER,不會自動將 Config 切換為 Proxy,也不會讓原本符合 DIRECT 的請求改走代理。

在哪個介面:進入 Home,開啟 Global Routing,確認目前選取的是 Config、Proxy 還是 Direct。中文說明中的「設定、代理、直連」分別對應這三個英文介面詞;Config 同時也是設定管理頁面的名稱,閱讀操作說明時請區分「路由模式」與「頁面入口」。

模式請求處理方式適用情境注意事項
設定 · Config依目前啟用設定中的規則選擇策略。日常使用,需依網域或 IP 區分連線路徑。先確認已啟用的設定與規則順序。
代理 · Proxy以代理方式處理請求,用於測試代理路徑。暫時判斷問題是否出在分流規則。不代表所有系統連線都一定會經過代理。
直連 · Direct以直接連線方式處理請求。比對目標在目前網路上的直接存取情況。這不等於關閉連線開關,也不是隱私保護開關。

如何設定:① 在 Home 選取要使用的伺服器;② 將 Global Routing 設為 Config;③ 確認 Config 頁面已啟用預期的設定;④ 開啟連線並存取已知目標。需要排查時,暫時切換為 Proxy 或 Direct,對同一目標重複測試,結束後恢復原本模式。

注意事項:切換模式只能提供比對線索,不能只憑一次成功就判定原因。應用程式快取、既有長連線與 DNS 快取可能保留舊結果。切換後請重新發出請求,並記錄網路環境;如果 Proxy 可用但 Config 無法使用,請優先檢查規則是否命中及策略引用,而非立即重建所有伺服器。

規則類型與策略選擇

iPhone / iPad:在 Config 確認已啟用的設定。規則回答「比對什麼」,策略回答「命中後如何連線」。

這是什麼:規則分流會將不同目標交由不同策略處理。DOMAIN 比對完整網域,DOMAIN-SUFFIX 比對網域後綴,DOMAIN-KEYWORD 依網域關鍵字比對;IP-CIDR 與 IP-CIDR6 分別用於 IPv4 和 IPv6 網段,GEOIP 則依 IP 所屬地區資料比對。規則通常由上而下檢查,由第一條命中的規則決定後續處理,因此範圍較廣的規則不宜排在精確規則之前。

在哪個介面:從 Config 開啟目前使用的設定,查看 [Rule] 區段及其引用的策略。編輯前先保留可還原的副本,尤其要確認修改的是目前啟用的檔案,而非名稱相近的其他設定。遠端設定更新後可能覆蓋本機編輯;長期使用前,請確認設定的維護來源。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

如何設定:① 列出需要個別處理的目標;② 優先加入精確規則,再補上範圍較廣的規則;③ 為每條規則選擇實際存在的策略;④ 將 FINAL 放在末尾作為預設處理;⑤ 儲存並啟用設定後重新測試。以上是規則語法示例,不是適用於所有網路的完整設定,也不包含伺服器資訊。

注意事項:PROXY、DIRECT、REJECT 是策略關鍵字,分別代表代理、直接連線與拒絕處理,請勿翻譯後寫回規則。網域規則與 IP 規則依據的資訊不同;存取 IP 位址不等同於存取某個網域。USER-AGENT 等依賴請求資訊的規則有其適用條件,不能假定它能辨識所有加密請求。若規則未命中,請先確認實際請求目標,再調整規則順序;詳細說明請參閱名詞解釋。

訂閱與伺服器管理

iPhone / iPad:先區分伺服器訂閱與規則設定,再使用 Subscribe 或 Add Server 匯入已有資訊。

這是什麼:伺服器記錄會儲存協定、位址、連接埠與驗證參數;訂閱用於批次取得及更新這些記錄;設定檔則負責管理路由、DNS 等行為。匯入伺服器不代表相關規則已啟用,更新訂閱也不等於更新 Config 中的規則檔。分開確認這三者,可減少「清單中已出現記錄,但仍無法連線」的誤判。

在哪個介面:Home 的 SERVER 區域可查看及選取伺服器,Add Server 用於新增記錄,Subscribe 則是對應的訂閱入口。Config 用於管理設定檔;介面中的訂閱項目可能是設定,而非伺服器清單,使用前請先確認標題與匯入結果。Scan QR Code 和剪貼簿辨識只是輸入方式,不會改變原始資訊的類型。

如何設定:① 準備使用者已有的訂閱連結或伺服器參數;② 從相應入口匯入,手動輸入時先選對 Type;③ 確認位址、連接埠及協定所需的驗證欄位;④ 返回 Home,確認匯入的群組與實際選取的伺服器;⑤ 使用 Connectivity Test 初步檢查,再存取實際目標。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard、HTTP、SOCKS5 所需欄位各不相同,請勿照抄其他協定的填寫方式。

注意事項:訂閱連結通常包含存取憑證,分享截圖或診斷資料前,請遮蔽完整連結與驗證資訊。更新訂閱可能會改變記錄名稱、數量或群組,更新後請重新確認目前選取的項目。手動修改由訂閱產生的記錄,也可能在下次更新時被取代。發生問題時,先區分「訂閱無法下載」、「內容無法辨識」和「匯入後連線失敗」,再前往疑難排解手冊依症狀檢查,請勿反覆刪除仍有效的記錄。

On Demand 按需連線

iPhone / iPad:先確認手動連線正常,再設定 On Demand 的網路觸發條件。

這是什麼:On Demand 會依系統支援的條件決定是否建立連線,處理的是「何時連線」,而不是「特定網域要採用哪種策略」。網域與 IP 的路徑選擇仍須回到 Global Routing 與設定規則檢查。On Demand 也無法修復失效的伺服器、錯誤的驗證參數或已無法存取的訂閱。

在哪個介面:在 Settings 中尋找 On Demand,確認已啟用的條件及適用網路。相關選項會因平台、系統與應用程式的實際介面而異;若目前裝置未顯示某個選項,請勿直接套用其他平台的設定路徑,也不要以修改無關的開關替代。

如何設定:① 暫時停用 On Demand,確認手動啟用後可正常存取目標;② 記錄目前的規則與伺服器選擇;③ 啟用所需的觸發條件,一次只調整一項;④ 在 Wi-Fi 與行動網路之間切換,觀察連線狀態;⑤ 返回原本網路再次驗證,確認結果可重現。

注意事項:若手動中斷後連線又自動出現,請先檢查 On Demand 條件,不要直接判定為開關故障。按需連線與背景重新整理是不同設定,系統也可能限制連線排程。網路名稱、網路切換及休眠後恢復都會影響重現結果,排查時請記錄觸發前後的網路環境。

Data 流量統計

iPhone / iPad:Data 用於查看用戶端記錄的流量,不能取代系統帳單或既有服務的用量紀錄。

這是什麼:Data 提供應用程式記錄範圍內的流量資訊,可用於觀察連線活動與流量異常增加。統計結果取決於顯示的時間範圍、累計起點及用戶端實際記錄範圍,不宜直接視為整台裝置的行動數據用量,也不能作為判斷線路剩餘額度的唯一依據。

在哪個介面:開啟 Data,先確認統計項目名稱與目前時間範圍,再查看數值。若要判斷某次測試是否產生流量,請在測試前後讀取同一項指標;直接相減不同時段、不同網路或不同統計口徑的數字,通常無法得出有效結論。

如何設定:① 記下測試前的統計值與時間;② 關閉無關的下載或同步工作;③ 只執行一次明確的存取操作;④ 返回 Data 查看變化;⑤ 配合目前的路由模式、目標與網路類型判讀結果。若要清除統計資料,請先保存比對紀錄,並確認介面提供的是哪一種重設操作。

注意事項:流量增加不能單獨證明目標已完整載入;上傳、重試及背景連線也可能造成流量變化。若用量偏高,請先檢查系統背景工作、同步活動與連線重試,不要立即歸因於某條規則。需要核對費用或額度時,請分別查看系統行動數據紀錄與使用者既有服務的用量資訊。

Settings 常用項目

iPhone / iPad:先確認設定的作用範圍;每次只修改一項,並保留還原方式。

DNS:網域解析與設定來源

這是什麼、在哪裡:DNS 會將網域名稱解析為位址,相關設定須一併檢查 Settings 與目前的 Config。解析失敗與代理連線失敗是不同問題;即使伺服器記錄正確,目標網域無法解析時,請求仍可能失敗。

如何設定:① 記錄目前的 DNS 設定與啟用設定中的 dns-server;② 確認設定的解析伺服器在目前網路與路由下可連線;③ 一次只調整一處,再重新發出網域請求;④ 對照應用程式提供的診斷資訊判斷變化。注意:請勿同時修改 DNS、路由模式與伺服器,否則無法確認是哪一項生效。自訂解析不代表請求會自動加密,快取也可能讓修改結果無法立即反映。

Test Method:測試方式與結果限制

這是什麼、在哪裡:Settings 中的 Test Method 用於選擇測試方式,並會影響相應 Connectivity Test 結果的解讀。連線測試與完整載入網頁並非同一種操作;協定交握、目標存取及應用程式請求也可能處於不同階段。

如何設定:① 查看目前可選的測試方式與測試目標;② 在相同網路、相同方式下測試多台伺服器;③ 再存取實際使用的目標。注意:不同測試方式的數值不適合直接比較排名;單次測試逾時也不能證明所有請求都失敗,測試成功同樣不代表每個網站都能存取。記錄測試方式與目標名稱,比只記下一個數值更有助於排查。

Today Widget:快速查看與控制

這是什麼、在哪裡:Today Widget 是系統小工具的相關設定入口,實際顯示內容與控制方式請以目前系統及應用程式提供的選項為準。它用於快速查看狀態或執行操作,並非另一套獨立的路由設定。

如何設定:① 在 Settings 查看 Today Widget 選項;② 透過系統的小工具編輯入口加入可用的小工具;③ 返回 Home 確認操作後的連線狀態。注意:小工具顯示可能受到系統更新排程影響;若狀態不同步,請比對應用程式內與系統的連線狀態,不要連續點擊切換。若系統未提供相應小工具,請勿假定其他裝置也適用相同操作路徑。

iCloud:設定同步與裝置確認

這是什麼、在哪裡:在提供 iCloud 同步選項的介面中,可管理應用程式支援同步的內容。實際同步範圍請以目前選項說明為準;「已啟用同步」不代表伺服器、統計、連線狀態與所有系統權限都會完整複製。

如何設定:① 確認裝置已登入 iCloud 並具備相關權限;② 備份現有設定;③ 啟用應用程式支援的同步項目;④ 在另一台裝置確認檔案內容與目前啟用的項目。注意:避免兩台裝置同時修改同一份設定;訂閱網址與驗證資訊也屬於敏感內容,請先了解同步範圍再操作。同步不能取代備份;即使檔案名稱相同,也不代表兩台裝置啟用的是相同內容。

Diagnostics:蒐集可重現的診斷線索

這是什麼、在哪裡:在 Settings 中尋找 Diagnostics,使用實際提供的診斷工具查看連線相關線索。診斷資料可協助縮小問題範圍,並非自動修復所有設定的開關。

如何設定:① 記錄故障發生時間、網路類型與 Global Routing;② 只重現一次明確的操作;③ 查看該時間附近的錯誤或結果;④ 分別檢查伺服器、DNS 與規則。注意:對外分享前,請移除訂閱憑證、密碼、個人位址及不必要的存取紀錄。不要只憑單一錯誤就修改所有設定,先確認錯誤是否與本次失敗發生在相同時間、針對相同目標。

設定後的驗證順序

iPhone / iPad:從連線條件逐步檢查至請求結果,避免同時改變多個變數。

  1. 確認基本網路。先確認裝置目前的網路可正常使用,再檢查應用程式所需的系統連線權限。基本網路無法連線時,調整規則通常無法解決問題。
  2. 確認伺服器記錄。確認 SERVER 中實際選取的項目、協定與驗證欄位。訂閱更新後尤其要再次檢查;記錄存在不代表目前已選取。
  3. 確認 Global Routing。日常分流請切回 Config;需要比對時,暫時切換至 Proxy 或 Direct,並在測試後恢復。記下模式與測試目標,才能比較結果。
  4. 確認設定與 DNS。查看目前啟用的檔案、規則順序、策略名稱與解析設定。先判斷請求停在哪個階段,再修改對應項目。
  5. 確認自動連線與統計。最後再加入 On Demand 條件,並使用 Data 與 Diagnostics 輔助觀察。手動連線尚未穩定前,請勿新增自動觸發條件。

若遇到「開關能開啟但無法上網」、「只有部分目標失敗」、「訂閱匯入失敗」或「更新後異常」,可繼續閱讀疑難排解手冊。首次設定時,請依序參閱使用說明;需要查詢英文介面詞或規則關鍵字時,請查看名詞解釋,不要只憑名稱猜測設定用途。