Home Assistant 智能家居平台
Home Assistant 官方 Docker 镜像。开源家庭自动化平台,强调本地控制与隐私优先,支持 3500+ 设备与服务集成、自动化、仪表盘、语音助手 Assist 与能源管理,适合在树莓派或本地服务器自托管部署。 https://www.home-assistant.io
特色镜像推荐
Home Assistant(homeassistant/home-assistant)
Home Assistant 官方主镜像,Docker Hub 拉取量 500M+。提供完整家庭自动化运行时,支持数千种集成、自动化规则、仪表盘与 Assist 语音能力。部署时需挂载 /config 目录持久化配置,Web 界面默认通过 8123 端口访问。
Mosquitto Add-on(homeassistant/amd64-addon-mosquitto)
Home Assistant 官方 Mosquitto MQTT Broker Add-on 镜像(amd64),Docker Hub 拉取量 10M+。为 Zigbee2MQTT、ESPHome 等依赖 MQTT 的集成提供消息代理,是构建 MQTT 智能家居架构的常用组件。
Matter Server Add-on(homeassistant/amd64-addon-matter-server)
Home Assistant 官方 Matter Server Add-on 镜像,拉取量约 5M+。用于在 HA 环境中接入 Matter 协议设备,配合 Home Assistant Yellow 等 Matter-ready 硬件实现跨生态互联。
ARM64 架构镜像(homeassistant/aarch64-homeassistant)
面向 ARM64(aarch64)架构的 Home Assistant 构建镜像,适合树莓派、Home Assistant Green 等 ARM 设备部署。功能与通用 home-assistant 镜像一致,按目标平台选择对应架构标签即可。
Home Assistant 智能家居平台集合















推荐技术栈
核心平台
常用协议 Add-on
生态与集成
典型使用场景
本地优先的全屋智能
在自有服务器或树莓派上运行 Home Assistant,将灯光、温控、安防、媒体等设备统一接入,数据与自动化逻辑保留在局域网内。
MQTT 与多协议设备汇聚
配合官方 Mosquitto、Z-Wave JS、Matter Server 等 Add-on,打通 MQTT、Z-Wave、Matter/Thread 等多协议设备,构建混合品牌智能家居。
能源监控与优化
利用 Home Assistant 能源管理功能,对接电表、光伏逆变器、充电桩等,分析用能趋势并优化用电策略。
语音控制与 Assist
通过 Assist 语音助手在本地或移动设备上控制家居,支持唤醒词与自然语言,并可结合社区知识扩展对话能力。
常见问题 (FAQ)
Q1:Home Assistant 是什么?与商业智能家居云有何不同?
Home Assistant 是开源家庭自动化平台,由 Open Home Foundation 支持,强调本地控制、隐私与社区驱动。与依赖厂商云服务的封闭生态不同,HA 优先在本地处理数据与自动化,支持 3500+ 集成,用户可完全自托管。官网介绍其不可被收购出售,商业支持来自 Nabu Casa 等合作伙伴而非出售用户数据。
Q2:使用 Docker 部署 homeassistant/home-assistant 需要注意什么?
官方 Docker 部署需挂载配置目录(通常为 -v /path/to/config:/config)以持久化数据,Web 界面通过 8123 端口访问。部分场景(如 mDNS 设备发现、蓝牙/Z-Wave USB 设备)可能需要 host 网络模式或额外设备映射。完整安装步骤、时区与环境变量请以 www.home-assistant.io 的 Installation 文档为准。
Q3:home-assistant、aarch64-homeassistant、amd64-homeassistant 应如何选择?
homeassistant/home-assistant 是通用主镜像(500M+ 拉取)。aarch64-homeassistant 与 amd64-homeassistant 分别面向 ARM64 与 AMD64 架构的构建分发,便于在树莓派、x86 小主机等目标平台拉取匹配架构的镜像。选型原则:按部署设备的 CPU 架构选择对应仓库或标签,功能上均属 Home Assistant 核心平台。
Q4:Docker Hub 上的 addon 镜像与核心镜像是什么关系?
homeassistant 组织除核心平台外,还发布大量以 addon- 命名的官方 Add-on 镜像(如 mosquitto、matter-server、zwave_js),通常按架构分为 aarch64-addon-* 与 amd64-addon-*。这些镜像用于在 Home Assistant Supervisor/OS 生态中作为附加服务运行,扩展 MQTT、Matter、远程访问等能力;单独用 docker run 部署时需参考各 Add-on 官方说明,在完整 HA OS 环境中则由 Supervisor 统一管理。
Q5:Home Assistant 能否对接 Alexa、Google 等云端语音助手?
可以。官网提供 Alexa、Google Assistant 等集成说明,在保持核心系统本地运行的前提下,通过官方集成将部分控制能力暴露给云端语音助手。若更强调隐私,也可使用内置 Assist 语音助手在本地或移动设备上完成语音控制。