03 / OPERATIONS MANUAL

Mihomo内核运行、配置有效性检查与常见启动问题指南

用配置路径、进程和日志建立一条清楚的检查线索。先确认观察到的事实，再决定需要改动哪个环节。

OBSERVE BEFORE CHANGING

把问题放到
正确的运行阶段。

程序能执行、配置能加载、端口能监听、请求能完成，是四个不同结论。不要用一个状态替代全部验证。

Mihomo核心运行时应知道自己执行的文件版本、读取的配置以及使用的数据目录。初次部署可先阅读Windows与Linux安装方法，避免将服务目录与终端当前目录混淆。

配置编辑完成后，先在独立数据目录中用相应版本检查可信副本。错误可能来自路径、权限、YAML格式、版本不支持的内容或资源加载；不要一次改动所有字段。

# 以下均为示例路径，请替换为真实位置
mihomo -t -d /path/to/check-data -f /path/to/config.yaml

检查期间可能初始化目录或获取所需资源，并非对所有环境都完全只读。文件格式与错误输出的处理方法，见配置文件检查与错误定位。测试通过后，还要确认实际运行实例加载了同一份配置。

完整查询方法见进程状态、监听端口与运行日志。分享记录前删除凭据和个人网络信息，不强制结束尚未辨明的进程。

配置文件改了，运行中的核心一定会自动读取吗？

不一定。应按实际管理方式重新加载或重启，并从新的日志确认。文件被保存只代表磁盘内容改变。

服务显示active，为什么仍无法连接？

active反映服务状态，不能证明配置效果与远端可用性。继续核对监听和实际请求，别只看状态标签。

端口冲突时能否直接结束占用进程？

先查进程所属程序和启动方式。它可能由另一个客户端管理；确认影响范围后再作处理。

更换核心后出现问题，应该保留什么？

保留旧程序、配套配置、资源与启动参数，并按版本更新与回退流程恢复一套一致的状态。