docker alpine linux中设置时区

### 🤖 Assistant

在 Alpine Linux 中设置时区可通过以下步骤完成：

---

### **1. 安装时区数据包**
```bash
apk add --no-cache tzdata
```

---

### **2. 设置时区（以 Asia/Shanghai 为例）**
#### **方法一：符号链接方式（推荐）**
```bash
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
```

#### **方法二：复制时区文件**
```bash
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
```

---

### **3. 验证时区**
```bash
date
# 输出示例：Tue Mar  2 15:30:45 CST 2024
```

---

### **4. Docker 容器中的完整配置**
在 Dockerfile 中配置：
```
FROM alpine:3.18

# 安装时区工具
RUN apk add --no-cache tzdata

# 设置时区
ENV TZ=Asia/Shanghai
RUN ln -sf /usr/share/zoneinfo/$TZ /etc/localtime

# 可选：清理缓存（已通过 --no-cache 实现）
# 其他应用安装...
```

---

### **5. 临时运行时修改（无需重建镜像）**
启动容器时覆盖时区：
```bash
docker run -it --rm \
  -e TZ=Asia/Shanghai \
  -v /usr/share/zoneinfo/Asia/Shanghai:/etc/localtime:ro \
  your-image
```

---

### **常见问题排查**
1. **时区文件不存在**：
   ```bash
   # 检查时区文件路径
   ls /usr/share/zoneinfo/Asia/Shanghai
   # 如果不存在，重新安装 tzdata
   apk fix && apk add tzdata --force
   ```

2. **应用不识别时区**：
   ```bash
   # 同时设置环境变量
   export TZ=Asia/Shanghai
   ```

3. **Docker 容器时间同步**：
   ```bash
   # 启动时挂载宿主机时间
   docker run -v /etc/localtime:/etc/localtime:ro
   ```

---

### **时区对照表**
| 地区              | 时区文件路径                   |
|-------------------|-------------------------------|
| 上海              | `/usr/share/zoneinfo/Asia/Shanghai` |
| 香港              | `/usr/share/zoneinfo/Asia/Hong_Kong` |
| 台北              | `/usr/share/zoneinfo/Asia/Taipei` |
| 纽约              | `/usr/share/zoneinfo/America/New_York` |
| UTC               | `/usr/share/zoneinfo/UTC`     |

---

通过以上方法，您可以在 Alpine Linux 系统中快速完成时区配置，无论是物理机、虚拟机还是容器环境都能生效。