Docker 环境搭建时怎么配置容器的自动重启策略(restart policy)

夏强姑娘_7548

夏强姑娘_7548

2026-07-23

649人浏览

原创

推荐生产环境首选 unless-stopped:容器在 docker 守护进程重启或宿主机重启后自动拉起,但手动执行 docker stop 后不再自启;always 适合绝对不可中断的核心服务;on-failure:3 适用于依赖外部服务且需防死循环的场景;no 为默认值,适用于一次性任务。

docker 环境搭建时怎么配置容器的自动重启策略(restart policy)

要让 Docker 容器在异常退出或宿主机重启后自动拉起,关键不是“写个脚本轮询”,而是用好 Docker 原生的 --restart 策略,并确保底层服务支撑到位。

容器重启策略怎么选才合适

不同业务场景适合不同策略,不能一概用 always:

  • unless-stopped(推荐生产环境首选)

    • Docker 守护进程重启(比如 daemon 崩溃后恢复)或宿主机重启时,自动启动容器
    • 但如果你手动执行过 docker stop myapp,它就不会再自启,尊重运维意图
    • 适合 Web 服务、API 网关、缓存等无状态或状态可恢复的服务
  • always(慎用)

    • 不管容器是否被手动停过,只要 Docker daemon 启动,就强制拉起
    • 适合极少数绝对不可中断的核心组件,比如集群协调器(etcd)、证书签发服务(cert-manager)
    • 必须搭配 HEALTHCHECK,否则健康失败也会无限重启
  • on-failure[:max](调试/有依赖场景更安全)

    OpenClaw Docker Setup
    OpenClaw Docker Setup

    在 Linux 上通过 Docker 运行 OpenClaw,并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

    下载
    • 只在容器非零退出码时重启(如崩溃、OOM 被 kill 的 137 码)
    • 加上限值如 on-failure:3,避免因配置错误、数据库连不上等永久性问题陷入死循环
    • 适合依赖外部服务(如 MySQL、Redis)的应用,建议配合启动等待逻辑
  • no(默认值,不重启)

    • 适用于一次性任务、CI 构建容器、或你用 Kubernetes / systemd 等上层编排管理生命周期的情况

新建容器时直接配置 restart 策略

命令里加 --restart 参数,必须配合 -d(后台模式)才生效:

# 启动一个 Nginx,宿主机重启后自动恢复,但手动 stop 后不再拉起
docker run -d --restart unless-stopped --name web -p 80:80 nginx

# 启动一个 Redis,异常退出最多重试 5 次
docker run -d --restart on-failure:5 --name cache redis

# 启动一个核心服务,要求无条件复活(需配 HEALTHCHECK)
docker run -d --restart always --health-cmd="redis-cli ping" --health-interval=30s redis

已有容器补设 restart 策略

无需停止容器,docker update 可实时生效(Docker 20.10+):

# 把已运行的容器设为 unless-stopped
docker update --restart unless-stopped myapp

# 查看是否设置成功
docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' myapp
# 输出应为 unless-stopped、always 或 on-failure

别漏掉两个关键前提

光配 --restart 不够,下面两点必须同时满足:

  • Docker 服务本身要开机自启
    运行这条命令,确保 dockerd 在系统启动时自动拉起:

    sudo systemctl enable docker
  • 容器必须以 detached 模式(-d)运行
    前台交互模式(如 docker run -it ubuntu bash)不触发任何 restart 策略,哪怕写了 --restart 也无效

验证和常见踩坑点

  • 模拟验证:执行 sudo systemctl restart docker,然后 docker ps 看容器是否已运行
  • 端口冲突?容器启动失败会立即重试,没延迟——建议应用内加等待逻辑(如 wait-for-it.sh)或用 docker-compose 的 depends_on + healthcheck
  • 数据库类容器(PostgreSQL、MySQL)务必挂载持久化卷(-v),否则重启后数据清空
  • docker update --restart 对正在运行的容器生效,但 on-failure 类策略只响应“本次运行周期内”的异常退出,不保证宿主机重启后一定拉起(unless-stopped 和 always 才支持)

不复杂但容易忽略

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

705

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5139

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6117

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2333

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

259

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

451

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

400

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

305

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

425

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习