适用范围与准备

适用于通过面板调整 Mihomo 运行参数后当时生效,但重新加载配置或重启内核又恢复旧值。先保存当前配置文件、客户端配置项及变更记录;不要对共享代理实例直接试改端口或关闭全部连接。

先区分原因

官方API把读取运行配置、局部更新、重新加载和重启分成不同操作。面板中的一次修改不应自动被理解为已经写入你维护的文件;GUI还可能从订阅和覆写生成最终配置。需要同时看保存来源与当前运行值。

按顺序操作

  1. 选一个无须中断业务的已有差异,例如日志级别,记录文件值和面板显示值。先确认自己连接的是同一个内核实例及控制地址,避免把另一端口的面板当作当前服务。
  2. 利用面板或受控的GET /configs读取运行配置。不要把API secret发给他人;没有权限时先修正正常的访问授权,不清空secret、不把控制接口开放到公网。
  3. 核对刚才的操作属于局部更新还是加载某个文件。API中PATCH /configs与PUT /configs承担不同用途,POST /restart又是重启;菜单叫“保存”不代表它一定修改了原订阅。
  4. 找到客户端真正持久化的入口:手写文件、覆写、配置合并或GUI选项。把需要保留的值写到该入口,避免只编辑启动时会被重新生成的临时文件;同时保留可用旧版本。
  5. 在允许短暂影响连接的时间窗口,按客户端官方入口重载一次,再读运行值并建立新的只读请求。不强制重载未知路径;如果API拒绝工作目录外的配置,核对SAFE_PATHS规则,不能扩大成任意目录。
动作本轮如何判断
GET /configs读取运行状态,不能据此推断磁盘已保存
PATCH /configs局部更新后还需确认持久化来源
PUT /configs / 重启重新核对配置来源及运行值,不能只看HTTP成功

怎样确认有效

目标是“重载前后运行值符合预期,持久化来源也一致”,并且新请求按预期处理。HTTP 204或面板提示成功不能代替这两项检查;已有长连接的行为也不一定能反映新配置。

无效时恢复与下一步

如重载失败,恢复之前可用的配置来源并重新加载,保留失败日志。不要用删除全部缓存来掩盖来源错误。本篇依据控制API说明整理,没有调用真实实例的更新、重载或重启接口。