如何从MongoDB Atlas创建本地备份？

mongodump是MongoDB官方提供的工具，完全支持从MongoDB Atlas集群导出数据到本地，是官方认可的离线备份方式之一，下面是具体的操作步骤和参数说明：

1. 准备Atlas连接信息 #

登录MongoDB Atlas控制台，进入目标集群：

• 点击「Connect」→「Connect with MongoDB Shell」
• 复制生成的连接字符串，记得替换字符串中的<username>、<password>（密码中的特殊字符需做URL编码）和<dbname>（单库备份时指定）

2. 基础备份命令 #

备份单个数据库 #

mongodump --uri "mongodb+srv://<username>:<password>@cluster0.mongodb.net/<your-db-name>" --out ./local-db-backup

备份整个集群（所有数据库） #

去掉URI中的数据库名称即可：

mongodump --uri "mongodb+srv://<username>:<password>@cluster0.mongodb.net/" --out ./full-cluster-backup

3. 常用可选参数 #

• --gzip：对备份文件启用压缩，大幅减少占用空间，示例：

  mongodump --uri "mongodb+srv://<username>:<password>@cluster0.mongodb.net/<your-db-name>" --gzip --out ./compressed-backup
  

• --collection <collection-name>：仅备份指定集合，适合只需要部分数据的场景：

  mongodump --uri "mongodb+srv://<username>:<password>@cluster0.mongodb.net/<your-db-name>" --collection <target-collection> --out ./collection-backup
  

• --username/--password：如果不想在URI中明文写密码，可以单独传入这两个参数：

  mongodump --uri "mongodb+srv://<username>@cluster0.mongodb.net/<your-db-name>" --password <your-password> --out ./local-backup
  

4. 关键注意事项 #

• 本地必须安装MongoDB工具包（包含mongodump），版本建议与Atlas集群的MongoDB版本保持一致或接近，避免兼容性问题
• 确认Atlas集群的IP白名单已添加本地机器的公网IP，否则会触发连接拒绝
• M0免费集群的mongodump存在性能限制，大数据库备份可能耗时较长，建议在低峰期操作

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