管理席位

席位管理是指控制和监控哪些用户占用您订阅中席位的过程。有效的席位管理有助于您控制成本、防止意外的超额费用，并确保您的团队成员拥有所需的访问权限。

计费用户#

计费用户是指占用订阅席位并计入您订阅中所购席位数的用户。

以下用户计为计费用户：

• 有权访问订阅中的命名空间或顶级群组的用户，例如直接成员、继承成员，以及被邀请且具有以下角色之一的用户：
  • 访客（在专业版上计费，在基础版和旗舰版上不计费）
  • 计划者
  • 报告者
  • 安全管理员
  • 开发者
  • 维护者
  • 所有者
  • 自定义角色，但仅具有 read_code 权限的自定义访客成员角色除外
• 审计员用户
• 管理员（在极狐GitLab 私有化部署上，处于专业版和旗舰版层级）
• 无命名空间访问权限的用户（在极狐GitLab 私有化部署上，处于专业版）

在当前订阅期内，当您封禁、停用用户或向实例或群组添加用户时，计费用户数量会发生变化。如果某个用户属于同一持有订阅的顶级群组下的多个群组或项目，则只计一次。

席位使用情况按季度或年度进行审核。

为防止因意外添加用户而产生超额费用，您应：

• 阻止邀请群组层级之外的群组。
• 开启受限访问。

非计费用户的判定标准#

在以下情况下，用户不计为计费用户：

• 他们正在等待审批。
• 他们已被停用、 禁止 或封禁。
• 他们不是任何项目或群组的成员（仅限旗舰版订阅）。
• 他们仅具有访客角色（仅限旗舰版订阅）。
• 他们仅具有最小访问权限角色。
• 该账号是 极狐GitLab 创建的服务账号：
  • 幽灵用户。
  • 机器人：
    • 支持机器人。
    • 项目的机器人用户。
    • 群组的机器人用户。
    • 其他内部用户。

超出订阅限制的用户#

当您的实例或顶级群组中的计费用户数量超过您已购买的席位数时，您就存在超出订阅的用户（或欠付席位）。

例如，当向您的实例或群组添加新用户，或将现有用户提升为计费角色时，就可能发生这种情况。

超出订阅的用户数按以下方式计算：计费周期内的最大用户数 - 您订阅中已购买的席位数。

例如，您购买了 10 个席位的订阅，在计费周期内用户数量变化如下：

在这种情况下，您有 3 个超出订阅的用户（13 个最大用户数 - 10 个已购买席位）。

当您超出订阅限制时，您必须在续订之前或续订时为额外的用户付费。费用基于计费周期内的最大用户数，而不是当前用户数。

在极狐GitLab 私有化部署上，对于试用许可证，超出订阅的用户值始终为零。

为避免意外的超额费用，您可以：

• 开启受限访问，以在没有剩余席位时阻止添加用户。
• 要求管理员批准新用户账号。
• 在接近限制时主动购买更多席位。

免费访客用户#

在旗舰版层级中，被分配访客角色的用户不占用席位。该用户不得在实例中的任何位置（对于极狐GitLab 私有化部署）或命名空间中（对于 JihuLab.com）被分配任何其他角色。

在极狐GitLab 私有化部署的专业版层级中，如果某个访客用户在任何项目或群组（包括其个人命名空间）中具有更高角色，当您升级到旗舰版层级时，该更高角色将优先，他们将占用一个席位。为确保极狐GitLab 私有化部署旗舰版上的访客用户不占用席位，请在升级前确认他们在实例或命名空间中没有其他角色分配。

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

席位控制#

席位控制可帮助您管理用户如何被添加到订阅中，并防止意外的超额费用。席位控制适用于极狐GitLab 私有化部署上的实例，以及 JihuLab.com 上的顶级群组。

用户上限#

用户上限是指可以添加到 JihuLab.com 上顶级群组的最大计费用户数，或在极狐GitLab 私有化部署上可以创建账号的最大计费用户数。达到用户上限后，群组所有者或管理员必须批准要添加到顶级群组或要创建账号的用户。用户获得批准后，即可访问该群组或实例。如果群组所有者或管理员提高或移除用户上限，等待审批的用户将自动获得批准。

您可以为顶级群组设置用户上限以及为实例设置用户上限。

计费用户数每天更新一次。用户上限可能只有在已经超出后才会生效。如果上限设置为低于当前计费用户数的值（例如 1），则上限会立即启用。

在 JihuLab.com 旗舰版上，当计费用户数超过用户上限时，您无法将访客用户添加到群组。例如，当您有三名开发者和两名访客时，将用户上限设置为五。在您再添加两名开发者后，您将无法再添加任何用户，即使他们是不占用计费席位的访客用户。有关更多信息，请参阅议题 441504。

受限访问#

受限访问会在您的订阅中没有剩余许可席位时，阻止添加新的计费用户。在已超出席位限制的群组或实例上启用受限访问，不会更改任何现有成员的角色、封禁或移除任何现有成员；它会在保持当前成员不受影响的同时，阻止新的计费添加。不需要访问项目或群组的用户（例如通过 极狐GitLab 作为 OIDC 提供商进行身份验证的用户）可以被分配不计费的最小访问权限角色，从而不被席位限制阻止。

您可以为顶级群组设置受限访问以及为实例设置受限访问。

受限访问与外部群组共享不兼容。当您在 JihuLab.com 上开启受限访问时，阻止邀请群组层级之外的群组的设置会自动开启。此设置可防止因意外的计费用户而产生超额费用。

您仍然可以根据需要独立配置群组及其子群组的项目共享。

受限访问和用户上限不能同时使用。启用受限访问会禁用用户上限。

在极狐GitLab 私有化部署上，当您的订阅不允许超额时，极狐GitLab 会自动开启受限访问。当您的订阅不允许超额时，您无法关闭受限访问。

使用 SAML、SCIM 和 LDAP 时的预配行为#

当启用受限访问且没有可用的订阅席位时，通过 SAML、SCIM 或 LDAP 预配的用户会被分配最小访问权限角色，而不是其配置的访问级别。此行为可确保在 JihuLab.com 和极狐GitLab 私有化部署旗舰版上同步可以继续，而不会占用计费席位。

具有最小访问权限角色的用户可以完成身份验证并访问群组，但拥有有限的权限。当有可用席位时，他们可以被提升到其预期的访问级别。具有计费角色的现有用户不受此行为影响。

您可以查看席位使用情况并管理具有最小访问权限的用户。

已知问题#

当您开启受限访问时，可能会出现以下已知问题并导致超额：

• 在以下情况下，席位数仍可能被超出：
  • 您使用 SAML、SCIM 或 LDAP 添加新成员，并且已超出订阅中的席位数。用户会被分配最小访问权限，而不是被阻止。
  • 多个具有所有者角色或管理员访问权限的用户同时添加成员。
• 如果您通过 极狐GitLab 销售团队续订订阅，且用户数少于当前 订阅，您将产生超额费用。为避免此费用，请在续订开始前移除额外的用户。 例如，如果您有 20 个用户，并为 15 个用户续订订阅， 您将被收取五个额外用户的超额费用。

此外，受限访问可能会阻止标准的非超额流程：

• 被更新或添加到计费角色的服务机器人会被错误地阻止。
• 通过电子邮件邀请或更新现有计费用户会被意外阻止。

休眠用户重新激活#

当受限访问处于活动状态且没有可用的许可席位时，尝试重新登录的休眠用户（包括企业用户）会被设置为等待审批，而不是被重新激活。他们现有的群组和项目成员资格会被保留。非企业休眠成员的群组成员资格会被移除，而不是被停用。当他们通过 SAML、SCIM 或 LDAP 同步重新加入时，将适用预配行为，如果没有可用席位，他们将获得最小访问权限角色。

群组所有者或管理员可以在有可用席位时批准这些用户。

仅具有最小访问权限角色的用户会被直接重新激活，因为他们不占用计费席位。

您可以自动移除休眠成员。

待接受的邀请#

在您开启受限访问后，它将决定待处理的邀请是否可以继续：

• 在 JihuLab.com 上，当没有剩余订阅席位时，用户无法接受 授予计费角色的待处理邀请。该邀请会一直处于待处理状态，直到群组所有者 通过购买更多席位或移除计费成员来腾出席位。
• 在极狐GitLab 私有化部署上：
  • 在旗舰版上，适用相同的行为。该邀请会一直处于待处理状态， 直到管理员通过购买更多席位或移除计费成员来腾出席位。
  • 在专业版上，受限访问在创建账号时强制执行席位限制， 而不是在接受邀请时。当用户创建账号时，极狐GitLab 会通知用户 其账号无法创建，并应联系 极狐GitLab 管理员。

从用户上限更改为受限访问#

在 JihuLab.com 上，当您从用户上限更改为受限访问时，所有待处理成员（包括等待审批的成员和被邀请的成员）都会被自动移除。为确保用户被批准为成员，您必须在启用受限访问之前批准或移除待处理成员。

在极狐GitLab 私有化部署上，用户上限会将新用户账号保留为等待管理员审批，而不是像 JihuLab.com 上那样阻止群组或项目成员。当您从用户上限更改为受限访问时，待处理的新用户账号不会被自动移除。这些用户会一直处于被封禁状态，直到管理员批准他们。

在您开启受限访问后，它将决定待处理的用户审批是否可以继续：

• 在专业版上，受限访问会阻止待处理的审批，因为没有任何群组或项目成员资格的用户是计费的。
• 在旗舰版上，受限访问不会阻止待处理的审批，因为没有任何群组或项目成员资格的用户是不计费的。但是，在管理员批准他们后，如果没有可用席位，受限访问会阻止将该用户以计费角色添加到群组或项目。

购买更多席位#

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

如果受限访问：

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

在以下任一情况下，您无法为订阅购买席位：

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

要为订阅购买席位：

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

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

减少席位#

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

私有化部署计费和使用情况#

极狐GitLab 私有化部署订阅使用混合模式。您根据订阅期内启用的最大用户数支付订阅费用。

对于不在离线或封闭网络上的实例，每个季度会检查极狐GitLab 私有化部署实例中的最大同时用户数。

如果实例无法生成季度使用报告，则使用现有的补足模式。没有季度使用报告，就无法进行按比例计费。

订阅中的用户数表示您当前许可证中包含的用户数，基于您已支付的费用。除非您购买更多席位，否则此数字在您的订阅期内保持不变。

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

您可以查看和管理您的计费用户和许可证使用情况。

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

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

如果 LDAP 与 极狐GitLab 集成，则配置域中的任何人都可以注册 极狐GitLab 账号。这可能会导致续订时产生意外账单。如果您的实例允许新用户账号，则任何可以访问该实例的人都可以注册账号。

为防止意外超额，请参阅席位管理的最佳实践。

JihuLab.com 计费和使用情况#

JihuLab.com 订阅使用并发（席位）模式。您为可以同时使用订阅的用户选择一定数量的席位，并根据计费周期内分配给顶级群组、其子群组和项目的最大用户数支付订阅费用。

您可以在订阅期内添加和移除用户，而不会产生额外费用，只要任何给定时间的用户总数不超过订阅中的席位数。如果您添加更多用户并超出已购买的席位数，您将产生超额费用，该费用将包含在您的下一张发票中。

席位使用情况提醒#

如果您是链接到参与季度订阅对账的订阅的顶级群组的所有者角色，您会收到有关订阅中席位使用情况的提醒。

该提醒会显示在群组、子群组和项目页面上。在您关闭提醒后，直到再次使用席位之前，它不会再次显示。

该提醒在以下剩余席位区间显示：

查看席位使用情况#

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

1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
2. 在左侧边栏中，选择设置 > 使用配额。
3. 选择席位选项卡。

对于每个用户，列表会显示该用户作为直接成员的群组和项目。

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

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

查看计费信息#

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

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

• 使用统计数据每天更新一次，这可能导致使用配额页面与计费页面中的信息 存在差异。
• 上次登录字段会在用户退出后再次登录时更新。如果用户重新进行身份验证时存在活动会话 （例如，在 24 小时 SAML 会话超时后），则该字段不会更新。

搜索用户的席位使用情况#

您可以查看使用您订阅席位的用户。要搜索用户的席位使用情况：

1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
2. 在左侧边栏中，选择设置 > 使用配额。
3. 在席位选项卡的搜索字段中，输入用户的姓名或用户名。 搜索字符串必须至少包含三个字符。

搜索会返回名字、姓氏或用户名与搜索字符串匹配的用户列表。

例如，对于名字为 Amir 的用户，搜索字符串 ami 会匹配，但 amr 不会匹配。

导出席位使用数据#

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

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

导出席位使用历史记录#

先决条件：

• 您必须具有该群组的所有者角色。

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

1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
2. 在左侧边栏中，选择设置 > 使用配额。
3. 在席位选项卡中，选择导出席位使用历史记录。

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

从订阅中移除用户#

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

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

如果您通过将群组与另一个群组共享来向群组添加成员，则无法使用此方法移除该成员。您可以改为：

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

企业敏捷规划#

极狐GitLab 企业敏捷规划是一个附加组件，可帮助将非工程用户引入工程师构建、测试、保护和部署代码的同一 DevSecOps 平台。 该附加组件支持开发者与非开发者之间的跨团队协作，而无需为非工程团队成员购买 极狐GitLab 旗舰版许可证。

借助企业敏捷规划席位，非工程团队成员可以参与规划工作流，使用价值流分析衡量软件交付速度和影响，并使用高管仪表板来提升组织可见性。

有关企业敏捷规划席位以及如何购买它们的更多信息，请联系您的 极狐GitLab 销售代表。

使用企业敏捷规划席位#

在以下情况下，用户占用企业敏捷规划席位：

• 您的订阅包含已购买的企业敏捷规划席位。
• 用户在顶级群组、其子群组和项目中拥有的最高角色是计划者。

在以下任一情况下，用户占用旗舰版席位而不是企业敏捷规划席位：

• 您的订阅不包含已购买的企业敏捷规划席位。
• 具有计划者角色的用户在组织层级中的任何位置被分配了更高角色（例如开发者或维护者）。

要使用您已购买的企业敏捷规划席位，您必须首先在群组或项目中为用户分配计划者角色。

为防止具有计划者角色的用户被分配其他角色并因此占用旗舰版席位，您可以使用全局 SAML 群组成员资格锁定。

您可以在订阅详情和客户门户中查看已使用的企业敏捷规划席位数。在极狐GitLab 私有化部署上，您还可以在用户统计中按角色查看用户总数。

最佳实践#

要有效管理您的订阅席位并控制成本，请遵循以下最佳实践。

初始设置：

• 关闭新用户账号创建。
• 通过 LDAP 或 OmniAuth 自动封禁新用户。
• 要求对新账号和角色提升进行审批，以便从一开始就控制席位分配。
• 使用席位控制开启受限访问，或为群组或实例设置用户上限，以防止意外的席位使用。
• 尽可能分配不计费的角色，例如访客（在基础版和旗舰版上）或最小访问权限，以尽量减少席位使用。

常规活动：

• 定期监控席位使用情况和用户统计，以识别潜在的超额。
• 对在席位即将用尽时通知您的席位使用情况提醒采取行动。
• 自动停用或移除休眠成员，为活跃团队成员腾出席位。

战略规划：

• 为非工程团队成员使用企业敏捷规划席位，而不是完整的旗舰版席位。
• 在接近限制时购买席位，提前为增长做好规划。
• 导出并分析您的席位使用历史记录，以预测未来需求。