如何通过Docker Compose实现容器在系统重启或启动失败后自动重试重启

你之前对restart: always/restart: unless-stopped的认知存在两个关键偏差，刚好完全踩中你当前场景的问题：

• Docker的重启策略有明确的生效边界：只有当容器进程被成功拉起、后续因为任何原因退出时，策略才会触发重试。如果容器启动失败的原因是Docker引擎在准备运行环境阶段就报错（比如你配置里硬绑定的/dev/ttyACM0节点不存在、指定的卷路径不存在），这个阶段根本没有生成可追踪的容器进程，重启策略是完全不会触发重试的。
  系统刚开机时，Docker服务的启动时机早于udev对USB设备的枚举流程，第一次尝试拉起容器时，/dev/ttyACM0还没被系统创建，直接在环境准备阶段就被Docker引擎拒绝创建容器，自然不会有后续的持续重试动作。
• 就算重启策略正常触发，默认的重试节奏是指数退避的（从100ms、200ms、400ms逐步拉长，最长间隔到5分钟），很容易出现重试节奏和USB设备就绪的时间点错位，看起来就像容器卡住了没有尝试重启。

1. 调整Compose配置，绕过Docker引擎的硬路径校验 #

把原来通过devices块硬绑定的USB设备，改成通过卷挂载的方式接入容器，消除环境准备阶段的硬报错：
原配置片段：

devices:
  - /dev/ttyACM0

修改为：

volumes:
  # 保留原有已配置的卷规则，额外新增下面这行
  - /dev/ttyACM0:/dev/ttyACM0

这种挂载方式下，就算启动时/dev/ttyACM0节点还不存在，Docker也会正常把容器进程拉起来，不会在环境准备阶段直接报错。等后续udev创建好设备节点，容器里的deconz服务既能自动识别设备，重启策略也能正常触发重试逻辑。

2. 自定义重启重试节奏，消除指数退避的空窗 #

把原来简单配置的restart: "always"，替换为可自定义参数的重启策略，固定重试间隔，不限制重试次数，直到设备就绪、容器启动成功：
原配置片段：

restart: "always"

修改为：

restart_policy:
  condition: any # 不管什么原因导致容器退出都重试，和原always策略逻辑一致
  delay: 10s # 固定每10秒尝试一次，不会越等间隔越长
  max_attempts: 0 # 不设置重试次数上限，一直试到成功为止

你的配置里的compose版本为3.3，原生支持上述restart_policy参数，不需要额外升级。

3. 可选：从系统层面优化设备启动时序 #

如果希望减少开机后的等待时间，可以给Conbee II设备配置固定的udev符号链接，避免因为设备枚举顺序变化导致的路径不匹配问题：

• 通过lsusb查到Conbee II的Vendor ID和Product ID，在/etc/udev/rules.d/99-deconz.rules文件中写入规则，给设备生成固定路径：

  SUBSYSTEM=="tty", ATTRS{idVendor}=="1cf1", ATTRS{idProduct}=="0030", SYMLINK+="deconz", MODE="0666"
  

• 把Compose配置里所有引用/dev/ttyACM0的地方，替换为稳定的/dev/deconz路径，就不会出现USB设备已识别但节点路径不对的问题。

内容的提问来源于stack exchange，提问作者A.Dumas