文件設定代理集合

代理集合

proxy-providers 讓你透過訂閱連結動態拉取一批節點，而不用把每個節點手寫進 proxies。策略組用 use 欄位引入代理集合。

設定範例

config.yaml YAML

proxy-providers:
  provider1:
    type: http
    url: "http://test.com"
    path: ./proxy_providers/provider1.yaml
    interval: 3600
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300
      lazy: true
    filter: "(?i)港|hk|hongkong|hong kong"
    override:
      additional-prefix: "[provider1] "
      udp: true

基礎欄位

鍵名（如 provider1）必須

集合名稱，不能重複，建議和策略組名稱區分開。

type必須

可選 http/file/inline。

urltype 為 http 時必須

訂閱位址。

path可選

下載後儲存的檔案路徑，不填則用 URL 的 MD5 作為檔案名稱。出於安全考量，路徑只允許在 HomeDir 內，其他位置需要設定 SAFE_PATHS 環境變數。

interval可選

更新集合的時間間隔，單位秒。

proxy可選

經過指定代理進行下載/更新。

size-limit預設 0

限制下載檔案的最大大小，單位位元組，0 表示不限制。

header可選

自訂 HTTP 請求標頭，比如給需要驗證的訂閱位址加 Authorization。

payloadtype 為 inline 時必須

直接內聯寫節點內容，格式和 proxies 一致；當 http/file 解析失敗時也會用作備援節點。

health-check 健康檢查

欄位	說明
`enable`	是否啟用
`url`	健康檢查位址，推薦 `https://www.gstatic.com/generate_204` 或 `https://cp.cloudflare.com`
`interval`	檢查間隔，單位秒
`timeout`	逾時時間，單位毫秒
`lazy`	預設 true，集合內節點沒被使用時不進行測試
`expected-status`	期望的 HTTP 回應狀態碼，寫法見代理組通用欄位

override 覆寫

批量覆寫這個集合裡所有節點的欄位，常見用法：

欄位	說明
`additional-prefix` / `additional-suffix`	給節點名稱統一加前綴/後綴
`proxy-name`	用正規表示式取代節點名稱內容，`pattern` 匹配、`target` 取代（支援 `$1` 分組引用）
`udp` / `tfo` / `mptcp` / `skip-cert-verify` / `dialer-proxy` / `interface-name` / `routing-mark` / `ip-version`	批量覆寫通用欄位，含義同各自的通用欄位說明
`up` / `down`	批量設定頻寬（Hysteria/Hysteria2 專屬）
`udp-over-tcp`	批量設定 UDP over TCP（Shadowsocks 專屬）

篩選與解密

filter / exclude-filter可選

用關鍵詞或正規表示式篩選/排除節點，多個正規表示式之間用 ` 分隔。

exclude-type可選

不支援正規表示式，用 | 分割，按節點類型排除，如 "ss|http"。

age-secret-key可選

如果訂閱檔案是用 age 加密的，填這個金鑰即可自動解密；可用 mihomo age keygen 產生對應金鑰。

集合檔案本身的寫法（YAML / URI / Base64 三種格式），請看代理集合內容。