迁移到新服务器
将 BringCRM 迁移到新主机需同时考虑 Espo 整站、Docker 编排 与 Bring 业务数据。
参考：Moving to another server（英文）
迁移前清单
- [ ] 通知用户停机窗口
- [ ] 记录当前 Espo 版本、Bring 扩展版本
- [ ] 记录专业版激活状态（需在新站重新激活或迁移 config）
- [ ] 完整备份（见下文）
方案 A：Docker 整站迁移（推荐）
旧服务器
./backup-docker-container.sh
# 得到 bringcrm_YYYY-MM-DD_HHMMSS.tar.gz
新服务器
- 安装 Docker / 宝塔，部署相同结构 docker-compose.yml
- 首次启动 Espo（或恢复卷）
./restore-docker-container.sh bringcrm_xxx.tar.gz- 修改 compose 中 Site URL / WebSocket URL 为新 IP 或域名
docker restart相关容器- 防火墙放行端口
- 验证登录、外贸菜单、PDF、Cron
DNS
域名指向新 IP；管理 → 设置 → Site URL 更新为 https://新域名。
方案 B：Espo 原生备份包
- 旧站 管理 → 备份与恢复 下载备份
- 新站安装同版本 Espo + 相同 PHP 环境
- 安装 Bring 扩展 zip + Rebuild
- 恢复 备份包
- Rebuild、清除缓存
- Bring 专业版许可 重新激活（若 config 未含许可）
方案 C：仅迁移 Bring 业务数据
- 新站已装 Espo + Bring 扩展 + 用户角色已建好
- 旧站 Bring 数据备份 下载 zip
- 新站 数据备份与恢复 上传恢复
- 手动补：用户、邮箱、PDF 模板（若未在 Bring 包内）、系统设置
适合 换库但保留新站配置 的场景。
迁移后验证
| 项 | 检查 |
|---|---|
| 登录 | 内外部用户 |
| 客户/订单数据 | 抽样 |
| 打印 PDF / Excel | 模板是否存在 |
| 邮件 | Cron + 试发 |
| WebSocket | 通知实时 |
| 专业版功能 | 许可页 |
| Cron | 计划任务 Log 正常 |
自定义字段与布局
在 custom/Espo/Custom 的自定义若已复制到新站并 Rebuild，布局与字段应一致；仅 Bring zip 恢复 不含 custom 目录时需在旧站单独复制 custom。