# 创建命名卷
podman volume create app-data

# 创建带标签的卷
podman volume create --label env=production --label app=myapp pgdata

# 创建带驱动选项的卷
podman volume create --opt type=tmpfs --opt device=tmpfs --opt o=size=100m tmp-vol

# 列出所有卷
podman volume ls

# 查看卷详情
podman volume inspect app-data

# 删除卷
podman volume rm app-data

# 清理未使用的卷
podman volume prune

# 基本使用
podman run -d --name db \
    -v pgdata:/var/lib/postgresql/data:Z \
    -e POSTGRES_PASSWORD=secret \
    postgres:16-alpine

# 只读挂载
podman run -d --name app \
    -v app-config:/app/config:ro,Z \
    myapp:latest

# 多个卷
podman run -d --name web \
    -v web-content:/usr/share/nginx/html:Z \
    -v web-logs:/var/log/nginx:Z \
    nginx:1.27-alpine

# Rootless 卷存储路径
ls ~/.local/share/containers/storage/volumes/

# Root 卷存储路径
ls /var/lib/containers/storage/volumes/

# 查看特定卷的实际路径
podman volume inspect --format '{{.Mountpoint}}' app-data

# 挂载目录
podman run -d --name web \
    -v /home/user/website:/usr/share/nginx/html:ro,Z \
    nginx:1.27-alpine

# 挂载单个文件
podman run -d --name web \
    -v /home/user/nginx.conf:/etc/nginx/nginx.conf:ro,Z \
    nginx:1.27-alpine

# 使用 --mount 语法（更明确）
podman run -d --name web \
    --mount type=bind,source=/home/user/website,target=/usr/share/nginx/html,readonly \
    nginx:1.27-alpine

# 绝对路径 vs 相对路径
podman run -v ./data:/data ...        # ❌ 不推荐，语义不明确
podman run -v /home/user/data:/data ... # ✅ 推荐，绝对路径

# ✅ 正确：私有挂载（容器独占）
podman run -d -v /data/app:/app:Z myapp:latest

# ✅ 正确：共享挂载（多容器共享）
podman run -d -v /data/shared:/shared:z app1:latest
podman run -d -v /data/shared:/shared:z app2:latest

# ❌ 错误：缺少标签（SELinux 会阻止）
podman run -d -v /data/app:/app myapp:latest
# 容器内可能无法读写 /app

# :Z 会重新标记目录的 SELinux 上下文
# 查看标签前
ls -Z /data/app
# unconfined_u:object_r:default_t:s0 /data/app

# 挂载后（:Z 自动 re-label）
podman run -d -v /data/app:/app:Z myapp:latest

# 查看标签后
ls -Z /data/app
# system_u:object_r:container_file_t:s0:c123,c456 /data/app

# tmpfs 挂载（内存文件系统，适合临时数据）
podman run -d --name app \
    --tmpfs /tmp:rw,size=100m,mode=1777 \
    myapp:latest

# 使用 --mount 语法
podman run -d --name app \
    --mount type=tmpfs,target=/tmp,tmpfs-size=100m \
    myapp:latest

# 多个 tmpfs
podman run -d --name app \
    --tmpfs /tmp:rw,size=100m \
    --tmpfs /run:rw,size=50m \
    --tmpfs /var/cache:rw,size=200m \
    myapp:latest

# 查看当前存储驱动
podman info --format '{{.Store.GraphDriverName}}'

# 查看存储详情
podman system info | grep -A10 store

# 配置存储驱动（全局）
sudo tee /etc/containers/storage.conf << 'EOF'
[storage]
driver = "overlay"

[storage.options]
# 额外的镜像存储位置
additionalimagestores = [
    "/mnt/shared/images",
]

[storage.options.overlay]
mountopt = "nodev,metacopy=on"
# 限制镜像层大小（可选）
size = ""
EOF

# 配置存储驱动（用户级）
mkdir -p ~/.config/containers
tee ~/.config/containers/storage.conf << 'EOF'
[storage]
driver = "overlay"

[storage.options.overlay]
mount_program = "/usr/bin/fuse-overlayfs"
mountopt = "nodev,metacopy=on"
EOF

# 查看镜像分层
podman history nginx:1.27-alpine

# 查看容器存储使用
podman system df -v

# PostgreSQL 持久化
podman volume create pgdata

podman run -d --name postgres \
    -v pgdata:/var/lib/postgresql/data:Z \
    -e POSTGRES_PASSWORD=secret \
    -e POSTGRES_DB=appdb \
    -p 5432:5432 \
    postgres:16-alpine

# 备份数据
podman exec postgres pg_dump -U postgres appdb > backup.sql

# 使用专用备份卷
podman volume create pg-backup
podman run --rm -v pg-backup:/backup:Z -v pgdata:/data:ro,Z \
    busybox tar czf /backup/pg-$(date +%Y%m%d).tar.gz /data

# 创建多个目录
mkdir -p /opt/webapp/{html,config,logs}

# 只读挂载配置和内容，读写挂载日志
podman run -d --name webapp \
    -v /opt/webapp/html:/usr/share/nginx/html:ro,Z \
    -v /opt/webapp/config:/etc/nginx/conf.d:ro,Z \
    -v /opt/webapp/logs:/var/log/nginx:Z \
    -p 80:80 \
    nginx:1.27-alpine

# 使用 Bind Mount 实现代码热重载
podman run -d --name dev-app \
    -v $(pwd)/src:/app/src:Z \
    -v $(pwd)/config:/app/config:Z \
    -p 3000:3000 \
    node:20-alpine \
    npm run dev

# 代码修改会立即反映到容器中

# 管理员创建共享镜像存储
sudo mkdir -p /mnt/shared/images
sudo podman --root /mnt/shared/images pull alpine:3.20
sudo podman --root /mnt/shared/images pull nginx:1.27-alpine

# 普通用户配置使用共享存储
cat >> ~/.config/containers/storage.conf << 'EOF'
[storage.options]
additionalimagestores = [
    "/mnt/shared/images",
]
EOF

# 用户可以直接使用共享镜像（无需重新拉取）
podman images

# 查看系统存储使用情况
podman system df

# 详细信息
podman system df -v

# 清理所有未使用的资源
podman system prune -a

# 仅清理镜像
podman image prune -a

# 仅清理卷
podman volume prune

# 仅清理容器
podman container prune

# 迁移存储目录（数据迁移）
# 1. 停止所有容器
podman stop --all

# 2. 备份
rsync -aP ~/.local/share/containers/storage/ /backup/containers/

# 3. 修改配置
# ~/.config/containers/storage.conf
[storage]
graphRoot = "/mnt/new-storage/containers/storage"
runRoot = "/run/user/1000/containers"

# 4. 重新初始化
podman system reset