Home Assistant（简称 HA）是一个开源的智能家居平台，支持连接数百种智能设备和服务。本文将为你详细介绍如何在 Home Assistant 中添加设备、服务和第三方集成。
1. 准备工作
在开始添加设备前，请确保：
- 你已成功安装并运行 Home Assistant（可通过 Raspberry Pi、Docker、Hass.io 等方式部署）
- 你的设备与 Home Assistant 处于同一局域网
- 你已登录 Home Assistant 的 Web 管理界面（通常为
http://homeassistant.local:8123）
2. 通过“设置”添加集成
Home Assistant 使用“集成（Integrations）”来管理不同品牌或协议的设备。添加步骤如下：
- 点击左侧菜单中的 设置（Settings）
- 选择 设备与服务（Devices & Services）
- 点击右下角的 + 添加集成（Add Integration）
- 在搜索框中输入设备品牌或协议名称（如 “Xiaomi”, “MQTT”, “ESPHome”）
- 按照向导完成账号授权、IP 地址填写等配置
提示：Home Assistant 内置了 1000+ 78TP集成，大多数主流品牌（如 Philips Hue、TP-Link、Sonos、小米、涂鸦等）都可直接添加。
3. 常见设备添加示例
3.1 添加小米设备（通过 Miio 集成）
- 确保设备已接入米家 App 并连接 Wi-Fi
- 获取设备 IP 和 Token（可使用工具如
miio-cli）
- 在 HA 中搜索 “Xiaomi Miio”，输入 IP 和 Token 即可
3.2 添加 ESPHome 设备
- 使用 ESPHome 编写 YAML 配置并烧录到 ESP8266/ESP32
- 设备上线后，HA 会自动发现，点击确认即可添加
4. 手动编辑 configuration.yaml（高级用户）
部分旧版集成或自定义功能需手动编辑配置文件。例如添加 MQTT 传感器：
sensor:
- platform: mqtt
name: "客厅温度"
state_topic: "home/livingroom/temp"
修改后需重启 Home Assistant 或点击“检查配置”并重新加载。
5. 故障排查建议
- 设备未被发现？检查网络是否在同一子网
- 添加失败？查看日志（设置 → 系统 → 日志）
- 权限问题？确保 HA 有访问设备 API 的权限
6. 资源推荐