• 在安装过程中添加您的许可证文件
• 许可证到期时会发生什么
• 删除许可证
• 查看许可证详情和历史
• 故障排查
  • 管理中心没有许可证选项
  • 续订时用户数超过许可证限制
  • 添加许可证后仍显示 Start GitLab Ultimate trial

使用许可证文件或密钥激活极狐GitLab

如果您从极狐GitLab 收到许可证文件（例如，试用版），您可以将其上传到您的实例或在安装期间添加。许可证文件是一个 base64 编码的 ASCII 文本文件，扩展名为 .gitlab-license。

首次登录极狐GitLab 实例时，应显示带有 添加许可证 页面链接的注释。

否则，要添加您的许可证：

1. 以管理员身份登录极狐GitLab。
2. 在顶部栏上，选择 主菜单 > 管理员。
3. 在左侧边栏中，选择 设置 > 通用。
4. 在 添加许可证 区域，通过上传文件或输入密钥来添加许可证。
5. 选择 服务条款 复选框。
6. 选择 添加许可证。

在安装过程中添加您的许可证文件

您可以在安装极狐GitLab 时导入许可证文件。

• 源安装
  • 将 Gitlab.gitlab-license 文件放在 config/ 目录下。

  • 要为许可证指定自定义位置和文件名，请使用文件路径设置 GITLAB_LICENSE_FILE 环境变量：

    export GITLAB_LICENSE_FILE="/path/to/license/file"
    

• Omnibus 安装
  • 将 Gitlab.gitlab-license 文件放在 /etc/gitlab/ 目录下。

  • 要为许可证指定自定义位置和文件名，请将此条目添加到 gitlab.rb：

    gitlab_rails['initial_license_file'] = "/path/to/license/file"
    

许可证到期时会发生什么

在许可证到期前 15 天，系统会显示一个带有即将到期日期的通知给管理员。

当您的许可证到期时，系统会锁定功能，例如 Git 推送和议题创建。您的实例变为只读，并且所有管理员都会看到一条过期消息。在此之前，您有 14 天的宽限期。

要恢复功能，请续订您的订阅。

如果许可证已过期 30 天以上，您必须购买新订阅才能恢复功能。

要返回免费版功能，请删除所有过期的许可证。

删除许可证

要从私有化部署实例中删除许可证文件：

1. 在顶部栏上，选择 主菜单 > 管理员。
2. 在左侧边栏中，选择 订阅。
3. 选择 删除许可证。

重复这些步骤删除所有许可证，包括过去应用的许可证。

查看许可证详情和历史

要查看您的许可证详细信息：

1. 在顶部栏上，选择 主菜单 > 管理员。
2. 在左侧边栏中，选择 订阅。

您可以上传和查看多个许可证，但只有当前日期范围内的最新许可证是有效许可证。

当您上传未来日期的许可证时，在其适用日期之前不会生效。 您可以在 订阅历史 表中查看所有有效订阅。

您还可以将您的许可证使用信息导出到 CSV 文件。

故障排查

管理中心没有许可证选项

您无法上传您的许可证，因为没有 订阅 区域。在以下情况下，可能会出现此问题：

• 如果您原先安装的是社区版（Community Edition）而不是极狐GitLab，您必须在上传许可证前升级到极狐GitLab。
• 如果您使用的是 SaaS 版，您无法上传一个私有化部署版的许可证。

续订时用户数超过许可证限制

极狐GitLab 会显示一条消息，提示您购买更多用户。如果您上传的许可证没有足够的用户来覆盖您实例中的用户数量，则会出现此问题。

要解决此问题，请购买额外的席位覆盖这些用户。

在 14.2 及更高版本中，对于使用许可证文件的实例，以下规则适用：

• 如果超过许可的用户少于或等于许可文件中用户的 10%，则应用许可并在下次续订时支付超额。
• 如果超过许可的用户超过许可文件中用户的 10%，则在不购买更多用户的情况下无法申请许可。

例如，如果您为 100 个用户购买了一个许可证，那么当您激活您的许可证时，您可以拥有 110 个用户。但是，如果您有 111 个用户，则必须购买更多用户才能激活许可证。

添加许可证后仍显示 Start GitLab Ultimate trial

要解决此问题，请重新启动 Puma 或您的整个极狐GitLab 实例。