升级
本文说明 Bring 外贸扩展的升级步骤与注意事项。
请勿自行升级 EspoCRM 核心
安装 Bring 外贸扩展后，系统会自动禁用 EspoCRM 核心升级（adminUpgradeDisabled）。在 管理 面板尝试升级 Espo 时会提示：已禁用系统升级：升级 EspoCRM 可能导致外贸模块无法正常运行。请仅通过 BringCRM 兼容版本进行升级。
请仅升级 Bring 外贸扩展；EspoCRM 版本由 BringCRM 官方 Docker 镜像或安装包统一维护，勿手动更换 espocrm/espocrm 镜像 tag 或按 Espo 官方文档升级核心。
升级前
- 备份（必做）
- 整站（推荐）：宝塔面板 → Docker → 容器编排 → 选中 BringCRM 编排项目 → 备份
- 非宝塔环境：执行
backup-docker-container.sh，或在 Espo 管理 → 备份与恢复 做整库备份 - 业务数据（可选）：管理 → Bring外贸 → 数据备份与恢复 → 手动备份（便于单独迁移外贸业务数据）
- 记录当前版本：管理 → Bring外贸 → 检查更新（页面显示当前扩展版本）
- 阅读新版本发布说明（检查更新页「更新说明」，如有数据库结构变更请留意）
升级 Bring 外贸扩展
升级包由系统在服务器上下载并覆盖安装，不要从第三方渠道获取 zip，也不要先卸载旧版。
- 使用管理员登录
- 进入 管理 → Bring外贸 → 检查更新
- 点击 检查更新，确认有新版本可用
- 若状态为「有新版本可升级」：点击 一键升级 并确认
- 需已激活 Bring外贸许可，且订阅在有效期内；未激活或许可过期时无法升级
- 服务器会下载升级包并走与「管理 → 扩展」相同的覆盖安装
- 如已改过左侧菜单且不想被重排：先在本页取消 安装扩展时覆盖左侧导航，再点左上角 保存，然后再一键升级
- 完成后页面会自动刷新；若样式异常可再 强制刷新（Ctrl+F5）
升级时会改什么
四个默认角色权限仍按模板覆盖。PDF/Excel/Word/导入模板与货币列表一般只补缺失（已有同名 Word 模板不覆盖）。 左侧导航：默认按系统结构覆盖。若不想被改，先到 管理 → Bring外贸 → 检查更新 取消 安装扩展时覆盖左侧导航 并 保存。
Docker 环境
- 升级前在宝塔 Docker → 容器编排 中对项目执行 备份（与上文必做项一致）；非宝塔环境再备份数据卷与数据库
- 按上文「升级 Bring 外贸扩展」在 Espo 管理后台完成扩展安装
- 不要为升级 Espo 而修改
docker-compose.yml中的espocrm/espocrm镜像版本并pull；BringCRM 整体版本升级请关注官网发布说明 - 确认 cron/daemon 容器仍在运行（邮件、定时任务、自动备份等）
升级后验证
- 能登录，首页无 500 错误
- 外贸菜单完整
- 管理 → Bring外贸 → 检查更新 显示的新版本号与预期一致
- 打开报价单/销售单详情正常
- 打印 PDF 正常
- 管理 → Bring外贸 → Bring外贸许可 仍有效
- Cron/daemon 容器运行中
回滚
- 恢复升级前整站备份（宝塔编排备份包、Docker 脚本备份或 Espo 备份 zip）
- 业务数据单独回滚见 数据备份与恢复
常见问题
检查更新提示需要许可或订阅？
- 在 管理 → Bring外贸 → Bring外贸许可 激活；订阅过期需续订后再一键升级
一键升级失败？
- 确认服务器能访问许可下载地址，且磁盘空间足够
- 执行 管理 → Rebuild 后重试；查看
data/logs/espo-*.log - 请求超时（安装脚本较久）时，可加大 PHP / 反向代理超时后重试
能否升级 EspoCRM 到最新版？
- 不能。安装外贸扩展后核心升级入口已禁用；请等待 BringCRM 官方发布包含兼容 Espo 版本的整体更新
模板被覆盖？
- 新版安装逻辑应跳过已有模板；若被覆盖可从备份 zip 恢复 Excel/导入模板