---
title: "Docker timezone 時區問題"
url: https://geminixiang.com/posts/docker-timezone/
description: "Docker 容器時間不對？兩種修正方式：掛載主機的 /etc/localtime，或設定 TZ 環境變數（推薦）；alpine image 還需要先安裝 tzdata。"
published: 2022-08-15
category: "DevOps"
tags: ["python", "trick", "docker"]
---

# Docker timezone 時區問題

# Docker Timezone 時區問題

## 方法一： 將本機的時間帶到 image 當中

when `docker run some-image`

```
-v /etc/localtime:/etc/localtime:ro
```

docker-compsoe.yml

```yml
services:
  some-container:
    volumes:
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
```

## 方法二(推薦)： 設定環境變數

when `docker run some-image`

```
-e "TZ=Asia/Taipei"
```

docker-compose.yml

```yml
sevices:
  some-container:
    environment:
      TZ: Asia/Taipei
```

# 例外

如果使用到 alpine 版本

則需要自行重新 build image

Dockerfile 先添加以下兩行，再進行上述操作

```dockerfile
RUN apk update && \
    apk add -U tzdata

---

## About the author

**Ying Xiang Zhao** (geminixiang) — DevOps Engineer, Taipei, Taiwan.

Ying Xiang Zhao（geminixiang）是住在台北的 DevOps 工程師，工作橫跨雲原生基礎設施、CI/CD、ML 模型部署與全端開發。這個部落格記錄 infra、資安與 AI coding agent 的實戰筆記；作品包含開源專案 mikan（把 AI coding agent 帶進 Slack / Telegram / Discord）與 tiny-agent（用四種語言實作的極簡 coding agent），瀏覽器內的影片編輯器 Studio，並經營旅遊分帳工具 SentriPay。

**Open to work** — DevOps Engineer / Platform Engineer / Site Reliability Engineer / AI Infrastructure Engineer · Taipei, Taiwan / Remote. Résumé: https://geminixiang.com/about/ (JSON: https://geminixiang.com/resume.json)

Topics: DevOps, Cloud Native, Kubernetes, Docker, Terraform, Google Cloud, CI/CD, Security, AI coding agents, ML model deployment, TypeScript, Python

Projects:
- [mikan](https://github.com/geminixiang/mikan) — Self-hosted AI coding agent for Slack, Telegram, Discord and GitHub with per-conversation sandboxes
- [tiny-agent](https://github.com/geminixiang/tiny-agent) — Minimal AI coding agents in TypeScript, Go, Python and Rust, plus a book on how they work
- [SentriPay](https://sentripay.com) — Travel expense splitter with multi-currency conversion and shareable, live-synced trip ledgers
- [Studio](https://studio.geminixiang.com) — Browser-based video editor built on WebCodecs

[About](https://geminixiang.com/about/) · [Résumé](https://geminixiang.com/about/) · [LinkedIn](https://linkedin.com/in/geminixiang/) · [GitHub](https://github.com/geminixiang) · [Twitter](https://x.com/geminixiang)