# 成员角色与权限设置成员角色和权限分为 **团队角色** 和 **项目角色** 两个层级。邀请成员加入团队或项目时，根据邀请入口和邀请者自身的权限，可能会同时配置受邀者的团队角色与项目权限。 - [管理项目成员](https://docs.apifox.com/project-member-management.md) - [管理团队成员](https://docs.apifox.com/team-member-management.md) ## 团队角色与权限 ### 默认团队角色与权限 Apifox 提供 **团队所有者、团队管理员、团队成员、游客** 四种内置团队角色。为成员分配团队角色，可以控制其成员管理、团队设置和项目操作等团队级权限。

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

:::info[] 团队角色暂不支持自定义。 ::: :::note[组织级团队所有权管理] 上表说明的是成员在单个团队中的角色权限。对于归属于组织的团队，组织所有者和组织管理员还可以从组织管理页面移交团队所有权。此权限来自组织角色，不会改变上表中的团队角色权限。详情请参见[管理组织内的团队](https://docs.apifox.com/managing-teams-in-org.md)。 ::: #### 游客角色说明 **游客**是受限的内置团队角色，适用于暂时不需要访问团队项目的成员。 - **团队页面**：游客无法查看 **我的团队 → 成员/权限** 中的成员列表及角色权限内容。在团队设置中，仅保留本人 **我的团队内昵称** 的编辑入口。 - **已有项目**：成员的团队角色一旦改为 **游客**，其在当前团队的所有已有项目会自动改为 **禁止访问** 状态。即使之后将该成员改为其他团队角色，原有 **项目角色** 也不会自动恢复，需要管理员重新分配。 - **[新建项目](https://docs.apifox.com/project-basic-operations.md)**：创建项目时，无论 **其他成员的项目权限** 选择什么角色，游客默认无法访问该新建项目。如有所需，请在项目创建后找管理员分配项目权限。 :::info[] 团队角色 **游客** 与项目访问状态 **禁止访问** 是不同层级概念。 ::: ### 设置团队角色团队角色可以在成员设置中调整；如果邀请页面提供团队角色配置项，也可以在发送邀请时直接设置。给团队成员设置 **团队角色** 或 **项目角色** 的步骤：打开 **Apifox 主窗口 → 我的团队 → 成员/权限**。找到目标成员，点击其右侧的设置图标 `⚙️`。给这个成员选择合适的权限级别。 ![image.png](https://api.apifox.com/api/v1/projects/5097254/resources/684820/image-preview) ## 项目角色与权限 ### 默认项目角色与权限 Apifox 提供 **管理员、编辑者和只读成员** 三种内置项目角色及 **禁止访问** 状态： - **管理员**：可管理项目内容、设置和数据； - **编辑者**：可编辑大部分项目内容和数据，但部分项目设置和高风险操作受限； - **只读成员**：以查看和运行为主，可以执行权限表中标记为可用的操作，但不能修改共享的项目内容和配置； - **禁止访问**：无法访问项目中的信息和数据。以下是默认项目角色的详细权限列表：

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

:::tip[] - 项目角色既可以在邀请成员时配置，也可以在项目成员设置中调整。 - 了解更多：[项目成员管理](https://docs.apifox.com/project-member-management.md)。 ::: ## 自定义角色与权限 “角色与权限”功能可以根据不同协作场景配置更精细的角色权限。目前仅支持自定义项目角色，团队角色和组织角色暂不支持自定义。 ### 自定义项目角色如果 Apifox 内置项目角色不能够满足在项目权限控制相关的需求，可以使用自定义项目角色来解决这个问题。 :::info[] 自定义项目角色仅在[商业旗舰版](https://apifox.com/pricing)中提供。 ::: 在 **Apifox 主窗口 → 成员/权限 → 角色与权限**，或 **组织 → 成员 → 角色与权限** 页面中点击“添加”，即可创建自定义项目角色。 ![image.png](https://api.apifox.com/api/v1/projects/5097254/resources/488248/image-preview) 设置角色名称后，从项目功能列表中勾选该角色可以使用的功能。

:::tip[] - 勾选某个功能模块的“全部权限”后，该模块后续新增的权限也会自动授予此角色。 - 默认角色的名称和权限不可修改。可以复制“编辑者”或“只读成员”，再基于副本快速创建自定义角色。 ::: ## 邀请时的权限配置邀请时可以配置哪些权限，取决于邀请入口以及邀请者拥有的团队和项目管理权限： - **[从团队邀请](https://docs.apifox.com/team-member-management.md)**：只有团队所有者和团队管理员可以发起。邀请时可以设置受邀者的团队角色，并为全部项目统一设置项目角色，或选择“自定义”逐项目配置权限。 - **[从项目邀请](https://docs.apifox.com/project-member-management.md)**：只有当前项目的项目管理员可以发起。 - 如果邀请者同时是团队所有者或团队管理员，可以设置当前项目角色、团队角色和其他项目权限； - 如果邀请者不具备团队管理权限，只能设置当前项目角色。