配置 2026年10月17日

Clash 自訂規則集實戰:用 rule-providers 管理 GitHub 規則

把自訂分流規則移出主設定檔,透過 Mihomo rule-providers 從 GitHub 載入並定期更新。本文整理 YAML 欄位、規則匹配順序與版本控管做法,並說明常見載入錯誤的排查方式。

跨境電商 Amazon 賣家 Shopify

一、為什麼把規則移出主設定檔?

當分流規則只有幾條時,直接寫在主設定檔裡很方便;但隨著服務、裝置與例外情況增加,規則清單很容易變成一長串難以檢查的內容。每次只想替某個網域補一條規則,卻要編輯整份設定、確認縮排,再重新載入並驗證其他分流是否仍正常,維護成本也會跟著上升。

Mihomo 的 rule-providers 能把規則集獨立成遠端或本機檔案,再由主設定檔引用。這種做法適合管理自訂網域清單、團隊共用的分類規則,或需要定期更新的公開規則集。更新規則資料時,主設定檔的策略群組和其他設定可以維持不變,變更範圍更容易審查,也更容易回退。

不過,rule-providers 不是「把任何文字檔網址貼進去就會自動分流」。提供者必須宣告匹配行為、更新來源與本機路徑;主規則還要在正確的位置使用 RULE-SET,並指向設定中已存在的策略群組。只要其中一個名稱、格式或順序不符,規則就可能無法載入,或被前面的規則先行匹配。

本文示例使用公開的 GitHub 儲存庫與示意網域。實際使用前請確認來源可信、內容符合需求,並將範例中的網址、檔案路徑與策略群組名稱換成自己的設定。

二、拆解 rule-providers:來源、格式與更新間隔

每個規則提供者都有一個自己定義的名稱。名稱會在主規則中的 RULE-SET 參照,因此最好使用能看出用途的字詞,例如 github-dev-sites 或 work-domains,不要只用 list1 這類難以辨識的代號。提供者設定通常包括 type、behavior、url、path 和 interval;其中前幾項描述如何取得及解析規則,path 則指定本機快取位置。

下例以 classical 行為讀取 YAML 規則檔。url 指向 GitHub 的原始檔案,interval 以秒為單位設定重新檢查的間隔。請把 YOUR_ACCOUNT、儲存庫名稱與路徑替換成實際位置,並確認該檔案可公開讀取。

rule-providers:
  github-dev-sites:
    type: http
    behavior: classical
    format: yaml
    url: "https://raw.githubusercontent.com/YOUR_ACCOUNT/YOUR_REPO/main/rules/dev-sites.yaml"
    path: ./providers/github-dev-sites.yaml
    interval: 86400

這裡的 type: http 表示從遠端取得檔案;behavior: classical 表示規則檔中的項目使用傳統規則寫法,例如 DOMAIN-SUFFIX 或 IP-CIDR。format: yaml 用來明確指定檔案格式;檔案本身需使用符合該行為的結構。若你的核心版本不支援某個欄位,或你的客戶端包裝了不同版本的核心,載入時可能會回報欄位錯誤,因此請以實際執行的 Mihomo 版本文件與驗證結果為準。

interval: 86400 代表大約每 24 小時檢查一次更新,不代表每次都會重新下載,也不代表主設定檔每次啟動都必須連上 GitHub 才能使用規則。path 是核心存放提供者資料的位置;首次啟動時仍需能取得來源,之後是否能用快取啟動,則取決於快取是否已存在、客戶端如何管理設定目錄,以及核心本身的行為。請勿把快取路徑指向可能被清除的暫存資料夾。

三、建立 GitHub 規則檔並在主設定中引用

先在儲存庫中建立規則檔,例如 rules/dev-sites.yaml。以下內容使用 classical 行為,因此每一項都包含規則類型、比對值與策略名稱。最後一欄必須是你的設定中確實存在的策略群組;若範例中的 DEV_PROXY 並未定義,應改成實際使用的群組。

payload:
  - DOMAIN,api.example.com,DEV_PROXY
  - DOMAIN-SUFFIX,githubusercontent.com,DEV_PROXY
  - DOMAIN-KEYWORD,devportal,DEV_PROXY

上述網域只是格式示例,不應直接當成你需要代理的實際清單。新增網域前,先從應用程式文件、連線紀錄或錯誤訊息確認目的地;移除不再使用的項目,避免規則集逐漸堆積過寬的匹配條件。特別是 DOMAIN-KEYWORD,只要主機名稱含有指定字串就可能匹配,涵蓋範圍通常比精確網域或後綴規則更大。無法確認其影響時,優先使用範圍較清楚的規則類型。

接著在主設定檔宣告提供者,並於 rules 區塊中加入對應引用:

rules:
  - RULE-SET,github-dev-sites,DEV_PROXY
  # Keep more specific rules above broader fallback rules.
  - MATCH,DIRECT

RULE-SET 後的第一個參數必須與 rule-providers 下的名稱完全相同,第二個參數則是命中時使用的策略群組。這個名稱不是檔案名稱,也不是 GitHub 儲存庫名稱。若你使用的策略群組名稱不同,請同步修改規則檔或依需求調整規則設計;不要只改一處後就假設設定已正確。

規則是依序比對的,通常在前面找到匹配項目後就不會再繼續尋找後續規則。因此,應把必須優先處理的特定規則放在較前面,再安排規則集與較寬泛的兜底規則。若 RULE-SET 放在一條已經涵蓋相同網域的規則之後,該規則集即使成功載入,也可能沒有機會生效。將 MATCH 放在清單末端,則能讓前面的具體條件先完成比對。

四、更新策略與版本控管:讓每次變更都可追溯

設定提供者自動更新,不等於規則來源永遠穩定,也不等於規則變更永遠安全。若 url 固定指向 main 分支,儲存庫上的最新內容會隨提交變動;一旦新版本加入錯誤規則、改變 YAML 結構,或意外刪除既有項目,下一次更新便可能改變你的分流結果。若規則用於工作環境或需要可重現的部署,應考慮以固定版本標籤或提交版本管理來源,並在確認內容後再更新引用網址。

較穩妥的流程是先在測試設定中更新規則檔,查看變更差異,再交由另一位維護者檢查新增、刪除與修改項目。完成審查後,更新生產環境使用的版本,保留上一個已知正常的版本作為回退點。每次提交也應簡短說明變更原因,例如新增服務網域、修正拼字或移除停用端點。這些紀錄在日後排查「什麼時候開始走錯策略」時,通常比只記得最近曾經重啟客戶端更有幫助。

interval 應配合實際更新頻率設定,而非一味縮短。若清單每週才審查一次,每隔幾分鐘檢查並不會讓規則變得更可靠,反而增加來源請求與故障觀察難度。公開規則集也不宜未經審查就自動併入生產環境;更新頻率只是取得新版本的機制,不能取代版本審核、變更紀錄與回退方案。

使用 GitHub 原始檔案網址時,也要考慮遠端服務暫時無法連線、倉庫改名、分支刪除或檔案路徑變更等狀況。穩定的設計應讓你能判斷來源失效與規則本身有誤是兩種不同問題,並保留足以恢復前一版的檔案與紀錄。對於私人儲存庫,還需另行確認核心是否具備所需的驗證方式;不要把存取權杖直接寫入可公開分享的設定或日誌。

五、載入失敗與沒有命中時的排查順序

遇到提供者載入錯誤時,先查看客戶端的核心日誌,並記下錯誤時間、提供者名稱與回報內容。不要一開始就同時改網址、縮排、間隔和規則順序,否則即使問題消失,也很難知道真正原因。建議先按「來源可達、格式有效、名稱吻合、規則有機會匹配」的順序逐項確認。

如果客戶端提供設定檔檢查或核心重新載入功能,先用它確認設定語法,再觀察提供者的載入狀態與實際連線紀錄。不同客戶端的按鈕名稱和日誌位置可能不同,但判斷原則相同:先確認目前使用的核心與設定檔,再核對錯誤訊息指向的是遠端請求、規則解析、名稱引用,還是分流結果。更新後若結果異常,先恢復最後一個正常版本,再逐步縮小問題範圍。

六、常見問題

設定了 interval,就一定會在啟動時立即下載嗎?

interval 表示提供者檢查更新的時間間隔,不應直接當成「每次啟動必定下載」的保證。首次取得資料、更新時機與快取處理方式,會受核心版本、客戶端行為及網路狀態影響。部署前請確認核心能連到來源,並測試快取存在與來源暫時不可用時的啟動狀況。

什麼時候該用 classical,什麼時候該用 domain?

classical 適合包含多種傳統規則類型的清單;domain 則適合以網域為主的規則資料,但檔案內容必須符合該行為預期的格式。不要只因為規則檔副檔名是 .yaml 就判定行為正確;請讓提供者的 behavior、宣告的 format 與實際檔案結構互相吻合。

規則集寫在 rules 裡就一定會被使用嗎?

不一定。規則清單依序比對,前面的規則若已命中同一流量,後面的 RULE-SET 就可能不會生效。請檢查規則位置、匹配範圍及兜底規則,並透過客戶端的連線紀錄確認實際命中項目。

GitHub 網址應該指向 main 還是固定版本?

指向 main 較方便取得最新內容,但來源變更可能未經你的環境審查;固定到標籤或提交版本,則較容易重現與回退。若規則集會影響重要流量,通常應先在測試環境審查變更,再更新生產環境使用的版本。

把規則集放在 GitHub,能讓清單透過提交紀錄審查,也能讓主設定檔維持精簡;相較之下,手動貼規則雖然一開始較直接,清單一長就容易出現重複項目、漏改策略名稱或無法追查差異。若你重視自動更新,仍應搭配固定版本、載入驗證與回退機制,讓方便維護不會變成難以預測的分流變動。需要先準備合適的客戶端與核心,再按本文方式測試規則提供者時,可前往下載頁查看可用版本。

前往下載 Clash →

準備好開始了嗎?

選擇適合平台的客戶端,逐步設定並驗證你的 Mihomo 規則集。