Clash 配置文件详解:config.yaml 每一部分是什么意思

作者:Clash中文网编辑部 · 更新于

本文目录
  1. 整体结构
  2. 基础设置
  3. tun
  4. proxies:节点
  5. proxy-groups:策略组
  6. rule-providers:规则集
  7. rules:分流规则
  8. 改配置的正确方式
  9. 常见问题

机场订阅下载下来就是一份 YAML 格式的配置文件。看懂它,就能理解 Clash 在做什么,也方便排查问题。日常使用不需要手改,客户端的设置界面会帮你改。

整体结构

一份配置文件大致分成这几块:

部分 作用
基础设置 端口、模式、日志、局域网访问等
dns DNS 解析方式
tun 虚拟网卡模式
proxies 节点列表
proxy-groups 策略组(节点分组)
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,加快连接

不同客户端默认端口不一样,比如 Clash Verge Rev 默认 7897,以客户端设置里显示的为准。

tun

tun:
  enable: true
  stack: mixed            # system / gvisor / mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

客户端里的「虚拟网卡模式」开关,改的就是这里的 enable。原理见TUN 模式教程。

proxies:节点

proxies:
  - name: "香港 01"
    type: ss
    server: hk01.example.com
    port: 443
    cipher: 2022-blake3-aes-128-gcm
    password: "xxxx"

每个节点包含名称、协议类型、服务器地址、端口和认证信息。这部分由机场生成,不要外泄。各协议的区别见代理协议科普。

proxy-groups:策略组

proxy-groups:
  - name: 节点选择
    type: select
    proxies: [自动选择, 香港 01, 日本 01, DIRECT]
  - name: 自动选择
    type: url-test
    url: https://www.gstatic.com/generate_204
    interval: 300
    proxies: [香港 01, 日本 01]

select 手动选,url-test 自动选延迟最低的。详见策略组教程。

rule-providers:规则集

rule-providers:
  ai:
    type: http
    behavior: classical
    url: https://example.com/ai.yaml
    path: ./rules/ai.yaml
    interval: 86400

把一大批规则放在外部文件里,按时自动更新,配置文件更简洁。

rules:分流规则

rules:
  - RULE-SET,ai,节点选择
  - GEOSITE,cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,节点选择

从上往下匹配,命中即停。写法见规则分流教程。

改配置的正确方式

订阅更新会覆盖整份文件,所以:

  • 改端口、模式、TUN、局域网:用客户端的设置界面;
  • 加规则、改 DNS:用客户端的覆写功能(Clash Verge Rev 的全局扩展配置、Clash Party 的覆写);
  • 完全自己写配置:新建一个本地配置文件,而不是修改订阅。

常见问题

YAML 格式报错怎么办?

YAML 对缩进非常敏感,必须用空格,不能用 Tab;同一层级的缩进要一致;冒号后面要有空格。可以先在在线 YAML 校验工具里检查格式(注意不要粘贴含节点密码的内容)。

external-controller 有安全风险吗?

默认只监听 127.0.0.1,只有本机能访问,没有风险。如果改成 0.0.0.0 开放给局域网,一定要设置 secret,否则同一网络里的人都能控制你的 Clash。