挂载宿主机 /etc/localtime 是确保容器时区一致最常用、最轻量的方法，因其直接同步真实时区数据（如 Asia/Shanghai 符号链接），使 glibc 等库能正确计算本地时间偏移；需配合 -v /etc/localtime:/etc/localtime:ro 和推荐的 -v /etc/timezone:/etc/timezone:ro，并注意宿主机时区已校准、Alpine 需额外安装 tzdata、必须只读挂载。

直接挂载宿主机的 /etc/localtime 是确保容器时区与宿主机一致最常用、最轻量的方法。它不依赖容器内是否安装 tzdata，也不需要额外服务，只要宿主机时间本身准确，挂载后容器就能实时反映本地时间。

为什么挂载 /etc/localtime 有效

/etc/localtime 在 Linux 中不是一个普通文件，而是指向 /usr/share/zoneinfo/ 下某个时区数据的符号链接（如 Asia/Shanghai）或完整复制文件。glibc 等运行时库在格式化时间时会读取它来计算本地偏移和夏令时规则。挂载后，容器内程序调用 date、strftime() 或日志框架输出时间，都会基于这个真实时区数据做转换。

标准挂载命令写法

启动容器时添加以下两个只读挂载：

• -v /etc/localtime:/etc/localtime:ro —— 同步时区定义（必需）
• -v /etc/timezone:/etc/timezone:ro —— 同步时区名称字符串（推荐，尤其对 Debian/Ubuntu 系基础镜像）

完整示例：

docker run -d \
-v /etc/localtime:/etc/localtime:ro \
-v /etc/timezone:/etc/timezone:ro \
--name myapp nginx

验证是否生效

进入容器后执行：

• date —— 查看当前时间与宿主机是否完全一致（包括秒级）
• ls -l /etc/localtime —— 检查是否为有效链接，例如 /etc/localtime -> /usr/share/zoneinfo/Asia/Shanghai
• cat /etc/timezone —— 输出应为对应时区名，如 Asia/Shanghai

若 date 显示 UTC 或明显偏差，说明挂载未成功或宿主机自身未校准。

注意事项与常见问题

• 宿主机必须已正确设置时区并启用 NTP 校时（如 sudo timedatectl set-ntp true），否则挂载的是错误时间
• Alpine 镜像默认不读取 /etc/localtime，需额外安装 tzdata：RUN apk add --no-cache tzdata
• 挂载必须是 :ro（只读），避免容器意外修改宿主机时区配置
• 不要挂载整个 /etc 或使用 bind mount 覆盖其他关键文件，仅限这两个路径