如何将Docker隐式命名卷数据迁移至主机显式挂载点

问题背景 #

当前使用默认Local卷实现PostgreSQL数据持久化，配置如下：

services:
  postgres:
    ...
    volumes:
      - pgdata:/var/lib/postgresql/data:Z
...

volumes:
  pgdata:
    driver: local

希望切换为绑定挂载到指定路径/my/path的配置，以此获得更直接的数据控制权，目标配置：

services:
  postgres:
    ...
    volumes:
      - pgdata:/var/lib/postgresql/data:Z
...

volumes:
  pgdata:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /my/path
      external: true

需求：将旧卷中的现有数据迁移到/my/path，确保切换后服务能正常读取原有数据。

可行迁移方案 #

方案一：提前手动迁移旧卷数据 #

步骤清晰可控，适合直接操作宿主机的场景：

1. 停止服务：关闭运行中的PostgreSQL容器

   docker-compose down
   

2. 定位旧卷存储路径：通过docker volume inspect获取默认Local卷的物理存储路径

   docker volume inspect pgdata
   

   从输出中找到Mountpoint字段，示例值：/var/lib/docker/volumes/your_project_name_pgdata/_data
3. 准备目标路径：创建/my/path并设置正确权限（PostgreSQL容器默认使用UID/GID 999）

   mkdir -p /my/path
   chown 999:999 /my/path
   

4. 完整复制数据：用cp -a保留文件权限与属性，将旧卷数据复制到目标路径

   cp -a /var/lib/docker/volumes/your_project_name_pgdata/_data/* /my/path/
   

5. 切换配置并启动服务：将docker-compose.yml修改为目标绑定挂载配置，启动服务

   docker-compose up -d
   

6. 验证与清理：进入容器确认数据正常后，可删除旧Local卷

   docker volume rm pgdata
   

方案二：临时挂载双卷实现容器内数据同步 #

无需直接操作Docker存储目录，更安全：

1. 停止服务：

   docker-compose down
   

2. 临时修改配置：给PostgreSQL服务添加额外挂载，将/my/path映射到容器内临时目录

   services:
     postgres:
       ...
       volumes:
         - pgdata:/var/lib/postgresql/data:Z
         - /my/path:/tmp/pgdata_migrate:Z
   

3. 容器内执行复制：启动临时容器完成数据复制，执行后自动销毁容器

   docker-compose run --rm postgres sh -c "cp -a /var/lib/postgresql/data/* /tmp/pgdata_migrate/"
   

4. 恢复最终配置：将docker-compose.yml改回目标绑定挂载配置，启动服务

   docker-compose up -d
   

5. 清理旧卷：验证数据正常后删除旧Local卷

注意事项 #

• 迁移前务必备份数据，可通过临时容器打包：

  docker run --rm -v pgdata:/data -v /your/backup/path:/backup alpine tar czf /backup/pgdata_backup.tar.gz -C /data .
  

• 确保/my/path所在磁盘有足够空间，权限设置错误会导致PostgreSQL启动失败
• 使用external: true时，无需手动创建绑定卷，Docker会自动关联指定路径

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