Docker容器设置restart: unless-stopped后，为何手动停止后仍会自动重启？

Question

在Docker容器中设置`restart: unless-stopped`后，为何手动停止容器后它似乎仍会自动重启？这是许多用户常见的困惑。实际上，`restart: unless-stopped`策略意味着：只要没有明确使用`docker stop`或`docker kill`命令停止容器，Docker守护进程会在检测到容器异常退出时自动重启它。 问题的核心在于：如果在停止容器时未正确使用`docker stop`或`docker kill`，而是通过系统重启、Docker服务重启或其他间接方式终止容器，Docker会认为这不是“手动停止”，从而根据`unless-stopped`策略重新启动容器。此外，某些管理工具或脚本可能以非标准方式终止容器，也会触发这一行为。 解决方法：确保通过`docker stop `显式停止容器，避免间接终止手段。同时，检查是否有自动化工具或系统策略干扰容器状态。这有助于准确控制容器生命周期，避免不必要的重启。

Answer 1

1. 初步理解：Docker 容器的重启策略

Docker 提供了多种容器重启策略，其中 `restart: unless-stopped` 是一种常见的选择。它表示容器在任何非手动停止的情况下都会被自动重启。例如，当系统崩溃或 Docker 服务重启时，容器会根据此策略重新启动。

然而，许多用户发现，即使他们“手动”停止了容器，容器仍然会自动重启。这引发了困惑：为什么 `docker stop` 或其他方式停止容器后，容器似乎没有真正停止？

为了更深入地理解这一现象，我们需要从以下几个方面进行分析：

• 重启策略的工作原理
• 不同停止方式对容器状态的影响
• 可能的干扰因素及其解决方法

2. 深入分析：问题的核心原因

`restart: unless-stopped` 的核心机制在于区分“手动停止”和“异常退出”。Docker 守护进程通过信号和事件监听来判断容器是否被正常停止。只有当容器明确收到 `SIGTERM` 或 `SIGKILL` 信号（由 `docker stop` 或 `docker kill` 触发）时，才会被视为“手动停止”，并停止自动重启。

然而，在以下情况下，Docker 可能会错误地认为容器是非正常退出：

1. 系统重启： 当操作系统重启时，所有运行中的容器会被强制终止，而这种终止并不被视为“手动停止”。
2. Docker 服务重启： 类似于系统重启，Docker 服务的重启也会导致容器被强制终止。
3. 间接终止手段： 如果使用了第三方工具或脚本以非标准方式终止容器（例如直接杀死容器的 PID），Docker 无法正确识别为“手动停止”。

这些情况都会触发 `unless-stopped` 策略，导致容器重新启动。

3. 解决方案与最佳实践

为了避免不必要的容器重启，可以采取以下措施：

解决方案	描述
显式停止容器	始终使用 `docker stop ` 命令显式停止容器，确保容器接收到正确的停止信号。
检查自动化工具	确认是否有第三方工具或脚本以非标准方式终止容器，并调整其行为。
管理 Docker 服务	在计划性维护（如系统或 Docker 服务重启）前，先显式停止需要保持关闭状态的容器。

此外，可以通过以下代码示例验证容器的停止行为：

# 启动一个带有 restart: unless-stopped 策略的容器
docker run -d --name test_container --restart unless-stopped nginx

# 显式停止容器
docker stop test_container

# 检查容器状态
docker ps -a
    

4. 流程图：容器停止与重启的逻辑

以下是容器停止与重启的逻辑流程图，帮助理解不同停止方式对容器状态的影响：

graph TD;
            A[容器运行中] --> B{是否手动停止？};
            B --是--> C[容器停止];
            B --否--> D{是否异常退出？};
            D --是--> E[容器重启];
            D --否--> F[保持停止状态];

通过上述流程图可以看出，只有明确的“手动停止”才能避免容器根据 `unless-stopped` 策略重新启动。