在 Dockerfile 中配置时区是主动预设固定时区（如 Asia/Shanghai），非自动同步宿主机；Ubuntu 需 ENV TZ=Asia/Shanghai 并 ln -snf /usr/share/zoneinfo/$TZ /etc/localtime；Alpine 还须先 apk add --no-cache tzdata。
在 dockerfile 中配置时区，本质是让构建出的镜像自带正确的时区设置，这样基于它启动的所有容器默认就用本地时间（比如 asia/shanghai），无需每次运行都加参数或挂载。这不是“自动同步宿主机”，而是**主动预设一个固定、可靠的时区值**——生产环境推荐这么做，稳定且可复现。
直接在 Dockerfile 中写死时区（推荐）
这是最常用、最稳妥的方式，适用于 Ubuntu/Debian 系统镜像：
- 用 ENV 设置 TZ 环境变量
- 用 RUN 创建软链接并写入时区名
示例（以 Ubuntu 为基础）：
FROM ubuntu:22.04ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
echo $TZ > /etc/timezone
构建后，容器内执行 date 就会显示东八区时间，cat /etc/timezone 输出 Asia/Shanghai，ls -l /etc/localtime 指向正确的 zoneinfo 文件。
Alpine 镜像需要额外安装 tzdata
Alpine 极简，不带时区数据。只设 TZ 不生效，必须先装 tzdata 包：
RUN apk add --no-cache tzdata
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
echo $TZ > /etc/timezone
漏掉 apk add tzdata，date 仍会显示 UTC 或报错。
为什么不能“自动读取宿主机时区”？
Dockerfile 构建发生在镜像打包阶段，此时宿主机环境不可见。构建机和最终运行机的时区可能不同（比如 CI 服务器在 UTC，生产服务器在 CST）。所以不建议尝试动态获取宿主机时区，也不可靠。正确做法是：明确指定业务所需的时区（如中国项目统一用 Asia/Shanghai），并在所有环境保持一致。
验证是否生效
构建完镜像后，快速验证：
docker run --rm your-image datedocker run --rm your-image cat /etc/timezone
输出应为当前北京时间（非 UTC）和 Asia/Shanghai。如果仍是 UTC，检查是否用了 Alpine 却没装 tzdata，或路径写错（如 /usr/share/zoneinfo 拼成 /usr/share/zoneinfo 少字母）。
