Basalt - 跨境电商(类专线)通信服务返回首页

Mihomo 配置文件怎么改?已有订阅叠加规则、DNS 与 TUN 设置

更新于 2026-11-04 · bpt443.buzz

简答:Mihomo 配置文件修改不要从零重写:先复制当前配置或建立备份,再确认 mode 为 rule,使用 proxy-groups 的 use 引用已有订阅节点,最后添加 rules、DNS 或 TUN 配置并重载验证。最容易出错的是 YAML 缩进、策略组名称、规则顺序和订阅更新覆盖;先改一个区块,出现解析错误就立即恢复备份。

定义:Mihomo 配置文件是用 YAML 描述代理来源、策略组、DNS、TUN 和分流规则的文本配置,其中 proxy-providers 提供节点来源,proxy-groups 组织可选出口,rules 决定请求按顺序交给哪个策略组或 DIRECT。

先看这张 5 分钟操作清单:不要直接重写订阅

本文是面向已有订阅的修改流程,不要求你从零编写全部节点。Mihomo 官方文档分别定义了代理来源、策略组、规则、DNS 和 TUN 配置,字段之间可以按“节点来源→策略组→rules 或 RULE-SET→日志验证”的顺序检查。代理提供者文档、策略组文档、规则文档

步骤要做什么通过标准
1. 备份复制当前 YAML,另外保存订阅地址、策略组名称和原配置能随时恢复到修改前状态
2. 确认模式检查 mode: rule普通 rules 才会按顺序参与分流
3. 确认来源区分 proxies、proxy-providers 与策略组策略组能看到节点或提供者中的节点
4. 只改一块先改代理组或规则,再单独改 DNS、TUN出现问题时能定位到具体区块
5. 重载使用客户端的重载、更新配置或重新载入入口配置没有 YAML 解析错误
6. 验证查看日志中的规则、策略组和连接结果实际命中目标规则,而不是只看网页能否打开

关键结论:自定义规则通常要放在 MATCH 前面;如果把 MATCH 放在第一行,后面的具体规则通常没有机会命中。Mihomo 官方文档明确说明规则按从上到下匹配,顶部规则优先级更高。查看规则优先级与 MATCH 说明

按系统找到配置入口:路径不统一,入口方式更可靠

Mihomo 核心本身不能保证所有客户端、系统都使用同一个配置目录。Windows、macOS、Linux 和 Android 上,配置文件可能由图形客户端管理,也可能由命令行启动参数指定。因此不要直接套用网上的固定路径;优先在当前客户端中寻找“打开配置、编辑配置、复制配置、配置目录、重载配置”一类入口。找不到时,再查看该客户端的启动参数、工作目录或配置管理页面。

  • Windows:先使用客户端的配置列表或打开配置入口,修改前复制当前 YAML;如果启用了 TUN,官方文档提示 dns-mode: hijack 需要配合 strict-route 才能处理 Windows 的相关 DNS 路由场景。
  • macOS:优先从客户端的配置管理界面进入,不要假定配置一定位于某个固定目录。官方文档显示,TUN 的 DNS 劫持不能自动接管发送到本地网络的 DNS 请求,且 macOS 在未指定时的 TUN DNS 默认行为与 Windows、Linux 不同。
  • Linux:如果使用 TUN 的 DNS 劫持,官方文档要求相关场景配合 auto-redirect;修改后应同时检查系统路由、权限和是否仍有其他网络服务接管 DNS。
  • Android:客户端通常通过应用内配置管理页面完成导入、编辑或重载。官方文档提示,系统开启 Private DNS 时,DNS 请求不能被自动劫持;遇到规则命中但解析异常,先检查该系统开关。

不同客户端的按钮名称、配置保存方式和重载方式可能变化,本文不把某个客户端界面当成通用界面。若客户端没有直接编辑功能,可以先导出配置,在本地修改后再通过客户端的导入或替换入口加载;操作前必须保留原文件和回滚路径。

先保留订阅更新:用 proxy-providers 加载节点,再用 use 接入策略组

proxies 是直接写在当前配置里的节点定义,proxy-providers 是节点集合的来源,proxy-groups 是用户手动选择或自动选择的出口。已有订阅时,不建议把订阅中的全部节点复制到 proxies,否则后续更新会变成手工维护。

下面是脱敏结构示例,订阅地址、提供者名称和节点内容都需要替换;它不是可直接使用的真实订阅:

proxy-providers:
  my-subscription:
    type: http
    url: "替换为你的订阅地址"
    path: ./providers/my-subscription.yaml

再在策略组中通过 use 引用提供者:

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - DIRECT
    use:
      - my-subscription

官方策略组示例同时展示了 proxies、use、测速地址、检查间隔和过滤字段;use 引用的是代理提供者名称,不是订阅地址,也不是某个节点名称。查看 use、filter 与 include-all 字段

如果客户端每次更新订阅都会重新生成主配置,那么直接改主 YAML 可能被覆盖。判断标准是:修改后立即生效,但执行一次订阅更新后字段消失。此时应优先使用客户端支持的覆写配置、独立配置或合并机制;如果客户端没有这些能力,就把本地规则单独保存,并在每次更新后重新合并。具体入口和支持范围需以当前客户端为准。

规则设置:先用最小模板,再扩展 RULE-SET

先确认策略组名称真实存在,再添加规则。下面的模板只展示结构:

mode: rule
mixed-port: 7890

rules:
  - DOMAIN,internal.example,DIRECT
  - DOMAIN-SUFFIX,example.com,PROXY
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

DOMAIN 只匹配完整域名,DOMAIN-SUFFIX 可匹配域名及其子域名,DOMAIN-KEYWORD 范围更宽,容易误命中。GEOSITE 依赖当前 GEO 数据中的分类,GEOIP 按目标 IP 判断,IP-CIDR 按网段判断,PROCESS-NAME 则按进程名匹配;Android 场景还可以匹配应用包名。查看规则类型与示例

对域名规则和 IP 规则的区别要特别注意:当 Mihomo 需要用目标 IP 规则判断域名时,可能先触发 DNS 解析;加上 no-resolve 可以跳过这次解析。它适合不希望某条 IP 规则主动触发解析的场景,但也意味着该规则可能无法通过域名解析结果命中。官方文档将 no-resolve 定义为跳过目标 IP 规则触发的 DNS 解析。查看 no-resolve 说明

使用较大规则集合时,再增加 rule-providers:

rule-providers:
  local-list:
    type: file
    behavior: classical
    format: yaml
    path: ./rules/local-list.yaml

rules:
  - RULE-SET,local-list,PROXY
  - MATCH,DIRECT

RULE-SET 中的名称必须与 rule-providers 下的键完全一致;规则文件的 behavior 与 format 也要和实际内容匹配。官方文档列出了 HTTP、file、inline 等提供者类型及对应字段。查看 rule-providers 类型、格式与 behavior

DNS 设置:先做可回滚的最小改动

DNS 不应和规则、TUN 一起一次性大改。先备份原配置,只添加一个明确目的的 DNS 区块,并在重载后观察解析和日志。官方文档将 nameserver 定义为默认域名解析服务器,nameserver-policy 可按域名或 geosite 指定解析服务器;proxy-server-nameserver 只用于解析代理节点域名,direct-nameserver 用于直连出口的域名解析。查看 Mihomo DNS 字段说明

一个不绑定具体服务商的最小结构如下:

dns:
  enable: true
  ipv6: false
  enhanced-mode: redir-host
  nameserver:
    - 1.1.1.1
    - 8.8.8.8

上面的地址只是配置示例,不代表任何线路或解析效果;实际 DNS 地址应按网络环境和客户端支持情况选择。若使用 fake-ip,还要检查 fake-ip-range 与 fake-ip-filter;官方文档说明 enhanced-mode 可选 fake-ip 或 redir-host,默认值为 redir-host。查看 enhanced-mode、fake-ip 与 nameserver-policy

DNS 验证方法:重载后先测试一个明确域名,再查看日志是否出现解析失败、策略组名称错误或连接超时。若域名规则能命中但 IP 规则表现异常,记录当前 DNS 模式、IPv4 或 IPv6 状态,并暂时移除新增的 DNS 配置进行对比。恢复后问题消失,才说明新增 DNS 区块与现象相关;不要仅凭一次网页访问下结论。

TUN 设置:明确启用前提、平台差异和回滚方式

TUN 会改变系统流量接管方式,启用前应先确认客户端具备创建虚拟网卡的权限,并保留关闭 TUN、恢复系统代理和恢复原配置的入口。Mihomo 官方文档列出了 enable、auto-route、auto-redirect、dns-mode、dns-hijack、strict-route 等字段。查看 TUN 官方字段说明

可先使用这个最小结构进行单变量测试:

tun:
  enable: true
  auto-route: true
  auto-detect-interface: true
  dns-mode: native
  dns-hijack:
    - any:53

如果需要把其他接口发往 53 端口的请求也导入内部 DNS 模块,可评估 dns-mode: hijack。官方文档说明,native 会把 TUN 地址设为系统 DNS,hijack 还会拦截其他接口发往 53 端口的流量;Windows 需要 strict-route,Linux 需要 auto-redirect 才满足对应条件。查看 dns-mode、dns-hijack 与 strict-route

Windows 可在需要时测试:

tun:
  enable: true
  auto-route: true
  auto-detect-interface: true
  dns-mode: hijack
  dns-hijack:
    - any:53
  strict-route: true

Linux 需要额外核对客户端是否支持并启用了 auto-redirect。macOS 不要直接照搬 Windows 的 DNS 劫持配置;Android 则要检查 Private DNS,因为官方文档说明该功能开启时不能自动劫持 DNS 请求。strict-route 在 Windows 还可能让部分虚拟机软件出现异常,因此验证失败时应先关闭 TUN 或恢复备份,而不是继续叠加参数。

验证与回滚:重载后确认客户端仍能启动,检查系统是否出现网络中断、DNS 泄漏迹象或虚拟网卡异常,再分别测试浏览器和一个不依赖浏览器代理设置的应用。出现全局断网、客户端无法启动或虚拟机网络异常时,先关闭 TUN、恢复原配置并重启网络连接;回滚成功后,再一次只改一个字段。

配置不生效时,按日志分流而不是反复改参数

  1. 配置解析失败:先检查空格缩进、冒号、引号、重复顶层字段和列表层级。恢复备份后,每次只加入一小段。
  2. 策略组为空:检查 use 中的提供者名称、proxies 中的节点或策略组名称,以及提供者文件是否成功加载。
  3. 规则没有命中:确认 mode: rule,把测试用的具体规则放在 MATCH 前,检查目标策略组名称是否完全一致。
  4. IP 规则表现异常:检查 DNS 是否被触发、是否使用了 no-resolve、目标是否优先走 IPv6,以及当前日志显示的是域名匹配还是 IP 匹配。
  5. RULE-SET 加载失败:检查提供者键名、文件路径、下载状态、behavior 和 format,再确认 RULE-SET 调用位置在 MATCH 之前。
  6. 订阅更新后消失:对比更新前后的 YAML,确认客户端是否重新生成主配置;若确认被覆盖,改用客户端支持的覆写或独立规则文件机制。
  7. 规则已命中但连接失败:此时不要继续改规则。检查目标策略组、节点协议能力、DNS、TUN、系统防火墙和网络线路。官方文档特别说明,如果请求是 UDP 而所选节点不支持 UDP,匹配可能继续向下进行;应在日志中确认是否为该条件,而不能把它当成普通规则未命中。查看规则继续匹配条件

回滚原则:只要出现所有流量中断、策略组为空或配置无法启动,先恢复最后一个可用版本,再逐项加入修改。不要同时改 DNS、TUN、规则顺序和节点来源,否则无法判断真正原因。

修改完成后的自查卡

  • 当前配置是否已经单独备份,并且没有公开真实订阅地址、节点密码或控制接口密钥?
  • mode 是否为 rule,而不是 global 或 direct?
  • proxy-groups 中的 use 是否引用了实际存在的 proxy-providers 名称?
  • 具体规则是否位于 MATCH 前?
  • RULE-SET 名称、规则文件路径、behavior 和 format 是否一致?
  • DNS 修改后是否分别验证了域名解析、规则命中和实际连接?
  • TUN 是否有权限、系统路由是否正常,并且已经准备好关闭 TUN 的回滚路径?
  • 订阅更新后,新增规则和策略组是否仍然存在?如果消失,说明需要改用客户端支持的覆写或独立配置机制。

本文仅作为 Mihomo 配置修改与排查指南,站点不是 Mihomo 或相关客户端的官网;字段和客户端界面可能随当前核心或客户端变化,实际使用前应以当前官方文档和客户端界面为准。

常见问题

Mihomo 配置文件通常在哪里?Windows、macOS、Linux 和 Android 一样吗?

不一样,也不存在适用于所有客户端的固定路径。优先使用当前客户端的打开配置、编辑配置、配置目录或导出入口;命令行运行时再结合启动参数和工作目录确认。配置位置和重载按钮需以当前客户端为准。

已有订阅怎么加规则,才能避免更新后被覆盖?

不要把订阅节点全部复制到 proxies。可以保留 proxy-providers 作为节点来源,再在 proxy-groups 中用 use 引用提供者,并把本地规则放入客户端支持的覆写、独立规则文件或合并配置中。具体能力取决于所用客户端;如果更新后字段消失,就说明主配置被重新生成。

Mihomo 的 DNS 和 TUN 要一起开启吗?

不一定。先在现有接管方式下验证 rules,再单独修改 DNS;只有出现域名解析异常、应用流量未被接管或系统路由问题时,才测试 TUN。启用 TUN 前要确认权限,并保留关闭 TUN 和恢复原配置的路径。

为什么 GEOIP 或 IP-CIDR 规则没有按预期命中?

IP 类规则可能需要目标 IP,而域名请求可能先触发 DNS 解析。检查当前 DNS 模式、IPv4 或 IPv6、规则顺序及是否使用了 no-resolve;同时查看日志确认实际使用的是域名匹配还是 IP 匹配。

为什么我写了规则,但日志里仍然走了其他策略组?

先检查 mode 是否为 rule,再确认具体规则是否位于 MATCH 前、策略组名称是否完全一致。若请求是 UDP 而所选节点不支持 UDP,官方文档说明可能继续向下匹配;这时应结合日志判断,而不是只看配置文本。

TUN 开启后断网,应该先改哪个字段?

先关闭 TUN 或恢复备份,不要同时修改 DNS、MTU、路由和规则。恢复网络后只测试 enable、auto-route、dns-mode、dns-hijack 或 strict-route 中的一个变化;Windows、Linux、macOS 和 Android 对 DNS 劫持的前提不同,需按当前系统核对官方字段说明。

相关阅读

参考资料

  1. Mihomo 官方文档:Route Rules
  2. Mihomo 官方文档:Rule-Providers
  3. Mihomo 官方文档:Proxy Groups
  4. Mihomo 官方文档:Proxy Providers
  5. Mihomo 官方文档:DNS Configuration
  6. Mihomo 官方文档:TUN