MKMihomo 与 sing-box 内核手册TECHNICAL REFERENCE · mihomo / sing-box
文档号
YYK-3.1
修订 · 页
2026-10-18 · 07/10
§ 3.1mihomo第 07 / 10 页

mihomo 配置文件有哪些部分

Mihomo 与 sing-box 内核手册编辑部 · 更新于 2026-10-18

mihomo 配置采用 YAML,源码里的默认文件名为 config.yaml。顶层结构包含 DNS、TUN、代理、代理组、规则和规则集等部分;规则从上到下匹配,rule-providers 支持 yaml、text 与 mrs 格式。

mihomo 配置使用 YAML,源码里的默认配置文件名是 config.yaml。官方文档把配置分成全局参数、DNS、TUN、入站监听、代理、代理组、规则和规则集等部分;每个顶层段承担不同作用,不能把字段名称当作可互换配置。

顶层部分

段或字段作用范围
全局配置mode、log-level、allow-lan、external-controller 等通用参数
dnsDNS 监听、enhanced-mode、上游服务器与 hosts 等
tunTUN 入站、路由及接口相关设置
listeners入站监听器
proxies代理定义
proxy-providers远程代理资源提供项
proxy-groups选择、回退、负载均衡等策略组
rules按顺序匹配的路由规则
rule-providers可加载的规则集来源

mode 可为 rule、global 或 direct;日志等级包括 silent、error、warning、info 和 debug。官方文档写明基于最新的 Alpha 分支介绍,版本低的可能不支持部分功能。

规则与规则集

规则类型包括 DOMAIN、DOMAIN-SUFFIX、GEOSITE、IP-CIDR、GEOIP、端口、进程名称、UID、NETWORK、RULE-SET 及 MATCH 等,规则按文档描述从上到下匹配。Android 上 PROCESS-NAME 可匹配包名,UID 匹配 Linux 用户 ID;这些平台限制应结合规则类型理解。规则附加参数中,no-resolve 用于跳过为目标 IP 规则触发的 DNS 解析,src 将目标 IP 匹配改为来源 IP 匹配。

rule-providers 的 type 可为 http、file 或 inline;behavior 可为 domain、ipcidr 或 classical;format 可为 yaml、text 或 mrs,默认 yaml。domain 内容是域名,ipcidr 内容是 IP 段,classical 支持路由规则类型(rule-set / sub-rule 除外)。

官方说明 mrs 目前支持 domain 与 ipcidr 两种 behavior,可用 mihomo convert-ruleset 转换 yaml 或 text 文件。它不是任意规则都能装入的通用容器。配置路径和版本应与启动校验页及内核介绍交叉阅读。

其他顶层内容还有子规则、流量隧道、NTP 和实验性配置。DNS 文档列出 nameserver、fallback、fake-ip-filter 等名称;TUN 文档列出 stack、auto-route、dns-hijack 等字段。

规则集路径还受文档列出的安全限制:provider 文件路径只能位于 HomeDir(由 -d 指定)内;要放在其他位置需设置 SAFE_PATHS 环境变量。设置 path-in-bundle 时,本地文件不存在会先尝试从 HomeDir 的 BundleMRS.7z 解压。

常见问题

mihomo 配置是什么格式?

官方配置文档使用 YAML,源码里的默认配置文件名为 config.yaml。顶层部分包括 DNS、TUN、代理、代理组、规则和规则提供项。

mrs 可以包含所有规则吗?

官方说明 mrs 目前只支持 domain 与 ipcidr 两种 behavior。classical、其他规则类型不能据此认为都能转换为 mrs。