【Docker】解决Docker容器时间与宿主机时间不一致的几种方法

一、介绍

由于Docker容器内的时间默认是 UTC 世界标准时间，而宿主机时间为 CST 中国标准时间（东八区，Asia/Shanghai），时间相差8小时，根本原因是时区问题。因此，需要为Docker容器配置正确的时区，让容器内的时间与宿主机（或中国标准时间）保持一致。

二、解决方法

方法一：已运行的容器修改时区文件

bash 复制代码

1、进入容器
docker exec -it 容器ID/容器名称 /bin/bash

2、修改时区文件
# 备份容器默认时区文件
mv /etc/localtime /etc/localtime.bak
# 创建软链接，将系统时区指向上海时区
ln -sf /usr/share/zoneinfo/Asia/Shanghai  /etc/localtime
# 修改时区文件
echo "Asia/Shanghai" > /etc/timezone

这个方法的核心是修改容器内部的系统级时区配置，所有修改都是写入容器的文件系统中，容器的文件系统是持久化的（除非手动删除容器），因此重启容器、重启Docker、宿主机重启，时区都不会变。

方法二：创建新容器时挂载时区文件

bash 复制代码

docker run -d \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  --name 容器名称 镜像名称

参数解释：

/etc/localtime：Linux系统的「本地时区配置文件」，软链接文件，指向具体的时区文件

/etc/timezone：Linux系统的「时区文本配置文件」，部分程序会读取这个文件

ro：表示只读挂载，避免容器修改宿主机文件，提升安全性，建议加上
这个方法的核心是通过 Docker 的 -v 挂载参数，将宿主机的本地时区文件，直接挂载到容器内部对应的系统时区文件位置，让容器和宿主机共用同一个时区配置。

方法三：创建新容器时指定时区环境变量

bash 复制代码

docker run -it -e TZ=Asia/Shanghai ubuntu

注意：部分极简镜像（如 Alpine）可能需要先安装 tzdata 包才能识别 TZ 变量，否则时区设置不生效。

方法四：Dockerfile构建镜像时指定时区

1、编写Dockerfile文件

bash 复制代码

# 基础镜像
FROM ubuntu:latest

# 备份原时区文件
RUN mv /etc/localtime /etc/localtime.bak

# 创建软链接
RUN ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 修改时区文件
RUN echo "Asia/Shanghai" > /etc/timezone

# 启动容器
RUN apt update && apt install -y nginx
CMD ["nginx", "-g", "daemon off;"]

2、构建构建镜像+创建容器

bash 复制代码

# 构建镜像
docker build -t 自定义镜像名称:版本 .

# 创建容器
docker run -d --name 容器名称 自定义镜像名称:版本

这个方法的核心是使用Dockerfile构建的镜像指定了正确时区，因此基于该镜像创建的所有容器，默认就是正确时区，重启100%不失效。

三、查看容器时间

bash 复制代码

docker exec 容器ID/名称 date

输出显示CST即为正确时间

四、其他问题

问题1：

为什么在容器内直接执行命令 date -s "2026-01-19 16:30:00" 后，时间并没有生效？

答：这种方式是临时修改系统时间，不是修改时区。而且容器的系统时间默认和宿主机同步，手动修改后，会被宿主机时间覆盖，重启容器后立刻还原，这是错误的做法，千万不要用！

问题2：

时区修改成功后，容器内的应用（Java/MySQL/Nginx）时间还是错的？

答：分2种情况解决：

Java应用：Java虚拟机默认会读取系统时区，但部分Java程序会硬编码时区，此时需要在启动命令加参数：java -Duser.timezone=Asia/Shanghai -jar xxx.jar
MySQL容器：MySQL默认读取系统时区，但需要在配置文件中指定 default-time-zone = '+8:00'，或启动时加参数 --default-time-zone=+8:00

问题3：

宿主机时区本身就是错的，怎么办？

答：ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone