如何通过Podman迁移Nextcloud数据至其他主机并保持非root权限

源主机操作 #

1. 停止运行中的Pod #

先停止Nextcloud相关Pod，避免数据写入不一致：

podman pod stop <nextcloud-pod-id或名称>
# 若源主机不再使用该Pod，可删除Pod（数据卷会保留）
podman pod rm <nextcloud-pod-id或名称>

2. 定位数据卷路径 #

列出Nextcloud和数据库对应的卷，确认目标数据位置：

podman volume ls | grep -E "nextcloud|mariadb|postgres"

查看具体卷的挂载路径（rootless模式下通常在用户目录下）：

podman volume inspect <卷名称> | grep "Mountpoint"

示例路径：~/.local/share/containers/storage/volumes/<卷名称>/_data

3. 用podman unshare制作权限一致的归档 #

rootless Podman依赖UID/GID映射，直接用tar会丢失容器内权限信息，必须在podman unshare命名空间内打包：

podman unshare tar -czpf nextcloud-backup.tar.gz \
  -C ~/.local/share/containers/storage/volumes/<nextcloud卷名称> _data \
  -C ~/.local/share/containers/storage/volumes/<数据库卷名称> _data

参数说明：

• -czpf：启用gzip压缩、保留文件权限/属性、指定归档文件名
• -C：切换到目标目录后打包，避免归档包含冗余路径

目标主机操作 #

1. 匹配源主机用户环境 #

创建与源主机相同UID/GID的非root用户（若不存在）：

# 假设源主机用户UID为1000，GID为1000
useradd -u 1000 -m nextcloud-user
su - nextcloud-user

确保该用户已配置rootless Podman（执行过podman system migrate）。

2. 传输归档文件 #

用scp或rsync将归档文件传到目标主机用户目录：

scp nextcloud-backup.tar.gz nextcloud-user@目标主机IP:/home/nextcloud-user/

3. 用podman unshare恢复数据 #

先创建与源主机同名的数据卷，再在podman unshare环境下解压：

# 创建对应空卷
podman volume create <nextcloud卷名称>
podman volume create <数据库卷名称>

# 解压归档至数据卷
podman unshare tar -xzpf nextcloud-backup.tar.gz \
  -C ~/.local/share/containers/storage/volumes/<nextcloud卷名称> \
  -C ~/.local/share/containers/storage/volumes/<数据库卷名称>

4. 重新部署Nextcloud Pod #

使用与源主机完全一致的Pod定义（如podman-compose.yml或podman run命令）创建并启动Pod，确保卷名称匹配：

# 示例：用podman-compose启动（若之前用该方式部署）
podman-compose up -d

5. 验证权限与数据 #

进入Nextcloud容器检查文件权限：

podman exec -it <nextcloud容器ID> bash
ls -l /var/www/html/data

确保文件UID/GID与容器内运行用户（通常为www-data，UID 33）一致，数据库容器同理验证数据目录权限。

• 全程使用同UID的非root用户操作：rootless Podman的权限映射基于主机用户UID，不同UID会导致容器无法识别文件权限。
• 必须通过podman unshare执行打包/解压：该命令会进入Podman的用户命名空间，确保tar正确识别容器内的UID/GID映射关系。
• 禁止直接用普通tar命令操作：否则会丢失容器权限信息，导致迁移后出现权限拒绝错误。

内容的提问来源于stack exchange，提问作者cobran89