Home

Mihomo 配置从入门到进阶：三阶段完全教程

参考来源： 虚空终端官方文档 · 官方语法手册 ·

---

写在最前

Mihomo（原名 Clash Meta）是目前功能最完整、社区最活跃的 Clash 衍生内核。它本身没有图形界面，完全靠读取一份 YAML 格式的配置文件来工作。

本教程分三个阶段，每一阶段都有独立的完整示例，你可以从任一阶段开始阅读。第一阶段是能跑起来的最小配置，第二阶段引入规则集和锚点写法，第三阶段覆盖 TUN 透明代理、dialer-proxy 代理链、性能调优等进阶话题。

---

YAML 基础：动笔前必读

缩进规则

YAML 绝对禁止使用 Tab，只能用空格。同一层级的键必须对齐，缩进多少空格无所谓，但必须一致。这是新手最常见的报错来源。

# ✅ 正确
dns:
  enable: true
  listen: 0.0.0.0:1053

# ❌ 错误（第二行用了 Tab）
dns:
	enable: true

四种等价写法

mihomo 的配置文件支持 YAML 和 JSON 混写，下面四种写法完全等价：

# 写法一：标准多行 YAML（可读性最好，适合顶层配置）
tun:
  enable: true
  stack: mixed
  auto-route: true

# 写法二：多行 JSON 花括号（proxy-groups 中常用）
tun: {
  enable: true,
  stack: mixed,
  auto-route: true
}

# 写法三：单行 JSON 花括号（proxy-groups 列表项常用，极大缩短配置长度）
tun: { enable: true, stack: mixed, auto-route: true }

# 写法四：数组的单行写法
nameserver: [223.5.5.5, 119.29.29.29]
# 等价于：
nameserver:
  - 223.5.5.5
  - 119.29.29.29