Docker环境下Rails应用的PostgreSQL数据库文件夹跨系统迁移方法

方案1：PostgreSQL Dump/Restore（最通用，无环境兼容问题） #

这是跨环境迁移PostgreSQL数据的标准做法，完全避开直接迁移数据目录的权限、版本兼容问题：

• 导出数据：在原系统中，通过Docker执行pg_dump命令导出全量数据：

  # 替换<容器名>、<用户名>、<数据库名>为你的实际配置
  docker exec <postgres容器名> pg_dump -U <数据库用户名> <数据库名> > db_backup.sql
  # 若要压缩节省空间，可使用：
  docker exec <postgres容器名> pg_dump -U <数据库用户名> <数据库名> | gzip > db_backup.sql.gz
  

• 同步备份文件：将生成的db_backup.sql（或压缩包）上传至云盘、Git LFS（小数据量），或直接传输到目标系统。
• 导入数据：在新系统中，先启动Docker环境的PostgreSQL容器（确保Rails已通过rails db:create创建好空数据库），再执行导入：

  # 导入未压缩的备份
  cat db_backup.sql | docker exec -i <postgres容器名> psql -U <数据库用户名> <数据库名>
  # 导入压缩备份
  gunzip -c db_backup.sql.gz | docker exec -i <postgres容器名> psql -U <数据库用户名> <数据库名>
  

方案2：Docker卷打包迁移（保留本地数据库场景） #

如果你需要保留本地PostgreSQL实例，可通过Docker卷的打包/恢复解决之前的目录迁移配置问题，核心是严格匹配PostgreSQL版本：

• 打包原系统的Docker卷：假设你的PostgreSQL容器使用命名卷postgres_data（在docker-compose.yml中配置），执行打包：

  # 将卷内容打包为tar.gz
  docker run --rm -v postgres_data:/data -v $(pwd):/backup alpine tar czf /backup/postgres_volume.tar.gz -C /data .
  

• 在新系统恢复卷：
  1. 先创建同名的空Docker卷：docker volume create postgres_data
  2. 解压备份到卷中：

  docker run --rm -v postgres_data:/data -v $(pwd):/backup alpine tar xzf /backup/postgres_volume.tar.gz -C /data
  

  3. 启动Docker容器时，确保使用与原系统完全相同版本的PostgreSQL镜像（比如postgres:14-alpine，不能换成15），否则会因数据目录结构不兼容启动失败。

方案3：使用云端PostgreSQL服务（彻底免除本地迁移） #

如果频繁切换开发系统，直接用云端数据库是最省心的方案，所有系统共享同一数据源：

• 选择开发级云端服务：比如Supabase、Neon、AWS RDS免费版等，创建数据库实例后获取连接信息（主机地址、用户名、密码、数据库名）。
• 修改Rails配置：更新config/database.yml的开发环境配置，指向云端数据库：

  development:
    adapter: postgresql
    encoding: unicode
    database: <云端数据库名>
    username: <云端用户名>
    password: <云端密码>
    host: <云端数据库地址>
    port: 5432
  

• 迁移现有数据：用方案1的pg_dump导出本地数据，再导入到云端数据库，之后所有开发系统直接连接云端即可。

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