管理用户和席位

计费用户

计费用户是指在订阅中拥有命名空间访问权限的用户，包括直接成员、继承成员和受邀用户，且具有以下角色之一：

• Guest（在 Premium 版本中计费，在 Free 和 Ultimate 版本中不计费）
• Planner
• Reporter
• Developer
• Maintainer
• Owner

计费用户计入您订阅购买的席位数量。 在当前订阅期间内，当您阻止、停用或向实例或组添加用户时，计费用户数量会发生变化。 如果用户属于同一个顶级订阅组的多个组或项目，则只计算一次。

席位使用情况每季度或每年进行审核。 在 GitLab 自托管版中，计费用户数量在管理员区域每天报告一次。

在 GitLab.com 上，订阅功能仅适用于订阅所关联的顶级组。如果 用户查看或选择不同的顶级组（例如他们自己创建的组） 且该组没有付费订阅，则用户看不到任何付费功能。

用户可以属于具有不同订阅的两个不同顶级组。 在这种情况下，用户只能看到该订阅可用的功能。

为防止意外添加新的计费用户（可能导致超额费用），您应该：

• 禁止邀请组外部的组。
• 开启受限访问。

非计费用户的判定标准

如果用户满足以下条件，则不计为计费用户：

• 他们正在等待审批。
• 他们已被停用、 禁止或 阻止。
• 他们不是任何项目或组的成员（仅限 Ultimate 订阅）。
• 他们只有访客角色（仅限 Ultimate 订阅）。
• 对于任何 GitLab.com 订阅，他们只有最小访问权限角色。
• 该账户是 GitLab 创建的服务账户：
  • 幽灵用户。
  • 机器人：
    • 支持机器人。
    • 项目机器人用户。
    • 组机器人用户。
    • 其他内部用户。

免费访客用户

在终极版层级中，被分配访客角色的用户不占用席位。 用户不能在实例中的任何位置（GitLab 自托管版）或在命名空间中（GitLab.com）被分配任何其他角色。

• 如果您的项目是：
  • 私有或内部项目，访客角色的用户拥有一组权限。
  • 公开项目，所有用户（包括访客角色的用户）都可以访问您的项目。
• 对于 GitLab.com，如果访客角色的用户在其个人命名空间中创建项目，则用户不占用席位。 该项目位于用户的个人命名空间下，与具有 Ultimate 订阅的组无关。
• 在 GitLab 自托管版中，用户被分配的最高角色是异步更新的，可能需要一些时间才能更新。

购买更多席位

您的订阅费用基于计费期间内您使用的最大席位数量。

如果受限访问设置为：

• 开启：当订阅中没有剩余席位时，您必须购买更多席位才能让组添加新的计费用户。
• 关闭：当订阅中没有剩余席位时，组仍可继续添加计费用户。 GitLab 会对超额部分向您收费。

如果满足以下任一条件，您无法为订阅购买席位：

• 您通过授权经销商（包括 GCP 和 AWS 市场）购买了订阅。请联系经销商添加更多席位。
• 您拥有多年期订阅。请联系销售团队添加更多席位。

为订阅购买席位：

1. 登录客户门户。
2. 转到订阅与购买页面。
3. 在相关订阅卡上选择添加席位。
4. 输入额外用户的数量。
5. 查看购买摘要部分。系统会列出系统上所有用户的总价以及您已支付的金额抵扣。您只需支付净差额。
6. 输入您的付款信息。
7. 勾选我同意隐私声明和服务条款复选框。
8. 选择购买席位。

您将通过电子邮件收到付款收据。 您也可以在客户门户的发票部分访问收据。

减少席位

您只能在订阅续订时减少席位。 如果您想减少订阅中的席位数量，可以为更少的席位续订。

如果您在续订或购买订阅后想减少席位， 请向计费团队提交工单或联系您的 GitLab 销售代表。 如需帮助，请访问客户门户账户中的联系我们页面。

自托管版计费和使用情况

GitLab 自托管版订阅采用混合模式。您根据订阅期间内启用的最大用户数量支付订阅费用。

对于非离线或非封闭网络的实例，每季度检查 GitLab 自托管实例中的最大并发用户数量。

如果实例无法生成季度使用情况报告，则使用现有的调整模型。没有季度使用情况报告就无法进行按比例计费。

订阅中的用户数量代表您已付费的当前许可证包含的用户数量。 除非您购买更多席位，否则此数量在整个订阅期间保持不变。

最大用户数反映当前许可证期间系统上计费用户的最高数量。

超出订阅的用户

GitLab 订阅适用于特定数量的席位。 超出订阅的用户数显示当前订阅期间内超出订阅允许数量的用户数。

计算公式为当前许可证期限的最大用户数 - 订阅中的用户数。例如，您购买了 10 个用户的订阅。

事件	计费用户数	最大用户数
十个用户占满所有 10 个席位。	10	10
两个新用户加入。	12	12
三个用户离开且其账户被阻止。	9	12
四个新用户加入。	13	13

超出订阅的用户数 = 13 - 10（最大用户数 - 许可证中的用户数）

试用许可证的超出订阅用户数始终为零。

如果超出订阅用户数大于零，则您的 GitLab 实例中的用户数超过了许可证允许的数量。您必须在续订前或续订时为额外用户付费。这称为"调整"过程。如果您不这样做，您的许可证密钥将无法使用。

要查看超出订阅的用户数，请转到管理员区域。

查看用户

查看您实例中的用户列表：

1. 在左侧边栏底部，选择管理员。
2. 选择用户。

选择用户以查看其账户信息。

检查每日和历史计费用户

先决条件：

• 您必须是管理员。

您可以获取 GitLab 实例中每日和历史计费用户的列表：

1. 启动 Rails 控制台会话。

2. 计算实例中的用户数量：

   User.billable.count

3. 获取过去一年实例的历史最大用户数：

   ::HistoricalData.max_historical_user_count(from: 1.year.ago.beginning_of_day, to: Time.current.end_of_day)

更新每日和历史计费用户

先决条件：

• 您必须是管理员。

您可以手动更新 GitLab 实例中的每日和历史计费用户。

1. 启动 Rails 控制台会话。

2. 强制更新每日计费用户：

   identifier = Analytics::UsageTrends::Measurement.identifiers[:billable_users]
   ::Analytics::UsageTrends::CounterJobWorker.new.perform(identifier, User.minimum(:id), User.maximum(:id), Time.zone.now)

3. 强制更新历史最大计费用户：

   ::HistoricalDataWorker.new.perform

管理用户和订阅席位

管理用户数量与订阅席位数量可能很困难：

• 如果LDAP 已与 GitLab 集成，配置域中的任何人都可以注册 GitLab 账户。这可能导致续订时出现意外账单。
• 如果您的实例中开启了注册功能，任何能访问实例的人都可以注册账户。

GitLab 提供多种功能帮助您管理用户数量。您可以：

• 要求管理员审批新注册。
• 通过LDAP或 OmniAuth自动阻止新用户。
• 限制无需管理员审批即可注册或添加到订阅的计费用户数量。
• 禁用新注册， 而是手动管理新用户。
• 在用户统计页面中按角色查看用户细分。

要增加许可证覆盖的用户数量，在订阅期间购买更多席位。 订阅期间内添加的席位费用从购买日期按比例计算至订阅结束日期。 即使达到许可证中的用户数量，您仍可以继续添加用户。GitLab 会对超额部分向您收费。

如果您的订阅是通过激活码激活的，额外席位会立即反映在您的实例中。如果您使用的是许可证文件，您将收到更新后的文件。 要添加席位，将许可证文件添加到您的实例中。

导出许可证使用情况

先决条件：

• 您必须是管理员。

您可以将许可证使用情况导出为 CSV 文件。

该文件包含 GitLab 用于手动处理季度对账 和续订的信息。如果您的实例被防火墙隔离或处于离线环境，您必须向 GitLab 提供此信息。

1. 在左侧边栏底部，选择管理员。
2. 选择订阅。
3. 在右上角，选择导出许可证使用情况文件。

许可证使用情况文件内容

许可证使用情况文件包含以下信息：

• 许可证密钥
• 许可证持有者邮箱
• 许可证开始日期（UTC）
• 许可证结束日期（UTC）
• 公司
• 文件生成和导出的时间戳（UTC）
• 期间内每日历史用户计数表：
  • 记录计数的时间戳（UTC）
  • 计费用户计数

GitLab.com 计费和使用情况

GitLab.com 订阅采用并发（席位）模式。 您根据计费期间内分配给顶级组及其子组和项目的最大用户数量支付订阅费用。 只要在任何给定时间的总用户数不超过订阅数量，您可以在订阅期间内添加和删除用户而不会产生额外费用。 如果总用户数超过您的订阅数量，您将产生超额费用，必须在下一次对账时支付。

顶级组可以像其他组一样更改。

应付席位

如果计费用户数量超过订阅中的席位数量（称为应付席位数），您必须为超额用户付费。

例如，如果您购买了 10 个用户的订阅：

事件	计费成员数	最大用户数
十个用户占满所有 10 个席位。	10	10
两个新用户加入。	12	12
三个用户离开且其账户被移除。	9	12

应付席位数 = 12 - 10（最大用户数 - 订阅中的用户数）

为防止应付席位收费，您可以 开启受限访问。 此设置限制在订阅中没有剩余席位时组添加新的计费用户。

查看席位使用情况

要查看正在使用的席位列表：

1. 在左侧边栏，选择搜索或跳转至并找到您的组。
2. 选择设置 > 使用配额。
3. 选择席位标签页。

对于每个用户，列表显示用户是其直接成员的组和项目。

• 组邀请表示用户是被邀请到组的组的成员。
• 项目邀请表示用户是被邀请到项目的组的成员。

席位使用情况列表中的已用席位和订阅中的席位数据实时更新。 最大使用席位和应付席位的计数每天更新一次。

查看计费信息

要查看您的订阅信息和席位计数摘要：

1. 在左侧边栏，选择搜索或跳转至并找到您的组。
2. 选择设置 > 计费。

• 使用情况统计每天更新一次，这可能导致使用配额页面和计费页面中的信息存在差异。
• 上次登录字段在用户在登出后重新登录时更新。如果用户在重新认证时存在活动会话（例如 24 小时 SAML 会话超时后），此字段不会更新。

席位使用情况警报

如果您是顶级组的 Owner 角色，系统会通过警报通知您总席位使用情况。

警报显示在组、子组和项目页面上，仅适用于与参与季度订阅对账的订阅关联的顶级组。 您关闭警报后，直到再次使用席位前不会再次显示。

警报基于以下席位使用情况显示。您无法配置警报显示的阈值。

订阅中的席位	警报显示条件
0-15	剩余一个席位。
16-25	剩余两个席位。
26-99	剩余 10% 的席位。
100-999	剩余 8% 的席位。
1000+	剩余 5% 的席位。

导出席位使用情况

将席位使用情况数据导出为 CSV 文件：

1. 在左侧边栏，选择搜索或跳转至并找到您的组。
2. 选择设置 > 使用配额。
3. 在席位标签页中，选择导出列表。

导出席位使用历史

先决条件：

• 您必须拥有该组的 Owner 角色。

将席位使用历史导出为 CSV 文件：

1. 在左侧边栏，选择搜索或跳转至并找到您的组。
2. 选择设置 > 使用配额。
3. 在席位标签页中，选择导出席位使用历史。

生成的列表包含所有正在使用的席位， 不受当前搜索的影响。

从订阅中移除用户

要从您的 GitLab.com 订阅中移除计费用户：

1. 在左侧边栏，选择搜索或跳转至并找到您的组。
2. 选择设置 > 计费。
3. 在当前使用的席位部分，选择查看使用情况。
4. 在要移除用户的行右侧，选择移除用户。
5. 重新输入用户名并选择移除用户。

如果您通过将组共享给另一个组功能将成员添加到组，则无法使用此方法移除该成员。您可以：

• 从共享组中移除成员。
• 移除被邀请的组。