核心是挂载宿主机时区文件并设置tz环境变量，同时根据基础镜像在dockerfile中固化时区配置：挂载/etc/localtime和/etc/timezone实现运行时同步，env tz=asia/shanghai配合ln -sf /usr/share/zoneinfo/$tz /etc/localtime确保系统级生效，alpine需安装tzdata，debian需dpkg-reconfigure tzdata，验证需检查date、/etc/timezone及/etc/localtime软链。
要创建一个带有时区同步的 Docker 容器，核心是让容器内时间显示、系统识别和应用感知都统一为本地时区（比如 Asia/Shanghai），而不是默认的 UTC。这不能只靠改一个文件或设一个环境变量，得兼顾 /etc/localtime（运行时生效）、/etc/timezone（系统级声明）以及基础镜像特性。
挂载宿主机时区文件（最简单、推荐用于开发与测试）
直接复用宿主机的时区配置，无需修改镜像，启动即生效：
docker run -d \ -v /etc/localtime:/etc/localtime:ro \ -v /etc/timezone:/etc/timezone:ro \ --name myapp \ nginx:alpine
✅ 优点：零构建成本，实时同步，适用于宿主机时区已正确设置的场景
⚠️ 注意：宿主机必须已配置好 Asia/Shanghai（可用 timedatectl status 或 date 验证），否则挂载的是错的时区
在 Dockerfile 中固化时区（推荐用于生产镜像）
根据不同基础镜像选择适配写法，确保构建后镜像自带正确时区：
Debian/Ubuntu 类（如 python:3.11-slim）
ENV TZ=Asia/Shanghai
RUN ln -fs /usr/share/zoneinfo/$TZ /etc/localtime \
&& echo $TZ > /etc/timezone \
&& dpkg-reconfigure -f noninteractive tzdata \
&& rm -rf /var/lib/apt/lists/*
Alpine 类（如 nginx:alpine）
ENV TZ=Asia/Shanghai
RUN apk add --no-cache tzdata \
&& cp /usr/share/zoneinfo/$TZ /etc/localtime \
&& echo $TZ > /etc/timezone \
&& apk del tzdata
CentOS/RHEL 类（如 httpd:2.4）
ENV TZ=Asia/Shanghai
RUN ln -sf /usr/share/zoneinfo/$TZ /etc/localtime \
&& echo $TZ > /etc/timezone
✅ 优点：镜像可移植、不依赖宿主机、适合 CI/CD 和多环境部署
⚠️ 注意：多阶段构建中，务必在最终 FROM 阶段重复执行时区设置，builder 阶段配了不算数
运行时通过 TZ 环境变量（仅对部分程序有效）
适合快速验证或轻量级应用，但有明显局限：
docker run -e TZ=Asia/Shanghai ubuntu:22.04 date
⚠️ 局限性：
- 对 C 库强依赖的服务（MySQL、PostgreSQL、cron、systemd timer）基本无效
- Java 的
ZoneId.systemDefault()可能仍返回 UTC - 仅影响 shell 层、部分语言运行时（如 Node.js、Python 的
datetime默认行为）
启动后快速验证是否生效
进容器执行三步检查：
docker exec -it myapp sh date # 应显示 CST（如 Tue Jul 29 17:03:xx CST 2026） cat /etc/timezone # 应输出 Asia/Shanghai ls -l /etc/localtime # 应软链到 /usr/share/zoneinfo/Asia/Shanghai
不复杂但容易忽略
