官方手冊 · 規則參考

Shadowrocket 規則與設定檔完整指南

先確認目前使用的設定檔與 Global Routing,再判斷請求符合哪條規則。設定檔決定比對條件,策略決定後續處理方式;兩者應分開檢查。

本頁是系統化查閱手冊,適合已備妥自己的訂閱或伺服器資訊,並需要調整規則的使用者。初次使用請先依快速入門教學完成匯入、連線與基本驗證,再回到相關章節查閱語法;下文提及匯入與連線時也會連回教學,不重複說明安裝流程。

Shadowrocket 提供 iPhone、iPad、Mac(Apple 晶片與 Intel)、Windows、Android 及 Linux 版本;各平台的介面位置可能不同,以下以設定關鍵字與實際比對行為作為檢查依據。取得方式與系統安裝允許步驟請參閱全平台下載說明。

General Rule Host URL Rewrite

設定檔結構與安全編輯流程

設定檔是設定與規則的集合,不等於訂閱連結,也不等於伺服器清單。訂閱通常用來取得服務商維護的伺服器資訊;設定檔則說明請求如何解析、比對與處理。兩者可以搭配使用,但更新訂閱不代表目前規則正確,修改規則也無法修正伺服器參數。開始編輯前,應先在 Config 確認目前使用的檔案,而不是只查看剛下載到本機、檔名相同的副本。

四個區段各自負責什麼

[General] 儲存一般設定,常見內容包括 DNS 與系統流量處理選項;[Rule] 逐行設定比對條件與策略;[Host] 為指定主機名稱設定靜態解析對應;[URL Rewrite] 使用正規表示式描述 URL 的改寫或重新導向。區段名稱屬於語法,不要改成中文,也不要省略區段名稱,直接將某個區段的內容接到另一區段末尾。

以下範例用來說明結構,並非可直接取代個人設定檔的完整方案。範例中的網域僅供教學使用,PROXY 仍需有可用的伺服器選擇。實際設定檔可能還包含其他區段,不能因為本頁未列出就刪除。遇到不熟悉的內容,應先確認來源與用途,再決定是否修改。

[General]
bypass-system = true
dns-server = system

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

[Host]
localhost = 127.0.0.1

[URL Rewrite]
^http://example\.com(?=/|$) https://example.com 302

鍵值、欄位與換行的差異

一般設定與 Host 對應常以等號分隔左右兩側;規則行則通常以英文逗號分隔類型、條件與策略。中文逗號、全形空格,以及複製時帶入的引號,都可能影響解析結果。每條規則應各占一行,避免把編輯器的視覺換行誤認為實際換行:畫面上看起來是兩行,不一定代表檔案中真的有兩個換行符號。

空行有助於分組,但不會建立新的優先順序。規則歸屬由區段名稱決定,先後順序則由 Rule 中的位置決定。說明文字建議獨立寫成以 # 開頭的註解行,不要隨意接在規則欄位後面。尤其不要在條件後加上自然語言說明,再期待用戶端自動忽略多餘文字。

先複製,再修改,最後選定生效檔案

建議先複製目前可用的檔案,保留原始內容與服務商提供的資訊。先在副本中完成一項修改,儲存後再次確認所選設定檔,再發起新的測試請求。如果編輯的是遠端維護檔案的本機副本,也要釐清遠端來源與本機修改之間的關係,避免下次更新時覆蓋暫時調整。

檔名相同不代表內容相同,檔案已儲存也不代表它已成為目前使用的檔案。疑難排解時,可以在副本中新增一條容易辨識的測試規則,再從請求記錄確認比對結果。如果記錄仍顯示舊規則,先檢查目前使用的檔案與 Global Routing,不要繼續疊加修改。要復原時,直接切回原檔案,比憑記憶逐條撤銷更可靠。

範例不是通用的完整設定檔

合併規則時,保留現有必要區段與伺服器資訊,只移動或新增已理解的行。不要把不同來源的整份檔案直接首尾拼接。

訂閱應向你的服務商取得,匯入方式請參閱教學中的匯入與首次連線步驟。如果匯入後沒有可選的伺服器,應先排除輸入資訊與匯入結果的問題,再檢查規則;否則即使符合 PROXY,也沒有可用的後續連線目標。設定檔結構正確只是第一層檢查,不代表每條網路路徑都已驗證。

Global Routing 的三種模式與三種基本策略

Global Routing 控制整體路由模式,規則中的策略則決定符合條件後如何處理。介面中的 Config、Proxy、Direct,與規則中的 PROXY、DIRECT、REJECT 屬於不同層次。排查「規則為何沒有生效」時,先確認目前是否使用 Config 模式;若使用 Proxy 或 Direct,不能以當下的連線結果證明某條 Rule 的比對邏輯正確。

Config、Proxy、Direct 各自如何運作

Config 依目前設定檔分流,適合驗證自訂規則;Proxy 會讓用戶端可接管的請求朝代理路徑處理,可用來排除規則分流因素;Direct 則用來觀察直連路徑。這裡說的是用戶端接管範圍內的整體行為,不代表系統中的每個封包都必然經過相同流程,也不表示切換模式會立即重建所有現有連線。

Global Routing 與規則驗證的關係
介面模式主要用途檢查重點
Config(設定檔)依目前設定檔分流規則順序、比對條件與最終策略
Proxy(代理)檢查代理路徑的基本連線能力選取的伺服器與連線參數
Direct(直連)檢查目前網路的直連狀況本機網路、解析與目標服務

例如某個網域在 Proxy 下能開啟、在 Config 下失敗,只能說明兩種模式的結果不同,還不能直接判定是 DNS 出錯。接著應查看 Config 下實際選用了哪個策略、是否被更前面的 DIRECT 或 REJECT 攔截,以及目標請求是否與最初輸入的網域相同。瀏覽器重新導向後,網域可能已經改變。

PROXY、DIRECT、REJECT 的含義

PROXY 將符合條件的請求交由目前選取的代理處理;DIRECT 讓符合條件的請求走直連路徑;REJECT 則拒絕符合條件的請求。策略不代表連線一定成功:PROXY 仍需有效的伺服器資訊與可連線的目標;DIRECT 仍受目前網路影響;REJECT 的作用範圍則由比對條件決定。把它們理解為處理方式,比理解成「快」、「慢」或「修復按鈕」更準確。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY

這裡先精確拒絕一台主機,再讓另一台主機直連,只有其餘符合該網域後綴的請求才交由 PROXY 處理。如果把後綴規則移到最上方,後面兩條精確例外可能就沒有機會比對。策略本身沒有固定的優先高低,並非 REJECT 一定能覆蓋 PROXY;覆蓋關係取決於條件與順序。

仍須另外確認代理選擇與協定參數

規則中寫入 PROXY,並不會同時設定伺服器位址、連接埠或驗證資訊。使用 Shadowsocks、VMess、VLESS、Trojan 等協定時,仍須依服務商提供的資訊保留相應參數,不可因欄位名稱相似就套用其他協定的設定。協定屬於連線層,規則屬於選擇層;規則正確無法彌補連線參數缺漏。

On Demand 用來管理符合條件時的連線行為,不是 Rule 中的一種策略。測試期間如果連線狀態不斷變化,也要檢查觸發條件,避免把中斷或重新連線誤認為規則不穩定。Connectivity Test 主要用來觀察受測連線的狀態,即使測試成功,也不能取代對實際業務請求分流情況的驗證。

建議每次只把模式切換當成一個變因:先記下原設定,切換後建立新請求並記錄結果,再切回日常使用的 Config。完整的情境比較請參閱Global Routing 的 Config / Proxy / Direct 比較。不要在同一輪測試中同時更換伺服器、DNS 與規則,否則無論成功或失敗都難以判斷原因。

DOMAIN、DOMAIN-SUFFIX 與 DOMAIN-KEYWORD

網域規則適合用來指定「這台主機」、「此網域及其子網域」或「名稱包含某段文字」的處理方式。選擇規則類型時,應從必要範圍最小的條件開始,不要一開始就使用涵蓋範圍很廣的關鍵字規則。範圍越大,越容易連登入、付款、內容傳遞或其他無關請求一起改變,之後也更難釐清為何看似無關的網站受到影響。

DOMAIN:只指定一個完整主機名稱

DOMAIN 用來精確比對主機名稱。條件設定為 example.com 時,不應把它視為會自動涵蓋 www.example.com 的規則。適合只調整某個 API 或單一主機的情況。條件中只填網域名稱,不要加上通訊協定前綴、連接埠、路徑或查詢參數,也不要直接貼上從網址列複製的完整 URL。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN,static.example.com,DIRECT
FINAL,PROXY

同一個網頁往往會連線到多台主機:頁面文件可能來自一個網域,圖片、API 與驗證則可能來自其他網域。如果頁面只載入部分內容,不要立刻改用關鍵字比對。先從請求記錄找出失敗的主機,再決定是否新增精確規則。一個網域連線成功,不代表網頁涉及的所有請求都使用相同策略。

DOMAIN-SUFFIX:涵蓋指定網域層級

DOMAIN-SUFFIX,example.com,PROXY 用來比對該網域及其子網域,例如 www.example.com 和更深層的主機名稱。它依網域後綴邊界判斷,不是單純搜尋任意包含的文字;notexample.com 不會因為結尾字元相似,就被視為該網域的子網域。通常不必在條件中另外加星號或通訊協定前綴。

如果同一網域下大多數服務使用 PROXY,只有內部 API 使用 DIRECT,可以先寫內部 API 的 DOMAIN 例外,再寫涵蓋整個網域的 DOMAIN-SUFFIX 規則。這樣的排列清楚呈現規則意圖:第一條處理例外,第二條涵蓋網域範圍。若服務日後遷移到其他網域,舊的後綴規則不會自動追蹤,仍須依實際請求更新。

三種網域條件的適用範圍
類型條件範例適用範圍
DOMAINapi.example.com指定的完整主機名稱
DOMAIN-SUFFIXexample.com該網域及其子網域
DOMAIN-KEYWORDexample網域名稱包含指定文字

DOMAIN-KEYWORD:使用方便,但影響範圍較容易擴大

DOMAIN-KEYWORD 會比對網域名稱中的文字片段,不是搜尋網頁內容,也不會掃描 URL 路徑。條件設定為 example 時,可能會比對到多個互不相關的網域。只有在確實需要寬泛的文字條件,且已確認影響範圍時才適合使用;不適合作為處理陌生服務的第一條規則,更不應使用極短且常見的字母組合搭配拒絕策略。

使用 REJECT 時尤其應先窄後寬。拒絕共用網域可能同時中斷圖片、驗證碼或帳戶功能;拒絕承載業務內容的主機,也不一定只會影響預期封鎖的資源。網域規則無法依據同一條加密連線中的頁面元素做精細判斷。相關原理請參閱REJECT 規則的用途與限制。

如何確認網域條件確實比對成功

先將測試條件限制在一台已知主機,確認請求記錄中的名稱與條件一致,再查看比對到的規則與策略。不要只看瀏覽器網址列,因為重新導向、快取與背景 API 都可能改變實際請求集合。如果記錄只顯示目標 IP,應進一步確認是否能取得網域資訊,而不是反覆新增相同網域的規則。

網域別名與資源遷移也要分開判斷。目標在解析過程中引用其他名稱,不代表你必須把解析鏈中的所有網域都加入規則;應以用戶端的實際記錄與新的業務請求為依據。修改後使用相同入口重新測試,保留修改前後的記錄,確認影響範圍只涵蓋預期主機,再決定是否擴大到整個後綴。

IP-CIDR、GEOIP 與 USER-AGENT 的適用範圍

除了網域,規則也能依目標位址或請求中可取得的資訊作出判斷。這些條件不能互相取代:網域代表服務名稱,IP 代表連線目的位址,USER-AGENT 則代表特定請求欄位。選擇條件前,應先確認用戶端在該請求階段能取得哪些資訊,否則即使語法正確,規則也可能永遠沒有比對機會。

IP-CIDR:以網段表示位址範圍

IP-CIDR 以位址與前綴長度表示 IPv4 網段。前綴越長,涵蓋範圍越小;單一 IPv4 位址可使用 /32。例如 192.168.0.0/16 涵蓋該前綴下的位址,而 192.168.10.0/24 範圍較小。設定規則時應使用對應網段的網路位址,不要把斜線後的數字當成連接埠。

[Rule]
IP-CIDR,192.168.10.0/24,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

以下各行示範區域網路位址、IPv6 本機位址範圍與地理位置判斷的寫法,不是要求每份設定檔照抄。企業網路或遠端網路也可能使用相同的私人位址範圍;如果實際需求是透過指定的遠端路徑連線至某個私人網段,範圍過大的 DIRECT 規則反而可能讓連線走錯路。應依目前網路與目標位址的歸屬決定策略。

no-resolve 不代表停用 DNS

附加參數 no-resolve 用來避免僅為判斷該條 IP 規則而主動解析網域,不代表應用程式完全停止使用 DNS,也不代表後續所有規則都無法解析。若請求本身已是 IP,或已有可用的位址資訊,仍可能比對位址條件。需要依賴網域解析結果才能符合規則的情境,貿然加入此參數可能改變預期結果。

因此,發現網域請求未符合某個網段規則時,應檢查該規則是否允許為位址比對進行解析,也要確認後續規則如何處理。不要把 no-resolve 當成通用效能開關,套用到所有位址規則。先釐清希望減少哪一次解析,再從記錄確認行為;減少解析次數與採用正確策略並不是同一回事。

GEOIP:依位址資料庫判斷,不代表網站身分

GEOIP,CN,DIRECT 依據所用資料庫中目標 IP 的地理位置分類進行判斷。它無法識別網站使用哪種語言、經營主體位於何處,也不能保證同一網域在不同網路、時間與解析結果下都會符合相同地區。內容傳遞服務可能回傳不同位址,而資料庫分類也不等於實際業務的完整部署位置。

對於有明確業務需求的網域,通常應先用網域規則表達意圖,再將 GEOIP 放在後面作為範圍較廣的分類條件。如果某網站偶爾改變路徑,先核對當時的解析位址與比對記錄,區分是「位址改變」還是「規則失效」。不要為了掩蓋特定網域的需求,不斷調整 GEOIP 的位置,否則會同時改變更多請求的處理方式。

USER-AGENT:僅適用於可取得的請求欄位

USER-AGENT,Example*,DIRECT 示範依 User-Agent 模式比對的寫法,其中星號用於模式比對。它不等於依應用程式名稱、程序名稱或圖示識別軟體。應用程式可能共用同一套請求程式庫,也可能變更欄位;某些請求則完全沒有可供規則判斷的 User-Agent。

對於加密請求,不能假設用戶端自然看得到其中所有 HTTP 欄位,因此不要把 USER-AGENT 當成分類所有應用程式流量的通用依據。本頁不要求為了使用此規則而另外啟用解密設定。如果實際目標是讓指定服務優先走某條路徑,先評估是否能用清楚的網域或位址條件表示,測試時也要一併確認欄位是否可見及策略結果。

IPv4 與 IPv6 也應分別檢查。只設定 IP-CIDR 不會自動涵蓋對應的 IPv6 位址;目標服務改用另一種位址家族時,可能會符合不同規則。同一網域在不同網路上的表現不一致時,應把位址家族列為檢查項目之一,而不是立刻停用某種網路功能;先找出實際連線的目標位址,才能判斷缺少哪條條件。

由上而下比對、例外規則與 FINAL

閱讀 Rule 的基本方式是由上而下檢查,最先符合的規則決定該次請求使用的策略。更精確的類型不會自動取得較高優先順序,檔案末尾的規則也不會自然覆蓋開頭的規則。理解這點後,許多「規則寫了卻沒效果」的狀況都能轉化成可驗證的問題:請求在到達這條規則前,是否已符合其他條件?

將精確例外放在涵蓋範圍較大的規則之前

假設同一網域下只有一台主機需要直連,其他主機都要走代理。應先寫該主機的 DOMAIN,再寫涵蓋整個網域的 DOMAIN-SUFFIX。若順序相反,精確規則雖然仍保留在檔案中,卻可能永遠沒有機會比對。規則類型決定涵蓋範圍,位置決定先後順序;兩者都要正確,不能只檢查其中一項。

[Rule]
# 先比對精確例外
DOMAIN,intranet.example.com,DIRECT
DOMAIN,blocked.example.com,REJECT

# 再比對範圍較大的網域
DOMAIN-SUFFIX,example.com,PROXY

# 位址分類與最終策略放在後面
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

這裡將網域規則放在 GEOIP 之前,是為了讓明確的服務需求優先於範圍較大的位址分類。這不是適用於所有設定檔的固定排序公式:如果你明確要求優先處理某個位址範圍,也可以把經過檢查的位址例外放在前面。重點是清楚說明覆蓋關係,並為條件有交集的情況準備測試請求。

FINAL 是兜底規則,不是用來補充覆蓋

FINAL,PROXY 表示前面的規則都未符合時,使用 PROXY。它不包含網域或網段條件。一般應將 FINAL 留作 Rule 區段最後一條有效規則,避免後續條件失去作用。把 FINAL 移到中間,不會產生「先嘗試代理,失敗後再繼續比對規則」的效果;比對流程不會依連線狀態逐行重試。

FINAL 要選擇 DIRECT 或 PROXY,取決於整體分流目標,沒有適用所有情境的標準答案。選用 PROXY 時,未分類的請求依賴可用的代理選擇;選用 DIRECT 時,未分類的請求則依賴目前網路的直連能力。應在維護說明中記下兜底策略,並測試一個未被前面條件涵蓋的請求,確認實際結果符合預期。

重複規則、衝突規則與無法觸發的規則

完全重複的規則通常只會增加閱讀負擔;同一條件對應不同策略時,靠前的規則會遮蔽後面的決定。較隱晦的衝突來自涵蓋範圍重疊,例如關鍵字條件涵蓋後綴條件,後綴條件又涵蓋精確主機。排查時不能只搜尋完全相同的行,也要找出可能提早符合目標請求、涵蓋範圍更大的規則。

合併不同來源的規則時,建議先依業務需求整理,再檢查條件重疊,而不是單純依字母排序。排序工具可能把原本在最前面的例外移到後面。每組規則前可以加註解說明用途,但註解只方便閱讀,不會改變比對優先順序;即使註明「最高優先順序」,若放在 FINAL 之後也不會生效。

使用一組對照請求檢查涵蓋範圍

驗證後綴規則時,至少檢查網域本身、一個子網域,以及一個不屬於該網域的名稱;驗證精確例外時,再檢查同一網域下的另一台主機。目標不是證明「某個頁面能開啟」,而是確認需要涵蓋的請求確實受規則涵蓋、不需要涵蓋的請求也沒有受到影響。使用拒絕策略時,尤其要確認一般功能仍可正常完成。

如果多條規則都可能符合同一請求,可以在副本中暫時縮小測試範圍,逐步排除位置較前的候選規則。每次只調整順序或條件,不要同時變更策略。記下目前符合的規則、預期符合的規則與目標主機,往往比反覆截取整份設定檔更能說明問題。

規則比對不是連線失敗後的候選佇列

符合 PROXY 後連線失敗,不代表系統會繼續執行下一行的 DIRECT。應檢查所選路徑,或明確修改分流決定,不要在後面再加一條相同條件。

General、DNS 與 Host 如何影響規則判斷

DNS 將名稱轉換為位址,規則則決定請求採用哪種策略。兩者彼此相關,但不能畫上等號。網域規則可能在取得位址前就表達明確意圖,位址規則則需要目標位址資訊。排查時應分清楚「未取得位址」、「取得的位址不合適」與「取得位址後選錯路徑」,否則更換 DNS 可能暫時改變現象,卻沒有找出真正原因。

General 中的設定應先保留已知可用值

dns-server = system 表示使用系統 DNS 設定。這適合用來建立容易理解的基本狀態,但不保證在所有網路環境下都會得到相同結果。bypass-system = true 涉及系統相關流量的略過處理,不是網域白名單,也不應解讀為「所有本機流量一定直連」。實際接管範圍仍受系統與目前設定影響。

[General]
bypass-system = true
dns-server = system

[Host]
localhost = 127.0.0.1
printer.example.com = 192.168.10.20

如果現有設定檔已能正常運作,不要只為了讓檔案看起來更完整,就複製不熟悉的 General 參數。一般設定可能影響整份設定檔,不像精確網域規則那樣容易限制範圍。修改前記下原值,並確認要調整的是解析來源、系統接管行為或其他選項,避免同時引入多個全域變因。

系統 DNS、自訂 DNS 與 DNS over HTTPS

系統 DNS 會沿用目前網路環境的解析設定;自訂 DNS 則需要填入你確實能使用、且了解其來源的解析服務。DNS over HTTPS 會透過 HTTPS 傳送解析請求,但仍需要可連線的服務位址、有效連線與適當路徑。採用某種傳輸方式,不代表解析結果一定更適合目前業務,也不代表業務請求本身已經走代理。

本頁不推薦外部解析服務。若要更換 DNS,先在獨立副本中只修改解析設定,再使用相同網域與相同路由模式測試。若解析端點需要先解析網域名稱,也要留意初始名稱如何解析,避免設定依賴自身而形成循環。選擇方式請參閱系統 DNS、自訂 DNS 與 DNS over HTTPS 比較。

Host 只建立對應,不會直接指定策略

Host 中的 printer.example.com = 192.168.10.20 會將指定名稱對應至某個位址,不表示它會自動使用 DIRECT。若業務需求是直連,還要透過明確的規則設定路徑,並確認目標位址確實位於目前可連線的網路中。將名稱對應到私人位址,也不會讓裝置憑空取得連線至遠端私人網路的能力。

靜態對應適合位址固定且由你管理的主機,不適合未經確認就固定大型服務的解析結果。服務可能因區域、負載或故障切換而變更位址,長期保留舊對應會略過正常的解析調整。連線突然失敗時,也應檢查 Host 中的手動項目,而不只是檢查 Rule。

位址對應不等於變更加密服務身分

將網域指向另一台伺服器後,瀏覽器仍可能使用原網域進行加密連線與憑證驗證。如果目標伺服器並未為該名稱提供服務,連線就可能失敗。Host 不是修復憑證錯誤的通用方法,也不是 URL 重新導向;不要藉由略過身分驗證來掩蓋對應錯誤,應先確認網域、位址與目標服務是否相符。

解析快取與連線重用可能讓修改後的效果延遲出現。儲存設定後,應發起新請求,並留意應用程式是否仍在重用舊連線;必要時先結束相關應用程式的現有連線再測試。不要因為某次請求仍使用舊位址,就直接認定 Host 無效;也不要在沒有記錄的情況下連續切換多項 DNS 設定。

遇到「網域連線失敗,但直接連線至 IP 成功」的情況,也不能立刻認定是 DNS 出錯。直接連線至 IP 可能會使用不同的虛擬主機、不同憑證或不同規則,兩者並非完全等價的測試。較可靠的比較方式是保留相同網域,只檢查解析結果、比對規則與實際目標位址,讓每一輪測試的差異都能解釋。

URL Rewrite 的比對、重新導向與風險範圍

URL Rewrite 處理 URL 比對與改寫,不是 Rule 的另一種寫法。Rule 決定請求使用哪種策略;重新導向則可能讓應用程式再次請求另一個位址,兩者可能先後影響同一次存取流程。新增改寫規則前,先確認實際需求是「變更連線路徑」還是「變更請求位址」;如果只是要讓某個網域走代理,通常不需要使用 URL Rewrite。

先看懂正規表示式、替換目標與狀態碼

以下範例會將指定主機的 HTTP 位址導向同名的 HTTPS 位址,目標伺服器必須確實支援 HTTPS。比對運算式、替換目標與狀態碼各自負責不同工作,不能把以逗號分隔的網域規則語法搬到這個區段。此範例只用來說明單條規則,未檢查現有內容前,不建議直接加入所有設定檔。

[URL Rewrite]
^http://example\.com(?=/|$) https://example.com 302

開頭的 ^ 將比對範圍限制在 URL 起始位置;\. 表示字面上的句點,避免正規表示式把句點視為任意字元;(?=/|$) 要求主機名稱後面是斜線或字串結尾,避免把前綴相似的其他主機也納入目標。替換內容會變更符合條件的前綴,後續路徑是否保留應透過實際測試確認。

302 表示暫時重新導向,用戶端收到回應後可能會再次發起請求。它不是代理策略,也不表示連線失敗時會自動回退。測試時應留意新的目標位址、跳轉次數與最終比對到的規則,而不只看第一個頁面是否出現。如果目標位址再次符合反向改寫規則,請求可能會來回跳轉,最後導致失敗。

也要檢查路徑、查詢參數與請求方法

替換位址前綴可能同時影響該主機下的多條路徑。需要保留的路徑與查詢參數都應納入測試,不要只測試網站首頁。登入回呼或帶有簽章的請求對 URL 很敏感,改寫後即使頁面能開啟,也可能因參數意義改變而遭伺服器拒絕。複雜的擷取群組應逐一說明用途,避免使用難以檢查的運算式。

瀏覽器導覽與應用程式 API 請求也不是相同情境。某些請求包含本文,應用程式處理重新導向的方式可能與瀏覽器不同;不能只根據一次瀏覽器測試,就把同一條規則套用到所有 API。涉及帳戶、驗證或寫入操作時,應優先保留原本行為,只有在明確了解目標服務需求時,才進行範圍有限的測試。

加密流量的可見性限制

HTTPS 請求的完整路徑通常受到加密保護,不能假設用戶端在一般轉送時能任意讀取及改寫。某類改寫是否能套用,取決於流量可見性與實際設定。不要因為網域規則能比對主機名稱,就推論路徑改寫一定可行;主機資訊與完整 HTTP 內容屬於不同層次。

本頁不要求為了改寫而另外設定解密,也不把安裝憑證列為一般疑難排解步驟。如果業務目標能透過網域分流達成,應優先使用範圍明確的 Rule。涉及帳戶與敏感資料時,尤其要了解每項設定會影響哪些內容;無法說明用途的改寫規則,應留在副本中驗證,不要直接用於日常設定。

檢查改寫與後續規則的共同影響

假設原位址重新導向至另一個網域,新的請求仍須再次接受相應的路由判斷。原網域使用 DIRECT,不代表重新導向後的網域也會直連。網頁出現「第一個跳轉成功,後續失敗」時,應列出完整跳轉鏈,逐一核對每台主機的解析結果、比對規則與策略,而不是持續修改第一條網域規則。

維護改寫規則時,應記錄原始位址模式、目標位址、預期狀態碼與反例。反例至少要包含一台名稱相似但不應符合的主機,以及一條需要保留的路徑。發現異常時先停用新增的改寫規則,其他設定保持不變;如果問題因此消失,再逐步縮小運算式範圍,不要同時調整 DNS、伺服器與所有規則。

分別驗證網域分流與位址改寫

PROXY 不會改變 URL,重新導向也不會自動指定 PROXY。記錄每一跳的主機與策略,才能判斷故障發生在哪個環節。

規則驗證、常見問題與長期維護

規則驗證應形成完整流程:明確預期、保存副本、單項修改、建立新請求、查看記錄,最後決定保留或復原。不要把「網頁能開啟」當成全部驗收標準,也不要把一次失敗等同於整份設定檔失效。規則只是完整連線流程的一部分,應分層檢查解析結果、所選伺服器、目標服務與本機網路。

建立一組可重複執行的測試

每次修改都應準備一台預期符合規則的主機、預期採用的策略,以及一台不應受影響的對照主機。測試前確認 Global Routing 設為 Config、目前使用的檔案是剛儲存的副本,伺服器選擇也與上一輪相同。測試時主動發起新請求,不要只查看快取頁面;記錄實際主機、目標位址與策略,必要時補上當時的網路環境。

如果 Connectivity Test 正常但業務請求失敗,應繼續檢查該業務的實際請求,不要只重複測試伺服器。反過來說,業務頁面能開啟也不能證明所有規則都比對正確,因為內容可能來自快取或其他主機。有效的證據應對應本輪新請求,並說明它符合哪條規則,而不只是「感覺變快了」。

依照現象縮小疑難排解範圍

規則疑難排解的第一項檢查
現象優先檢查下一步
新規則未比對成功目前使用的設定檔、Config、前置條件查看實際主機與更早符合的規則
符合 PROXY 但連線失敗伺服器選擇與連線參數分別驗證代理路徑與目標服務
只有部分資源載入失敗API、靜態資源與重新導向網域逐台主機核對策略
更新後本機修改消失遠端來源與本機副本比較更新前後的相關區段

儲存後出現語法問題時,先檢查最近修改的區段名稱、英文逗號、等號與行尾內容,再縮小範圍,以最少幾行進行驗證。連線後所有業務都失敗時,先還原上一份可用檔案,區分是全域設定還是個別規則改變。只有單一網域失敗時,優先檢查該網域的解析結果、前置比對與改寫,不必先重建所有伺服器資訊。

分開記錄訂閱更新與規則維護

訂閱應向你的服務商取得,更新訂閱與更新設定檔應視為兩件不同的事。一次更新可能變更伺服器項目或選取狀態;遠端設定檔更新也可能取代本機規則。更新後先確認變更的是哪類內容,再重新執行相關測試。匯入方式的差異請參閱Subscribe、Add Server、掃描 QR Code 與從剪貼簿匯入說明。

建議為本機例外保留簡短說明,寫明用途、條件範圍、預期策略與驗證方式。定期檢查已停用的主機、重複行與遭覆蓋的例外,不要只新增而不整理。規則數量增加不代表涵蓋更精準;能說明每組條件、也能快速復原的設定檔,較容易在業務變動時維持可管理性。

儲存記錄時保護個人資訊

請求記錄可能包含存取網域、路徑與查詢參數,訂閱連結也可能帶有存取憑證。向他人說明問題時,只保留必要的規則類型、匿名化主機名稱與比對策略,不要直接傳送完整訂閱連結、驗證欄位或未經檢查的整份設定檔。範例可以改用 example.com,但應保留足以重現問題的條件關係與規則順序。

取得用戶端與取得連線服務是兩回事:iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費。用戶端一次買斷 ≠ 連線服務方案。Shadowrocket 是閉源商業應用,本手冊以使用者已有服務資訊為前提說明設定,不提供節點服務。iPhone / iPad 的系統需求以 App Store 頁面標示為準。

需要重新取得用戶端時,請前往下載頁面查看指定管道:iPhone / iPad 請核對開發者 Shadow Launch Technology Limited 與應用程式 ID 932747118;其他平台的安裝檔由本站 /dl/ 提供。安裝遭系統阻擋時,請參閱安裝允許說明;規則異常則返回本頁相關章節逐層檢查,不要混淆安裝問題與分流問題。

如果只是要完成首次連線,請回到快速入門教學依序操作;若要釐清某次異常,請從實際請求出發,依序檢查目前使用的檔案、Global Routing、比對條件、最終策略、解析結果與連線路徑。每次只處理一個可觀察的問題,才能讓修改與結果相互對應,並保留明確的復原方式。