always、on-failure、no、unless-stopped区别揭秘，你真的懂Docker Compose重启机制吗？

第一章：Docker Compose重启机制概述

Docker Compose 提供了一套灵活的容器生命周期管理机制，其中重启策略是确保服务高可用性的关键组成部分。通过在 docker-compose.yml 文件中配置 restart 字段，用户可以定义容器在退出或系统重启时的行为模式。

重启策略类型

Docker 支持多种重启策略，适用于不同的应用场景：

• no：默认策略，容器不会自动重启
• on-failure[:max-retries]：仅在容器以非零状态退出时重启，可指定最大重试次数
• always：无论退出状态如何，始终重启容器
• unless-stopped：始终重启，除非容器被手动停止

配置示例

以下是一个典型的 docker-compose.yml 片段，展示如何为 Web 服务设置重启策略：

version: '3.8'
services:
  web:
    image: nginx:latest
    restart: unless-stopped  # 容器随宿主机启动而自动恢复运行
    ports:
      - "80:80"
  db:
    image: postgres:13
    restart: on-failure:5    # 失败时最多尝试重启5次
    environment:
      POSTGRES_PASSWORD: example

该配置确保数据库服务在启动失败时进行有限重试，而 Web 服务则在宿主机重启后自动恢复，适合生产环境部署。

策略选择建议

使用场景	推荐策略	说明
开发调试	no	避免异常循环启动干扰调试
关键后台服务	always	保证服务持续可用
长期运行应用	unless-stopped	兼顾自动恢复与手动控制

第二章：always重启策略深度解析

2.1 always策略的定义与触发条件

always 策略是容器镜像拉取行为中的一种配置选项，指示容器运行时在启动前始终尝试从指定仓库拉取最新镜像。

触发机制

该策略在以下场景中被激活：

• 每次 Pod 被调度到节点上时
• 无论本地是否存在相同标签的镜像
• 即使镜像已缓存，仍会向镜像仓库发起校验请求

典型配置示例

apiVersion: v1
kind: Pod
metadata:
  name: example-pod
spec:
  containers:
    - name: app
      image: nginx:latest
      imagePullPolicy: Always

上述配置中，imagePullPolicy: Always 明确指定使用 always 策略。每次启动容器时，Kubelet 都会强制调用镜像服务接口，验证远程镜像摘要是否变更，确保部署一致性。

2.2 容器异常退出时的重启行为分析

在 Kubernetes 中，容器异常退出后的重启策略由 Pod 的 restartPolicy 字段控制。该策略直接影响应用的可用性与故障恢复机制。

支持的重启策略

• Always：无论容器如何退出，始终重启（默认策略）
• OnFailure：仅当容器以非零状态退出时重启
• Never：从不自动重启容器

典型配置示例

apiVersion: v1
kind: Pod
metadata:
  name: example-pod
spec:
  containers:
    - name: app-container
      image: nginx
  restartPolicy: OnFailure

上述配置中，restartPolicy: OnFailure 表示只有容器因错误退出时才会重启，适用于批处理任务。

重启行为与控制器关系

Deployment、Job 等控制器会结合 restartPolicy 实现更复杂的调度逻辑。例如，Job 控制器要求容器必须使用 Never 或 OnFailure 策略，以确保任务执行状态可追踪。

2.3 系统重启后容器的自动恢复实践

在生产环境中，系统意外重启可能导致关键服务中断。通过合理配置容器运行时的重启策略，可实现服务的自动恢复。

重启策略配置

Docker 支持多种重启策略，常用如下：

• no：不自动重启容器
• on-failure：失败时重启（可指定重试次数）
• always：无论状态如何，始终重启
• unless-stopped：始终重启，除非被手动停止

实践示例

docker run -d \
  --restart=unless-stopped \
  --name nginx-service \
  -p 80:80 \
  nginx:latest

上述命令中，--restart=unless-stopped 确保容器在系统重启后自动启动，适用于长期运行的服务。该策略结合 systemd 可实现完整的自愈能力，保障服务高可用性。

2.4 结合docker-compose.yml配置实例演示

在微服务部署中，docker-compose.yml 是定义多容器应用的标准化配置文件。以下是一个典型的服务编排示例：

version: '3.8'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html
    depends_on:
      - app
  app:
    build: ./app
    environment:
      - NODE_ENV=production

上述配置定义了两个服务：web 使用 Nginx 镜像并映射主机 80 端口，通过卷挂载静态内容；app 则基于本地目录构建镜像，并设置运行环境变量。

服务依赖与启动顺序

depends_on 确保 app 服务先于 web 启动，实现逻辑依赖控制。

配置结构解析

• version：指定 Compose 文件格式版本
• services：定义各个容器服务
• volumes：实现数据持久化与文件共享

2.5 always策略适用场景与风险提示

适用场景分析

always 策略常用于开发与测试环境，确保容器在任何情况下均被启动。典型应用场景包括日志采集器、监控代理等守护进程。

• 持续运行的服务型容器
• 调试用途的临时任务
• 必须保持在线的系统组件

潜在风险提示

该策略可能导致资源耗尽或无限重启循环。例如，当应用存在崩溃缺陷时，Docker 将不断尝试重启：

{
  "RestartPolicy": {
    "Name": "always",
    "MaximumRetryCount": 0
  }
}

上述配置中，MaximumRetryCount 不生效，容器将无限制重启，可能引发宿主机负载飙升。建议在生产环境中结合健康检查与on-failure策略使用，避免系统稳定性受损。

第三章：on-failure与no策略对比剖析

3.1 on-failure策略的工作机制与退出码关联

on-failure 策略是容器编排系统中常见的重启策略之一，主要用于控制任务在非正常退出时的行为。该策略不仅判断容器是否退出，更关键的是依赖进程的退出码（exit code）来决定是否触发重启。

退出码的语义解析

操作系统中，进程退出码为0表示成功，非0值代表不同类型的错误。容器遵循此规范，例如：

• 0：任务成功完成，不触发重启；
• 1-127：常见错误，如应用崩溃、配置错误；
• 128+：信号终止，如 SIGKILL 对应 137。

策略触发条件

当容器以非0退出码终止时，on-failure 策略将评估是否重启。部分系统支持设置最大重试次数：

restart: on-failure
restart-retry-count: 3

上述配置表示仅在失败时重启，最多尝试3次。该机制避免了无限循环重启，同时保障了短暂故障的自愈能力。

3.2 no策略的完全禁用重启行为解析

在容器编排系统中，`no` 策略表示当容器终止时，不进行任何自动重启操作。该策略适用于一次性任务或调试场景，确保容器按预期执行后即结束生命周期。

策略配置示例

restart: no

上述配置明确禁止容器在退出后被守护进程重启，无论退出状态码为何值。

行为特征分析

• 容器正常退出（exit 0）后，不会重新启动；
• 容器异常崩溃（非0退出码）同样不会触发重启；
• 适用于需要精确控制执行次数的任务，如数据迁移脚本。

该策略简化了运行逻辑，避免了无限循环重启带来的资源浪费，是实现“执行即终止”模型的核心配置之一。

3.3 on-failure与no在故障排查中的应用差异

在系统服务管理中，`on-failure` 与 `no` 是 systemd 重启策略的关键选项，其行为差异直接影响故障恢复机制。

策略行为对比

• no：服务异常退出后不重启，适用于一次性任务或需人工介入的场景；
• on-failure：仅当服务非正常退出（如崩溃、超时）时触发重启，适合高可用守护进程。

配置示例与分析

[Service]
Restart=no
ExecStart=/usr/bin/my-service

该配置下，无论何种错误，服务终止后不会自动拉起，便于收集崩溃现场日志。

[Service]
Restart=on-failure
RestartSec=5s
ExecStart=/usr/bin/my-service

当服务非零退出时，systemd 将在5秒后尝试重启，有效应对临时性故障，避免雪崩效应。

应用场景选择

场景	推荐策略	原因
调试阶段	no	防止频繁重启掩盖问题根源
生产环境守护进程	on-failure	实现自动恢复，提升可用性

第四章：unless-stopped策略工作机制揭秘

4.1 unless-stopped策略的核心逻辑解读

unless-stopped 是 Docker 容器重启策略中的关键机制，确保容器在宿主机重启或守护进程恢复后自动启动，除非被手动停止。

策略触发条件

• 宿主机系统重启后容器自动恢复运行
• Docker 守护进程重启时容器重新启动
• 仅当容器被 docker stop 显式停止时，才不再自动重启

配置示例与分析

{
  "RestartPolicy": {
    "Name": "unless-stopped"
  }
}

该配置表示：只要容器不是被用户主动停止，Docker 就会在满足重启条件时拉起容器。相比 always 策略，unless-stopped 更适用于生产环境，避免了手动停止调试后的意外重启。

策略对比表

策略	自动重启	手动停止后是否重启
no	否	否
always	是	是
unless-stopped	是	否

4.2 手动停止状态如何影响自动重启判断

当系统服务被手动停止时，其状态标记将区别于异常崩溃，直接影响自动重启机制的触发逻辑。

状态标识的作用

系统通常通过状态码区分手动停止与意外退出。若进程退出码为 `SIGTERM`（如用户执行 `systemctl stop`），则标记为“手动终止”，调度器将暂停自动重启流程。

systemctl stop myservice.service
# 服务状态变为 inactive (dead)，且 ActiveState=inactive, SubState=exited

该操作会设置内部标志位，防止重启控制器在下一个周期重新拉起服务。

重启策略配置示例

以下 systemd 配置展示了如何结合策略避免手动停止后的自启：

[Service]
ExecStart=/usr/bin/myserver
Restart=on-failure
RestartSec=5s
KillSignal=SIGTERM

其中 `Restart=on-failure` 表示仅在非正常退出时重启，排除了手动终止场景。

• 手动停止：设置终止标志，抑制自动重启
• 崩溃退出：无终止标志，触发重启逻辑
• 策略隔离：通过退出码和状态机实现行为区分

4.3 与其他策略在持久化服务中的对比实验

在评估持久化策略时，我们对比了RDB、AOF及混合持久化模式在Redis中的表现。

性能与数据安全权衡

• RDB基于快照，恢复速度快，但可能丢失最近写操作；
• AOF记录每条写命令，数据安全性高，但日志体积大，恢复慢；
• 混合模式结合两者优势，重启时优先使用RDB加载，再用AOF重放增量。

配置示例

# 启用混合持久化
aof-use-rdb-preamble yes
save 300 100
appendonly yes

该配置表示：每5分钟有100次修改则触发RDB快照，同时开启AOF，且使用RDB作为AOF重写的基础，显著提升重启加载效率。

性能对比

策略	写吞吐	恢复时间	数据丢失风险
RDB	高	低	高
AOF	中	高	低
混合	高	中	低

4.4 生产环境中unless-stopped的最佳实践建议

在生产环境中使用 Docker 的 `--restart=unless-stopped` 策略时，需结合服务特性与运维规范进行精细化配置。

合理选择重启策略场景

该策略适用于长期运行的服务（如 Web 服务器、数据库），避免容器因人为停止而自动重启。对于调试或临时任务，应使用 `no` 或 `on-failure`。

配合健康检查机制

确保容器应用具备自愈能力，通过健康检查判断服务状态：

docker run -d \
  --restart=unless-stopped \
  --health-cmd="curl -f http://localhost:80 || exit 1" \
  --health-interval=30s \
  my-web-app

上述命令每 30 秒检测一次服务可用性，防止容器运行但应用卡死的情况被忽略。

关键服务部署建议

• 始终结合日志收集系统（如 ELK）监控容器退出原因
• 定期测试故障恢复流程，验证重启行为是否符合预期
• 避免在有状态服务中盲目启用，需确保数据持久化配置正确

第五章：四大重启策略选型指南与总结

适用场景对比分析

在微服务架构中，选择合适的重启策略需结合系统特性。以下是四种常见策略的适用场景：

• 立即重启（Immediate Restart）：适用于短暂瞬态故障，如网络抖动导致的服务中断。
• 延迟重启（Delayed Restart）：适合处理资源竞争或依赖服务短暂不可用的情况。
• 指数退避重启（Exponential Backoff）：应对持续性故障，避免雪崩效应。
• 条件重启（Conditional Restart）：仅在满足健康检查或外部信号时触发，适用于高可用集群。

性能与稳定性权衡

策略	恢复速度	资源消耗	适用频率
立即重启	高	高	低频故障
指数退避	中	低	高频故障

实战代码示例

以下是一个基于 Go 的指数退避重启实现片段：

func exponentialBackoff(maxRetries int) {
    for i := 0; i < maxRetries; i++ {
        if err := callService(); err == nil {
            log.Println("服务调用成功")
            return
        }
        backoff := time.Second << uint(i) // 2^i 秒
        time.Sleep(backoff)
    }
    log.Fatal("重试次数耗尽")
}

生产环境配置建议

在 Kubernetes 中，可通过 Pod 的 restartPolicy 字段控制行为，配合 livenessProbe 实现条件重启。例如，当数据库连接池耗尽时，延迟重启可避免密集重连压垮数据库。某电商系统在大促期间采用指数退避策略，将服务恢复成功率提升至 98.7%。