升级您的部署

确保在每次大版本升级时进行 一致的备份 然后 非常重要，以便在需要时能够回滚。

该 Overleaf 工具包↗ 是一个 git 仓库，因此很容易获得新的工具包功能。只需运行 bin/upgrade 命令并按照屏幕提示操作。

值得注意的是，Docker 镜像版本（在 config/version）与工具包代码更新是分开管理的。更新工具包代码将 不要 自动更改您正在运行的 Docker 镜像的版本。这意味着在大多数情况下，您可以在不升级部署的情况下升级工具包版本。

该 bin/upgrade 脚本

当您运行 bin/upgrade 命令时，脚本将检查工具包代码是否有可用更新，并提供更新您的工具包的选项。您始终可以拒绝此升级，且不会有任何更改。

如果您确实选择更新工具包代码，脚本将接着检查 默认 Docker 镜像版本是否已更改，并提供将本地版本文件（在 config/version）升级以匹配新的默认版本的选项。

如果您选择切换版本，脚本将引导您完成关闭 Docker 服务、进行备份并重启 Docker 服务的流程。您的旧版本文件将被自动复制到 config/__old-version，以防您需要回滚到该版本的 Docker 镜像。

在执行 Server CE/Pro 升级时，我们建议先将已部署的大版本升级到最新发行版本 然后 再升级到最新发行的 下一个 大版本。如果您的部署落后于最新版本超过一个大版本，则需要执行分步升级。

例如，如果您正在运行 3.5.10，您需要升级到 3.5.13 -> 执行完整项目历史迁移 -> 4.2.9 -> 5.5.4。

您应该 绝对不要 跳过大版本（3.5.10 -> 5.5.4）。如果您使用 Toolkit 且落后于最新版本超过一个大版本，您必须 不要 使用 bin/upgrade 脚本，因为您需要执行手动的分步升级。

对于手动导入 Docker 镜像的隔离网络（air-gapped）设置，请设置 PULL_BEFORE_UPGRADE=false 中。 config/overleaf.rc 文件。

请查看 这里 以获取有关在隔离/离线环境中部署的更多信息。

升级路径

该 bin/upgrade 命令将始终选择当时可用的最新 Server Pro/CE 版本。如果您的升级周期不频繁，这可能导致跳过主要版本并可能升级到您未预期的版本。

在执行升级时，我们建议在升级到下一个主要版本的最新发行版之前，先升级到当前主要版本的最新发行版。例如，如果您当前运行的是 3.3.2，而可用的最新版本是 5.3.1，正确的升级路径应为：

• 3.3.2 -> 3.5.13

• 3.5.13 -> 4.2.9

• 4.2.9 -> 5.5.1

为避免任何升级问题，我们建议在执行任何升级之前查阅我们的 发行说明 因为某些版本可能需要额外步骤，例如对工具包进行手动更改、升级数据库或运行迁移脚本。

如果您还没有这样做，请注册我们的 邮件列表 以便在发布新版本/更新时收到通知。这将使您能够安排定期的维护窗口，与我们的发布计划保持紧密一致。