本文適合正在閱讀或修改 Shadowrocket 本機設定的使用者。先確認目前啟用的檔案與 Global Routing,再依照狀況查看對應區段:連線走錯路徑,檢查 [Rule];網域解析到錯誤位址,檢查 [Host] 和 [General];需要依 URL 路徑重新導向,則查看 [URL Rewrite]。
.conf 區段與語法
方括號中的區段名稱,會決定後續各行採用的語法,直到遇到下一個區段名稱為止。[General] 和 [Host] 都可能出現等號,但等號左側代表的意義不同:前者是設定項目,後者是主機名稱。[Rule] 通常以英文逗號分隔類型、比對值與策略;[URL Rewrite] 的重新導向項目則以空白分隔比對運算式、目標 URL 和動作。
要在現有檔案中新增規則,先找到原有的 [Rule] 區段,再決定插入位置。不要把整段範例直接加到檔案末尾:末尾可能屬於其他區段,即使新的一行看起來像規則,也不會在讀取規則的位置生效。
在 Config 中編輯並啟用檔案
在設定檔清單中看到某個檔案,不代表目前連線正在使用它。以下以 iPhone / iPad 的介面用語為例。第一次修改時只調整一行,並保留修改前的檔案副本,方便在相同測試條件下還原驗證。
確認檔案
開啟
Config,確認要編輯的檔名,並先另存一份未修改的副本。若遠端設定檔會更新,測試時請使用本機副本,避免重新整理後變更遭到覆蓋。編輯原始內容
在
Config點選檔名,選擇Edit Plain Text。找到目標區段,只新增或調整一項設定,保留原有的英文標點和分隔符號,然後儲存。啟用設定檔
返回
Config,點選編輯後的檔名並選擇Use Config。確認啟用的是編輯後的檔案,而非用於還原的副本。重新發出請求
前往
Home→Global Routing→Config。以相同目標重新建立連線;若應用程式沿用舊連線,請先結束原有連線再測試。
Config 既是設定頁面的名稱,也是 Global Routing 下的一種模式。前者用來選擇檔案,後者則決定是否依該檔案的規則分流。排查 [Rule] 時,這兩個位置都要確認。
Config
建議依照所選設定檔中的規則決定連線策略。例外項目、網域後綴項目和 FINAL 的順序都會影響結果。
適用情況:確認已啟用設定檔中的規則是否命中。
Direct
使用直連模式。直連成功只能表示目前網路可以直接連上目標,無法證明設定檔中的某條 DIRECT 規則已命中。
適用情況:使用相同目標,單獨檢查直連是否可用。
Proxy
讓用戶端處理的連線使用代理模式。測試前確認 Home 已選取自己的服務,再以相同目標建立新連線。
適用情況:不依賴分流規則,單獨檢查代理連線路徑。
[General] 與 [Host]:解析設定和單一網域對應
[General] 存放設定檔層級的設定,例如 dns-server = system 代表使用系統 DNS。[Host] 則可為特定主機名稱指定位址。前者決定一般使用哪種解析設定;後者指定 Shadowrocket 處理解析時,該名稱是否有個別對應。兩者都不能取代 [Rule] 的連線策略選擇。
[General]
dns-server = system
[Host]
docs.example.com = 192.0.2.10
192.0.2.10 是文件示範用位址,不可用於連線測試。上方的對應只設定了 docs.example.com,沒有設定 api.example.com。驗證對應時,仍須使用原本的主機名稱發出請求,不要把瀏覽器網址改成 IP;這會改變請求使用的主機名稱,也可能影響 HTTPS 憑證驗證條件。
依問題範圍選擇檢查項目
多個網域解析異常
- 檢查
[General]中的dns-server,並確認問題是否只出現在特定網路。 - 使用相同設定檔,在兩個網路分別發出新請求,確認狀況是否隨系統 DNS 所在的網路而改變。
只有單一主機名稱異常
- 檢查
[Host]是否設定了該完整主機名稱,特別留意www和其他子網域。 - 在副本中移除該項對應,再以相同名稱重試,排除舊連線或快取造成的干擾。
先判斷是名稱解析錯誤,還是位址正確但連線失敗;兩種狀況需要檢查的項目不同。
[Rule]:由上而下比對,第一條命中規則生效
規則不會自動依精確程度排序。若要讓某個主機名稱成為網域後綴規則的例外,先寫該主機名稱的 DOMAIN,再寫涵蓋範圍較大的 DOMAIN-SUFFIX。未命中前面規則的連線,則交由末尾的 FINAL 處理。
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
docs.example.com:命中第一行,採用DIRECT,不再檢查後綴規則。api.example.com和example.com:未命中第一行,命中第二行,採用PROXY。實際使用前,請在Home選取自己的服務。example.net:前兩行都不符合,依FINAL,DIRECT處理。
交換前兩條規則後,docs.example.com 會先命中 DOMAIN-SUFFIX,後面的精確規則就不會有機會生效。範例中的 FINAL,DIRECT 只是此設定檔的預設處理方式。修改現有檔案時,應先確認原本的預設策略;不要為了插入一條例外規則,連帶改變其他連線的處理方式。
IP-CIDR 依目標 IP 所屬的網段比對,例如 IP-CIDR,192.0.2.0/24,DIRECT;GEOIP 則依 IP 的地理歸屬資訊比對,不是依網域後綴判斷。排查網域請求時,先檢查上方是否已有網域規則命中,再確認 IP 類規則是否取得可供比對的目標位址。
[URL Rewrite]:依 URL 路徑重新導向
[Rule] 決定連線如何處理;[URL Rewrite] 則比對用戶端能處理的 HTTP 請求 URL。以下範例同時限定協定、主機名稱和路徑,並以 302 指向新位址。這只是語法示範,不依賴範例網域提供網頁。
[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302
^和$用來限定完整 URL;\.用來比對網域中的字面句點。替換成自己的測試網域時,請保留句點前的反斜線。- 這個運算式只會比對
http://docs.example.com/old,不會比對/old/或/old?from=help。驗證時,請分別請求原路徑和附帶參數的路徑,確認比對範圍符合預期。 - 目標位址使用相同主機的
/new,不會再次命中這個運算式。檢查重新導向時,先確認第一個回應是否為302、目標位址是否正確,再檢查新請求能否完成。
HTTPS 請求的路徑位於加密內容中,只知道目標主機名稱不足以比對路徑。如果測試工具在送出前已將 HTTP 升級為 HTTPS,上方的運算式就不會照原樣命中。先確認實際送出的協定和 URL,再決定是否需要修改運算式。
儲存後未生效的常見原因
明明設定了 DIRECT,為什麼還是走代理?
先確認 Home → Global Routing 是否設為 Config,再檢查目前啟用檔案中的 [Rule]。若上方已有涵蓋該主機名稱的 DOMAIN-SUFFIX,請將精確的 DOMAIN 例外移到它前面,重新建立連線驗證。
可以把新規則直接貼在 FINAL 下面嗎?
不要把一般規則放在預設規則之後。若已有 FINAL,請將新規則插入其前方,再檢查更上方是否有涵蓋該目標的項目。儲存後,分別測試一個應命中新規則的目標,以及一個應交由預設規則處理的目標。
修改 Host 位址後,為什麼瀏覽器網址列沒有變?
[Host] 修改的是主機名稱對應的位址,因此網址列仍顯示原本的 URL 屬正常情況。要驗證對應,請使用自己管理的目標服務,確認新連線是否抵達預期位址;若要將 /old 改為 /new,應檢查重新導向,而不是主機對應。
切回原始檔案後,如何判斷是哪次修改出了問題?
在相同網路上,分別使用原始檔案和修改後的副本發出相同請求,並保持 Global Routing 與所選服務不變。若只有副本出現問題,就從最近修改的區段開始逐行還原,每次只改一處並重試,直到找出觸發問題的項目。