迁移概述
本文介绍使用mongodump模式完成FastGPT的Docker环境MongoDB数据库迁移的方法，适用于将现有部署的FastGPT数据迁移至新的Docker环境。需提前确认源环境、目标环境的MongoDB版本兼容，且提前在源、目标及过渡环境创建对应备份目录。
详细迁移步骤
- 目录准备
在源环境的FastGPT容器内创建临时备份目录，该目录会自动同步至宿主机的FastGPT安装目录下的Data/backup：
```bash docker exec -it fastgpt sh mkdir -p /data/backup
``` 同时在目标环境创建备份目录，注意不要放在fastgpt/data目录下：
```bash mkdir -p /fastgpt/mongobackup
```
- 导出源环境数据
在源环境服务器本地执行导出命令，无需进入容器，需替换其中的username、password为实际的MongoDB认证信息：
```bash docker exec -it mongo bash -c "mongodump --db fastgpt -u username -p password --authenticationDatabase admin --out /data/backup"
``` 若文件未自动同步至宿主机，可使用以下命令手动拷贝：
```bash docker cp mongo:/data/backup [A环境本地fastgpt目录]:/fastgpt/data/backup
```
- 压缩与传输备份文件
进入源环境宿主机的FastGPT数据目录，压缩备份文件：
```bash cd /usr/fastgpt/mongo/data tar -czvf ../fastgpt-mongo-backup-$(date +%Y-%m-%d).tar.gz ./
``` 使用scp命令将压缩包传输至目标环境或过渡环境，需替换其中的密钥路径、服务器地址和目标路径：
```bash scp -i /Users/path/your-pem-file.pem root@[源服务器地址]:/usr/fastgpt/mongo/fastgpt-mongo-backup-$(date +%Y-%m-%d).tar.gz [目标路径]
```
- 导入数据至目标环境
在目标环境宿主机解压备份文件：
```bash tar -xvzf fastgpt-mongo-backup-2024-05-03.tar.gz -C /fastgpt/mongobackup/data
``` 解压后可检查bson文件的数量，确认文件完整后即可导入目标MongoDB。
迁移注意事项
迁移过程中需注意备份文件的完整性，若跨环境传输后文件数量不一致，可能导致导入后无数据。建议先在过渡环境校验解压后的文件，确认无误后再传输至目标环境。同时需确保目标环境的MongoDB版本符合FastGPT的兼容要求。
来源：https://doc.fastgpt.cn/zh-CN/self-host/migration/docker_mongo