Home Assistant 入门教程本地智能家居自动化搭建的 7 步路线图【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/coreHome Assistant 是一款开源的本地智能家居平台把各品牌的智能设备收进一块本地面板用免代码自动化代替手动切 APP。只要你有一台树莓派、NAS 或闲置小主机跟着这篇文章走10 分钟能跑通第一个联动。30 秒自测本地智能家居适合你吗先做一道判断题。同样一个回家开灯两套体系的差别是这样的对比项各品牌云 APPHome Assistant 本地方案控制逻辑跑在哪厂商服务器你家的机器上断网时的表现联动基本失效自动化照常执行数据流向经过厂商云端不出家庭网络跨品牌联动难常需中转原生支持统一实体模型费用硬件 可能的云订阅仅硬件成本软件开源免费上手成本低首次装机约 30 分钟适合你如果设备来自 2 个以上品牌、想要跨品牌联动、在意数据不出门、家里有一台可以 7×24 通电的机器。不适合你如果只有 1~2 台设备且无联动需求、找不到一台常开主机、无法接受哪怕半小时的初始配置。判断结果明确再继续。装错的代价不是钱是闲置的硬件。Home Assistant 装之前备什么硬件与网络清单硬件三选一主机适合谁要点树莓派 4/5纯新手16GB 以上 Class 10 存储卡、5V 电源、网线直连NAS / 闲置 x86 小主机家里已有设备走 Docker 或官方generic-x86-64镜像不占用主系统官方机型镜像玩单机硬件的人machine 官方镜像目录 提供 12 种机型含 raspberrypi4-64、raspberrypi5-64、odroid、green、yellow、qemu 等网络三件事路由器上留一个 2.4G 频段的 SSID绝大多数智能设备只认它主机本身走有线别和 WiFi 设备抢信道给主机分配固定 IPDHCP 保留不然面板地址会飘。可验证结果手机和主机同网段ping 主机IP能通2.4G 列表里能看到设备要连的那个 SSID。两项都过了再往下走。Home Assistant 怎么装三条路径选一条路径一官方镜像纯新手推荐从官方渠道下载对应机型的镜像树莓派选raspberrypi4-64或raspberrypi5-64写入存储卡/SSD通电。浏览器访问http://主机IP:8123初始向导约 5 分钟填地理位置、时区、创建账号。路径二Docker有 NAS 或闲置主机一条命令配置目录持久化时区按自己改# 后台运行 Home Assistant 容器配置保存在 /data/homeassistant docker run -d --name homeassistant \ --restartunless-stopped -e TZAsia/Shanghai \ -v /data/homeassistant:/config \ --networkhost ghcr.io/home-assistant/home-assistant:stable路径三源码开发者克隆仓库https://gitcode.com/GitHub_Trending/co/core建虚拟环境依赖清单见 requirements.txt然后用python -m homeassistant --config config启动。适合要读代码或提 PR 的人日常使用不必走这条路。可验证结果无论哪条路径http://主机IP:8123能登录、看到状态总览页安装就算完成。Home Assistant 自动化配置日落自动开灯 第一个自动化只做一件事日落前 20 分钟书房台灯自动亮到 60%。全程不碰代码。界面路径设置 → 自动化与场景 → 自动化 → 新建 → 使用对话式编辑器触发条件选时间类事件选日落偏移量填-00:20:00动作选打开灯目标实体填你的台灯亮度设 60%保存。不等天黑开发者工具 → 操作里手动调用一次light.turn_on确认实体和动作都对。可验证结果当晚日落前 20 分钟台灯自己亮起或者手动测试时灯真的开了。偏爱 YAML 的话效果等价的写法# automations.yaml日落前 20 分钟点亮书房台灯 - alias: 日落开灯 trigger: - trigger: sun event: sunset offset: -00:20:00 action: - action: light.turn_on target: entity_id: light.study data: brightness_pct: 60之后 90% 的自动化都是这三个槽位的组合什么时候发生trigger、要不要执行condition、执行什么action。智能家居设备怎么接入 Home Assistant五类设备逐个说统一入口设置 → 设备与服务 → 添加集成输入品牌名多数设备会被自动发现。components 集成目录 里有 1500 多个内置集成买设备前可以先翻 brands 品牌目录上百个品牌文件在基本意味着有官方集成可用。灯光Hue 同网段会自动弹出按一下网桥按钮完成配对小米系走 Xiaomi Miio / Xiaomi Aqara 集成输入账号或扫码被 Tuya 生态覆盖的国产 WiFi 灯直接走 Tuya 集成。注意灯先确认连的是 2.4G 频段5G 频段很多灯根本搜不到。窗帘多数走品牌云集成如 Aqara、Dooya追求稳定性的刷 ESPHome 固件后本地接入响应和可靠性最好。首次配网尽量站在窗边操作信号弱的房间配网会反复失败。音箱与投屏Sonos、Apple TV 等都有官方集成接入后自动化可以直接调音量、播播单。投屏类设备记得走 Google Cast 集成而不是品牌 APP 的私有协议否则只能看到不能控制。传感器温湿度、门窗、人体这类Zigbee 协议建议先把协调器配好再让 Home Assistant 接管ZHA比逐台走云省事得多。电池供电的传感器别开高频轮询否则电池寿命直接砍半。门锁支持 HomeKit 或 Matter 的锁最省心一次配对全屋可用。门锁是高敏感设备建议单独建一个只有家庭成员可操作的分组不要混进全部设备。可验证结果五类设备都能在实体列表里找到并且能被自动化引用——接一个设备顺手给它配一条最小自动化别囤积。Home Assistant 长期运营每季度花 30 分钟做的五件事 ️备份设置 → 系统 → 备份手动存一份再打开自动备份。每季度把备份文件下载一次确认能解开才算真备份。只记该记的recorder配置里用include白名单只收传感器和关键开关purge_keep_days设为 7。一周后观察历史表体积应该稳住了。清理无用集成多启用一个集成就多一份发现和轮询开销不用的删掉别囤。更新走官方渠道系统页有更新提示时先读更新日志再动手不要手动改源码里的版本号。本地优先能走 Zigbee、Matter、ESPHome 这类本地协议的就不走云集成云集成在你确认过其数据用途之前保持关闭。可验证结果备份列表里有一周内生成的文件跑满一周历史数据体积不再线性增长。Home Assistant 问题速查表现象可能原因解法面板页面打不开访问了错误 IP或端口不通同网段设备访问http://主机IP:8123先 ping 主机确认在线添加集成后搜不到设备设备在 5G 频段或不在同一网段设备改连 2.4G SSID或在集成里手动填设备 IP面板明显变慢历史全量记录 集成过多recorder 白名单瘦身清理无用集成自动化偶尔不触发实体状态瞬间抖动或条件卡得太死触发加持续时长如for: 00:00:05防抖条件放宽为任一人在家更新后某集成报错第三方库升级不兼容查日志里的具体异常回滚一个版本等官方修复深夜离家自动化误触发手机 GPS 漂移person 误判 not_home给 person 实体加停留时长阈值夜间免打扰时段禁止执行把一盏灯交给自动化剩下的交给路线图判断、准备、安装、首跑、扩展、运营、排错每步都有可验证的终点。配置细节各集成都有自己的手册官方文档入口在 home-assistant.io 网站的 docs 栏目社区论坛在 community.home-assistant.io卡住时按品牌关键词搜一下多半有人踩过同款坑。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考