高墙之外❤️返回首页

Mihomo DNS 配置教程:先跑通 1053,再设置 Fake-IP 与分流

更新于 2026-11-15 · passwall.buzz

简答:改了 Mihomo DNS 却没有效果,最常见原因不是解析器地址写错,而是配置未加载,或系统请求根本没有进入 Mihomo 的监听端口。先复制最小配置并用 1053 端口验证,再按 Fake-IP、nameserver-policy、TUN 和 dns-hijack 的顺序逐项增加;Windows、macOS、Android 和 OpenWrt 的接管方式并不相同。

定义:Mihomo DNS 配置,是通过 dns 节点设置内置 DNS 服务的监听地址、解析器、Fake-IP 或 redir-host 模式,以及按域名分流的解析策略。

先做最小配置:确认请求真的进入 Mihomo

本站是独立的第三方使用指南站,不是 Mihomo 项目的官方站点。配置前先分清两个问题:DNS 服务是否启动,以及系统或应用的请求是否被送到这个 DNS 服务。下面的模板只保留基础字段,监听地址使用本机 127.0.0.1:1053;1053 不是系统默认 DNS 端口,系统不会因为你写了这行就自动使用它。

dns:
  enable: true
  listen: 127.0.0.1:1053
  ipv6: false
  enhanced-mode: redir-host
  default-nameserver:
    - 223.5.5.5
  nameserver:
    - https://doh.pub/dns-query
    - https://dns.alidns.com/dns-query
  proxy-server-nameserver:
    - https://doh.pub/dns-query

字段结构、enhanced-mode、fake-ip-filter-mode 和各类 nameserver 的职责,可对照Mihomo DNS configuration。上面的公共 DNS 地址是真实示例,不是占位符:可以保留,也可以替换成所在网络能够访问的 DNS;如果替换为域名形式,仍要保留可用的 default-nameserver 来解析这些 DNS 服务器域名。

  • 必须保留:enable: true、listen、至少一项 nameserver。
  • 可以替换:default-nameserver、nameserver、proxy-server-nameserver 中的地址。
  • 先不要加入:fallback、nameserver-policy、direct-nameserver、Fake-IP 过滤和 TUN 参数。
  • 重要限制:订阅客户端可能通过 Merge、Script 或覆写重新生成运行配置,修改的 YAML 不一定就是最终加载的配置。

保存后重新载入配置,先检查客户端日志中是否有 YAML 缩进错误、未知字段或端口绑定失败。若日志没有报错但仍无效果,下一步不是继续增加 DNS 字段,而是检查请求有没有进入 127.0.0.1:1053。

现象判断先做什么
日志提示端口无法监听1053 被占用,或客户端权限不足换一个未占用的本机端口,并同步修改测试命令
本地端口有响应,但系统网页仍走原 DNSDNS 服务启动了,但系统请求未转发到 1053使用 TUN 的 dns-mode/dns-hijack,或将监听改为实际接管链路使用的端口
配置改完完全没有变化当前运行配置来自订阅、Merge 或 Script查看客户端最终运行配置和启动日志

四段增量配置:每次只增加一个变量

不要一开始把 DNS、Fake-IP、分流和 TUN 全部打开。下面按四段增加,每段完成后都先验证;出现问题时,删除最后一段即可回滚。

  1. 第 1 段:只跑通 redir-host。使用上一节的最小配置,在本机对 1053 发起查询。命令返回记录,说明内置 DNS 至少能响应;这还不能证明系统所有应用都经过 Mihomo。
  2. 第 2 段:加入 Fake-IP。将 enhanced-mode: redir-host 改为 enhanced-mode: fake-ip,并加入过滤:
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter-mode: blacklist
  fake-ip-filter:
    - '*.lan'
    - '*.local'

官方 DNS 文档列出 blacklist、whitelist 和 rule 等模式。Fake-IP 返回 198.18.0.0/16 范围内的地址可能是正常现象,不应单凭这个地址判断解析失败。若 NAS、打印机、局域网域名或某个应用异常,先改回 redir-host,再逐条增加过滤。

  1. 第 3 段:加入域名策略。只有确认基础解析正常后,才增加 nameserver-policy:
  nameserver-policy:
    '+.lan': 192.168.1.1
    '+.local': 192.168.1.1

192.168.1.1 是局域网 DNS 示例,必须替换成当前网络中确实可访问的地址;不知道局域网 DNS 时,删除这两条策略比照抄更安全。nameserver-policy 优先于普通 nameserver 和 fallback 查询,具体解析路径可参考Mihomo DNS resolve process。

  1. 第 4 段:最后才接入 TUN。需要接管没有使用系统代理的应用时,再考虑 TUN。本文示例使用官方文档列出的 mixed 协议栈:
tun:
  enable: true
  stack: mixed
  auto-route: true
  dns-mode: hijack
  dns-hijack:
    - any:53
  strict-route: false
  # auto-redirect: true  # 仅 Linux 适用,Windows、macOS、Android 删除

auto-redirect 仅适用于 Linux,并且需要配合 auto-route;不要把它复制到 Windows、macOS 或 Android。官方 TUN 文档还说明,dns-mode: hijack 在 Windows 需要 strict-route,在 Linux 需要 auto-redirect 才能覆盖相应的 DNS 接管场景。Windows 如果出现局域网共享、打印机、虚拟机或其他虚拟网卡异常,先把 strict-route 保持为 false 做对照测试,再决定是否开启。字段行为应以Mihomo TUN configuration和当前内核版本为准。

我的场景先开哪些字段暂时可删哪些字段
只想确认 DNS 模块是否能工作enable、listen、nameserverFake-IP、TUN、fallback、policy
需要看见真实解析地址enhanced-mode: redir-hostFake-IP 过滤
希望 TUN 接管普通应用 DNSauto-route、dns-mode: hijack、dns-hijackLinux 以外的 auto-redirect
局域网域名、NAS 或打印机异常先回退 redir-host,再配置局域网 policy全部 Fake-IP 过滤和 strict-route

按平台落地:1053、系统 DNS 与 DNS 劫持不是一回事

不同平台的核心差异,是系统请求到达 Mihomo 的方式不同。Mihomo 官方说明,macOS 和 Windows 无法自动劫持发往局域网的 DNS 请求;Android 开启系统“私人 DNS”时,也不能自动劫持这类请求。相关限制可查看Mihomo TUN configuration中的 dns-hijack、dns-mode 说明。

平台入口与权限验证重点
Windows客户端的 TUN、服务模式或网络扩展设置;通常需要管理员权限。系统 DNS 设置可在“设置—网络和 Internet—Wi-Fi 或以太网—硬件属性—DNS 服务器分配”中查看,具体名称以当前 Windows 版本为准。1053 只接受显式测试;要接管系统请求,应检查 TUN、dns-mode 和 strict-route。局域网或虚拟机异常时先关闭 strict-route。
macOS客户端的 TUN 或网络扩展权限;系统 DNS 可在“系统设置—网络—当前网络—详细信息—DNS”中查看,菜单名称可能随版本变化。不要把 127.0.0.1:1053 直接当作系统 DNS 地址填写;macOS 对发往局域网的 DNS 请求不能自动劫持。
Android客户端申请 VPN 权限;系统设置中进入“网络和 Internet”或“连接”,找到“私人 DNS”,测试时设为“关闭”。入口名称随厂商界面变化。关闭私人 DNS 后重新连接,再看客户端 DNS 日志;否则系统 DoT 请求可能绕过 Mihomo。
OpenWrt在所用图形插件的 DNS、透明代理或 TUN 页面查找配置入口,菜单名称需以当前插件为准;找不到时使用配置编辑器直接修改运行配置。先确认 dnsmasq 或其他本地 DNS 是否占用 53 端口。Mihomo 继续监听 1053 时,需要由 TUN、透明代理或本地 DNS 转发把请求送入 1053,不能只填写 DNS 段。

OpenWrt 上如果 53 端口已被 dnsmasq 使用,不要直接让多个服务抢占同一端口。更稳妥的路径是保留现有本地 DNS 服务,再确认它是否能把上游请求转给 Mihomo;如果当前插件支持 TUN 的 DNS 劫持,则按插件说明启用,并检查防火墙和路由规则。具体插件入口未统一,无法核实的菜单名称应以当前版本为准。

命令行验证:看哪一行代表成功或旁路

验证顺序是:先测 Mihomo 本地监听,再测系统默认 DNS,最后看日志或抓包。不要把一次在线 DNS 检测当成所有应用都没有旁路的证明。

Windows PowerShell

Resolve-DnsName -Name example.com -Server 127.0.0.1 -Type A -DnsOnly
Resolve-DnsName -Name example.com -Server 127.0.0.1 -Type AAAA -DnsOnly

Resolve-DnsName 的参数列表包含 -Server,但没有自定义 DNS 端口参数,因此上面的命令只适用于监听在默认 DNS 端口的服务,不能直接测 1053。Microsoft 文档列出了该命令的参数和 -DnsOnly 行为,见Microsoft Resolve-DnsName。

测试 1053 时使用 Windows 自带的 nslookup 交互模式:

nslookup
set port=1053
server 127.0.0.1
example.com
exit

预期至少能看到服务器被切换到 127.0.0.1、端口为 1053,并返回 Name 与 Address 等记录。如果提示超时或服务器无响应,先检查 Mihomo 是否运行、监听地址是否写错,以及本机防火墙是否拦截。Microsoft 的nslookup 命令说明明确列出 set port 用于修改 DNS 服务器端口。

macOS、Linux 与 OpenWrt

dig @127.0.0.1 -p 1053 example.com A
dig @127.0.0.1 -p 1053 example.com AAAA

看到 status: NOERROR 且回答区有记录,表示本地监听器返回了结果;看到 connection refused,优先检查服务是否启动或端口是否正确;超时则检查监听地址、防火墙和 TUN 路由。OpenWrt 某些精简系统未安装 dig,可以改用插件自带的 DNS 测试功能或安装对应诊断工具,具体命令需以系统软件包为准。

抓包确认是否旁路

在实际使用的物理网卡、TUN 接口或本机回环接口上抓包,并在 Wireshark 显示过滤器中输入 dns 或 dns.qry.name。这些过滤器字段可参考Wireshark Display Filters。如果应用命中了 hosts、缓存或自身的加密 DNS,可能没有新的普通 DNS 数据包;因此应同时对照客户端日志、系统设置和抓包结果。

检查结果说明下一步
1053 查询成功,系统网页正常内置 DNS 与当前接管路径暂时可用再逐项加入 Fake-IP、policy 或 TUN
1053 查询成功,系统网页仍走其他 DNSDNS 模块正常,但请求未被接管检查 TUN、dns-mode、dns-hijack、私人 DNS 或本地 DNS 转发
1053 查询失败监听器、配置加载或端口存在问题查看日志、恢复最小模板并重新载入
Fake-IP 返回 198.18.0.0/16可能是预期的虚拟地址结合过滤规则、日志和实际连接判断,不要只看地址范围

配置改了不生效:按这个顺序回滚

  1. 确认最终配置:查看客户端运行配置,而不是只看编辑器中的原始 YAML。订阅更新、Merge 和 Script 都可能覆盖 DNS 节点。
  2. 恢复最小模板:暂时删除 fallback、nameserver-policy、Fake-IP 过滤和 TUN,只保留 enable、listen、nameserver。
  3. 显式测试 1053:Windows 使用 nslookup 的 set port=1053,macOS、Linux 或 OpenWrt 使用 dig -p 1053。
  4. 确认系统接管:检查 TUN 是否有权限、路由是否生效、Android 私人 DNS 是否关闭,以及 Windows 是否被其他 VPN 或虚拟网卡接管。
  5. 逐项恢复:先恢复 Fake-IP,再恢复 policy,最后恢复 TUN;每次只改一个变量,并记录哪一项改变后出现异常。

如果节点域名可以解析但节点仍然连接失败,DNS 只完成了“把域名转换为地址”这一环,仍需检查节点端口、协议、TLS、出站路径和客户端日志。需要继续排查 TUN 权限、路由或虚拟网卡时,可阅读站内的Mihomo TUN 模式连接不上怎么办?先恢复网络再定位 DNS 与权限。

常见问题

Mihomo 的 DNS 配置应该写在哪个文件?

应写入当前客户端实际加载的主配置、Merge 或覆写区域,而不是随意新建一个未被引用的 YAML。修改后要重新载入,并查看最终运行配置或启动日志;订阅更新可能覆盖手动修改。

为什么配置了 127.0.0.1:1053,系统 DNS 仍然没有变化?

1053 只是 Mihomo 的监听端口,系统不会自动把 DNS 请求发送到这个端口。需要通过 TUN 的 dns-mode、dns-hijack、透明代理或本地 DNS 转发接管请求;不同平台的权限和限制也不同。

Windows 怎么测试 Mihomo 的 1053 端口?

Resolve-DnsName 没有自定义端口参数,不能直接测 1053。打开 PowerShell 或命令提示符运行 nslookup,然后输入 set port=1053、server 127.0.0.1、example.com;返回服务器地址和解析记录,才说明该端口有响应。

Fake-IP 和 redir-host 应该怎么选?

排查初期建议先使用 redir-host,返回结果更容易理解;确认基础 DNS 和 TUN 正常后,再根据应用兼容性切换到 Fake-IP。NAS、打印机、局域网域名或个别应用异常时,先回退 redir-host,再增加过滤。

Android 为什么要把私人 DNS 设为关闭?

Mihomo 官方 TUN 文档说明,Android 开启私人 DNS 时,相关 DNS 请求不能被自动劫持。测试 DNS 接管时先关闭私人 DNS,重新连接客户端并查看日志;测试结束后是否恢复,取决于你的网络需求。

nameserver-policy 里的 192.168.1.1 必须保留吗?

不必须。它只是局域网 DNS 的示例地址,只有当该地址确实存在且可访问时才应保留;不知道当前网络的局域网 DNS 时,先删除策略,避免把局域网域名发送到不可达服务器。

看到 198.18.0.0/16 是不是 DNS 出错?

不一定。Fake-IP 模式可能使用该范围返回虚拟地址,这是预期现象。应结合 enhanced-mode、fake-ip-filter、客户端日志和实际连接结果判断,不能只凭一次 A 记录结果下结论。

相关阅读

参考资料

  1. Mihomo DNS configuration
  2. Mihomo DNS resolve process
  3. Mihomo TUN configuration
  4. Microsoft nslookup command
  5. Microsoft Resolve-DnsName
  6. Troubleshoot DNS Client Name Resolution Issues - Windows Client
  7. Wireshark Display Filters(wireshark.org)
  8. Mihomo TUN 模式连接不上怎么办?先恢复网络再定位 DNS 与权限