升级
本文说明 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外贸 → Bring外贸许可（页面显示当前扩展版本）
- 阅读新版本发布说明（本页「更新说明」，如有数据库结构变更请留意）
升级 Bring 外贸扩展
升级包由系统在服务器上下载并覆盖安装，不要从第三方渠道获取 zip，也不要先卸载旧版。
- 使用管理员登录
- 进入 管理 → Bring外贸 → Bring外贸许可
- 点击 检查更新，确认有新版本可用
- 若状态为「有新版本可升级」：点击 一键升级 并确认
- 需已开通许可，且升级服务仍在有效期内；未开通或升级服务过期时无法升级，请联系部署方
- 系统会先备份业务数据，再下载升级包，并用与「管理 → 扩展」相同的覆盖安装
- 如已改过左侧菜单且不想被重排：先在本页取消 安装扩展时覆盖左侧导航，再点该面板右上角 保存，然后再一键升级
- 完成后页面会自动刷新；若样式异常可再 强制刷新（Ctrl+F5）
管理员打开 管理 首页时，若每日定时检查已发现新版本，面板上会有提示，点链接进入许可页升级。
升级时会改什么
请到 管理 → Bring外贸 → Bring外贸许可 页面的「安装行为选项」面板查看/调整。默认行为如下：
- 左侧导航、仪表盘布局、默认角色：默认覆盖。
- PDF/Excel/Word/导入模板、演示用户、默认团队、示例公司：默认不覆盖/不重复创建（首次安装除外）。
若你希望升级时某项也执行，在安装包升级前打开对应开关并保存；若想保留现有自定义内容，关闭对应开关即可。未勾选「覆盖模板」时，仍会补上尚未存在的 Word 单证模板。货币列表等其它配置一般只补缺失项。预置统计报表、客户区域/筛选/标签、默认跟进规则只在首次安装写入。
升级不会把当前仪表盘另存一份。卸载扩展后，首页恢复为 Espo 默认看板。
Docker 环境
- 升级前在宝塔 Docker → 容器编排 中对项目执行 备份（与上文必做项一致）；非宝塔环境再备份数据卷与数据库
- 按上文「升级 Bring 外贸扩展」在 Espo 管理后台完成扩展安装
- 不要为升级 Espo 而修改
docker-compose.yml中的espocrm/espocrm镜像版本并pull；BringCRM 整体版本升级请关注官网发布说明 - 确认 cron/daemon 容器仍在运行（邮件、定时任务、自动备份等）
升级后验证
- 能登录，首页无 500 错误
- 外贸菜单完整
- 管理 → Bring外贸 → Bring外贸许可 显示的新版本号与预期一致，许可状态仍有效
- Cron/daemon 容器运行中
回滚
- 恢复升级前整站备份（宝塔编排备份包、Docker 脚本备份或 Espo 备份 zip）
- 业务数据单独回滚见 数据备份与恢复
常见问题
检查更新提示需要许可或订阅？
- 许可由部署方开通；订阅过期需续订后再到 管理 → Bring外贸 → Bring外贸许可 一键升级
一键升级失败？
- 确认服务器能访问许可下载地址，且磁盘空间足够
- 执行 管理 → Rebuild 后重试；查看
data/logs/espo-*.log - 请求超时（安装脚本较久）时，可加大 PHP / 反向代理超时后重试
能否升级 EspoCRM 到最新版？
- 不能。安装外贸扩展后核心升级入口已禁用；请等待 BringCRM 官方发布包含兼容 Espo 版本的整体更新
模板被覆盖？
- 新版安装逻辑应跳过已有模板；若被覆盖可从备份 zip 恢复 Excel/导入模板