Home Assistant 搭建指南:10分钟跑通第一个全屋自动化
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
猫要开门才叫,智能灯要先开三个 APP 才亮:装应用、注册账号、连网,断网时你就剩一个昂贵的照明件。Home Assistant 是一个开源智能家居平台,把全部控制逻辑搬回你自己家里的设备。这篇带你从装机走到第一个自动化生效,全程不用写代码。
Home Assistant 值得装的理由:三条硬证据 🧭
控制逻辑不出家门。自动化引擎在本地进程里跑,拔了外网,灯和窗帘照常联动——稳定性由你自己的硬件说了算。
内置集成超过 1500 个。homeassistant/components/ 目录下一个品牌一个文件夹,从 Hue 到 Z-Wave 都能翻到,买设备前先查自家牌子在不在名单里。
自动化只分三段。触发 → 条件 → 动作,界面提供对话式编辑器,第一条规则通常十分钟配完。
APP 还在,但从今往后它替你干活。
Home Assistant 安装方式二选一,按身份对号入座 🚀
官方系统镜像——纯新手:一块树莓派 4/5 加 16GB 起步的 Class 10 存储卡,刷入镜像通电即用,系统、升级、备份全内置,坏了重刷即可。各机型官方镜像放在 machine/ 目录里。
Docker 一行命令——有 NAS 或闲置小主机:
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这条命令把 Home Assistant 拉进容器、挂好配置目录,还带断电自动重启,一条搞定。
开发者可以直接克隆 https://gitcode.com/GitHub_Trending/co/core ,用python -m homeassistant跑源码,依赖清单见 requirements.txt。
10分钟配好一个日落开灯自动化,就三步 🌆
第一条规则别贪多,只做一件小事:日落前 30 分钟,客厅灯自动亮起。
界面路径:设置 → 自动化与场景 → 自动化 → 新建 → 对话式编辑器。
- 触发:选"太阳"事件,偏移量填 -30 分钟,意思是日落后 30 分钟的前一刻;
- 条件:第一次可以留空,或加"人在家",避免空房子开灯;
- 动作:选
light.turn_on,挑出你的客厅灯,亮度拖到 80。
保存,当晚见分晓。偏爱 YAML 的话,上面这条规则等价于:
- alias: 日落开灯 trigger: [{trigger: sun, event: sunset, offset: "-00:30:00"}] action: - action: light.turn_on target: {entity_id: light.living_room} data: {brightness_pct: 80}翻译成人话:日落前 30 分钟,把这盏灯打开,亮度设成八成。
Home Assistant 设备接入:三条通道各一条推荐路径 🔌
本地协议(Zigbee / Thread / 本地 WiFi):推荐路径是先接上 Zigbee 协调器,再让 ZHA 集成接管,传感器一次进一大批,之后完全不依赖云端。高频坑:协调器离设备太远,信号弱了会集体掉线,放家里中央位置,别塞在角落。
品牌云(涂鸦、小米等):推荐路径是直接选对应品牌的官方集成,扫码登录就能用,上手最快。高频坑:云集成依赖账号归属和外部网络,断网或账号跨区,设备会显示"不可用"。
新标准(Matter / HomeKit):推荐路径是设备支持 Matter 就优先走它配网,一次配对全屋可用,自动化也能直接调用。高频坑:Matter 覆盖的是基础控制,读门锁电量这类高级功能仍要回品牌自有通道。
Home Assistant 上线第一周必做的 4 件事
- 打开自动备份(设置 → 系统 → 备份)。系统翻车时一键恢复,不用全屋重配。验证:备份页看"上次备份"时间,24 小时内才算在干活。
- 给 recorder 设白名单,只记传感器和关键开关。全量记录会撑大数据库,面板越用越慢。验证:三天后看系统概览里的数据库体积,应明显小于全量记录。
- 删掉用不到的集成。每个集成都在后台占扫描开销,留着就是白交房租。验证:设备列表按"集成"筛选,看到没买的品牌就移除。
- 更新只在系统页检查。手动改源码版本,会弄丢现有集成的兼容性。验证:更新后读一遍更新日志,确认版本号和修复了什么。
排障速查表:先看这四种现象 🛠️
| 现象 | 先看哪里 | 解法 |
|---|---|---|
| Zigbee 传感器频繁掉线 | 设备信息页的信号强度 | 协调器挪近家中中央,避开路由器 2.4G 频段干扰 |
| 云集成凌晨显示"不可用" | 外部网络连通性与账号登录状态 | 换本地协议集成,或到集成设置里重新登录账号 |
| 断电重启后系统没自动起来 | 容器启动参数是否含自动重启 | 补上 unless-stopped 参数,或在系统里开启镜像自启 |
| Matter 设备首次配网一直转圈 | 配对码与通道是否填对 | 移除设备重新配对,确认 pin 码逐位正确 |
各集成的详细配置手册都在官方文档站,按集成名搜索即可;卡住的时候去社区论坛按品牌关键词一搜,基本都有人踩过同款坑。先把一盏灯从 APP 里解放出来,再谈管整个家。
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考