bash

进入容器（以镜像名为 myapp 为例）

docker exec -it myapp sh

查看当前日期时间

date

查看时区设置

cat /etc/timezone # Debian/Ubuntu 系

或

ls -l /etc/localtime # CentOS/Alpine 等

如果输出类似 `UTC` 或 `Etc/UTC`，则表示存在时区问题。

## 解决方法

### 方法一：挂载宿主机时区文件（推荐）

运行容器时，将宿主机的 `/etc/localtime` 文件挂载到容器内相同路径，并设置为只读。

```bash
docker run -d \
  -v /etc/localtime:/etc/localtime:ro \
  --name myapp \
  your-image

对于 Docker Compose：

services:
  myapp:
    image: your-image
    volumes:
      - /etc/localtime:/etc/localtime:ro

该方式最简单，直接让容器使用与宿主机相同的时区设置，无需修改镜像。

方法二：设置环境变量 TZ

在容器启动时通过环境变量指定时区，多数基础镜像支持该方法。

docker run -d \
  -e TZ=Asia/Shanghai \
  --name myapp \
  your-image

Docker Compose 示例：

services:
  myapp:
    image: your-image
    environment:
      - TZ=Asia/Shanghai

注意：部分精简镜像（如 Alpine）可能需要先安装 tzdata 包才能正确识别时区名称，推荐使用挂载文件的方法避免依赖问题。

方法三：在 Dockerfile 中固化时区

制作镜像时直接设置时区，适合团队统一维护。

FROM ubuntu:22.04

# 设置时区环境变量
ENV TZ=Asia/Shanghai

# 安装 tzdata 并配置时区（Debian/Ubuntu 系统）
RUN apt-get update && \
    DEBIAN_FRONTEND=noninteractive apt-get install -y tzdata && \
    ln -fs /usr/share/zoneinfo/$TZ /etc/localtime && \
    dpkg-reconfigure --frontend noninteractive tzdata

# 对于 CentOS
# RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 对于 Alpine
# RUN apk add --no-cache tzdata && \
#     cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
#     echo "Asia/Shanghai" > /etc/timezone && \
#     apk del tzdata

然后构建镜像并运行即可。

方法四：容器内临时修改（仅用于测试）

进入容器手动创建软链接：

docker exec -u root -it myapp sh
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
echo "Asia/Shanghai" > /etc/timezone

容器重启后该修改会丢失，不推荐用于生产环境。

验证修改效果

重新启动容器后，查看日志时间是否已同步为北京时间。

# 查看容器日志，注意时间戳
docker logs --timestamps myapp

# 或进入容器确认
docker exec myapp date

如果输出显示 CST 时区且时间准确，则问题已解决。

常见问题与排错

挂载 /etc/localtime 后仍差 8 小时

• 检查宿主机本身的时区是否为 Asia/Shanghai。
• 某些应用（如 Java）可能使用自己的时区数据库，需额外通过 -Duser.timezone=Asia/Shanghai 等参数配置。
• 确认挂载路径是否正确，容器内是否已有同名文件（可能被镜像覆盖）。

TZ 环境变量不生效

• 精简镜像可能未包含时区数据包，改用挂载 /etc/localtime 方式更可靠。
• 修改环境变量后需要重新创建容器，并非重启已有容器生效。

使用 Alpine 镜像的时区设置

Alpine 默认可能缺少时区文件，推荐使用以下 Dockerfile 片段：

FROM alpine:latest
RUN apk add --no-cache tzdata
ENV TZ=Asia/Shanghai