先确认适用条件

适用于使用 systemd 管理代理进程的 Linux 主机,启动时出现 Start request repeated too quickly。示例假定系统级单元叫 mihomo.service;必须替换成实际名称,用户级服务需使用对应的 --user 管理路径。

先区分原因与影响范围

启动速率限制是连续失败后的保护,往往不是最初的错误。配置解析失败、路径或权限错误、端口冲突都可能先发生;reset-failed 会清除失败状态和启动限制计数,但不会修好配置,也不会自动启动服务。

按顺序检查,每次只改一项

  1. 确认主机、单元名称和服务影响范围,先阅读状态与已有日志,不连续执行 restart。示例的 status 在服务失败时返回非零属于状态信息,应连同文字保存,不能当作检查没运行。
  2. 在日志里向前查找首次失败附近的具体错误,并读取单元定义中的 ExecStart、User 和配置路径。日志或 unit 可能含内部信息,只在本机查看,分享前去掉订阅地址、密码与令牌。
  3. 根据首次错误修复最小问题,保留原配置备份;需要检查配置时用实际内核支持的配置校验入口。只改应用配置通常不需要 daemon-reload;若修改 systemd 单元文件,才由有权限的管理员重新加载单元定义。
  4. 在已获准的维护窗口,确认根因修正后,只对该单元执行 reset-failed,再 start。不要省略单元名清除所有服务状态,也不要把 StartLimit 关掉来掩盖循环失败。
  5. 重新读取状态和本次日志,观察是否再次快速退出;随后从实际使用端验证代理请求。若再次触发限制,停止重试并回到最新首次错误,不让自动重启持续消耗资源。
只读检查;系统级服务示例。读取系统日志可能需要管理员授权。
systemctl status mihomo.service --no-pager
systemctl cat mihomo.service
journalctl -u mihomo.service -n 100 --no-pager
以下会改变服务状态;仅在根因已修复、名称正确且获准维护时执行。
sudo systemctl reset-failed mihomo.service
sudo systemctl start mihomo.service

怎样确认已经恢复

服务维持预期运行状态、日志没有重复的根因错误,实际客户端请求也成功且走到预期路径。仅看到 active、端口监听或 reset-failed 返回成功,不能代替业务验证。

未恢复时如何回退与求助

恢复刚修改的配置或单元文件;若恢复了单元文件,由管理员重新加载后按维护计划启动。保留旧配置仍可能带回原故障,应如实记录未恢复,提交首次错误及版本,不重复重启整台主机。