数据备份与恢复
Bring 外贸提供面向业务数据的备份与恢复，便于迁移、归档或误操作回滚。生产环境通常需要 两层备份：整站备份（灾难恢复、换机）与 Bring 业务备份（单独迁移外贸数据）。
与 Espo 原生备份的区别
Espo 管理后台另有「备份与恢复」（整库 SQL + 文件）。Bring 备份针对外贸模块业务实体打包为 zip，更适合业务数据迁移；用户账号、角色、邮箱配置等不在 Bring 备份范围内。整站迁移可同时参考 Espo 文档：Backup and restore
备份方式总览
| 方式 | 入口 | 适合场景 |
|---|---|---|
| 宝塔 Docker 容器编排备份（推荐） | 宝塔 → Docker → 容器编排 | 整站灾难恢复、升级前必做、换机 |
| Espo 原生备份 | 管理 → 备份与恢复 | 非宝塔环境整库备份 |
| Docker 脚本 | backup-docker-container.sh |
命令行整站备份 |
| Bring 业务备份 | 管理 → Bring外贸 → 数据备份与恢复 | 单独迁移/归档外贸业务数据 |
升级前备份步骤与 升级 文档一致：优先做宝塔编排整站备份，再选手动 Bring 业务备份。
宝塔面板：Docker 容器编排备份（整站）
BringCRM 官方 Docker 部署（见 安装和部署）在宝塔中表现为一个 容器编排项目。备份该项目会一并保存数据库、站点文件与编排配置，适合升级、换机、整站回滚。
创建备份
- 登录 宝塔面板
- 左侧进入 Docker → 容器编排
- 找到 BringCRM 对应的编排项目（安装时填写的项目名称）
- 点击该项目行的 备份
- 等待备份完成；宝塔会生成备份包，可在编排项目的备份列表中查看
建议
- 升级扩展前必做（见 升级）
- 定期备份（如每周），备份文件下载到本机或对象存储
- 数据量大时避开业务高峰
从编排备份恢复
- Docker → 容器编排 → 同一项目（或新建项目后导入）
- 打开 备份 列表，选择升级/误操作之前的备份点
- 执行 恢复（界面可能显示「还原」等，以宝塔当前版本为准）
- 恢复完成后确认各容器（含 espocrm-daemon）处于运行状态
- 浏览器访问站点，检查登录、外贸菜单、PDF 打印
恢复会覆盖当前整站数据
仅在确认要回滚时使用。若只需回滚外贸业务数据，见下文 Bring 业务备份与恢复 一节。
非宝塔环境
无宝塔时使用项目脚本或 Espo 原生备份：
- 脚本：
docker_trade/linux/backup-docker-container.sh→ 生成bringcrm_日期时间.tar.gz；恢复用restore-docker-container.sh - 或 Espo 管理 → 备份与恢复 下载整库包
Bring 业务备份与恢复
面向外贸模块业务实体的 zip 备份，与整站备份互补，不能替代用户/角色/邮箱等系统配置。
入口
管理 → Bring外贸 → 数据备份与恢复
备份包含的内容
- 业务实体：客户、联系人、报价单及明细、销售单及明细、采购单及明细、出运单及明细、样品寄送、产品、供应商、货代、应收应付、收付款、退税、利润、资金账户与调账、检测相关等
- 跟进日志（Stream）：上述业务记录上的跟进与系统动态
- 附件：业务记录关联的图片与文件
- 模板：Excel / Word 单证模板、导入模板配置
不包含的内容
恢复后需重新配置：
- 用户、团队、角色与权限
- 系统设置、许可与激活信息
- 邮箱账户（SMTP/IMAP）
- 邮件收发记录、导入历史、客户查重记录等
备份设置
| 选项 | 说明 |
|---|---|
| 启用自动定时备份 | 按计划自动执行 |
| 每几天备份一次 | 间隔天数 |
| 备份时间 | 每日执行时刻（服务器时区） |
建议
数据量很大时可关闭自动备份，仅用手动备份，避免高峰时段占用资源。整站层面仍应保留宝塔编排或 Espo 定期全备。
页头 保存 / 取消 与 Espo 其他设置页相同。点击 保存 后自动备份计划生效。
手动备份
- 在页头点击 手动备份
- 任务进入队列，完成后系统通知
- 最近备份 列表显示文件名、大小、创建时间
- 系统保留最近 30 个备份包，超出自动删除最旧文件
备份包为 .zip，内含各实体 CSV 及 backup-report.txt 报告。
从备份恢复
- 上传备份 zip 或选择已有备份
- 点击 恢复
- 系统在后台按依赖顺序导入
恢复会覆盖或更新现有业务数据
操作前请确认环境（建议先在测试环境验证）。完成后查看通知与导入结果中的错误行。
三种备份如何配合
| 需求 | 推荐做法 |
|---|---|
| 日常防灾难、升级前 | 宝塔 容器编排 → 备份 |
| 只迁外贸订单/客户等业务 | Bring 数据备份与恢复 导出 zip，新站恢复 |
| 换服务器整站搬家 | 宝塔编排备份恢复，或 Docker 脚本 + 迁移指南 |
| 升级扩展后回滚 | 恢复升级前的 宝塔编排备份；业务 zip 仅用于补回单独导入的数据 |
常见问题
Q：升级前只做了 Bring 业务备份够吗？
- 不够。升级扩展可能影响数据库结构与全站文件，务必先做 升级文档 中的 宝塔编排整站备份。
Q：入口打不开或提示无权限？
- 确认当前用户为管理员，或角色有备份功能权限
- 整站异常时联系部署方检查 管理 → Bring外贸 → 许可
Q：备份失败？
- 查看 zip 内
backup-report.txt及系统通知 - 检查磁盘空间
data/foreign-trade-backups/
Q：恢复后模板还在吗？
- Excel/导入模板若在 Bring 备份范围内会一并恢复；PDF 模板属于 Espo Template 实体，整站迁移时用宝塔编排备份或 Espo 原生备份更完整