Upgrade from Gitea

如果您已经在运行开源 Gitea 项目，并希望体验 Enterprise 功能集，只需替换二进制文件或容器镜像即可完成迁移。本指南将带您了解升级流程，并说明相关的兼容性细节。

确认基线版本

• 查看当前运行的 Gitea 版本（Site Administration -> System Status 或 gitea --version）。
• 选择相对应的 Gitea Enterprise 版本。社区版 v1.X.Y 对应 Enterprise 版本 vX.Y.*。如有需要，您也可以放心选择更高的 Enterprise 次版本（例如，v1.27.3 -> v27.3.2 或任意更新的 v27.*）。
• 从 Gitea 1.26.x 迁移到 Enterprise 27.x 时，请先查看 Gitea 1.27 的破坏性变更。尤其需要注意，Gitea 1.27 中 Actions 可复用工作流支持以及 Content-Security-Policy script nonce 的行为发生了变化。

替换二进制文件

如果您是通过社区版二进制文件安装的：

1. 从 commitgo/gitea-ee releases 下载 Enterprise 二进制文件。
2. 停止正在运行的服务。
3. 替换可执行文件，并确保权限与原有部署一致。
4. 重新启动服务。

sudo systemctl stop gitea
curl -L -o /usr/local/bin/gitea "https://gitea.com/commitgo/gitea-ee/releases/download/v27.3.2/gitea-ee-27.3.2-linux-amd64"
sudo chmod 755 /usr/local/bin/gitea
sudo systemctl start gitea

所有现有配置（app.ini）和数据目录都是兼容的。

替换容器镜像

如果您运行的是社区版 Docker 镜像，请更新您的部署清单：

services:
  gitea:
    image: gitea/gitea:1.27.3
    image: commitgo/gitea-ee:27.3.2

• 拉取新镜像（docker compose pull 或 helm upgrade）。
• 重启容器或滚动更新部署，使新镜像使用现有的 /data 卷启动。

Enterprise 与社区镜像使用相同的入口点，因此无需任何迁移步骤。

激活

服务重启后：

1. 以管理员身份登录。
2. 按照许可证激活上传或续订 Enterprise 许可证。
3. 确认 Enterprise 功能已启用。

只要目标版本等于或高于您之前运行的 Enterprise 版本，您可以随时反向执行替换步骤，切换回社区版。