用户组（User Groups）

用户组提供了一种可复用的层级化授权方式。管理员无需将相同的用户逐个添加到每个团队或仓库，只需定义一次用户组、添加成员，再将用户组分配给组织团队或仓库即可。

用户组自 Gitea Enterprise v26 起提供，仓库协作者用户组于 Gitea Enterprise v27 中新增。

启用用户组

1. 打开 Site Administration > User Groups。
2. 勾选 启用用户组（Enable user groups）。
3. 保存设置。

启用后，系统会显示用户组管理页面、LDAP 用户组同步设置、团队用户组区块以及仓库协作者控制项。关闭该功能后，所有用户组相关的界面和路由都会被隐藏。

创建和管理用户组

1. 打开 Site Administration > User Groups。
2. 点击 新建用户组（New User Group）。
3. 输入 名称（Name），并可选择填写 描述（Description）。
4. 可选择 父级（Parent） 用户组来构建层级关系。
5. 将 Slug 留空即可从名称派生；也可以输入一个稳定的小写标识符，仅使用字母、数字、点、下划线和连字符。
6. 点击 创建用户组（Create Group）。

在用户组的编辑页面中，您可以：

• 添加或移除单个成员
• 创建或查看子用户组
• 查看哪些组织团队正在使用该用户组

层级关系与有效成员

用户组可以嵌套。子用户组既包含自己的直接成员，也包含从父用户组继承而来的有效成员。将用户组分配给团队或仓库后，该用户组的所有有效成员都会获得相应的访问权限。

将用户组分配给组织团队

1. 打开组织的 Teams 页面，并选择一个团队。
2. 打开 用户组（User Groups） 区块。
3. 点击 添加用户组（Add User Group），并选择一个或多个用户组。

通过子用户组继承的成员也会被纳入团队。从源用户组移除成员后，通过该团队授予的访问权限也会被移除。

将用户组分配给仓库

从 Gitea Enterprise v27 开始，仓库管理员可以将用户组作为仓库协作者：

1. 打开 Repository > Settings > Collaborators。
2. 在 用户组（User Groups） 区块中搜索并添加用户组。
3. 选择访问模式：读取、写入或管理员。

该用户组的有效成员会获得对应的仓库访问权限。您可以在同一页面修改或移除仓库用户组。

将 LDAP 组同步到用户组

用户组可以从 LDAP 认证源同步：

1. 打开 Site Administration > Identity & Access > Authentication Sources，并编辑 LDAP 认证源。
2. 将 LDAP 组同步模式（LDAP Group Synchronization Mode） 设置为 同步组到用户组（Synchronize groups to user groups）。
3. 配置组的唯一 ID、名称、描述、父级检测策略和同步间隔。
4. 保存认证源，然后选择 立即同步 LDAP 用户组（Sync LDAP User Groups Now） 执行一次初始同步。

同步会从目录中创建并更新用户组及其成员。认证源页面会显示最近一次同步状态。

可用性

用户组于 Gitea Enterprise v26 中引入，仓库协作者用户组于 Gitea Enterprise v27 中新增。