docker容器时区需通过启动参数（-e tz=asia/shanghai）或镜像构建（dockerfile中设置env tz并配置/etc/localtime）实现，挂载宿主机/etc/localtime仅适用于linux宿主机，alpine等精简镜像须在构建时安装tzdata，修改daemon.json或容器内手动改时区均无效且违反最佳实践。
直接在 Docker Desktop 启动容器时设置时区，和用命令行 docker run 本质一致——Docker Desktop 本身不提供图形化时区配置入口，所有时区控制都落在容器启动参数或镜像构建阶段。你不需要改 Docker Desktop 的全局设置（比如 daemon.json），也不该进容器里手动改 /etc/localtime。
用 -e TZ=Asia/Shanghai 启动容器最简单有效
这是绝大多数 Linux 基础镜像（Ubuntu、Debian、CentOS）原生支持的方式。Docker Desktop 的 GUI 创建容器流程不暴露环境变量字段，所以必须用 CLI 模式：
- 在 Docker Desktop 中点击左下角 “CLI” 打开终端（或直接用系统终端）
- 执行类似命令：
docker run -d -e TZ=Asia/Shanghai --name myapp nginx - 验证：
docker exec myapp date应输出东八区本地时间，而非 UTC
注意：部分精简镜像（如 alpine）默认没装 tzdata，仅设 TZ 环境变量无效——它需要时区数据文件支撑。这类镜像必须配合镜像构建阶段安装，不能只靠运行时环境变量。
Alpine 镜像必须在 Dockerfile 里装 tzdata 并复制时区文件
alpine 镜像体积小，但默认不含时区数据库。只加 -e TZ=Asia/Shanghai 不起作用，date 仍显示 UTC 时间。正确做法是在构建镜像时固化时区：
- 在
Dockerfile中添加：ENV TZ=Asia/Shanghai RUN apk add --no-cache tzdata && \ cp /usr/share/zoneinfo/$TZ /etc/localtime && \ echo $TZ > /etc/timezone && \ apk del tzdata - 构建后运行：
docker run -d --name alpine-app your-alpine-image，无需再传-e TZ - 关键点：
apk del tzdata可删掉运行时冗余包，但必须在cp和echo之后执行
挂载宿主机 /etc/localtime 是兼容性最强的兜底方案
当你无法控制镜像构建过程（比如用第三方闭源镜像），或者遇到某些 Java/Node.js 应用忽略 TZ 环境变量的情况，挂载是更底层、更可靠的手段：
- 命令写法：
docker run -d -v /etc/localtime:/etc/localtime:ro -e TZ=Asia/Shanghai myimage - 原理：直接把宿主机的二进制时区文件映射进容器，绕过用户空间解析逻辑
- 注意：
/etc/localtime在 macOS 或 Windows 上 Docker Desktop 宿主机并不存在——此方案仅适用于 Linux 宿主机；macOS/Windows 用户应优先依赖TZ环境变量 + 镜像内预置时区
别碰 docker desktop 的 daemon.json 或手动进容器改 time
网上有些教程让你改 daemon.json 加全局时区，或进容器用 ln -sf 软链、date -s 改系统时间，这些全是错误路径：
-
daemon.json不支持timezone字段，加了也无效 - 容器内手动改
/etc/localtime或运行date命令，重启即失效，且违反不可变基础设施原则 -
date -s修改的是容器内 wall clock，但宿主机内核时间未变，反而可能引发 NTP 冲突或应用时间跳变
真正需要持久、可靠、可复现的时区行为，只有两个落点：构建镜像时写死（Dockerfile），或启动容器时注入（-e TZ 或 -v /etc/localtime）。其它都是临时补丁，容易在 CI/CD 或多环境迁移中出问题。
