快速開始
本章節協助你在 15 分鐘內完成 FastBee 開源版的首次體驗。完成部署後，按照以下步驟在 5 分鐘內建立第一個物聯網產品並接入設備。
頁面導讀
頁面內容快速開始欄目主流程：從登入平台、建立產品、定義物模型到 MQTT 接入驗證的完整首次體驗路徑。
適用場景適合完成部署後第一次使用平台的使用者，按步驟建立產品、定義物模型、新增設備並完成 MQTT 連線測試。
前置條件已完成安裝部署，可正常存取 Web 控制台，並準備一個 MQTT 用戶端（如 MQTTX）。
驗收點平台可查看設備線上狀態，設備能上報屬性資料並接收平台下發的指令。
1. 登入平台
瀏覽器存取 http://伺服器IP，使用預設帳號登入：
- 使用者名稱：
admin - 密碼：
admin123
2. 建立產品
- 進入 物聯網 > 產品管理
- 點擊 新增 按鈕
- 填寫產品資訊：
- 產品名稱：如「溫濕度感測器」
- 產品分類：選擇或新建分類
- 設備類型：選擇「直連設備」
- 認證方式：選擇「簡單認證（一機一密）」
- 點擊 確定 儲存
3. 定義物模型
在產品詳情頁點擊 物模型 頁籤。
- 新增 屬性：如「溫度」（資料型別：float，單位：℃）
- 新增 屬性：如「濕度」（資料型別：float，單位：%RH）
- 新增 功能（可選）：如「開關」（資料型別：bool）
- 點擊 發佈 使物模型生效
4. 新增設備
- 進入 物聯網 > 設備管理
- 點擊 新增 按鈕
- 選擇剛建立的產品
- 填寫設備名稱（如「sensor-001」）
- 系統自動產生 設備編號 和 認證金鑰，記錄這些資訊
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. 查看資料
- 即時資料：設備詳情 > 物模型資料
- 設備日誌：設備詳情 > 設備日誌
- 線上狀態：設備清單中查看設備是否線上
下一步
常見問題
快速開始和安裝部署是什麼關係？
安裝部署是前置條件，負責把平台跑起來；快速開始是部署完成後的首次使用引導，涵蓋建立產品到設備接入的最短路徑。
FastBee 開源版的預設登入帳號是什麼？
預設使用者名稱為 admin，密碼為 admin123。部署完成後在瀏覽器存取 http://伺服器IP 即可登入平台。
MQTT 用戶端的連線參數怎麼填？
伺服器位址為你的伺服器 IP，連接埠為 1883（TCP），Client ID 格式為 S&設備編號&產品ID&使用者ID，使用者名稱和密碼分別填寫 MQTT 帳號與 MQTT 密碼。
設備上報屬性資料使用什麼主題？
向 /{產品ID}/{設備編號}/property/post 主題發送 JSON 陣列格式的資料，發佈後可在設備詳情頁的物模型資料中查看即時資料。
如何確認設備接入成功？
以三個驗收點為準：設備清單中設備顯示線上，設備詳情 > 物模型資料可查看上報的即時資料，設備能正常接收平台下發的指令。