跳到主要内容
版本：26.4.1

从 Gitea 升级（Upgrade from Gitea）

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

确认基线版本​

  • 查看当前运行的 Gitea 版本（Site Administration -> System Status 或 gitea --version）。
  • 选择相对应的 Gitea Enterprise 版本。社区版 v1.X.Y 对应 Enterprise 版本 vX.Y.*。如有需要，您也可以放心选择更高的 Enterprise 次版本（例如，v1.24.6 -> v24.6.0 或任意 v25.*）。

替换二进制文件​

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

  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/v24.6.0/gitea-ee-24.6.0-linux-amd64"
sudo chmod 755 /usr/local/bin/gitea
sudo systemctl start gitea

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

替换容器镜像​

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

 services:
   gitea:
-    image: gitea/gitea:1.24.6
+    image: commitgo/gitea-ee:24.6.0
  • 拉取新镜像（docker compose pull 或 helm upgrade）。
  • 重启容器或滚动更新部署，使新镜像使用现有的 /data 卷启动。

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

激活​

服务重启后：

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

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