一、為什麼把自訂規則拆成 rule-providers
當規則只有幾條時,直接把網域寫在主設定檔的 rules 區段最容易理解;但使用時間一長,例外站點、工作服務、開發工具與內網網域逐漸混在一起,主設定檔就會變得難以閱讀。每次只想補一個網域,卻要在長清單中找位置,還可能不小心改動其他用途的規則。若多人共用設定,也很難從修改紀錄看出一條規則究竟為何加入、是否仍然需要。
rule-providers 的用途,是把一組相關規則放到獨立檔案,再由主設定檔引用。主設定檔保留策略群組、規則順序與例外處理;規則提供者則專注管理某一類網域或網段。這樣既能讓設定分層,也能透過 GitHub 的提交紀錄追蹤每次變更,必要時回退到已知可用的版本。
要先釐清一點:GitHub 負責保存檔案與版本紀錄,不會自動替你判斷規則正不正確,也不代表客戶端一定會即時取得最新內容。提供者的更新方式取決於你使用的是遠端 HTTP 檔案,還是本機檔案,以及核心是否支援相關欄位。開始設定前,請確認客戶端實際使用的核心版本;例如以 Mihomo 為核心的客戶端,欄位支援與更新操作仍可能因版本和圖形介面而有差異。
拆分規則的價值不只在檔案變短,更在於能為每組規則定義清楚的責任範圍。比方說,程式碼託管平台、公司內部網域與影音服務可以各自維護;遇到連線問題時,就能先檢查對應的提供者,而不是把整份設定都當成故障來源。建議每組規則都能回答三個問題:這組規則服務什麼用途、由誰維護、以及如何驗證修改沒有造成非預期的路由。
二、理解 rule-providers 欄位與規則檔格式
遠端提供者通常需要指定類型、行為、下載網址、快取路徑與更新間隔。type: http 表示核心從網址取得規則檔;behavior 用來說明規則內容是網域、IP 網段,還是完整的傳統規則;path 則是本機快取位置。若使用 interval,請以秒為單位設定更新週期。更新太頻繁通常沒有實際好處,還會增加遠端請求與故障排查的變數。
下例示範以 GitHub 儲存網域規則,網址中的帳號與倉庫名稱須換成你自己的公開儲存庫。公開規則檔宜使用可直接讀取原始內容的網址,並確認連結回應的是檔案本文,而不是儲存庫頁面、登入頁或錯誤訊息。
# Example remote provider configuration
rule-providers:
project_domains:
type: http
behavior: domain
format: yaml
url: https://raw.githubusercontent.com/OWNER/REPOSITORY/main/rules/project-domains.yaml
path: ./rules/project-domains.yaml
interval: 86400
rules:
- DOMAIN,internal.example.com,DIRECT
- RULE-SET,project_domains,PROJECT
- MATCH,DIRECT
對應的 YAML 規則檔可採用 payload 清單,例如:
payload:
- '+.example.com'
- '+.service.example.net'
- exact.example.org
這裡的 behavior: domain 是針對網域型條目;若提供者保存的是完整 Clash 規則,例如 DOMAIN-SUFFIX、IP-CIDR 等,應使用與內容相符的 behavior: classical,並確認檔案格式及核心版本支援情況。不要把「網域清單」與「完整規則清單」混成同一種格式:前者由核心按網域行為解讀,後者則包含規則類型、匹配值等欄位,格式不符時即使 YAML 看起來可讀,提供者也可能載入失敗。
若規則檔已隨設定一起放在本機,也可以使用檔案型提供者,將來源指向本機檔案。這種方式適合離線環境、內部版本控制或希望由部署流程統一更新的情況;但它不會因為你在 GitHub 推送新提交,就自動更新到裝置上。遠端型與本機型都要考慮備份與回復:保留一份最近可用的規則檔,並在改動出問題時能迅速還原。
- type:選擇遠端 HTTP 或本機檔案來源,依實際核心支援為準。
- behavior:按照內容選擇 domain、ipcidr 或 classical,不可只看檔名猜測。
- format:只有在核心支援且與檔案實際格式一致時才設定,例如 yaml;不要把網頁原始碼誤當規則檔。
- url 與 path:遠端來源與本機快取各司其職;檢查 URL 可讀性,也確認客戶端有權寫入快取目錄。
- interval:選擇符合維護頻率的更新週期,並另行了解客戶端是否提供手動更新或錯誤提示。
三、用 GitHub 管理版本:讓更新可審查、可回退
把規則放上 GitHub 後,建議不要直接把每一筆臨時測試都推到主要分支。可以先在分支中修改,再透過差異檢視確認新增、刪除與範圍變化,通過測試後才合併。提交訊息最好描述意圖,例如「加入公司工單網域」或「移除已停用的舊服務」,而不要只寫「更新規則」。日後看到某個網域被導向錯誤策略,這些訊息能協助你還原背景,而不是重新猜測當初的決策。
檔案的組織方式也會影響長期維護。不要把所有用途塞進一個名稱含糊的 rules.yaml;可以依服務責任拆成網域、IP 網段與完整規則清單,但也不宜細到每個網域都建立一個提供者。拆分的目標是讓人能快速判斷規則歸屬,而不是單純增加檔案數量。若某個項目已不再使用,先查明是否仍有相依服務,再移除並記錄原因。
- 採用清楚的命名:提供者名稱、檔名與用途保持一致,例如以服務或團隊命名,避免
test2、new-rules這類無法說明責任的名稱。 - 縮小修改範圍:一次只調整同一用途的規則,並避免順手把不相關的規則重新排序,讓回歸測試更容易定位問題。
- 審查寬泛匹配:新增網域後綴或關鍵字規則時,評估它可能涵蓋的子網域與無關流量,必要時改用更精確的網域條目。
- 保留可用版本:重大調整前建立提交紀錄或標籤,出現故障時可回退到已知穩定版本,並確認客戶端重新載入了舊內容。
- 避免暴露敏感資料:規則檔可能包含內部網域或網路設計資訊;公開前檢查內容,必要時改用受控的私有來源,並確認客戶端能合法存取。
分支或標籤可以協助管理檔案版本,但 URL 指向哪個版本也會影響實際更新方式。若 URL 固定指向主要分支,核心按更新間隔取得的會是該位置目前提供的內容;若使用固定版本路徑,變更則較可控,但更新需要你主動調整引用。兩種做法沒有絕對優劣:個人規則通常重視簡便,團隊或重要網路則更需要審查、測試與回退流程。無論採用哪一種,都應在日誌中記下變更時間、規則範圍與預期策略,方便日後對照。
四、規則順序、驗證方式與失效排查
把提供者宣告完成,不代表其中的規則就會自動生效;主設定檔還必須在 rules 中引用對應的提供者。多數 Clash 規則採由上而下比對,先匹配到的規則會先決定策略。因此,具體例外通常應放在較寬泛的規則之前,所有規則提供者的引用也要放在能反映預期優先級的位置。最後的 MATCH 是兜底項目,通常應位於規則清單末端,否則後面的規則便沒有機會命中。
例如,內部主機必須直連時,不要先用涵蓋範圍很大的提供者規則把它送往代理,再期待後面的直連條目修正結果。先明確列出內網或必要例外,再排列一般服務提供者,最後才設定兜底策略。若不同提供者之間也可能重疊,就要確認哪一組應優先;同一網域若同時被兩個規則集匹配,靠「再加一條」不一定能解決,關鍵是規則的先後位置與條目範圍。
遇到規則沒有命中時,建議依固定順序檢查,不要一次更換 URL、規則格式、策略群組和 DNS 設定。先確認設定檔能被核心載入,再確認提供者是否成功取得並解析,接著核對被測試的實際網域,最後查看連線紀錄中命中的規則與策略。若只看瀏覽器是否能開啟網站,很容易把登入狀態、服務端錯誤或應用快取誤判成分流問題。
- 先做設定檢查:確認縮排使用一致空格、冒號與清單結構正確,且提供者名稱在宣告與
RULE-SET引用處完全相同。 - 再檢查來源檔:直接開啟遠端 URL,確認得到的是預期規則內容;檢查是否有拼字錯誤、權限限制、重新導向或回傳錯誤頁面的情況。
- 確認快取與更新:查看客戶端或核心日誌中的提供者載入狀態,確認快取路徑可寫入,並使用客戶端提供的更新操作重新載入,而不是只重新整理網頁。
- 檢查格式與行為:對照
behavior與檔案內容;網域清單、IP 網段與傳統規則格式不可互換,必要時先用少量條目建立最小測試檔。 - 確認匹配順序:在連線紀錄中核對實際請求的主機名稱、命中的規則集與策略群組;如果命中較早的寬泛規則,應調整順序或縮小規則範圍。
- 逐一排除外部因素:若規則確實命中但連線失敗,再檢查策略群組是否可用、節點是否正常,以及 DNS、作業系統代理或其他 VPN 是否影響結果。
如果載入失敗只發生在某一台裝置,也要比較客戶端版本、核心版本與設定檔實際路徑;圖形介面顯示的設定可能不是核心目前正在使用的那一份。若你修改了 GitHub 上的內容,卻仍看到舊的命中結果,先確認提供者更新是否成功、快取是否已刷新,再查看客戶端日誌,不要急著重建整套規則。完成修正後,至少用一個預期命中網域、一個應走直連的例外網域及一個兜底測試,驗證結果與設計一致。
相較於只靠瀏覽器擴充功能管理個別網站,或把所有條件長期堆在一份難以審查的設定檔中,rule-providers 能把規則內容、更新來源與策略引用分開,並利用 GitHub 保留變更脈絡;但它仍需要你檢查核心相容性、匹配順序與日誌,並非設定後就無須維護。若你希望在桌面或行動裝置上搭配圖形介面管理相容用戶端,可先了解可用選項,再依自己的設定流程選擇合適工具。