讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夏强姑娘_7548

夏强姑娘_7548

发布时间:2026-07-23 14:04:41

|

649人浏览过

|

来源于php中文网

原创

推荐生产环境首选 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 才支持)

不复杂但容易忽略

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

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

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

705

2023.07.24

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

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

5159

2024.04.08

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

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

6137

2024.04.08

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

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

2333

2024.04.08

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

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

259

2026.02.11

Docker 容器部署
Docker 容器部署

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

451

2026.03.31

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

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

400

2026.05.11

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

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

305

2026.05.15

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

热门下载

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

精品课程

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

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn