Clash 配置文件教程:config.yaml 的结构与写法

Clash(mihomo)配置文件 config.yaml 的完整讲解:端口等基础设置、proxies 节点、proxy-providers 订阅、proxy-groups 策略组四种类型、rules 规则,附带一份有注释的可用示例,以及不被订阅更新覆盖的修改方法。

更新于

Clash 的行为完全由一份 YAML 文件决定。用订阅时这份文件由服务商生成,看懂它的结构才能自己调整。

五个部分

部分 作用
基础设置 端口、模式、日志、控制接口
dns 域名解析,见 DNS 设置
proxies、proxy-providers 节点,或从订阅拉取节点
proxy-groups 策略组,决定用哪个节点
rules、rule-providers 分流规则,见规则教程

一份可用的示例

mixed-port: 7890          # HTTP 与 SOCKS5 共用端口
allow-lan: false          # 是否允许局域网设备连接
mode: rule                # rule / global / direct
log-level: info
external-controller: 127.0.0.1:9090

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - https://dns.alidns.com/dns-query
    - https://doh.pub/dns-query

proxy-providers:
  airport:
    type: http
    url: "你的订阅链接"
    interval: 43200
    path: ./providers/airport.yaml
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300

proxy-groups:
  - name: 手动选择
    type: select
    use: [airport]
    proxies: [自动测速, DIRECT]

  - name: 自动测速
    type: url-test
    use: [airport]
    url: https://www.gstatic.com/generate_204
    interval: 300
    tolerance: 50

rules:
  - GEOSITE,category-ads-all,REJECT
  - GEOSITE,cn,DIRECT
  - GEOIP,private,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,手动选择

基础设置

配置项 含义
mixed-port 混合端口,见系统代理与端口
allow-lan 局域网共享开关,见局域网共享
mode 运行模式
external-controller 控制接口,见控制面板
secret 控制接口密码
tun 虚拟网卡,见 TUN 模式

策略组的四种类型

type 行为
select 手动选择
url-test 定时测速,自动使用延迟最低的节点
fallback 按顺序使用第一个可用的节点
load-balance 把请求分摊到多个节点

策略组可以互相嵌套,例如让「手动选择」里包含「自动测速」这个组。常见做法是给流媒体、AI 服务各建一个组,在规则里把对应域名指过去。

按地区筛选节点

  - name: 香港节点
    type: url-test
    use: [airport]
    filter: "香港|HK|Hong Kong"

filter 用正则表达式匹配节点名称。

不被覆盖的修改方法

  • Clash Verge Rev:订阅卡片右键里的「编辑规则」「编辑节点」「编辑代理组」,以及订阅页的「全局扩展配置」;
  • 安卓客户端:「设置 → 覆写」;
  • 自己维护配置:像上面的示例那样用 proxy-providers 引入订阅,规则和策略组自己掌握。

常见问题

Clash 配置文件在哪个位置?

Clash Verge Rev 在「设置 → Verge 设置 → 配置目录」可以打开所在文件夹。mihomo 命令行默认读取 ~/.config/mihomo/config.yaml,也可以用 -d 参数指定目录。

修改了配置,更新订阅后又变回去了怎么办?

订阅更新会整个覆盖本地文件。要让修改保留,使用客户端的覆写功能:Clash Verge Rev 的「全局扩展配置」和订阅右键菜单里的编辑规则、编辑节点,安卓客户端的「覆写」。

配置文件报错 yaml 格式错误怎么办?

检查缩进是否全部使用空格且层级对齐、冒号后是否有空格、带特殊字符的值是否加了引号。日志里会给出出错的行号。

继续阅读