Mihomo 更新 常见问题与排查 202609：安装、配置与迁移指南

Mihomo 更新并不只是替换程序文件，还涉及安装包架构、配置兼容、端口占用、系统代理和规则资源。按照“先备份、再校验、后替换、逐项验证”的顺序操作，可以更快定位安装、首次运行和迁移过程中出现的问题。

更新前先锁定安装包、架构与配置位置

截至2026年09月，更新前应先在旧客户端中记录内核路径、配置文件位置、运行模式、监听端口与系统代理状态，并备份 YAML、规则文件及证书等自行维护的数据。进入 /client 后按设备和硬件架构选择安装包；站内明确列出的 Windows 桌面端适用于 Windows 10/11 64 位系统，其他平台则应先到 /compatibility 核对运行环境。关闭正在运行的 Mihomo 后再替换程序，避免文件被占用。不要直接覆盖整个配置目录，也不要从不明镜像获取文件。若下载页提供校验值或签名，应在安装前核验；未提供时至少确认文件名、平台、架构和来源页面一致。

首次配置先做语法测试，不要立即导入复杂规则

首次启动建议先用最小配置验证内核，再导入订阅和复杂规则。可在自有配置中显式设置 `mixed-port: 7890`，并将控制接口限定为 `external-controller: 127.0.0.1:9090`；这些端口是配置示例，如已被其他程序占用，应改用空闲端口，不要将控制接口直接暴露到公网。启动前可执行 `mihomo -t -f /path/to/config.yaml`，Windows 可使用 `mihomo.exe -t -f .\config.yaml` 检查配置。若提示解析失败，重点核对 YAML 缩进是否使用空格、冒号后是否留有空格、引号是否成对，以及同级字段是否保持一致缩进。

场景排查：更新成功但浏览器突然无法联网

真实场景一是更新后界面显示内核已运行，但浏览器全部打不开。先不要反复重装，应依次确认新配置中的 `mixed-port` 是否仍与系统代理端口一致，再检查旧进程是否占用端口。Windows 可执行 `netstat -ano | findstr :7890` 查看 7890 端口对应的进程编号；若存在两个相关进程，应退出旧客户端后重新启动。随后临时关闭系统代理进行对照测试：直连正常通常说明代理端口、规则或节点配置有误；直连同样失败则应继续检查本机网络。若日志出现 DNS 超时，可先确认 DNS 配置中的服务器地址可达，并排除防火墙拦截，而不是直接删除全部配置。

场景排查：跨设备迁移后规则存在却没有命中

真实场景二是把旧设备配置复制到新设备后，Mihomo 可以启动，但规则集加载失败或流量始终落入兜底规则。常见原因是配置引用了旧设备的绝对路径，或规则提供器缓存没有随配置迁移。应检查 `rule-providers`、证书和外部资源所使用的路径，将不存在的目录改为新设备可访问的位置，并确认当前账户具备读写权限。若控制面板连接失败，还要核对 `external-controller` 的地址、端口及 `secret` 是否与客户端填写内容一致。迁移时建议只复制确认需要的 YAML 与规则数据，程序文件则从 /client 按新设备平台和架构重新下载，避免把不兼容的可执行文件一起带入。

用日志分层定位，并为更新保留可回退副本

排查应按“程序能否启动、配置能否解析、端口能否监听、规则是否命中、目标是否可达”的顺序进行。需要更多细节时，可暂时把配置中的 `log-level` 调整为 `debug`，复现一次问题后保存关键时间段日志，再恢复原级别，避免长期产生大量记录。分享日志前应删除节点地址、认证信息、订阅链接、控制密钥和本地路径等敏感内容。每次更新都建议保留上一份可用程序与配置快照；若当前稳定版启动异常，可先恢复旧副本验证是否由新程序、配置变更或运行环境引起。回退只是定位手段，确认原因后仍应从正规下载渠道获取最新版并重新验证。

常见问题

已经替换最新版文件，为什么客户端仍显示旧内核信息？

客户端界面与 Mihomo 内核可能分别更新。先彻底退出旧进程，再确认客户端实际调用的内核路径是否指向新文件；如果机器上存在多个同名程序，应检查启动参数和工作目录。重新启动后再查看日志中的启动信息，不要只依据下载文件夹里的文件判断是否更新成功。

配置测试已经通过，为何开启系统代理后仍然没有流量？

语法通过只表示 YAML 可以解析，不代表系统代理、监听端口和规则一定正确。应核对系统代理填写的地址与 `mixed-port` 是否一致，确认端口处于监听状态，并从日志查看请求是否进入 Mihomo、命中了哪条规则。如果日志中完全没有浏览器请求，问题通常在系统代理设置、应用自身代理或端口映射环节。

能否把旧电脑的整个 Mihomo 目录直接复制到新设备？

不建议整体复制。不同系统和硬件架构需要匹配的程序文件，绝对路径、权限、证书位置及规则缓存也可能失效。更稳妥的方式是从 /client 下载适配新设备的安装包，再迁移经过检查的 YAML 和自定义规则，并逐项修正路径、端口及控制接口设置。

总结

准备安装或更新 Mihomo？请前往 /client 按设备与架构选择官方渠道安装包；更新前可在 /compatibility 核对兼容环境，并通过 /highlights 了解核心功能、规则分流与配置方向。

相关阅读：Mihomo 更新 常见问题与排查 202609，Mihomo 更新 常见问题与排查 202609使用技巧，Mihomo 202639 周效率实践清单：安装、配置、更新与迁移指南