Home Assistant（简称HA）全解

一、基础介绍

Home Assistant是Python 开发、完全开源免费的本地智能家居中枢平台，2013 年诞生，归属非营利 Open Home 基金会，核心理念：本地优先、隐私可控、打通全品牌智能设备。

一句话定位：把米家、苹果 HomeKit、飞利浦、华为、涂鸦等杂牌智能设备收拢到一个后台，自由做自动化联动，数据存在本地不上厂商云端。

官方DEMO在线体验

核心优势

1. 海量设备兼容：3500 + 官方集成，Zigbee/Z-Wave/MQTT/WiFi 全协议通吃，国内米家、易来、绿米、涂鸦全系完美接入；
2. 本地运行：断外网照样自动执行开灯、温控，隐私不泄露；
3. 超强自动化：可视化 + YAML 双配置，天亮开窗、人来开灯、室温超 26℃自动开空调一键设置；
4. 高度自定义：自定义 UI 大屏面板、接入 HomeKit / 小爱 / 谷歌 / 亚马逊语音控制；
5. HACS 插件商店：社区上万第三方插件，补全官方没有的设备对接。

二、四种主流安装方案（从易到难）

1. HA OS（新手首选，全功能）

刷镜像独立系统，树莓派 4/5、N100 小主机、旧电脑、虚拟机 VMware，烧录镜像开机即用，地址：http://IP:8123（默认 8123 端口）。

• 优点：完整功能、一键升级、自带插件商店；缺点：独占整机系统。

2. Docker 部署（NAS / 常备服务器首选）

群晖、威联通、Linux 服务器用容器安装，不破坏原有系统，灵活启停。

3. Supervised（Linux 系统内嵌 HA）

Ubuntu/Debian 系统下安装，兼顾系统自由和 HA 全功能。

4. Core（最简纯 Python）

仅核心程序，无附加组件，适合极客二次开发。

三、新手入门三步

1. 初始化：打开IP:8123→注册管理员账号→填写地区时区；
2. 添加设备：设置→设备与服务→右下角添加集成，搜「Xiaomi Miot」对接米家、Zigbee 配网、MQTT 网关；
3. 做自动化：设置→自动化与场景，可视化编辑器拖拽配置（无需写代码）： 示例：人体传感器有人移动 → 开启客厅主灯，关灯延时 5 分钟。

四、国内必备配套

1. HACS：第三方应用商店，安装小众设备插件、自定义仪表盘；
2. Zigbee 网关：CC2652P/ZBT-2 USB 棒，本地 Zigbee 设备免厂商网关接入；
3. 内网穿透：FRP/DDNS 实现外网随时随地远程控制家中设备；
4. 米家接入：MIoT 插件（免网关直连米家云端设备）、Zigbee 网关本地对接两种方案。

五、常见玩法

• 全屋可视化中控大屏：电脑 / 平板做墙面控制面板，展示温湿度、用电、设备状态；
• 跨生态互通：小爱音箱控制 HomeKit 设备、苹果 Siri 开关米家插座；
• 能耗监控：智能插座统计家电功耗，联动省电自动化。