先确认适用条件
适用于使用 systemd 管理代理进程的 Linux 主机,启动时出现 Start request repeated too quickly。示例假定系统级单元叫 mihomo.service;必须替换成实际名称,用户级服务需使用对应的 --user 管理路径。
先区分原因与影响范围
启动速率限制是连续失败后的保护,往往不是最初的错误。配置解析失败、路径或权限错误、端口冲突都可能先发生;reset-failed 会清除失败状态和启动限制计数,但不会修好配置,也不会自动启动服务。
按顺序检查,每次只改一项
- 确认主机、单元名称和服务影响范围,先阅读状态与已有日志,不连续执行 restart。示例的 status 在服务失败时返回非零属于状态信息,应连同文字保存,不能当作检查没运行。
- 在日志里向前查找首次失败附近的具体错误,并读取单元定义中的 ExecStart、User 和配置路径。日志或 unit 可能含内部信息,只在本机查看,分享前去掉订阅地址、密码与令牌。
- 根据首次错误修复最小问题,保留原配置备份;需要检查配置时用实际内核支持的配置校验入口。只改应用配置通常不需要 daemon-reload;若修改 systemd 单元文件,才由有权限的管理员重新加载单元定义。
- 在已获准的维护窗口,确认根因修正后,只对该单元执行 reset-failed,再 start。不要省略单元名清除所有服务状态,也不要把 StartLimit 关掉来掩盖循环失败。
- 重新读取状态和本次日志,观察是否再次快速退出;随后从实际使用端验证代理请求。若再次触发限制,停止重试并回到最新首次错误,不让自动重启持续消耗资源。
systemctl status mihomo.service --no-pager
systemctl cat mihomo.service
journalctl -u mihomo.service -n 100 --no-pagersudo systemctl reset-failed mihomo.service
sudo systemctl start mihomo.service怎样确认已经恢复
服务维持预期运行状态、日志没有重复的根因错误,实际客户端请求也成功且走到预期路径。仅看到 active、端口监听或 reset-failed 返回成功,不能代替业务验证。
未恢复时如何回退与求助
恢复刚修改的配置或单元文件;若恢复了单元文件,由管理员重新加载后按维护计划启动。保留旧配置仍可能带回原故障,应如实记录未恢复,提交首次错误及版本,不重复重启整台主机。