Clash 配置文件详解:看懂并修改 config.yaml

逐段解释 Clash(mihomo)配置文件 config.yaml 的结构:端口与基础设置、proxies 节点、proxy-groups 策略组、proxy-providers 订阅集合和 rules 规则,附一份带注释、可直接改用的完整示例。

最后更新:

本页内容

Clash 的全部行为都由一份 YAML 配置文件决定。用订阅的时候,这份文件由服务商生成,你不需要动它;但看懂它的结构,才能自己加规则、调整策略组,或者排查问题。

本文按 mihomo 内核的语法说明,原版 Clash 的配置是它的子集。

整体结构

一份配置文件由五个部分组成:

部分 作用
基础设置 端口、运行模式、日志、控制接口
dns 域名解析方式,见 DNS 设置
proxies / proxy-providers 节点列表,或从订阅地址拉取节点
proxy-groups 策略组:把节点组织起来,决定手动选还是自动选
rules / rule-providers 分流规则,见规则与分流

请求的处理顺序是:进入代理端口 → 从上到下匹配 rules → 命中的规则指向某个策略组 → 策略组选出一个节点 → 发出去。

完整示例

下面是一份可以正常工作的最小配置,节点信息是占位内容,需要换成自己的。

# ---------- 基础设置 ----------
mixed-port: 7890            # HTTP 和 SOCKS5 共用的代理端口
allow-lan: false            # 是否允许局域网内其他设备连接
bind-address: "*"
mode: rule                  # rule 规则 / global 全局 / direct 直连
log-level: info             # silent / error / warning / info / debug
ipv6: false
external-controller: 127.0.0.1:9090   # 控制接口,供面板使用
secret: ""                  # 控制接口密码,对外开放时必须设置
unified-delay: true         # 测速时去掉握手耗时,结果更接近真实延迟
tcp-concurrent: true        # 并发连接多个 IP,取最快的

# ---------- DNS ----------
dns:
  enable: true
  ipv6: false
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  default-nameserver: [223.5.5.5, 119.29.29.29]
  nameserver:
    - https://dns.alidns.com/dns-query
    - https://doh.pub/dns-query

# ---------- 节点 ----------
proxies:
  - name: "香港 01"
    type: ss
    server: hk01.example.com
    port: 8388
    cipher: aes-256-gcm
    password: "your-password"

  - name: "日本 01"
    type: trojan
    server: jp01.example.com
    port: 443
    password: "your-password"
    sni: jp01.example.com

# ---------- 策略组 ----------
proxy-groups:
  - name: "节点选择"
    type: select            # 手动选择
    proxies: ["自动选择", "香港 01", "日本 01", DIRECT]

  - name: "自动选择"
    type: url-test          # 自动选延迟最低的
    proxies: ["香港 01", "日本 01"]
    url: https://www.gstatic.com/generate_204
    interval: 300           # 每 300 秒测一次
    tolerance: 50           # 延迟差小于 50ms 不切换

# ---------- 规则 ----------
rules:
  - DOMAIN-SUFFIX,local,DIRECT
  - GEOSITE,category-ads-all,REJECT
  - GEOSITE,cn,DIRECT
  - GEOIP,private,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,节点选择

基础设置

配置项 含义
mixed-port 混合端口,HTTP 和 SOCKS5 都用它。也可以用 port、socks-port 分开设置
allow-lan 设为 true 后,同一局域网的手机、电视可以把代理地址填成这台机器的 IP
mode 运行模式,一般保持 rule
log-level 日志详细程度,排查问题时临时改成 debug
external-controller 控制接口地址,网页面板和图形客户端通过它管理内核
secret 控制接口的密码
tun 虚拟网卡设置,见 TUN 模式

proxies:节点

proxies 下的每一项是一个节点。所有类型都有 name、type、server、port 四个字段,其余字段随协议变化。mihomo 支持的常见类型:

type 协议
ss Shadowsocks
vmess VMess
vless VLESS(可搭配 REALITY)
trojan Trojan
hysteria2 Hysteria2
tuic TUIC
wireguard WireGuard
http / socks5 普通 HTTP、SOCKS5 代理

节点的 name 不能重复,策略组靠名字引用节点。每种协议的完整写法见 Clash 支持的协议。

proxy-providers:从订阅拉取节点

不想把节点写死在配置里时,可以让内核定时从订阅地址下载节点列表:

proxy-providers:
  my-sub:
    type: http
    url: "你的订阅链接"
    interval: 43200          # 每 12 小时更新
    path: ./providers/my-sub.yaml
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300

proxy-groups:
  - name: "节点选择"
    type: select
    use: [my-sub]            # 用 use 引入整个 provider
    proxies: [DIRECT]

这样分流规则和策略组由你自己掌握,节点交给订阅自动更新,适合在服务器上长期运行。

proxy-providers 还可以用 filter 按名称筛选节点,例如只保留名字里带「香港」的:

    filter: "香港|HK"

proxy-groups:策略组

策略组决定「一批节点里到底用哪个」。常用的四种类型:

type 行为 适合
select 手动选择 主入口,自己决定用哪个节点或哪个子组
url-test 定期测速,自动用延迟最低的 不想手动挑节点
fallback 按顺序用第一个可用的 有明确的主备顺序
load-balance 把请求分摊到多个节点 多节点并用

策略组可以嵌套:上面示例里,「节点选择」的选项里包含了「自动选择」这个组。常见的做法是为不同用途建不同的组,例如「流媒体」「AI 服务」,再在规则里把对应域名指向这些组。

DIRECT(直连)和 REJECT(拒绝)是内置策略,可以直接写进任何策略组的 proxies 里。

修改配置的正确姿势

直接改订阅下载下来的文件,下次更新就会被覆盖。应该用客户端提供的覆写机制:

  • Clash Verge Rev
    • 加几条规则:右键订阅卡片 →「编辑规则」,在界面里添加前置规则;
    • 加节点或策略组:右键订阅卡片 →「编辑节点」「编辑代理组」;
    • 对所有订阅都生效的改动:在「订阅」页面的「全局扩展配置」里写 YAML;
  • Clash Meta for Android:「设置 → 覆写」;
  • mihomo 命令行:自己维护 config.yaml,节点用上面的 proxy-providers 引入。

改完后查看客户端的「日志」页面,确认没有报错。

接下来可以看规则与分流,了解 rules 部分的详细写法。

常见问题

Clash 的配置文件在哪里?

Clash Verge Rev 在「设置 → Verge 设置 → 配置目录」可以直接打开所在文件夹;右键订阅卡片选「编辑文件」能看到订阅原文。命令行运行 mihomo 时,配置文件是 -d 参数指定目录下的 config.yaml,默认目录是 ~/.config/mihomo。

改了订阅里的配置,为什么一更新就没了?

订阅更新时会用服务器上的内容整个覆盖本地文件。想让修改保留下来,要用客户端的覆写功能:Clash Verge Rev 是「全局扩展配置」和订阅卡片右键里的「编辑规则」,Clash Meta for Android 是「设置 → 覆写」。

YAML 格式要注意什么?

缩进只能用空格,不能用 Tab,同一层级的缩进必须对齐;冒号后面要有一个空格;包含冒号、井号等特殊字符的值要加引号。格式写错时内核会拒绝加载,并在日志里给出出错的行号。

url-test、fallback、load-balance 有什么区别?

url-test 定期测速并自动选用延迟最低的节点;fallback 按顺序使用第一个可用的节点,出故障才切到下一个;load-balance 把请求分散到多个节点上。手动选择用 select 类型。