Home Assistant 入门指南从零搭建本地智能家居自动化的完整教程【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core凌晨一点只想关走廊那盏灯却要翻三个 APP米家管联动灯、Hue 管亮度、窗帘 APP 里场景还在作怪。Home Assistant 把全屋设备收进一块本地面板——这个开源的本地智能家居平台用智能家居自动化替代你的来回切换。它和你手里的米家 / Hue 有什么不同 品牌 APP 解决管好自己家的设备Home Assistant 解决别家的设备也听我的。对一张表就清楚了对比项品牌 APP米家 / Hue 等Home Assistant逻辑跑在哪各家云端断网即失联你自己的机器上断网照样联动数据不出门自动化怎么配每套界面一套规则互相不通统一的触发 → 条件 → 动作全在界面上点选免代码设备覆盖面只认自家产品线homeassistant/components/ 下内置 1500 多个集成Hue、Shelly、Z-Wave、KNX 主流品牌基本全覆盖后续可扩展性厂商给什么用什么自动化、脚本、场景随时加硬件升级时 machine/ 里有官方机型镜像树莓派 4/5、x86 等跟着走一句话它不是来抢品牌 APP 饭碗的是来给品牌 APP 当总指挥的。选一条路装好它对号入座三档选一档不用全试。第一档纯新手树莓派 4/5 加一张 16GB 以上 Class 10 存储卡烧录官方镜像后通电即开系统、升级、备份全内置坏了重刷就好。镜像不用自己找machine/ 目录里按机型都有现成的如raspberrypi4-64、generic-x86-64。5V 电源加一根网线就能跑。第二档有 NAS / 闲置小主机Docker 一条命令搞定不污染现有系统# 挂载配置目录 /data/homeassistant时区按自己地区改 docker run -d --name homeassistant \ --restartunless-stopped -e TZAsia/Shanghai \ -v /data/homeassistant:/config \ --networkhost ghcr.io/home-assistant/home-assistant:stable第三档开发者想读源码、提 PR 的克隆后装依赖再启动git clone https://gitcode.com/GitHub_Trending/co/core cd core pip install -r requirements.txt # 依赖清单就在这个文件里 python -m homeassistant --config config给设备上户口按协议找入口装好后进设置 → 设备与服务 → 添加集成输品牌名大部分设备会被自动发现。别按灯、窗帘、音箱找按设备走的协议找入口更稳Zigbee先装好协调器再用 ZHA 集成接管传感器、开关批量入网纯本地最省心。坑配对期间别把电池设备扔出房间一次只配一个。Wi-FiTuya、小米系、各原生协议品牌各有对应集成输账号或扫码完成配对。坑设备必须挂在 2.4G 网段5G 频段它根本听不见。蓝牙BLE 传感器、信标由 Home Assistant 自己的蓝牙栈统一接管。坑主机摆放位置决定耳朵灵敏度离设备太远会漏信号。Matter / HomeKit新标准设备最省心一次配对全屋可用门锁、音箱尤其合适。坑买前确认 Hub 和设备固件都是新版本旧固件常卡在配对界面出不来。纯云集成部分品牌只能走云服务官方集成里直接填凭据即可。坑云集成意味着数据过第三方先弄清数据用途再开。跑通第一个联动日落自动开灯 第一次别贪多只做一件事日落前 30 分钟客厅灯自己亮起来。操作路径设置 → 自动化与场景 → 自动化 → 新建 → 使用对话式编辑器。触发条件选日落偏移量填-00:30:00动作选light.turn_on目标实体填你的客厅灯亮度拖到 80% 左右。保存当晚见效。所有联动都是同一个三段式触发什么时候→条件在什么前提下→动作做什么。上面例子没写条件就是无条件执行想让有人在家才开灯条件里加一条人员实体即可。喜欢 YAML 的话规则长这样# automations.yaml日落前 30 分钟点亮客厅灯 - alias: 日落开灯 trigger: - trigger: sun event: sunset offset: -00:30:00 # 提前半小时触发 condition: [] # 可留空需要可加任一人员在家 action: - action: light.turn_on target: entity_id: light.living_room data: brightness_pct: 80尝到甜头后后面所有场景都是这三段的排列组合。跑稳后的五件必做小事 ️跑起来不等于跑得好。花半小时做这五件事后面半年都省心先备份再折腾设置 → 系统 → 备份手动建一份再打开自动备份。恢复时按提示上传即可这是最重要的一条。历史只记该记的recorder 用include白名单只收传感器和关键开关purge_keep_days调到 7小树莓派也流畅。关不用的集成每多留一个就多一份后台扫描开销确认不用的就移除。更新只走官方渠道系统页提示有更新时先看日志说明别手动改源码版本。守住隐私底线能走本地协议的Zigbee、Matter、ESPHome就别走云集成云集成确认数据用途后再开。踩坑速查表现象常见原因解法设备发现不到不同网段 / 设备连了 5G移到 2.4G 网段或在集成里手动填设备 IP面板明显变卡历史全量记录、集成堆太多recorder 白名单瘦身移除无用集成自动化偶发不触发触发实体状态抖动加持续 X 秒防抖条件放宽到组内任一成员更新后集成报错第三方库版本冲突看日志具体报错回滚一个版本等官方修复深夜离家自动化误清场手机定位漂移误判 not_homeperson 实体加停留时间阈值夜间免打扰时段禁止执行智能家居不用一步到位。先把一盏灯交给自动化今晚你就能早点睡。想再深一点官方文档站里每个集成都有单独的配置手册卡住时在社区论坛按品牌关键词搜基本都能找到踩过同款坑的人。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考