项目管理
项目功能使企业内的多个组织或部门能够独立使用和管理各自的 MQTT 集群。通过为不同角色分配权限,可以实现对平台能力的更细化管理。基于项目的结构,每个组织或部门都可以独立管理其所属的 MQTT 集群,并实现资源与账单的隔离。在多项目机制下,所有部署必须创建在某个项目下,且每个部署只能属于一个项目。
查看项目
您可以通过控制台的多个入口查看和管理项目:
- 在控制台首页的项目管理区块中,点击查看所有项目。
- 或者,在左侧导航栏点击项目管理。
进入项目管理页面,您将看到所有已创建的项目。每个项目卡片展示以下信息:
- 项目名称与描述
- EMQX Broker 概览,包括:
- Broker 总数
- 运行中的 Broker 数量
- 已停止的 Broker 数量
TIP
如果您是项目管理员或项目使用者角色,只能访问您被授权查看的项目。有关各角色对应的项目管理权限,请参见角色与权限。
点击项目卡片可进入项目概览页面,在该页面中可以创建和管理该项目下的部署。
创建项目
您可以在项目管理页面或控制台**首页(概览)**页面中点击 + 新建项目来创建新项目。
- 进入项目管理或控制台首页。
- 点击 + 新建项目。
- 在弹出的新建项目对话框中,填写项目名称和备注(备注为必填项)。
- 点击确认创建项目。
注意
EMQX Platform 控制台最多支持创建 20 个项目。
在项目下创建部署
要创建部署,您需要先进入目标项目:
- 点击项目卡片进入项目概览页面。
- 在项目概览页面中,有以下两种方式可创建部署:
- 直接点击页面中的 + 新建部署。
- 或点击左侧菜单中的 EMQX Broker,在该页面中点击 + 新建部署。
有关部署的详细创建步骤,请参见:创建部署章节。
为提升多部署场景下的管理效率,项目页面顶部的面包屑导航支持下拉切换项目与部署,实现快速跳转与自动刷新页面数据。

移动部署至其他项目
点击部署卡片右上角的菜单按钮,选择移动到。
在弹出的下拉菜单中选择目标项目。
点击确认后,部署将被移动到所选项目中。
编辑项目名称与备注
TIP
仅主账号用户(管理员账户) 可以编辑项目名称和备注。详见:管理子账号。
- 点击目标项目卡片进入项目。
- 在左侧菜单中点击项目设置。
- 在基础设置区块中修改项目名称与备注。
- 点击保存。

删除项目
TIP
仅主账号用户(管理员账户) 可以删除项目。详见:管理子账号。
注意
删除项目前,请确保该项目下没有任何部署。
- 点击目标项目卡片进入项目。
- 在左侧菜单中点击项目设置。
- 滚动至页面底部,点击删除项目按钮。
- 确认提示后点击确认执行删除操作。
添加项目成员
如果您是管理员角色,可以将团队成员分配至项目中,包括创建新成员账户或添加已有成员账户,以实现更灵活的协作和权限控制。
点击目标项目卡片进入项目。
在左侧菜单中点击项目设置。
在项目成员区块中点击**+ 添加**。在弹出的添加项目成员对话框中:
可选择添加新建用户或已有用户。
若为新建用户:
- 输入有效的成员账号(邮箱地址)
- 设置登录**密码****
- 可填写备注(可选)
- 选择角色:
- 项目管理员
- 项目使用者
点击确认即可添加成员至项目。您可以重复此操作添加更多成员。