异常教程

docker 重启（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代 DevOps 和云原生开发中，Docker 已成为容器化部署的核心工具。无论是开发环境的快速迭代，还是生产环境的高可用保障，docker 重启都是开发者和运维人员必须掌握的关键技能。容器的意外停止或需要更新配置时，如何高效、安全地重启服务，直接影响系统的稳定性和用户体验。本文将从基础概念到实战案例，系统讲解 Docker 容器的重启机制，帮助读者构建可靠的应用服务。

一、Docker 容器的基础状态与重启逻辑

1.1 容器的生命周期与状态

Docker 容器的状态包括 运行（running）、暂停（paused）、退出（exited） 等。容器的生命周期由其内部主进程（PID 1）的状态决定：

  • 运行态：主进程正常执行，容器持续工作。
  • 退出态：主进程结束，容器停止，但文件系统和日志仍保留。
  • 暂停态：容器被临时冻结，但资源未完全释放。

比喻：可以想象容器像一台电脑，运行态是开机状态，退出态是关机，而暂停态则是“休眠”模式。

1.2 重启的必要性

在以下场景中需要主动触发重启：

  1. 故障恢复：容器因代码错误、内存泄漏等异常退出。
  2. 配置更新：修改镜像或启动参数后需重新加载。
  3. 版本升级：部署新代码时替换旧容器。

二、手动触发容器重启的命令与操作

2.1 基础命令 docker restart

最直接的重启方式是使用 docker restart 命令：

docker restart <容器名或ID>

例如，重启名为 my-web-app 的容器：

docker restart my-web-app

注意事项：

  • 此命令会强制停止正在运行的容器（类似 kill -SIGTERM），等待 10 秒后未响应则强制终止。
  • 若容器已处于退出态，docker restart 会直接将其重新启动。

2.2 强制重启与优雅关闭

若需立即终止容器并重启，可添加 -t 参数指定超时时间：

docker restart -t 3 <容器名>  # 等待3秒后强制终止

对比：
| 命令类型 | 信号 | 适用场景 |
|----------------|----------------|------------------------|
| 默认 docker restart | SIGTERM → SIGKILL | 大多数场景的平衡选择 |
| 强制终止 | SIGKILL | 容器无响应时使用 |

三、Docker 容器的自动重启策略详解

3.1 重启策略的核心作用

Docker 提供了 no、on-failure、always、unless-stopped 四种重启策略，可定义容器退出后的自动恢复行为。

3.1.1 策略详解

策略名称行为说明
no容器退出后永不自动重启。适用于临时任务或调试场景。
on-failure容器退出码非0时重启（默认最大重试3次）。适合需要故障恢复的长期服务。
always无论退出原因如何，始终重启。即使手动停止后重新启动 Docker，容器也会重启。
unless-stopped除非容器被手动停止，否则一直重启。即使 Docker 服务重启后也会恢复。

比喻：

  • always 像一个倔强的哨兵，无论风吹雨打都要坚守岗位。
  • on-failure 则像医生，只在检测到“生病”（非零退出码）时才会采取行动。

3.1.2 配置策略的方法

在启动容器时通过 --restart 参数指定策略：

docker run --restart=on-failure:5 \  
  -d \  
  --name my-db \  
  mysql:latest

上述命令中，on-failure:5 表示当退出码非0时最多尝试重启5次。

3.2 重启策略的实战应用

案例：部署一个 MySQL 数据库服务，要求崩溃后自动恢复：

docker run \  
  --restart=always \  
  -d \  
  --name mysql-server \  
  -e MYSQL_ROOT_PASSWORD=my-secret-pw \  
  mysql:8.0

此配置下，即使 MySQL 进程异常退出，容器也会自动重启，保障服务可用性。

四、容器重启的进阶技巧与故障排查

4.1 联动服务的依赖管理

在复杂应用中，多个容器可能需要按顺序重启。例如，Web 应用依赖数据库，可通过 docker-compose 定义依赖关系：

version: '3'  
services:  
  db:  
    image: mysql:8.0  
    restart: always  
  web:  
    image: my-web-app:latest  
    restart: on-failure:3  
    depends_on:  
      - db

此配置中，web 服务仅在 db 正常运行后启动，避免依赖缺失导致的启动失败。

4.2 日志与状态检查

若容器重启后仍存在问题，需通过以下命令排查：

  1. 查看容器日志： 
    docker logs --tail 100 --since 1h <容器名>
  2. 检查容器状态： 
    docker inspect <容器名> | grep "State"
  3. 验证退出原因： 
    docker inspect <容器名> | grep "ExitCode"

五、实战案例：通过自动重启保障服务高可用性

5.1 场景背景

假设我们部署了一个 Nginx 服务器，要求：

  • 永远保持运行，除非手动停止。
  • 在崩溃后自动重启，并限制重试次数避免无限循环。

5.2 实现步骤

  1. 创建并启动容器，配置 unless-stopped 策略： 
    docker run \  
  --name nginx-server \  
  --restart unless-stopped \  
  -p 80:80 \  
  -d \  
  nginx:latest
  2. 验证策略是否生效： 
    docker inspect nginx-server | grep RestartPolicy  
# 输出示例：  
# "RestartPolicy": {"Name":"unless-stopped","MaximumRetryCount":0},
  3. 模拟故障并观察重启：
    • 手动终止容器： 
      docker stop nginx-server  
docker start nginx-server  # 手动启动后策略生效
    • 若容器因错误退出（例如修改配置导致 Nginx 启动失败），系统将自动重启。

5.3 扩展场景：结合健康检查

通过 HEALTHCHECK 指令增强可靠性：

FROM nginx:latest  
HEALTHCHECK CMD curl --fail http://localhost/ || exit 1

此配置下，Docker 会定期检查 Nginx 的响应，若健康检查失败则触发重启。

六、常见问题与解决方案

6.1 重启后配置丢失

若容器数据未持久化，重启后会丢失未提交的修改。解决方案：

  • 使用 数据卷 挂载持久化存储： 
    docker run -v /my-data:/app_data ...
  • 或通过 docker commit 保存当前状态为新镜像。

6.2 自动重启策略未生效

可能原因及排查：

  • 策略未正确配置，需检查 docker inspect 输出。
  • 容器退出码为0（always 策略除外），需修改程序逻辑避免正常退出。

结论

掌握 docker 重启 的核心机制与策略，是构建健壮容器化应用的关键。从手动干预到自动化策略，再到结合健康检查和数据持久化，开发者可以显著提升服务的稳定性与可靠性。建议读者通过实际操作加深理解，例如尝试搭建一个包含多服务依赖的 Docker Compose 项目，并设置不同重启策略观察效果。随着实践的深入，您将更好地驾驭 Docker 的强大功能，为复杂场景提供高效解决方案。

最新发布

查看更多文章