CapRover迁移服务器与更换根域名的完整指南

迁移前的准备工作

在CapRover平台迁移到新服务器时，需要特别注意SSL证书和域名配置的转移。以下是经过验证的完整迁移方案，比直接修改配置文件更为可靠。

标准迁移流程

1. 创建完整备份

   • 通过CapRover管理界面生成系统备份文件
   • 备份包含所有应用配置、数据库和证书信息

2. 新服务器准备

   • 在新服务器上安装相同版本的Docker和CapRover
   • 确保新服务器防火墙开放80/443端口

3. 恢复备份

   • 在新服务器CapRover界面恢复备份文件
   • 系统会自动重建所有服务和配置

特殊情况处理方案

当无法使用标准备份恢复时，可采用以下替代方案：

1. 停止所有容器

   docker stop $(docker ps -aq)
   

2. 修改SSL配置

   • 编辑配置文件：/captain/data/config-captain.json
   • 将所有force-ssl、has-ssl和hasRootSsl设为false

3. 清理旧证书

   rm -rf /captain/data/letsencrypt
   

4. 重启服务

   docker start $(docker ps -aq)
   

5. 重新配置

   • 通过IP地址访问CapRover管理界面
   • 设置新的根域名
   • 为各服务重新启用SSL

注意事项

1. 证书更新可能需要24-48小时完成
2. 确保新域名DNS已正确解析到新服务器IP
3. 迁移后检查所有服务的连通性
4. 建议在低峰期执行迁移操作

最佳实践建议

1. 始终保持CapRover版本一致
2. 迁移前测试备份文件的可用性
3. 记录所有自定义配置项
4. 考虑使用CI/CD管道自动化部署过程

通过以上步骤，可以确保CapRover平台平稳迁移到新环境，同时保持服务的连续性和安全性。