[Settings]

Shadowrocket
功能與常用設定

先確認 Global Routing,再檢查規則、伺服器與 DNS。依序一次只修改一個項目,才能分辨是連線故障還是分流結果造成的問題。

官方手冊 · 操作位置以 iPhone / iPad 介面為例;其他平台請依實際介面確認同名功能。

[Global Routing]

Config、Proxy 與 Direct 三種模式

Global Routing 決定整體處理方式;選擇伺服器和選擇路由模式是兩回事。

功能說明:Global Routing 提供 Config、Proxy、Direct 三種模式,分別代表依設定檔分流、使用代理,以及直接連線。它不是協定選擇器,也不會替使用者補齊伺服器參數。Home 中選取的伺服器,會作為一般 PROXY 策略使用的代理目標;設定檔中的特定策略或策略組也可能另有指定。

位置與設定方式:在 Home 開啟 Global Routing,依使用目的選擇模式,再返回確認目前選取的伺服器及連線開關。日常使用既有規則檔時通常選 Config;排查特定目標是否受規則影響時,可暫時切換至 Proxy 對照;檢查本地網路能否直接連線至目標時,可選 Direct。測試完成後請恢復原本模式,避免將暫時設定當成日常設定。

三種路由模式的用途與檢查重點
介面選項 處理方式 適用情境 注意事項
Config · 設定檔 依目前啟用的設定檔規則決定策略。 例如指定網域走 PROXY、本地位址走 DIRECT 等分流需求。 確認已啟用目標設定檔,且有適用的 FINAL 規則。
Proxy · 代理 以代理作為整體處理方式。 暫時對照測試代理路徑,縮小規則排查範圍。 不代表所有 App、所有系統流量都一定會經過代理。
Direct · 直連 以直接連線作為整體處理方式。 比較直接連線的結果,檢查本地網路的基本連線能力。 不代表關閉連線開關,也不代表清除 DNS 設定。

注意事項:Proxy 可以連線、Config 卻失敗時,通常應優先檢查命中的規則、策略指向及設定檔是否已啟用,而不是立刻重建伺服器。兩種模式都失敗時,再檢查伺服器參數、DNS 與目前網路。Direct 連線失敗也不能單獨證明代理設定有誤,因為目標可能無法透過目前網路直接連線。

[Rule]

規則比對與策略走向

規則決定「比對什麼」,策略決定「比對後如何處理」。

功能說明:在 Config 模式下,規則分流會依目標網域、位址或其他可用資訊選擇處理策略。DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對網域後綴;DOMAIN-KEYWORD 比對網域中的關鍵字;IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍;GEOIP 依位址所屬地區比對;USER-AGENT 依據請求中可取得的對應資訊,不適合用來取代通用的依 App 分流功能。

位置與設定方式:在 Config 中找到並編輯準備使用的設定檔,將規則放入 [Rule] 區段。儲存後,還要確認該檔案已設為目前使用的設定檔,並將 Global Routing 設為 Config。規則依由上而下的順序比對,通常先放較明確的目標,再放較廣泛的範圍,最後以 FINAL 作為兜底規則。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.net,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,fc00::/7,DIRECT
FINAL,DIRECT

這段教學範例會讓指定網域使用 PROXY,列出的本地位址範圍使用 DIRECT,其餘請求則由 FINAL,DIRECT 處理。範例網域不是訂閱或伺服器位址。PROXY 代表使用代理策略,DIRECT 代表直接連線,REJECT 代表拒絕請求;這些名稱描述的是處理方式,不是三種不同協定。

PROXY DIRECT REJECT

注意事項:若將涵蓋範圍廣的規則放在前面,可能會遮蔽後面的特定規則。IP 規則也須考量網域解析結果;連線重用、快取與 App 自身行為,都可能影響單次測試結果。修改後重新發出請求,檢查實際命中的規則,不要只依連線圖示判斷。完整段落結構與更多寫法請參閱規則參考。

[Subscribe]

訂閱與伺服器管理

先分清單一伺服器資訊與可更新的訂閱清單,再選擇匯入方式。

功能說明:Subscribe 用於匯入及更新伺服器清單;Add Server 用於填寫或匯入單一伺服器資訊。訂閱不是規則設定檔,更新伺服器清單也不等於替換 Config。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 等協定的欄位意義各不相同,請依現有資訊選擇對應類型;只填地址和連接埠並不代表參數已填完整。

位置與設定方式:從 Home 的新增入口進入 Add Server;已有訂閱時選擇 Subscribe,貼上向你的服務提供者取得的連結並儲存。新增單一伺服器時,請確認類型、地址、連接埠及認證欄位;TLS、SNI、傳輸方式等附加項目則依提供的資訊填寫。使用 Scan QR Code 前,先確認 QR Code 內容是預期的伺服器或訂閱資訊,而非一般網頁網址。

匯入成功後返回 Home,確認清單中出現預期項目,選取要使用的伺服器,再執行 Connectivity Test。清單顯示項目只代表內容已被辨識,不表示認證正確或線路可用。訂閱內容變更時,請在對應的訂閱項目中更新,並再次確認目前選取的項目仍存在。

注意事項:訂閱連結可能含有存取憑證,請勿放入公開截圖、共用設定檔或求助貼文。自動更新可能覆蓋訂閱產生項目的本機修改;需要長期保留的手動項目,應與訂閱項目分開管理。更新失敗時,先確認連結是否完整或已失效,再檢查目前網路能否連線至訂閱網址;不要反覆刪除所有設定檔碰運氣。

[On Demand]

按需連線與手動連線的關係

On Demand 決定何時建立連線,不負責決定特定網域使用哪條規則。

功能說明:On Demand 透過系統的按需連線機制,在符合已設定的網路條件時嘗試建立連線。它與 Global Routing 屬於不同層級:前者控制何時觸發連線,後者控制連線建立後的整體路由方式。啟用 On Demand 不會自動選擇合適的伺服器,也無法修復已過期的訂閱或錯誤的認證參數。

位置與設定方式:進入 Settings 中的 On Demand 設定項目,先閱讀目前可用的條件與選項。建議先關閉自動觸發,手動完成一次連線與網頁存取測試,確認伺服器和 Config 運作正常後,再啟用所需條件。如果介面提供網路類型或網路名稱條件,請逐項確認,避免將原本只想在特定網路啟用的功能設為廣泛觸發。

注意事項:手動中斷連線後又重新連上時,應先查看 On Demand 是否仍符合觸發條件,而不是立刻認定開關失效。若要持續停止連線,請先停用按需觸發,再操作連線開關。網路切換、系統排程及其他 VPN 設定都可能影響結果,請分別在 Wi-Fi 與行動網路下測試;出現連線圖示後,仍須確認實際存取是否正常。

[Data]

Data 流量統計的用途與限制

用來觀察用戶端記錄的流量變化,不能取代服務提供者端的用量紀錄。

功能說明:Data 可查看 App 記錄的流量狀況,協助判斷連線期間是否有資料傳輸。閱讀統計時,請一併留意介面標示的時間範圍與分類;數據不一定等於裝置的全部網路流量,也不一定等同於服務提供者後台顯示的用量。背景通訊、協定額外負載及計量起訖時間不同,都可能造成差異。

位置與設定方式:開啟 Data,先確認目前查看的時間範圍或統計項目。準備比較某項操作時,記下操作前的數值、關閉無關下載,再存取明確的目標,之後觀察數值變化。如果介面提供重設統計資料的選項,請先確認是否仍需要保留歷史紀錄,再執行重設;重設本機統計不會改變服務提供者端的用量。

注意事項:流量增加只能表示有資料傳輸,不能證明請求一定命中 PROXY,也不能證明頁面內容已完整載入。判斷分流時,請查看請求與規則資訊;確認用量則應查看服務提供者提供的紀錄。若 Data 持續增加但前台沒有操作,可先檢查背景 App、系統同步及正在進行的傳輸,再決定是否中斷連線。

[Settings]

Settings 常用項目逐一檢查

設定入口與可用選項可能因系統和平台而異;以下依同名功能說明,不假設所有裝置的版面都相同。

DNS:網域解析與設定檔繼承

功能說明與位置:DNS 會將網域名稱解析為位址,可在 Settings 的 DNS 設定及目前 Config 的 [General] 區段中確認相關選項。解析與代理是不同環節:連線成功不代表解析結果符合預期;解析成功也不代表伺服器能連線至目標。

設定方式與注意事項:先記錄原有設定,再確認目前設定檔是否指定 DNS,以及是否存在系統解析或其他覆寫項目。需要修改時,只使用自己明確掌握的解析參數,並一次只變更一個來源。不要同時修改 DNS、伺服器和規則,否則難以判斷是哪項設定造成影響。測試時重新發出請求,並將系統、App 與用戶端快取納入考量;不要把更換 DNS 當成所有連線問題的通用解法。

Test Method:維持一致的測試條件

功能說明與位置:Settings 中的 Test Method 用於選擇 Connectivity Test 的測試方式。不同方法著重的階段可能不同,例如建立連線與取得測試目標的回應,兩者並不必然等同;測試方式、目標與逾時條件都會影響顯示結果。

設定方式與注意事項:先閱讀目前測試方式的說明,再依排查目的選擇合適的選項。比較伺服器時,請維持測試方式、目標和網路環境一致。單次逾時不能直接證明伺服器永久失效;請先重複測試並嘗試實際存取,再檢查認證、TLS 與目標可達性。測試通過但網頁無法使用時,應繼續檢查 DNS、規則及特定 App 的行為。

Today Widget:使用快速操作前先確認狀態

功能說明與位置:系統支援時,Today Widget 會提供快速入口;可在 Settings 的同名項目中確認相關設定,能否加入也取決於目前系統是否支援小工具。它方便查看或切換狀態,但不能取代 Home 中完整的伺服器與路由設定。

設定方式與注意事項:先在系統提供的小工具新增介面搜尋 Shadowrocket,再依 App 提供的選項設定顯示內容。使用快速操作前,請確認目前的伺服器與 Global Routing;操作後返回 App,或透過實際存取確認結果。系統可能延遲更新小工具內容,因此不要只根據小工具顯示的舊狀態判斷連線結果。

iCloud 同步:先備份再合併

功能說明與位置:iCloud 相關功能可在支援的 Apple 裝置間儲存或同步 App 支援的資料。請在 Settings 的對應項目中確認入口;實際同步範圍以介面說明為準,不要假設伺服器、設定檔、歷史資料和所有設定都會同步。

設定方式與注意事項:先確認裝置使用預期的 iCloud 帳號、系統允許 App 使用 iCloud,並另外備份重要設定,再啟用同步或執行復原。更換裝置後,請逐項檢查項目數量、目前設定檔與伺服器選擇;不要只因看到檔案出現,就認定所有狀態都一致。同步也不代表服務提供者的授權可共用,伺服器可使用的裝置數仍依使用者既有服務的約定。

Diagnostics:收集可重現的問題資訊

功能說明與位置:Diagnostics 可協助定位連線與網路問題,請在 Settings 的對應項目中查看目前提供的診斷功能。診斷的價值在於記錄問題發生的環節,而不只是給出籠統的「無法連線」結論。

設定方式與注意事項:先記下目前的網路類型、Global Routing、選取的伺服器及失敗目標,再執行與問題相關的診斷。比較修改前後的結果時,請維持其他條件不變。分享結果前,請檢查並移除訂閱連結、認證欄位、個人位址及其他敏感資訊;只保留必要的錯誤說明與已去識別化的背景資訊。

[Check]

修改設定後的檢查順序

分開確認「是否已連線」、「是否命中規則」及「結果是否符合預期」。

  1. 保留原始狀態。記錄目前的 Config、Global Routing、伺服器及準備修改的項目。編輯設定檔前先備份;備份若含有憑證,請妥善保管。
  2. 建立基本連線。選取伺服器並手動連線,執行 Connectivity Test,接著存取已知目標。若基本連線失敗,先確認參數與目前網路,不要急著修改規則。
  3. 確認實際分流。在 Config 模式下,分別測試預期走 PROXY 和 DIRECT 的目標,檢查對應請求的策略結果。只測試一個目標,無法證明整份設定檔都正確。
  4. 最後啟用自動功能。確認手動操作穩定後,再啟用 On Demand 或調整同步行為。切換網路後重複檢查,確認自動連線是否符合設定條件。
  5. 失敗時逐項還原。還原最近一次修改並重新測試。維持可重現的操作順序,比同時調整多個開關更容易找出原因。

需要首次匯入訂閱與建立連線的完整步驟,請繼續閱讀使用教學;需要了解更多規則寫法,請參閱規則參考;遇到特定錯誤時,請依常見問題中的分類檢查。尚未取得用戶端的使用者,請先前往下載指南選擇對應平台。