Home Assistant 零基础指南:30分钟装机并跑通第一个自动化
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
反直觉的事实:断网那一刻,多数人的智能家居就瘫痪了,因为逻辑跑在厂商的云端。Home Assistant 是开源本地智能家居平台,把全屋设备收进一个面板,控制逻辑跑在你自己的设备上——断网后灯照样亮。
每台设备一个 APP,每个 APP 一套规则,规则还都存在别人家的服务器上,网一断,整个家"掉线"。这是大多数人放弃智能家居的真正原因。Home Assistant 的解法只有四个字:跑在本地。下文带你从空机器到跑通第一个联动,全程点选,不用写代码。
三种安装路径,各配一条路
| 路径 | 需要什么 | 耗时 | 适合谁 |
|---|---|---|---|
| 树莓派官方镜像 | 树莓派 4/5 + 16GB Class 10 存储卡 | 约10分钟 | 纯新手 |
| Docker | 有 Docker 的 NAS 或闲置主机 | 约5分钟 | 有 IT 基础 |
| 源码运行 | 任意 Linux 机器 + Python 环境 | 半天 | 开发者 |
纯新手:把官方镜像写入存储卡、通电,浏览器能打开页面就算成功——系统、升级、备份都打包在里面,各机型的官方镜像在 machine/ 目录里,硬件选型有官方背书。
有 IT 基础:一条命令拉起,时区改成自己的,不碰现有系统:
docker run -d --name homeassistant --restart=unless-stopped \ -e TZ=Asia/Shanghai -v /data/homeassistant:/config \ --network=host ghcr.io/home-assistant/home-assistant:stable跑两三分钟看到初始化向导,跟着填账号和时区即可。
开发者:克隆源码后建虚拟环境装依赖,用python -m homeassistant --config启动,依赖清单见 requirements.txt。
我的判断:十个人里九个选树莓派路线,理由是一条——坏了重刷就行,没有任何损失。
硬件决定上限,但决定你能否跑通的,是下面的两步。
2分钟接上第一个"设备",不花一分钱 🧩
想最快跑通,先别买硬件,用官方内置的模拟数据:
- 设置 → 设备与服务 → 添加集成
- 搜索 demo,回车,不需要账号和网络
- 约30秒后,设备页会多出一整套模拟的灯、传感器、音箱
去状态页拨动一下light.demo,开关能翻转,环境就算就绪。搜不到 demo 说明版本偏旧,先到系统页更新。后面所有教程都基于这套模拟数据练手,练熟后把目标换成真实设备即可,步骤完全一样。
假的房子比真的房子教你快。
你的第一个自动化:开门就亮灯
目标只有一个:模拟门传感器变成"开"时,模拟灯自动点亮。全程点选:
- 设置 → 自动化与场景 → 自动化 → 新建
- 选"使用对话式编辑器",用一句话描述:门传感器开启时,打开模拟灯
- 保存后手动拨一下传感器,运行日志里能看到灯被触发
习惯 YAML 的话,整条规则就这些:
- alias: 开门亮灯 trigger: - trigger: state entity_id: binary_sensor.demo to: "on" action: - action: light.turn_on target: entity_id: light.demo触发是状态,动作是命令,效果是一条日志——这套"触发→动作→效果"三段式是自动化的全部核心,后面看到的每个玩法都只是它的组合。
换成真设备:三种协议三条路
打开设置 → 设备与服务 → 添加集成,输入品牌名,大部分设备会被自动发现。按协议选路:
- 云接入:飞利浦 Hue 同网段自动弹出,按一下网桥按钮完成配对;走 Tuya 生态的 WiFi 设备直接选 Tuya 集成。坑:先确认设备在 2.4G 网段,5G 频段会让很多设备发现不到。
- 本地接入:Zigbee 先买一个协调器,再让 Home Assistant 批量接管;支持 Matter 的设备一次配对全屋可用;刷 ESPHome 固件的稳定性最好。
- 拿不准:品牌名单维护在 brands/ 目录,1500 多个集成都在 homeassistant/components/,买设备前查一眼自家牌子在不在。
能走本地就走本地——断的是网,断不了你手里的逻辑。
再走一步:从一盏灯到全屋 📺
第一盏灯跑通后,补三件小事就进入"全屋"阶段:
- 分组:客厅 5 盏灯放进一个组,一条命令同开同关,不用在实体名里翻找。
- 场景:"灯调暗到 20% + 电视开 + 音箱音量 10"合成一个"观影模式",一点就触发。
- 媒体:电视、音箱接入后都能被自动化指挥,下面这张演示图里的家庭客厅,就是内置演示集成放的一集动画。
一盏灯和全屋之间,差的只是"分组"这一步。
你一定会踩的5个坑:速查
这五条不是玄学,是高频现象,对号入座:
| 现象 | 常见原因 | 解法 |
|---|---|---|
| 设备发现不到 | 5G WiFi / 与主机不同网段 | 移到 2.4G,或手动填设备 IP |
| 自动化偶发不触发 | 实体状态抖动 | 触发里加"持续 X 秒" |
| Zigbee 传感器掉线 | 信号弱 / 电池耗尽 | 协调器挪近,换电池 |
| 面板用一个月变慢 | 历史数据全量堆积 | 用 recorder 白名单限定记录范围 |
| 更新后集成报错 | 第三方依赖冲突 | 看日志里的具体报错,等官方修复 |
接下来7天:3件能打卡的事
- 今天:设置 → 系统 → 备份,手动建一份备份并开启自动备份,这是全部清单里最重要的一条。
- 第2天:接一台真灯,把自动化的目标从演示实体换成真实实体。
- 第3-4天:做第一个"观影模式"场景,把电视、灯、音箱编进同一组。
别急着添设备,一个稳定跑着的自动化,比十个半成品值钱。
那么,你明天要写的第二个自动化是什么?
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考