首页/云/Docker 容器速查/容器时间与 UTC 时差
容器排障52 条

容器时间与 UTC 时差

容器默认 UTC:日志与宿主差 8 小时是时区而非故障;用 TZ 环境变量设置时区,注意精简镜像可能缺时区数据。

Docker 容器速查云更新于 2026-10-12
默认UTC(多数官方镜像)
设置-e TZ=Asia/Shanghai
依赖镜像内需有时区库(如 alpine 装 tzdata)

示例

示例
docker run --rm alpine date
docker run --rm -e TZ=Asia/Shanghai alpine date
docker run --rm -e TZ=Asia/Shanghai alpine sh -c 'apk info -e tzdata || echo need-tzdata'
跨时区协作把容器统一 UTC、展示层再转换,往往比逐个容器设 TZ 更好维护。

易错点

  • 挂载宿主 /etc/localtime 的姿势在跨平台与滚动重启下不稳,长期方案要评估
  • 改 TZ 没生效先查镜像是否带时区库,而不是怀疑命令写错

数据来源与参考

  • Docker 官方文档:Environment variables 与镜像时区实践(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌