发布时间:2026-09-28 04:31 更新时间:2026-09-28 04:31 阅读量:8
把应用搬进容器之后,很多人会顺手在 Dockerfile 里装个 cron,或者在 docker-compose 里起一个跑 crond 的 sidecar。上线没几天问题就来了:任务明明只配了一条,却看到执行了两次;日志文件在容器里写得好好的,docker logs 里却什么都没有;脚本手动跑没问题,定时一跑就报找不到环境变量;再严重一点,凌晨的任务在下午才触发。这些现象背后其实都是同一个决策没想清楚:定时任务到底该放在容器里,还是留在宿主机上。这篇把两种做法的边界、常见故障的定位方法和配置示例讲清楚,方便你按实际环境取舍。
容器内跑 cron 的好处是任务与镜像版本绑定,迁移时不会漏配,环境隔离也比较干净。代价是容器本身是为单进程前台运行设计的,cron 作为后台守护进程塞进去,会带来几个副作用:日志默认不落到 stdout,无法被 docker logs 收集;容器重启后 crontab 不会自动重建,除非你写进镜像或挂载进去;容器时区、locale、PATH 往往与宿主机不同,脚本里的 date、python、node 行为可能对不上。
宿主 crontab 的好处是环境稳定、日志统一进 syslog 或 journal,排查方便。代价是任务与代码版本解耦,镜像升级后忘记同步脚本是常事;另外如果同一任务在宿主机和容器里都配了一份,就会出现重复执行。
一个折中的判断标准:任务依赖应用代码和运行时(比如调用项目里的 php 脚本、python 模块),放容器里更合适;任务只是调外部 API、做备份、清理文件,放宿主机更省心。如果非要在容器里跑,建议用独立的任务容器,而不是把 cron 塞进业务容器。
遇到“任务跑两次”,先确认是不是真的配了两份。宿主机和容器各查一遍:
# 宿主机的用户级与系统级 crontab
crontab -l
sudo ls -l /etc/cron.d/ /etc/cron.daily/
容器内的 crontab(假设容器名 app)
docker exec -it app crontab -l
docker exec -it app ps aux | grep -E 'cron|crond'
如果两边都有同名任务,那就是重复触发的直接原因。还有一种隐蔽情况:容器内 crond 读的是 /etc/crontab 和 /etc/cron.d/*,而宿主 crontab 用的是用户级配置,两套配置语法不同(系统级多一个“用户名”字段),复制粘贴时容易把字段搞错,导致任务被解析成别的用户执行或干脆不执行。
“日志缺失”通常是因为 cron 默认把输出通过邮件发给用户,容器里没有 MTA,输出就被丢弃。解决办法是在每条任务后面显式重定向,并让容器日志能被 docker logs 看到:
# 容器内 /etc/cron.d/app 的写法示例
注意系统级 crontab 需要“用户名”字段
SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
TZ=Asia/Shanghai
*/5 * * * * root /usr/local/bin/run-task.sh >> /proc/1/fd/1 2>&1
把输出写到 /proc/1/fd/1 是个常用技巧,它指向容器 PID 1 的标准输出,这样 docker logs 才能看到。写普通文件也可以,但要记得挂载出来,否则容器重建后日志就没了。
“env 变量不生效”几乎都是从交互式 shell 直接跑 cron 造成的错觉。cron 不加载 /etc/profile、~/.bashrc,PATH 也比登录 shell 短很多。排查时先把当前环境打出来对比:
# 在任务脚本开头临时打印环境
env > /tmp/cron-env.txt
手动模拟 cron 的干净环境执行
env -i /bin/sh -c '/usr/local/bin/run-task.sh'
对比两份输出,缺哪个变量就在 crontab 顶部用 VAR=value 显式声明,或者让脚本自己 source 一份固定的 env 文件。不要指望 cron 继承你 ssh 登录时的环境。
时区问题的表现是任务在错误的时间点触发,或者脚本里 date 输出的时间和预期差 8 小时。cron 判断触发时间用的是它自己进程的时区,而不是宿主机时区。容器默认继承宿主机的 /etc/localtime 吗?不一定,取决于镜像和挂载方式,具体以实际环境为准。
稳妥做法是给任务容器显式设置时区,并确认 crond 真的读到了:
# docker run 时显式指定
docker run -d --name cronjob \
-e TZ=Asia/Shanghai \
-v /etc/localtime:/etc/localtime:ro \
your-cron-image
进容器确认
docker exec -it cronjob date
docker exec -it cronjob cat /etc/timezone 2>/dev/null || true
docker exec -it cronjob ps -o pid,cmd -C crond
要注意两点:一是 TZ 环境变量只对支持它的程序生效,glibc 的 date 会认,某些精简镜像里的 busybox 行为可能不同;二是如果 crond 在容器启动时已经跑起来,后来再改 TZ 不会让它重新加载调度时区,需要重启进程。所以时区配置要放在容器启动阶段完成。
另一个容易忽略的点是宿主机与容器的时钟源。如果宿主机本身 NTP 没同步,或者容器内时间被别的方式改过,cron 的触发时间同样会漂。先用 date 和 timedatectl 确认宿主机时间正常,再谈容器内时区。宿主机时间不准,容器里怎么配 TZ 都救不回来。
最后给一个取舍建议:如果任务与业务代码强相关,把它做成独立任务容器,crontab 文件写进镜像或配置挂载,输出统一重定向到 PID 1 的 fd,时区在启动时固定;如果任务只是运维层面的常规动作,放宿主机 crontab 或 systemd timer,日志进 journal,排查链路更短。无论选哪边,都只保留一份配置,避免容器与宿主机同时调度同一个任务。上线前用 docker exec 和 crontab -l 各核对一次,能省掉大部分重复触发和日志找不到的麻烦。
| 📑 | 📅 |
|---|---|
| MySQL隐形变慢排查:buffer pool命中率与磁盘临时表 | 2026-09-28 |
| Linux僵尸进程排查:ps状态Z到父进程不回收定位 | 2026-09-28 |
| PostgreSQL连接池选型与pgbouncer事务池踩坑 | 2026-09-27 |
| Docker 容器 PID 1 与信号处理:docker stop 超时强制 kill 的成因与写法 | 2026-09-27 |
| Nginx proxy_pass 带 URI 与不带 URI:路径拼接错乱排查 | 2026-09-27 |
| Linux TCP backlog 溢出排查:ss -lnt 的 Send-Q 怎么看 | 2026-09-28 |
| Nginx 缓存代理写满磁盘:max_size 与缓存目录清理实战 | 2026-09-28 |
| MySQL 8 临时表爆满排查:内存临时表与磁盘落盘定位 | 2026-09-28 |
| Redis内存碎片率异常:used_memory与RSS差在哪 | 2026-09-28 |
| Docker容器DNS解析异常:127.0.0.11与自定义网络排查 | 2026-09-28 |