Podman 部署 InfoCloud 容器时区配置笔记

问题背景

使用 Podman 部署的 InfoCloud 容器内缺少 /usr/share/zoneinfo 和 /etc/localtime 文件，导致容器时区不正确。

解决方案汇总

方案一：重建容器（推荐）

使用 Podman 原生的 --tz=local 参数，让容器自动同步宿主机时区。

# 停止并删除旧容器（数据卷不会丢失）
podman stop infcloud
podman rm infcloud

# 使用 --tz=local 重新创建容器
podman run -d \
  --name infcloud \
  --tz=local \
  [其他参数如 -v、-p 等] \
  [镜像名称]

优点：一劳永逸，官方推荐
适用版本：Podman 2.1+

方案二：Podman Compose 配置

Podman Compose 没有 --tz 直接参数，可通过以下方式实现：

方式 A：使用环境变量（推荐）

# podman-compose.yml
version: '3'
services:
  infcloud:
    image: your-image-name
    environment:
      - TZ=Asia/Shanghai   # 设置时区
    # 其他配置...

方式 B：挂载宿主机时区文件

services:
  infcloud:
    image: your-image-name
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro   # 可选
    # 其他配置...

方式 C：Quadlet 配置（systemd 集成）

# infcloud.container
[Container]
Image=your-image-name
Timezone=Asia/Shanghai
Environment=PUID=1000,PGID=1000

完整示例

version: '3'
services:
  infcloud:
    image: your-image-name
    container_name: infcloud
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - ./data:/data
    ports:
      - "8080:80"
    restart: unless-stopped

方案三：手动复制时区文件到容器

适用于容器内缺少 /usr/share/zoneinfo 目录的情况。

快速操作（一条命令）

# 创建目录、复制文件、创建软链接
podman exec infcloud sh -c "mkdir -p /usr/share/zoneinfo/Asia && \
                            exit" && \
podman cp /usr/share/zoneinfo/Asia/Shanghai infcloud:/usr/share/zoneinfo/Asia/Shanghai && \
podman exec infcloud ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

分步操作

# 1. 进入容器
podman exec -it infcloud /bin/sh

# 2. 创建目录（容器内执行）
mkdir -p /usr/share/zoneinfo/Asia

# 3. 退出容器
exit

# 4. 复制时区文件
podman cp /usr/share/zoneinfo/Asia/Shanghai infcloud:/usr/share/zoneinfo/Asia/Shanghai

# 5. 创建软链接
podman exec -it infcloud /bin/sh -c "ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime"

# 6. 验证时区
podman exec infcloud date

注意：容器重启后修改会丢失，仅适用于临时测试。

方案四：重新构建镜像（长期方案）

创建 Dockerfile：

FROM your-infcloud-base-image

# Alpine 系统
RUN apk add --no-cache tzdata

# 或 Debian/Ubuntu 系统
# RUN apt-get update && apt-get install -y tzdata

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

构建并运行：

podman build -t infcloud:latest .
podman run -d --name infcloud infcloud:latest

方法对比

验证时区是否生效

# 查看容器时间
podman exec infcloud date

# 进入容器查看时区设置
podman exec -it infcloud /bin/sh
date
cat /etc/timezone   # 如果有此文件

常见问题

Q：容器内没有 /usr/share/zoneinfo 目录怎么办？

A：使用方案一（--tz=local）或方案三（手动创建目录后复制）。

Q：重启容器后时区又变回去了？

A：手动复制的方式会丢失，改用方案一、二或四。

Q：Alpine 镜像如何安装时区支持？

A：podman exec infcloud apk add tzdata

Q：如何找回原容器的创建参数？

A：podman inspect infcloud | grep -A 10 "CreateCommand"

最佳实践建议

1. 新部署：直接使用 --tz=local 或 Compose 的 TZ 环境变量
2. 已部署容器：重建容器（方案一）比手动修改更可靠
3. 生产环境：使用 Dockerfile 构建自定义镜像（方案四）
4. 快速测试：手动复制文件（方案三）

最后更新：2026-04-17