容器时间同步关键在于统一时区解释而非修改系统时间；推荐挂载宿主机/etc/localtime或设置tz环境变量，构建阶段固化时区更利于生产部署。
容器内部系统时间同步，关键不在“改时间”，而在“统一时区解释”。Docker 容器共享宿主机的内核时间（CLOCK_REALTIME），本身不会漂移或变慢；所谓“时间不同步”，99% 是时区配置缺失导致的显示偏差——比如宿主机显示 10:00 CST，容器却显示 02:00 UTC，实际是同一时刻，只是解读方式不同。
直接挂载宿主机时区文件（最简生效）
这是见效最快、无需重建镜像的方法，适合快速验证或临时调整：
- 在
docker-compose.yml的服务定义中添加只读挂载：volumes:- /etc/localtime:/etc/localtime:ro - 该操作将宿主机的时区符号链接（如
/etc/localtime → /usr/share/zoneinfo/Asia/Shanghai）原样映射进容器，应用读取/etc/localtime即可获得正确时区信息 - 注意：要求宿主机已正确配置时区（
timedatectl status显示Time zone: Asia/Shanghai (CST, +0800)）
通过 TZ 环境变量驱动时区（跨平台兼容）
适用于 Alpine、Debian、Ubuntu 等主流基础镜像，且对 Java、Node.js、Python 等运行时兼容性好：
- 在服务配置中设置环境变量：
environment:- TZ=Asia/Shanghai - 多数镜像内的 glibc 或 tzdata 会自动响应
TZ变量，更新/etc/localtime和时区缓存 - Java 应用需额外注意：JVM 启动时会缓存时区，若容器启动后才设置
TZ，需重启 JVM 才生效；建议在ENTRYPOINT或启动脚本中确保TZ已就位
构建阶段固化时区（生产推荐）
避免运行时依赖外部配置，提升镜像可移植性和一致性：
- 在 Dockerfile 中显式设置：
ENV TZ=Asia/ShanghaiRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime \&& echo $TZ > /etc/timezone - 对于 Alpine 镜像，还需安装 tzdata：
RUN apk add --no-cache tzdata - 这样构建出的镜像自带时区配置，无论在哪台宿主机上运行，只要未被运行时覆盖，都会默认使用东八区
组合使用更稳妥（应对特殊场景）
某些应用（如旧版 MySQL 容器或定制化 C 程序）可能同时依赖 /etc/localtime 文件和 TZ 环境变量：
- 在 docker-compose.yml 中可两者并用：
volumes:- /etc/localtime:/etc/localtime:roenvironment:- TZ=Asia/Shanghai - 挂载保证文件路径有效，环境变量兜底适配不读文件的应用逻辑
- 特别适合混合技术栈或遗留系统容器化场景
