Docker 容器内定时任务秘诀全解

在容器里跑定时任务常会遇到这些痛点：

• Cron 服务没有启动，任务根本不执行
• 容器重启后任务失效。日志丢失
• 时区不一致导致时间偏差
• 脚本方法或权限错误，任务报错却找不到线索
• 敏感信息硬编码在 crontab 中，安全性堪忧

下面从「语法速查」到「高级实践」一步步帮你解决这些问题，让定时任务在 Docker 中稳如老狗。

主要语法速查

Crontab 基本格式

表达式	说明
* * * * *	分 时 日 月 周
0 2 * * *	每天凌晨 2 点执行一次
@reboot	容器启动时立即执行

关键 Docker 标志

标志	说明
-e	设置环境变量
-v	挂载卷，用于持久化日志、脚本或 crontab 文件
-d	后台运行容器，常配合cron -f保持前台进程活着

Dockerfile 示例

# 基础镜像
FROM ubuntu:20.04
# 安装 cron 与 tzdata
RUN apt-get update && apt-get install -y cron tzdata
# 设置容器时区
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ> /etc/timezone
# 添加业务脚本并赋予执行权限
COPY script.sh /script.sh
RUN chmod +x /script.sh
# 添加 crontab 文件
COPY crontab /etc/cron.d/simple-cron
RUN chmod 0644 /etc/cron.d/simple-cron && \
crontab /etc/cron.d/simple-cron
# 创建日志文件并确保可写
RUN touch /var/log/cron.log && chmod 666 /var/log/cron.log
# 启动 cron 并实时输出日志
CMD

Docker Compose 示例

version: "3.8"
services:
cronjob:
再看build。.
containername: croncontainer
volumes:
- ./script.sh:/script.sh:ro # 脚本只读挂载
- ./crontab:/etc/cron.d/simple-cron:ro # crontab 文件只读挂载
- ./cron-logs:/var/log # 持久化日志目录
environment:
- TZ=Asia/Shanghai # 与 Dockerfile 中保持一致
- SCRIPT_PATH=/script.sh # 示例环境变量，可在 crontab 中引用
command:

Crontab 文件示例

# 每分钟执行一次 script.sh，使用 root 权限，并把输出追加到日志文件中
* * * * * root $SCRIPT_PATH>> /var/log/cron.log 2>&1 

MAILTO= 0 */6 * * * root $SCRIPT_PATH>> /var/log/cron.log 2>&1

监控与调试技巧

常用工具对照表

工具	说明
docker logs	实时查看容器的 stdout/stderr
docker exec -it crontab -l	列出容器内部当前的 cron 表
docker exec -it ps aux | grep cron	确认 cron 服务是否在运行

Oops let's correct table rows.

We'll rewrite correctly:

="" etc.<="" p="">

Continue.

常见痛点：

• Cron 服务未启动，任务根本不跑；
• 容器重启后 Cron 配置丢失、日志消失；
• 容器时区与宿主机不一致，导致时间偏差；
• Cron 脚本方法或权限错误，却找不到错误来源；
• Sensitive 信息硬编码进 crontab，安全隐患大。

这里通过完整示例、常用方法还有故障排查技巧。把这些坑一网打尽，让你的定时任务在 Docker 中“稳如老狗”。

Crontab 基本格式 

---