一、先理解規則提供者:把分流清單從主設定檔拆出去
在 Clash 或 Mihomo 的設定裡,規則提供者(Rule Provider)可以理解成一份可獨立更新、可重複引用的規則資料。傳統做法是把大量 DOMAIN-SUFFIX、DOMAIN-KEYWORD 和 IP-CIDR 直接寫進主設定檔;短期看起來直觀,長期卻容易變成數百行難以審查的清單。當某個服務更換 CDN、增加新網域,或團隊需要回溯哪一次修改造成誤分流時,直接改主檔往往不容易定位。
規則提供者把這些內容拆成另一份 YAML 檔,再由 rule-providers 區塊描述它的來源、格式、更新週期與儲存位置,最後透過 RULE-SET 把它接回 rules。因此,主設定檔負責「如何組織策略」,遠端檔案負責「目前有哪些目的地」。這種分工特別適合 AI 工具、套件管理器、程式碼託管平台等網域經常變動的場景,也方便用 Git 保存每一次修改。
在開始前,先確認你的客戶端核心是否支援目前設定語法。Clash Verge Rev、部分 Mihomo 客戶端通常支援較完整的規則提供者功能,但不同版本對 format、健康檢查、規則行為與遠端下載錯誤的處理可能不同。若匯入後出現「設定解析失敗」,不要先懷疑 GitHub;應先在客戶端的核心版本、設定檢查器或日誌中確認是哪一個欄位不被支援。
二、用 GitHub 託管自訂 YAML:網址、格式與版本管理
最容易維護的方式,是在自己的 GitHub 儲存庫建立專門目錄,例如 rules/ai.yaml、rules/developer.yaml 和 rules/package.yaml。每份檔案只處理一個明確主題,不要把 AI、影音、內網和套件來源全部混成一張「萬用清單」。這樣做的好處是:當 AI 服務連線異常時,可以只停用或替換 AI 規則提供者,不會意外改變其他工作流的出口。
GitHub 儲存庫中的一般網頁網址不是規則檔下載網址。瀏覽器看到的 github.com/user/repo/blob/main/rules/ai.yaml 是 HTML 頁面;Clash 需要的是原始內容網址,也就是 raw.githubusercontent.com 路徑,或你自行配置的固定下載服務。若檔案是公開的,可以使用類似下列形式的網址;若儲存庫是私人或受組織政策限制,請不要把存取權杖直接寫進可分享的設定檔。
# A public raw URL pattern
https://raw.githubusercontent.com/your-account/your-rules/main/rules/ai.yaml
規則檔本身也必須符合客戶端期待的結構。最常見的是 payload 陣列,內容可以是域名規則、IP 規則或其他受支援的規則類型。建議在檔案開頭加入簡短的英文註解,說明用途、最後人工檢查日期與預期策略,不要在註解中放入帳號、內部主機或私人節點資訊。
# Purpose: developer services that require the DEV_PROXY group
# Review domains against official documentation and client logs.
payload:
- DOMAIN-SUFFIX,github.com
- DOMAIN-SUFFIX,githubusercontent.com
- DOMAIN-SUFFIX,npmjs.org
- DOMAIN-SUFFIX,pypi.org
- DOMAIN-SUFFIX,registry.npmjs.org
GitHub 的版本管理是這套方案的核心價值。修改前先開分支,提交訊息寫清楚「新增哪個服務、為何新增、觀察到什麼錯誤」,再透過 Pull Request 檢查差異。不要只留下「update rules」這類無法追蹤原因的訊息。若遠端規則日後造成大範圍誤分流,你可以快速比較提交紀錄、回退到上一個版本,並在本機測試後再重新發佈。
三、主設定檔寫法:指定來源、更新週期與策略群組
建立遠端檔案後,要在主設定檔的 rule-providers 區塊宣告它。behavior 必須和檔案內容相符:以域名為主通常使用 domain,包含完整傳統規則時使用 classical,IP 網段則依核心支援情況使用 ipcidr。path 是本機快取位置;即使遠端暫時失效,部分核心仍可讀取上次成功下載的快取,因此路徑不要指向容易被清理的暫存目錄。
rule-providers:
AI_SERVICES:
type: http
behavior: domain
format: yaml
path: ./rule-providers/ai-services.yaml
url: https://raw.githubusercontent.com/your-account/your-rules/main/rules/ai.yaml
interval: 86400
proxy: DEV_PROXY
DEV_TOOLS:
type: http
behavior: domain
format: yaml
path: ./rule-providers/dev-tools.yaml
url: https://raw.githubusercontent.com/your-account/your-rules/main/rules/developer.yaml
interval: 86400
proxy: DEV_PROXY
rules:
- RULE-SET,AI_SERVICES,AI_PROXY
- RULE-SET,DEV_TOOLS,DEV_PROXY
- MATCH,DIRECT
這裡的 type: http 表示從 HTTP 或 HTTPS 網址取得內容,interval: 86400 代表以秒為單位的更新週期,即每天嘗試更新一次。更新週期不宜設得過短:GitHub 檔案不是即時資料庫,頻繁下載可能造成不必要的請求,也讓問題排查變得困難。若你每天只修改一次規則,十二小時或二十四小時通常已足夠;經常測試新網域時,則可先縮短週期,驗證完成後再恢復較保守的值。
proxy 欄位是許多人忽略的部分。它描述「下載規則提供者本身」要走哪個策略,並不等於規則命中後的流量策略。上例中的 DEV_PROXY 只負責讓核心取得 GitHub 上的 YAML;真正命中 AI_SERVICES 的流量,會按照 RULE-SET 後面的 AI_PROXY 出站。兩者可以相同,也可以刻意分開,方便判斷到底是「清單下載失敗」還是「服務連線品質不佳」。
如果核心版本不接受 format: yaml,不要直接刪除欄位後反覆嘗試。先查看該版本文件,確認它需要 yaml、text 或其他格式。某些舊版只接受純文字清單,而新版本可以解析帶有 payload 的 YAML;同一個 URL 若格式與 behavior 不一致,常見結果就是提供者顯示已載入,但規則數量為零。
四、規則優先順序:避免自訂清單被前面的規則吃掉
Clash 的規則通常採用由上到下、先命中先套用的邏輯。這意味著規則提供者本身寫得正確,並不代表它一定會生效。如果前面已有一條寬泛的 DOMAIN-SUFFIX,github.com,DIRECT,後面再放 RULE-SET,DEV_TOOLS,DEV_PROXY,GitHub 相關請求可能早已在前面結束匹配。除錯時要同時看提供者內容與完整規則順序,不能只盯著 YAML 檔案。
一般可以採取「例外在前、主題規則居中、兜底在後」的排列方式。內網、本機網段與明確不應代理的管理位址先處理;需要特殊出口的 AI 或開發服務接著處理;最後才放地區規則、既有大分類與 MATCH。如果團隊已有一份大型訂閱規則,請把自訂規則放在確定不會被寬泛規則遮蔽的位置,並在提交說明中記錄這個依賴關係。
| 順序層級 | 用途 | 常見例子 | 注意事項 |
|---|---|---|---|
| 第一層 | 本機與內網例外 | IP-CIDR,192.168.0.0/16,DIRECT | 避免把區網設備送到遠端節點 |
| 第二層 | 明確自訂服務 | RULE-SET,AI_SERVICES,AI_PROXY | 放在可能覆蓋它的寬泛規則之前 |
| 第三層 | 一般分類規則 | 影音、廣告、地區或既有訂閱清單 | 確認不會與自訂服務重疊 |
| 最後 | 預設兜底 | MATCH,DIRECT | 依安全政策決定是否改為其他策略 |
對同一個網域同時出現在多個提供者的情況,建議不要靠猜測優先級。先在客戶端的連線或規則命中頁確認實際採用哪一條,再決定要縮窄自訂清單,或把它移到更前面。尤其是 DOMAIN-KEYWORD,匹配範圍通常比 DOMAIN-SUFFIX 更寬,容易把名稱中含有相同字串的無關服務一起納入。能用完整網域或明確後綴解決時,就不必使用關鍵字規則。
五、測試、故障排查與長期維護:讓 GitHub 清單真的可靠
第一次啟用後,不要立即把所有裝置切到這份規則。先在單一客戶端重新載入設定,查看規則提供者狀態是否為成功、下載時間是否更新、快取檔案是否產生,以及規則數量是否合理。規則數量為零、HTTP 狀態碼錯誤、YAML 解析錯誤和代理連線逾時,分別代表不同方向:前兩者偏向 URL 或檔案內容,解析錯誤偏向格式,逾時則可能是下載所走的出口或 DNS 路徑有問題。
接著用最小測試集驗證。挑選一個你確定應該走 AI_PROXY 的主機、一個應該走 DEV_PROXY 的主機,以及一個明確應直連的內網位址。分別從瀏覽器、終端機與需要代理的背景程式發起請求,因為不同程式可能不讀系統代理,也可能需要 TUN 才能進入核心。若瀏覽器命中而 CLI 沒命中,問題未必在規則提供者,還要檢查環境變數、應用程式自己的代理設定,以及是否實際經過同一個 Clash 核心。
GitHub 端也要考慮變更風險。儲存庫最好啟用分支保護與審查,避免把未測試的網域直接推到 main。可以在提交前使用簡單腳本檢查重複項、空白網域、錯誤縮排和不允許的私人主機;若團隊規模較大,則把規則檔分成測試分支與穩定分支,讓客戶端只追蹤穩定分支。不要使用會隨時間漂移、無法查看內容差異的第三方規則 URL 作為唯一來源。
維護時還要定期清理過時規則。某個服務搬移到新 CDN 後,舊網域可能仍被保留在清單中,導致無關流量被送往代理;某些套件服務則可能同時需要登入、API、下載與物件儲存網域,漏掉其中一類就會出現「首頁能開、安裝失敗」的假性矛盾。建議在每份提供者旁邊保留用途說明,並以官方文件、客戶端日誌和實際請求三者交叉確認,不要因為某次連線成功就永久加入整個頂級網域。
當遠端 GitHub 暫時無法取得檔案時,先確認本機快取是否仍可用,再查看更新日誌與核心重載結果;不要在故障期間立刻把所有流量改成全域代理。若規則檔內容被意外覆寫,應先回退 Git 提交、固定已知可用版本,再檢查分支權限與審查流程。對需要穩定運作的裝置,也可以在驗證完成後使用帶有明確版本標籤的發佈分支,避免每次主分支變動都立即影響生產環境。
相較於只在單一瀏覽器安裝代理擴充功能的做法,規則提供者能把網域分類、版本差異與更新紀錄放到同一個可審查流程中;而相較於把所有規則硬編進主設定檔,GitHub 託管又能讓 AI 工具與開發套件服務各自擁有清晰出口,出問題時只需回退一個檔案。只要你仍然保留最小權限、明確優先順序與實際日誌驗證,Clash 就能把這套分流流程做得更容易觀察,也更適合長期維護。