Shell脚本如何配置容器重启策略

wen 实用脚本 2026-07-16 2

Shell脚本如何配置容器重启策略：从入门到生产级实践

目录导读

为什么需要容器重启策略？
Docker原生重启策略详解
Shell脚本动态配置重启策略的方法
实战案例：自动化监控与重启脚本
生产环境中的高级配置技巧
常见问题与问答

为什么需要容器重启策略？

在微服务和云原生架构中，容器化应用可能因内存溢出、进程崩溃、网络波动等原因意外停止，如果没有合理的重启机制，服务将长时间不可用，影响业务连续性。容器重启策略能够自动检测容器退出状态，并按照预设规则重新启动容器,从而提升系统的自愈能力。

Shell脚本如何配置容器重启策略

根据Google SRE（站点可靠性工程）最佳实践，一个健康的生产系统应当具备“自动故障恢复”能力，而Shell脚本作为最灵活的自动化工具，可以动态检测容器状态并执行精准的重启操作，这是Docker原生restart策略无法完全覆盖的场景（基于业务日志判断的重启、限次重启、延迟重启等）。

Docker原生重启策略详解

在掌握Shell脚本之前，需先理解Docker内置的重启策略（--restart参数）,它是配置的基础：

策略值	行为描述
`no`	默认值，容器退出后不自动重启
`on-failure[:max-retries]`	仅在容器非正常退出（退出码非0）时重启，可限制重试次数
`always`	容器总是重启，无论退出码如何，包括手动`docker stop`后（Docker daemon重启后也会重启）
`unless-stopped`	类似`always`，但手动停止后不会在daemon重启时自动重启

关键区别：always会强制重启，即使退出码为0；而on-failure更智能，只有异常退出才触发，生产环境推荐使用on-failure:3（最多重试3次）或unless-stopped。

使用示例：

docker run -d --restart on-failure:5 nginx

Shell脚本动态配置重启策略的方法

当原生策略无法满足复杂需求时（如根据CPU使用率、日志错误关键字、外部依赖状态决定是否重启）,Shell脚本便成为必要选择。

配合`docker update`实时更新策略

docker update可以动态修改运行中容器的重启策略,无需停止容器：

# 将容器myapp的重启策略改为on-failure:3
docker update --restart=on-failure:3 myapp
# 或改为always
docker update --restart=always myapp

使用`docker inspect`检测当前状态并条件重启

#!/bin/bash
CONTAINER_NAME="web-app"
# 获取容器退出码
EXIT_CODE=$(docker inspect -f '{{.State.ExitCode}}' $CONTAINER_NAME 2>/dev/null)
if [ "$EXIT_CODE" != "0" ]; then
    echo "容器异常退出，退出码: $EXIT_CODE"
    # 检查日志中是否有OOM（内存溢出）关键字
    LAST_LOG=$(docker logs --tail 5 $CONTAINER_NAME 2>&1 | grep -i "OutOfMemory")
    if [ -n "$LAST_LOG" ]; then
        echo "检测到OOM，跳过重启，通知运维"
        # 可发送告警邮件或调用webhook
    else
        docker restart $CONTAINER_NAME
        echo "已触发重启"
    fi
fi

结合systemd实现更稳健的守护

将容器封装成systemd服务,由systemd接管重启管理：

[Unit]
Description=My Docker Container
After=docker.service
[Service]
ExecStart=/usr/bin/docker start -a my_container
ExecStop=/usr/bin/docker stop my_container
Restart=on-failure
RestartSec=5
User=root
[Install]
WantedBy=multi-user.target

实战案例：自动化监控与重启脚本

以下是一个完整的生产级脚本,监控多个容器并智能重启：

#!/bin/bash
# 容器重启策略管理器 - monitor_restart.sh
# 配置区
CONTAINERS=("nginx" "redis" "app-server")
MAX_RESTARTS=5
RESTART_WINDOW=3600  # 1小时内最多重启5次
ALERT_WEBHOOK="https://hooks.domain.com/webhook/alert"
# 函数：检查容器健康状态
check_container_status() {
    local container=$1
    local status=$(docker inspect -f '{{.State.Status}}' $container 2>/dev/null)
    echo $status
}
# 函数：获取最近重启次数
get_restart_count() {
    local container=$1
    local count=$(docker inspect -f '{{.RestartCount}}' $container)
    echo $count
}
# 主循环
for container in "${CONTAINERS[@]}"; do
    status=$(check_container_status $container)
    if [ "$status" == "exited" ] || [ "$status" == "dead" ]; then
        restart_count=$(get_restart_count $container)
        if [ $restart_count -lt $MAX_RESTARTS ]; then
            echo "[$(date)] 重启容器: $container (已重启 $restart_count 次)"
            docker restart $container
        else
            echo "[$(date)] 容器 $container 重启次数超过限制，停止自动重启"
            curl -s -X POST $ALERT_WEBHOOK \
                -H "Content-Type: application/json" \
                -d "{\"text\":\"容器 $container 重启次数达上限($restart_count)\"}"
        fi
    fi
done

将此脚本放入crontab每分钟执行：

* * * * * /path/to/monitor_restart.sh

生产环境中的高级配置技巧

健康检查优先于重启

不要盲目重启！先用docker exec运行内建健康检查命令：

HEALTH=$(docker exec myapp curl -f http://localhost/health || echo "fail")
if [ "$HEALTH" == "fail" ]; then
    # 先尝试优雅关闭，再强制重启
    docker stop --time=30 myapp
    sleep 2
    docker start myapp
fi

带退避机制的延迟重启

连续故障时应延长重启间隔,避免资源耗尽：

# 根据重启次数计算等待时间（指数退避）
WAIT=$((2 ** restart_count * 5))
echo "等待 $WAIT 秒后重启..."
sleep $WAIT

基于Docker Compose的批量策略

在docker-compose.yml中定义重启策略后,用Shell脚本批量更新：

for service in $(docker-compose ps --services); do
    docker-compose up -d --no-deps --scale $service=1 $service
done

结合Docker SDK for Go/Python

更复杂的策略可用Python编写，但Shell仍然是轻量首选，例如用Python调用Docker API做更精细的日志分析：

# 伪代码，实际可集成到Shell脚本中
import docker
client = docker.from_env()
container = client.containers.get('myapp')
if container.status == 'exited':
    log = container.logs(tail=100).decode()
    if 'Fatal' in log:
        container.restart(timeout=10)

常见问题与问答

Q1：--restart=always和unless-stopped有什么区别？ A：核心区别在于手动停止后的行为。always会在Docker daemon重启后自动启动即使之前手动停止；unless-stopped会记住手动停止状态，daemon重启后不会自动启动，如果你的容器需要通过docker stop进行维护，建议使用unless-stopped。

Q2：Shell脚本中如何判断容器是否健康，而不只是运行状态？ A：使用docker inspect -f '{{.State.Health.Status}}' container_name，需要先在Dockerfile中定义HEALTHCHECK指令，如果健康状态为unhealthy,即使容器在运行也应重启。

Q3：重启策略配置后，为什么容器还是重启不了？ A：常见原因包括：1) 策略设置错误（no不会重启）；2) 容器启动参数中有--restart=no覆盖；3) Docker daemon自身未运行或磁盘满导致无法拉取镜像；4) 系统资源限制（如ulimit），建议先用docker inspect container | grep Restart检查当前策略。

Q4：Shell脚本重启容器时，如何避免影响正在处理请求？ A：使用docker stop --time=30先给容器30秒优雅关闭时间，等待进程处理完当前请求，然后docker start重启，更专业的做法是利用Docker的restart策略结合K8s的滚动更新。

Q5：能否在Shell脚本中同时管理多个容器的重启依赖？ A：可以，例如数据库容器必须先启动,应用容器后启动：

# 按依赖顺序重启
docker restart mysql       # 先重启数据库
sleep 5                   # 等待数据库就绪
docker restart app-server # 再重启应用

你应该掌握了从Docker原生策略到Shell脚本动态控制的完整体系。重启不是目的，稳定才是，合理配置重启策略，配合日志监控和告警,能让你的容器化应用具备真正的生产级自愈能力。

Shell脚本如何配置容器重启策略