成员角色与权限设置

成员角色和权限分为 团队角色 和 项目角色 两个层级。邀请成员加入团队或项目时，根据邀请入口和邀请者自身的权限，可能会同时配置受邀者的团队角色与项目权限。

团队角色与权限

默认团队角色与权限

Apifox 提供 团队所有者、团队管理员、团队成员、游客 四种内置团队角色。为成员分配团队角色，可以控制其成员管理、团队设置和项目操作等团队级权限。

资源分类	资源名称	功能	团队所有者	团队管理员	团队成员	游客
团队管理	成员/角色	查看团队成员	✅	✅	✅	❌
		邀请团队成员	✅	✅	❌	❌
		设置/移除团队成员角色	✅	✅	❌	❌
		查看项目角色	✅	✅	❌	❌
		新增、编辑或删除项目角色	✅	✅	❌	❌
	团队设置	修改团队名称	✅	✅	❌	❌
		移交团队	✅	❌	❌	❌
		解散团队	✅	❌	❌	❌
	项目操作	新建项目	✅	✅	❌	❌
		克隆项目	✅	✅	❌	❌
		删除/转移项目	✅	✅	❌	❌
		修改项目名称	✅	✅	❌	❌

团队角色暂不支持自定义。

游客角色说明

游客是受限的内置团队角色，适用于暂时不需要访问团队项目的成员。

团队页面：游客无法查看 我的团队 → 成员/权限 中的成员列表及角色权限内容。在团队设置中，仅保留本人 我的团队内昵称 的编辑入口。

已有项目：成员的团队角色一旦改为游客，其在当前团队的所有已有项目会自动改为 禁止访问 状态。即使之后将该成员改为其他团队角色，原有 项目角色 也不会自动恢复，需要管理员重新分配。

新建项目：创建项目时，无论 其他成员的项目权限 选择什么角色，游客默认无法访问该新建项目。如有所需，请在项目创建后找管理员分配项目权限。

团队角色游客与项目访问状态 禁止访问 是不同层级概念。

设置团队角色

团队角色可以在成员设置中调整；如果邀请页面提供团队角色配置项，也可以在发送邀请时直接设置。

给团队成员设置 团队角色 或 项目角色 的步骤：

打开 Apifox 主窗口 → 我的团队 → 成员/权限。

找到目标成员，点击其右侧的设置图标 ⚙️。

给这个成员选择合适的权限级别。

项目角色与权限

默认项目角色与权限

Apifox 提供 管理员、编辑者和只读成员 三种内置项目角色及 禁止访问 状态：

管理员：可管理项目内容、设置和数据；

编辑者：可编辑大部分项目内容和数据，但部分项目设置和高风险操作受限；

只读成员：以查看和运行为主，可以执行权限表中标记为可用的操作，但不能修改共享的项目内容和配置；

禁止访问：无法访问项目中的信息和数据。

以下是默认项目角色的详细权限列表：

资源分类	资源名称	功能	只读成员	编辑者	管理员	禁止访问
分支管理	迭代分支	查看、切换	✅	✅	✅	❌
		合并	❌	✅	✅	❌
		查看/提交合并请求	❌	✅	✅	❌
		保护分支内容增删改、合并	❌	❌	✅	❌
	API 版本	查看、切换	✅	✅	✅	❌
接口管理	接口包括用例、MD、WS、通用接口文档等相关资源	查看、运行	✅	✅	✅	❌
		增删改	❌	✅	✅	❌
		生成代码	❌	✅	✅	❌
		接口用例增删改	❌	✅	✅	❌
	数据模型	查看、引用	✅	✅	✅	❌
	数据模型	增删改	❌	✅	✅	❌
	组件库	查看、引用	✅	✅	✅	❌
	组件库	增删改	❌	✅	✅	❌
	快捷请求	查看、发送	✅	✅	✅	❌
	快捷请求	增删改	❌	✅	✅	❌
	回收站	查看	❌	✅	✅	❌
		恢复	❌	✅	✅	❌
		永久删除	❌	❌	✅	❌
自动化测试	测试场景	查看、运行功能测试	✅	✅	✅	❌
		运行性能测试	✅	✅	✅	❌
		增删改	❌	✅	✅	❌
		导出外部程序运行	❌	✅	✅	❌
	定时任务	查看/立即运行	✅	✅	✅	❌
	定时任务	增删改	❌	✅	✅	❌
	测试报告	删除	❌	✅	✅	❌
环境管理	全局变量	查看、编辑本地值	✅	✅	✅	❌
	全局变量	增删改	❌	✅	✅	❌
	全局参数	查看	✅	✅	✅	❌
	全局参数	增删改	❌	✅	✅	❌
	Vault Secrets（密钥库）	增删改查	❌	✅	✅	❌
	环境	查看、编辑本地值	✅	✅	✅	❌
	环境	增删改	❌	✅	✅	❌
分享文档	快捷分享	查看	✅	✅	✅	❌
	快捷分享	增删改	❌	✅	✅	❌
	发布文档	查看、预览	✅	✅	✅	❌
	发布文档	发布设置	❌	❌	✅	❌
项目设置	基本设置	查看	✅	✅	✅	❌
		修改	❌	❌	✅	❌
		项目克隆	❌	❌	✅	❌
	成员管理	查看	❌	❌	✅	❌
		添加	❌	❌	✅	❌
		成员角色设置/移除	❌	❌	✅	❌
	功能设置包括接口功能设置、响应校验设置、Mock 设置、高级设置	查看	✅	✅	✅	❌
	功能设置包括接口功能设置、响应校验设置、Mock 设置、高级设置	增删改	❌	❌	✅	❌
	通知对象	查看	✅	✅	✅	❌
	通知对象	增删改	❌	✅	✅	❌
	通知事件	查看	✅	✅	✅	❌
	通知事件	增删改	❌	✅	✅	❌
	常用参数	查看、引用	✅	✅	✅	❌
	常用参数	增删改	❌	✅	✅	❌
	迭代分支	查看	✅	✅	✅	❌
	迭代分支	增删改、保护、归档、恢复	❌	✅	✅	❌
	API 版本	查看	✅	✅	✅	❌
	API 版本	增删改	❌	✅	✅	❌
	公共脚本	查看、引用	✅	✅	✅	❌
	公共脚本	增删改	❌	✅	✅	❌
	数据库连接	查看、引用	✅	✅	✅	❌
	数据库连接	增删改	❌	✅	✅	❌
	自定义函数	查看、引用	✅	✅	✅	❌
	自定义函数	增删改	❌	✅	✅	❌
	导入数据	手动导入	❌	✅	✅	❌
		定时导入手动触发	❌	✅	✅	❌
		定时导入设置	❌	❌	✅	❌
	导出数据	导出数据	❌	✅	✅	❌
请求历史	本地请求历史	查看	✅	✅	✅	❌
	本地请求历史	分享	✅	✅	✅	❌
	共享请求历史	查看	✅	✅	✅	❌
	共享请求历史	删除	❌	✅	✅	❌

项目角色既可以在邀请成员时配置，也可以在项目成员设置中调整。

了解更多：项目成员管理。

自定义角色与权限

“角色与权限”功能可以根据不同协作场景配置更精细的角色权限。目前仅支持自定义项目角色，团队角色和组织角色暂不支持自定义。

自定义项目角色

如果 Apifox 内置项目角色不能够满足在项目权限控制相关的需求，可以使用自定义项目角色来解决这个问题。

自定义项目角色仅在商业旗舰版中提供。

在 Apifox 主窗口 → 成员/权限 → 角色与权限，或 组织 → 成员 → 角色与权限 页面中点击“添加”，即可创建自定义项目角色。

设置角色名称后，从项目功能列表中勾选该角色可以使用的功能。

勾选某个功能模块的“全部权限”后，该模块后续新增的权限也会自动授予此角色。

默认角色的名称和权限不可修改。可以复制“编辑者”或“只读成员”，再基于副本快速创建自定义角色。

邀请时的权限配置

邀请时可以配置哪些权限，取决于邀请入口以及邀请者拥有的团队和项目管理权限：

从团队邀请：只有团队所有者和团队管理员可以发起。邀请时可以设置受邀者的团队角色，并为全部项目统一设置项目角色，或选择“自定义”逐项目配置权限。

从项目邀请：只有当前项目的项目管理员可以发起。

如果邀请者同时是团队所有者或团队管理员，可以设置当前项目角色、团队角色和其他项目权限；

团队角色与权限#

默认团队角色与权限#

游客角色说明#

设置团队角色#

项目角色与权限#

默认项目角色与权限#

自定义角色与权限#

自定义项目角色#

邀请时的权限配置#

团队角色与权限

默认团队角色与权限

游客角色说明

设置团队角色

项目角色与权限

默认项目角色与权限

自定义角色与权限

自定义项目角色

邀请时的权限配置