Docker容器挂载宿主机localtime与timezone后时区仍不正确如何解决

问题根因定位及解决方案 #

排查步骤

1. 优先验证软链接挂载失效问题
   你当前宿主机的/etc/localtime是软链接，指向/usr/share/zoneinfo/Asia/Shanghai，直接挂载软链接到容器时，默认没有预装tzdata包的alpine最小镜像内部不存在/usr/share/zoneinfo/目录，无法识别软链接指向的真实文件，会直接 fallback 到UTC时区。
   直接挂载真实时区文件验证：

docker run --rm -it -v /usr/share/zoneinfo/Asia/Shanghai:/etc/localtime alpine date

如果执行后输出CST时间，即可确认是软链接挂载问题，后续启动容器时直接挂载真实时区文件即可解决。
2. 检查权限限制问题
如果上述命令执行后仍输出UTC时间，进入容器验证挂载文件的可读状态：

docker run --rm -it -v /etc/localtime:/etc/localtime alpine /bin/sh
# 容器内执行
ls -l /etc/localtime
cat /etc/localtime

如果出现权限报错，大概率是宿主机的SELinux/AppArmor限制了容器对挂载文件的访问：

• 临时关闭SELinux验证：setenforce 0，重新启动容器测试
• 确认是SELinux问题后，要么给时区文件添加对应的SELinux上下文，要么启动容器时添加--security-opt label=disable参数规避限制

3. 检查Docker daemon配置差异
   对比当前服务器和其他正常服务器的Docker版本、daemon配置：

• 查看daemon配置：cat /etc/docker/daemon.json，确认是否有全局环境变量、启动参数强制覆盖了容器时区
• 版本差异过大时可排查对应Docker版本是否存在挂载类已知bug

通用替代方案

如果不想依赖宿主机时区配置，可在构建alpine系镜像时内置时区配置，无需额外挂载：

RUN apk add --no-cache tzdata \
    && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \
    && echo "Asia/Shanghai" > /etc/timezone \
    && apk del tzdata

内容的提问来源于stack exchange，提问作者lostmarine