n8n 中文文档

自定义实例角色

提示

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 可以创建自定义实例角色。

创建自定义实例角色:

  1. 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
  2. 选择 Create role 创建角色。
  3. 输入角色名称和可选描述。
  4. 可选择一个 Preset 预设(Admin、Member),以基于内置角色预填权限,然后按需调整。
  5. 为该角色选择权限: * 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。
  6. 选择 Save 保存。

将自定义实例角色分配给用户

具有 Roles: Manage all roles 权限的用户可以分配自定义实例角色。

分配自定义实例角色:

  1. 转到 Settings 设置 > Users 用户。
  2. 找到要更新的用户。
  3. 选择该用户当前角色,打开角色下拉菜单。
  4. 在 Custom roles 自定义角色 下,选择要分配的角色。

编辑自定义实例角色

更新现有自定义实例角色:

  1. 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
  2. 找到要编辑的自定义角色。
  3. 选择 three-dot menu 三点菜单 > Edit 编辑。
  4. 更新角色名称、描述或权限。
  5. 选择 Save changes 保存更改。

警告

Editing affects all assigned users 编辑会影响所有已分配用户

对自定义实例角色的更改会影响整个实例中拥有该角色的所有用户。

复制自定义实例角色

基于现有角色创建新角色:

  1. 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
  2. 找到要复制的角色。
  3. 选择 three-dot menu 三点菜单 > Duplicate 复制。
  4. 按需更新角色名称和权限。
  5. 选择 Create role 创建角色。

删除自定义实例角色

删除自定义实例角色:

  1. 转到 Settings 设置 > Roles 角色 > Instance roles 实例角色。
  2. 找到要删除的角色。
  3. 选择 three-dot menu 三点菜单 > Delete 删除。
  4. 确认删除。

提示

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 的用户可以编辑自己持有的自定义项目角色,为自己授予该项目中原本未获得的权限。

请仅将这些权限分配给完全可信的用户,并避免不必要地组合这些权限。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。