最稳妥的时区配置是在Dockerfile中固化：先设ENV TZ=Asia/Shanghai，再用ln -snf生成/etc/localtime软链接并写入/etc/timezone；Ubuntu/Debian无需额外安装tzdata，CentOS需yum install tzdata，Alpine则需apk add tzdata后复制时区文件。
直接在 Dockerfile 里固化时区配置是最稳妥的做法，避免运行时依赖环境变量或挂载，一劳永逸。
用 ENV + ln -snf 预设时区（通用性强）
适用于 Ubuntu、Debian、CentOS 等主流镜像。核心是两步：设置 TZ 环境变量，并用它生成 /etc/localtime 符号链接，同时写入 /etc/timezone 文件。
- 在 Dockerfile 中添加：
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
echo "$TZ" > /etc/timezone
注意：Ubuntu/Debian 镜像自带 tzdata 包，无需额外安装；CentOS/RHEL 需先 RUN yum install -y tzdata 再执行链接操作。
Alpine 镜像需额外安装 tzdata
Alpine 默认不带时区数据，必须显式安装并配置：
- Dockerfile 片段：
RUN apk add --no-cache tzdata && \
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
echo "Asia/Shanghai" > /etc/timezone
不用 ln -sf，因为 Alpine 的 /usr/share/zoneinfo 路径下文件是真实文件而非符号链接，直接复制更可靠。
构建后验证是否生效
镜像构建完成后，启动容器并检查关键文件和输出：
-
docker run --rm your-image date—— 应显示 CST 时间（如Wed Aug 13 17:54:00 CST 2026） -
docker run --rm your-image cat /etc/timezone—— 输出应为Asia/Shanghai -
docker run --rm your-image ls -l /etc/localtime—— 应指向/usr/share/zoneinfo/Asia/Shanghai
若三项均符合，说明时区已在镜像层固化，后续所有基于该镜像的容器都会继承正确时区。
避免常见坑点
有些做法看似简洁，但存在隐患：
- 只设
ENV TZ=Asia/Shanghai不做链接 —— 多数程序（如 Java、Python 的 datetime）会读取 TZ，但系统级命令（如date）仍可能显示 UTC - 用
timedatectl set-timezone—— Alpine 和多数精简镜像无 systemd，该命令不可用 - 挂载宿主机 /etc/localtime 到容器 —— 虽然简单，但破坏镜像可移植性，且在 Kubernetes 等编排环境中难以统一管理
真正可靠的方案，是在构建阶段就把时区“焊死”在镜像里。
