自定义实例角色
提示
Feature availability 功能可用性
自定义实例角色适用于:
- n8n Cloud: Enterprise
- Self-hosted: Enterprise
可用版本:n8n 2.30.0(2026 年 7 月 7 日发布)
提示
Instance roles vs project roles 实例角色与项目角色
n8n 有两类自定义角色:
Custom instance roles 自定义实例角色:与用户在实例级别需要的管理能力相关的角色。
Custom project roles 自定义项目角色:应用于特定项目内的角色。请参阅创建自定义项目角色。
自定义实例角色允许你向用户授予特定的实例级能力,而无需授予完整 Admin 访问权限。与内置角色(Owner、Admin、Member、Chat user)不同,自定义实例角色可以为实例设置、用户管理和其他实例级管理能力定义细粒度权限。
创建自定义实例角色
实例 Owner 和实例 Admin 可以创建自定义实例角色。
创建自定义实例角色:
- 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
- 选择 Create role 创建角色。
- 输入角色名称和可选描述。
- 可选择一个 Preset 预设(Admin、Member),以基于内置角色预填权限,然后按需调整。
- 为该角色选择权限: * Instance settings 实例设置 > Manage 管理:查看和更改实例范围设置。 * Members 成员 > Manage 管理:在整个实例中邀请、移除和更新用户。 * Roles 角色 > Manage project roles 管理项目角色:仅创建、编辑和删除自定义项目角色。 * Roles 角色 > Manage all roles 管理所有角色:创建、编辑和删除所有自定义角色(实例和项目)。选择此项会自动包含 Manage project roles 管理项目角色。 * API keys > Manage own 管理自己的 API key:创建和删除用户自己的 API key。 * API keys > Manage others 管理他人的 API key:查看和删除其他用户的 API key。会自动包含 Manage own 管理自己的 API key。 * Tags 标签 > View 查看:查看所有标签。 * Tags 标签 > Manage 管理:创建、编辑和删除标签。 * Projects 项目 > Create 创建:创建新项目。 * Insights > View 查看:查看实例级 Insights。
- 选择 Save 保存。
将自定义实例角色分配给用户
具有 Roles: Manage all roles 权限的用户可以分配自定义实例角色。
分配自定义实例角色:
- 转到 Settings 设置 > Users 用户。
- 找到要更新的用户。
- 选择该用户当前角色,打开角色下拉菜单。
- 在 Custom roles 自定义角色 下,选择要分配的角色。
编辑自定义实例角色
更新现有自定义实例角色:
- 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
- 找到要编辑的自定义角色。
- 选择 three-dot menu 三点菜单 > Edit 编辑。
- 更新角色名称、描述或权限。
- 选择 Save changes 保存更改。
警告
Editing affects all assigned users 编辑会影响所有已分配用户
对自定义实例角色的更改会影响整个实例中拥有该角色的所有用户。
复制自定义实例角色
基于现有角色创建新角色:
- 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
- 找到要复制的角色。
- 选择 three-dot menu 三点菜单 > Duplicate 复制。
- 按需更新角色名称和权限。
- 选择 Create role 创建角色。
删除自定义实例角色
删除自定义实例角色:
- 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
- 找到要删除的角色。
- 选择 three-dot menu 三点菜单 > Delete 删除。
- 确认删除。
提示
Reassign users before deletion 删除前重新分配用户
如果有用户拥有此角色,请先将他们重新分配到其他角色,然后再删除该角色。
权限参考
下表说明 Instance roles 实例角色 编辑器中每个权限组及其复选框的含义。
| Group 组 | Checkbox 复选框 | 允许的操作 |
|---|---|---|
| Instance settings 实例设置 | Manage 管理 | 查看和更改实例范围设置 |
| Members 成员 | Manage 管理 | 在整个实例中邀请、移除和更新用户 |
| Roles 角色 | Manage project roles 管理项目角色 | 仅创建、编辑、复制、删除和分配自定义项目角色 |
| Roles 角色 | Manage all roles 管理所有角色 | 创建、编辑、复制、删除和分配所有自定义角色(实例和项目)。会自动包含 Manage project roles 管理项目角色。 |
| API keys | Manage own 管理自己的 API key | 创建和删除用户自己的 API key |
| API keys | Manage others 管理他人的 API key | 查看和删除其他用户的 API key。会自动包含 Manage own 管理自己的 API key。 |
| Tags 标签 | View 查看 | 查看所有标签 |
| Tags 标签 | Manage 管理 | 创建、编辑和删除标签 |
| Projects 项目 | Create 创建 | 创建新项目 |
| Insights | View 查看 | 查看实例级 Insights 和使用数据 |
警告
Privilege escalation risk 权限提升风险
某些权限组合会产生权限提升风险:
- 拥有 Roles: Manage all roles 的用户可以编辑自己的自定义角色,添加原本未授予的权限。
- 拥有 Members: Manage 的用户可以邀请自己控制的用户,然后授予该用户 Admin 级访问权限。
- 拥有 Roles: Manage project roles 的用户可以编辑自己持有的自定义项目角色,为自己授予该项目中原本未获得的权限。
请仅将这些权限分配给完全可信的用户,并避免不必要地组合这些权限。