快速开始

本章节帮助你在 15 分钟内完成 FastBee 开源版的首次体验。完成部署后，按照以下步骤在 5 分钟内创建第一个物联网产品并接入设备。

页面导读

页面内容快速开始栏目主流程：从登录平台、创建产品、定义物模型到 MQTT 接入验证的完整首次体验路径。

适用场景适合完成部署后第一次使用平台的用户，按步骤创建产品、定义物模型、添加设备并完成 MQTT 连接测试。

前置条件已完成安装部署，可正常访问 Web 控制台，并准备一个 MQTT 客户端（如 MQTTX）。

验收点平台可查看设备在线状态，设备能上报属性数据并接收平台下发的指令。

1. 登录平台

浏览器访问 http://服务器IP，使用默认账号登录：

• 用户名：admin
• 密码：admin123

2. 创建产品

1. 进入 物联网 > 产品管理
2. 点击 新增 按钮
3. 填写产品信息：
   • 产品名称：如 "温湿度传感器"
   • 产品分类：选择或新建分类
   • 设备类型：选择 "直连设备"
   • 认证方式：选择 "简单认证（一机一密）"
4. 点击 确定 保存

3. 定义物模型

在产品详情页点击 物模型 标签页。

1. 添加 属性：如 "温度"（数据类型：float，单位：℃）
2. 添加 属性：如 "湿度"（数据类型：float，单位：%RH）
3. 添加 功能（可选）：如 "开关"（数据类型：bool）
4. 点击 发布 使物模型生效

4. 添加设备

1. 进入 物联网 > 设备管理
2. 点击 新增 按钮
3. 选择刚创建的产品
4. 填写设备名称（如 "sensor-001"）
5. 系统自动生成 设备编号 和 认证密钥，记录这些信息

5. MQTT 连接测试

使用任意 MQTT 客户端（如 MQTTX、MQTT.fx）连接平台：

参数	值
服务器地址	你的服务器 IP
端口	1883 (TCP)
Client ID	S&设备编号&产品ID&用户ID
用户名	MQTT 账号
密码	MQTT 密码

上报属性数据

向以下主题发送 JSON 数据：

Topic: /{产品ID}/{设备编号}/property/post

[{
  "id": "temperature",
  "value": "25.6",
  "remark": ""
}, {
  "id": "humidity",
  "value": "60.2",
  "remark": ""
}]

发布后在设备详情页 物模型数据 中查看实时数据。

6. 查看数据

• 实时数据：设备详情 > 物模型数据
• 设备日志：设备详情 > 设备日志
• 在线状态：设备列表中查看设备是否在线

下一步

• 学习 MQTT 接入详解
• 配置 场景联动
• 编写 规则脚本

常见问题

快速开始和安装部署是什么关系？

安装部署是前置条件，负责把平台跑起来；快速开始是部署完成后的首次使用引导，覆盖创建产品到设备接入的最短路径。

FastBee 开源版的默认登录账号是什么？

默认用户名为 admin，密码为 admin123。部署完成后在浏览器访问 http://服务器IP 即可登录平台。

MQTT 客户端的连接参数怎么填？

服务器地址为你的服务器 IP，端口为 1883（TCP），Client ID 格式为 S&设备编号&产品ID&用户ID，用户名和密码分别填写 MQTT 账号与 MQTT 密码。

设备上报属性数据使用什么主题？

向 /{产品ID}/{设备编号}/property/post 主题发送 JSON 数组格式的数据，发布后可在设备详情页的物模型数据中查看实时数据。

如何确认设备接入成功？

以三个验收点为准：设备列表中设备显示在线，设备详情 > 物模型数据可查看上报的实时数据，设备能正常接收平台下发的指令。