全局配置 config.yaml 字段详解

允许局域网

allow-lan可选

是否允许其他设备经过本机的代理端口访问互联网。手机、平板要接入电脑跑的 Clash，必须把它打开。

bind-address可选

绑定地址，仅允许其他设备通过这个地址访问。"*" 绑定所有 IP；也可以填单个 IPv4/IPv6 地址只绑定一个网卡。

lan-allowed-ips / lan-disallowed-ips可选

局域网访问的 IP 白名单和黑名单，仅在 allow-lan: true 时生效；黑名单优先级高于白名单。

config.yaml YAML

allow-lan: true
bind-address: "*"
lan-allowed-ips:
  - 0.0.0.0/0
  - ::/0
lan-disallowed-ips:
  - 192.168.0.3/32

用户验证

authentication可选

给 http(s)/socks/mixed 代理设置用户名密码验证，格式为 "user:pass" 数组。

skip-auth-prefixes可选

设置允许跳过验证的 IP 段，比如 127.0.0.1/8、::1/128。

运行模式与日志

mode默认 rule

rule 规则匹配（最常用）；global 全局代理，所有流量走 GLOBAL 策略组里选中的节点；direct 全局直连，忽略所有代理。

log-level默认 info

输出日志的详细程度，从少到多：silent 静默 → error → warning → info → debug（几乎输出全部运行信息，排障时才需要）。

ipv6默认 true

是否允许内核接受 IPv6 流量。

find-process-mode默认 strict

是否匹配发起连接的进程（配合 PROCESS-NAME 规则用）：always 强制匹配所有进程；strict 由内核判断是否需要匹配；off 完全不匹配，路由器上跑建议用这个。

TCP Keep Alive

移动设备上适当调整这几项可以减少耗电：

字段	说明
`keep-alive-interval`	TCP Keep Alive 包的发送间隔，单位秒
`keep-alive-idle`	TCP Keep Alive 的最大空闲时间
`disable-keep-alive`	禁用 TCP Keep Alive，Android 上会被强制置为 true

外部控制（API）

面板（Dashboard）就是通过这里配置的 RESTful API 跟内核通信的。

external-controller可选

API 监听地址，默认 127.0.0.1:9090 只允许本机访问；改成 0.0.0.0:9090 可以监听所有网卡（比如手机连路由器上的面板）。

secret可选

API 的访问密钥，开放到 0.0.0.0 时强烈建议设置，否则任何人都能连上你的面板改配置。

external-controller-cors可选

API 的 CORS 标头配置，allow-origins 数组 + allow-private-network。

external-ui / external-ui-url可选

把一份面板静态网页资源（如 metacubexd）挂载到 API 地址/ui；external-ui-url 用来配置自动下载/更新面板资源的地址。

config.yaml YAML

external-controller: 127.0.0.1:9090
secret: ""
external-ui: ui
external-ui-url: "https://github.com/MetaCubeX/metacubexd/archive/refs/heads/gh-pages.zip"

还有 external-controller-tls（HTTPS API）、external-controller-unix（Unix socket）、external-controller-pipe（Windows namedpipe）等进阶写法，通过 Unix socket / namedpipe 访问 API 不会校验 secret，请自行保证安全。

其它常用字段

字段	说明
`unified-delay`	开启统一延迟时会计算 RTT，消除不同协议握手耗时带来的延迟差异，让测速数字之间可比
`tcp-concurrent`	启用 TCP 并发连接：用 DNS 解析出的所有 IP 同时发起连接，取第一个成功的，可以缓解某些线路的连接失败问题
`interface-name`	指定 mihomo 的流量出站网卡
`routing-mark`	为 Linux 下的出站连接设置默认路由标记
`profile.store-selected`	记住每个策略组上次手动选择的节点，重启后不用重新选
`profile.store-fake-ip`	储存 fake-ip 映射表，域名再次连接时复用原有映射地址
`global-client-fingerprint`	已弃用，请直接在每个 `proxy` 里设置 `client-fingerprint`

GEO 数据源

geodata-mode默认 false

GEOIP 数据文件格式，true 使用 .dat 格式，false 使用 .mmdb 格式。

geodata-loader默认 memconservative

standard 标准加载器；memconservative 为小内存设备优化的加载器（路由器等场景推荐）。

geo-auto-update / geo-update-interval可选

是否自动更新 GEO 数据库以及更新间隔（单位小时）。

geox-url可选

自定义 geoip/geosite/mmdb/asn 四个数据文件的下载地址，网络环境不好时可以换成国内镜像。