项目简介
Home Assistant 是一款以本地控制和隐私优先为核心理念的开源智能家居自动化平台。项目采用 Python 开发,支持在 Raspberry Pi、NAS 或本地服务器上运行,可连接超过 3000 种智能设备,涵盖照明、温控、安防、媒体播放器等品类。Home Assistant 强调所有数据处理和设备控制均在本地完成,无需依赖云服务,确保家庭隐私安全。
Home Assistant 在 GitHub 上拥有超过 77k Stars,最新版本为 2026.5.4,拥有活跃的全球社区,每月发布新版本,是智能家居领域最受欢迎的开源解决方案。
核心功能
- 3000+ 设备集成:支持飞利浦 Hue、小米米家、涂鸦智能、Sonos、Nest、Ring 等主流品牌设备
- 自动化引擎:基于 YAML 或可视化编辑器创建复杂自动化规则,支持条件判断、时间触发、传感器联动
- 场景模式:一键切换回家、离家、睡眠、观影等预设场景,批量控制多个设备
- 能源监控:实时追踪家庭用电量、太阳能发电、电池储能数据,生成详细能耗报告
- 安防监控:集成摄像头、门窗传感器、烟雾报警器,支持实时画面查看和异常告警
- 语音助手集成:支持 Amazon Alexa、Google Assistant、Apple Siri 语音控制
- 仪表盘定制:通过 Lovelace UI 自由拖拽组建个性化控制面板,支持多种卡片样式
- 移动端应用:提供 iOS 和 Android 原生 App,支持推送通知和地理围栏触发
- 本地语音控制:集成 Whisper 语音识别和 Piper 语音合成,实现离线语音指令
- ESPHome 设备自制:通过 ESPHome 固件将 ESP8266/ESP32 开发板变为智能设备
- Node-RED 工作流:与 Node-RED 深度集成,通过可视化节点编排复杂自动化流程
- 历史数据记录:长期存储传感器数据,支持趋势分析和图表可视化
- 备份与恢复:支持完整配置备份,一键迁移到新设备
- 多用户与权限:支持家庭成员账户,可设置不同区域的访问权限
- MQTT 代理:内置 MQTT Broker,方便接入 DIY 物联网设备
仓库信息
- GitHub 地址:https://github.com/home-assistant/core
- 官方网站:https://www.home-assistant.io/
- 官方文档:https://www.home-assistant.io/docs/
- 在线演示:https://demo.home-assistant.io/
- 开发语言:Python 100%
- 开源协议:Apache-2.0
- Stars 数量:77k+
安装方式
方式一:Home Assistant OS(推荐,Raspberry Pi / x86)
# 下载对应设备的镜像文件
# https://www.home-assistant.io/installation/
# 使用 Etcher 将镜像写入 SD 卡或 U 盘
# 插入设备启动,访问 http://homeassistant.local:8123 完成初始化
方式二:Docker 部署
docker run -d --name homeassistant \
--privileged \
--restart unless-stopped \
-e TZ=Asia/Shanghai \
-v /path/to/config:/config \
-v /run/dbus:/run/dbus:ro \
--network host \
ghcr.io/home-assistant/home-assistant:stable
方式三:Docker Compose 部署
version: '3.8'
services:
homeassistant:
image: ghcr.io/home-assistant/home-assistant:stable
container_name: homeassistant
privileged: true
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
volumes:
- ./config:/config
- /run/dbus:/run/dbus:ro
network_mode: host
方式四:Python 虚拟环境安装(Linux)
# 创建虚拟环境
python3 -m venv homeassistant
source homeassistant/bin/activate
# 安装 Home Assistant
pip install homeassistant
# 启动服务
hass
方式五:Home Assistant Container(含 Supervisor)
# 使用官方安装脚本
curl -fsSL get.home-assistant.io | bash
使用场景
- 全屋智能控制中心:统一管理家中所有智能设备,替代多个品牌 App
- 自动化节能方案:根据光照、温度、人员存在自动调节空调和照明
- 家庭安防系统:门窗传感器+摄像头+报警器联动,异常自动推送通知
- 老人儿童看护:跌倒检测、长时间未活动告警、电子围栏安全提醒
- 影音娱乐联动:观影模式自动关闭窗帘、调暗灯光、开启投影仪
- 花园灌溉自动化:根据土壤湿度和天气预报自动浇水
- 能源自给监控:太阳能+储能电池+电网实时数据可视化
与同类产品对比
| 特性 | Home Assistant | 小米米家 | Apple HomeKit | Google Home |
|---|---|---|---|---|
| 部署方式 | 自托管 | 仅云端 | 仅本地网关 | 仅云端 |
| 数据隐私 | 完全本地 | 小米云端 | Apple 云端 | Google 云端 |
| 开源协议 | Apache-2.0 | 闭源 | 闭源 | 闭源 |
| 设备兼容性 | 3000+ | 小米生态 | HomeKit 认证 | Google 生态 |
| 自动化能力 | 极强 | 基础 | 基础 | 基础 |
| 定制自由度 | 极高 | 有限 | 有限 | 有限 |
| 使用成本 | 免费 | 免费 | 需 Apple 设备 | 免费 |
| 离线运行 | 完全支持 | 部分受限 | 部分受限 | 不支持 |
| 社区生态 | 极活跃 | 一般 | 一般 | 一般 |