项目管理

项目功能使企业内的多个组织或部门能够独立使用和管理各自的 MQTT 集群。通过为不同角色分配权限，可以实现对平台能力的更细化管理。基于项目的结构，每个组织或部门都可以独立管理其所属的 MQTT 集群，并实现资源与账单的隔离。在多项目机制下，所有部署必须创建在某个项目下，且每个部署只能属于一个项目。

查看项目

您可以通过控制台的多个入口查看和管理项目：

• 在控制台首页的项目管理区块中，点击查看所有项目。
• 或者，在左侧导航栏点击项目管理。

进入项目管理页面，您将看到所有已创建的项目。每个项目卡片展示以下信息：

• 项目名称与描述
• EMQX Broker 概览，包括：
  • Broker 总数
  • 运行中的 Broker 数量
  • 已停止的 Broker 数量

TIP

如果您是项目管理员或项目使用者角色，只能访问您被授权查看的项目。有关各角色对应的项目管理权限，请参见角色与权限。

点击项目卡片可进入项目概览页面，在该页面中可以创建和管理该项目下的部署。

创建项目

您可以在项目管理页面或控制台概览页面中点击 + 新建项目来创建新项目。

1. 进入项目管理或控制台首页。
2. 点击 + 新建项目。
3. 在弹出的新建项目对话框中，填写项目名称和备注（备注为必填项）。
4. 点击确认创建项目。

注意

EMQX Platform 控制台最多支持创建 20 个项目。

在项目下创建部署

要创建部署，您需要先进入目标项目：

1. 点击项目卡片进入项目概览页面。
2. 在项目概览页面中，有以下两种方式可创建部署：
   • 直接点击页面中的 + 新建部署。
   • 或点击左侧菜单中的 EMQX Broker，在该页面中点击 + 新建部署。

有关部署的详细创建步骤，请参见：创建部署章节。

为提升多部署场景下的管理效率，项目页面顶部的面包屑导航支持下拉切换项目与部署，实现快速跳转与自动刷新页面数据。

移动部署至其他项目

1. 点击部署卡片右上角的菜单按钮，选择移动到。

   

2. 在弹出的下拉菜单中选择目标项目。

3. 点击确认后，部署将被移动到所选项目中。

编辑项目名称与备注

TIP

仅主账号用户（管理员账户） 可以编辑项目名称和备注。详见：管理子账号。

1. 点击目标项目卡片进入项目。
2. 在左侧菜单中点击项目设置。
3. 在基础设置区块中修改项目名称与备注。
4. 点击保存。

删除项目

TIP

仅主账号用户（管理员账户） 可以删除项目。详见：管理子账号。

注意

删除项目前，请确保该项目下没有任何部署。

1. 点击目标项目卡片进入项目。
2. 在左侧菜单中点击项目设置。
3. 滚动至页面底部，点击删除项目按钮。
4. 确认提示后点击确认执行删除操作。

添加项目成员

如果您是管理员角色，可以将团队成员分配至项目中，包括创建新成员账户或添加已有成员账户，以实现更灵活的协作和权限控制。

1. 点击目标项目卡片进入项目。

2. 在左侧菜单中点击项目设置。

3. 在项目成员区块中点击 + 添加。在弹出的添加项目成员对话框中：

   • 可选择添加新建用户或已有用户。

   • 若为新建用户：

     • 输入有效的成员账号（邮箱地址）
     • 设置登录密码
     • 可填写备注（可选）
     • 选择角色：
       • 项目管理员
       • 项目使用者

4. 点击确认即可添加成员至项目。您可以重复此操作添加更多成员。