# 快速開始

本章節協助你在 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 接入詳解](https://www.fastbee.cn/doc/zh-hant/open/v2/quickstart/mqtt.md)
* 設定 [場景聯動](https://www.fastbee.cn/doc/open/v2/manual/scene.md)（简体中文）
* 編寫 [規則指令碼](https://www.fastbee.cn/doc/open/v2/manual/script.md)（简体中文）

## 常見問題

### 快速開始和安裝部署是什麼關係？

安裝部署是前置條件，負責把平台跑起來；快速開始是部署完成後的首次使用引導，涵蓋建立產品到設備接入的最短路徑。

### FastBee 社區版的預設登入帳號是什麼？

預設使用者名稱為 `admin`，密碼為 `admin123`。部署完成後在瀏覽器存取 `http://伺服器IP` 即可登入平台。

### MQTT 用戶端的連線參數怎麼填？

伺服器位址為你的伺服器 IP，連接埠為 1883（TCP），Client ID 格式為 `S&設備編號&產品ID&使用者ID`，使用者名稱和密碼分別填寫 MQTT 帳號與 MQTT 密碼。

### 設備上報屬性資料使用什麼主題？

向 `/{產品ID}/{設備編號}/property/post` 主題發送 JSON 陣列格式的資料，發佈後可在設備詳情頁的物模型資料中查看即時資料。

### 如何確認設備接入成功？

以三個驗收點為準：設備清單中設備顯示線上，設備詳情 > 物模型資料可查看上報的即時資料，設備能正常接收平台下發的指令。

## 相關閱讀

* [安裝部署](https://www.fastbee.cn/doc/open/v2/install.md)（简体中文）：Docker 一鍵部署與傳統系統部署的完整指引
* [MQTT 接入](https://www.fastbee.cn/doc/zh-hant/open/v2/quickstart/mqtt.md)：連線參數、訊息發佈與平台側閉環驗證詳解
* [設備接入常見問題](https://www.fastbee.cn/doc/help/device-access-faq.html)（简体中文）：設備上線啟用、配網與資料儲存的故障排除
