win11下docker容器时间比宿主机慢8小时，因容器默认使用utc时区而宿主机为cst（utc+8）；可通过挂载宿主机时区文件、docker compose配置或dockerfile固化时区解决。
Win11下Docker容器时间与宿主机Windows北京时间相差8小时，会导致日志时间错乱、定时任务凌晨1点变上午9点执行、报表跨日聚合数据偏移——这并非容器“走时不准”，而是容器内Linux系统默认使用UTC时区，而Win11宿主机显示的是CST（UTC+8）本地时间，两者根本不在同一时区坐标系里。
确认问题：先验证容器是否真在用UTC
打开 PowerShell，运行：docker exec -it date。若输出类似 Wed Sep 24 11:52:30 UTC 2026，而你Win11右下角显示的是 2026/9/24 19:52，则确认是UTC vs CST的8小时偏差。注意：【不要直接改容器内系统时间，它会在重启后重置】。
再查容器是否读取了时区文件：docker exec -it cat /etc/timezone 2>/dev/null || echo "无/etc/timezone"。若返回空或UTC，说明时区未配置。
已运行容器临时修复（仅限调试，不持久）
方法一：进入容器手动链接上海时区
执行 docker exec -it /bin/bash → 运行 ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime → 再执行 echo "Asia/Shanghai" > /etc/timezone。此时 date 命令会立即显示正确北京时间。
⚠️但该修改仅存于当前容器可写层，容器删除或镜像重建后失效；且部分精简镜像（如Alpine）缺 tzdata 包，需先 apk add tzdata 才能生效。
新容器启动时永久同步（推荐）
第一步：确保Win11宿主机已正确设置时区
在Win11设置→时间和语言→日期和时间→时区，确认选中“(UTC+08:00) 北京，重庆，香港特别行政区，乌鲁木齐”。Docker Desktop会自动从系统读取此设置，但不会自动透传给Linux容器。
第二步：启动容器时挂载宿主机时区文件
PowerShell中运行：docker run -d -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name myapp nginx。其中 /etc/localtime 在Win11上实际由Docker Desktop虚拟机（WSL2）维护，该挂载会把WSL2中已设为CST的时区文件透传进容器。
第三步：验证挂载是否生效
docker exec myapp date 应输出带 CST 或 +0800 的时间；docker exec myapp cat /etc/timezone 应返回 Asia/Shanghai。
使用 Docker Compose 统一管理时区
在 docker-compose.yml 的 service 下添加 volumes 配置：
volumes:
- "/etc/localtime:/etc/localtime:ro"
- "/etc/timezone:/etc/timezone:ro"
保存后执行 docker-compose down && docker-compose up -d。注意：路径前的 / 是WSL2 Linux路径，不是Win11的 C:\，Docker Desktop会自动映射。
若使用 Alpine 基础镜像，还需在 compose 文件中加环境变量：TZ: Asia/Shanghai，否则 /etc/timezone 挂载可能被忽略。
构建镜像时固化时区（一劳永逸）
方法一：Dockerfile 中预设环境变量与软链接
在 Dockerfile 开头加入：
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
构建命令：docker build -t myapp:v2 .。此后所有基于此镜像启动的容器，date 默认显示北京时间，无需额外参数。
方法二：针对 Alpine 镜像必须显式安装 tzdata
RUN apk add --no-cache tzdata && cp -f /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone。缺少 apk add tzdata 这步，Asia/Shanghai 文件根本不存在，软链接会指向空。
