Home Assistant 入门：零基础搭建本地智能家居自动化的完整指南

Home Assistant 入门零基础搭建本地智能家居自动化的完整指南【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core凌晨一点想关走廊那盏灯你得先打开米家关传感器联动的灯再切到Hue 应用调亮度最后还得确认窗帘 APP 里的场景没有把它重新打开——三个 APP 来回切人是想睡了灯没想好。这正是大多数人放弃智能家居的原因设备越买越多控制却越来越碎。Home Assistant 入门(.) 其实可以很平静它是开源智能家居平台 Home Assistant把全屋设备收进一个本地面板用自动化代替你手动切换 APP——本文带你不用写代码走完从装机到跑通第一个联动的全过程。先别装看看它能帮你干什么 装之前先确认这东西值不值得占一块硬盘。Home Assistant 的核心收益就四条条条和省心有关本地优先控制逻辑跑在你自己的设备上断网时家里照样联动数据不出门隐私自己说了算。免代码自动化触发条件、执行动作全在界面上点选太阳落山就开灯这种规则普通人 10 分钟能配好。设备兼容性极广项目 homeassistant/components/ 目录下有 1500 多个内置集成从飞利浦 Hue、Shelly 到 Z-Wave、KNX主流品牌基本都见得到brands/ 目录里还维护着上百个品牌与集成的对应关系买设备前可以先查自家牌子在不在名单里。可持续扩展自动化、脚本、场景随时能加官方预制的树莓派、x86 等各种机型镜像放在 machine/ 目录硬件选型有官方背书。一句话它不替你买设备它替你管设备。按你的情况选安装方式别一上来就折腾三种路径对应三种人对号入座即可不用全试。纯新手最推荐树莓派 4/5 加一张 16GB 以上的 Class 10 存储卡写入官方镜像后通电即开自带系统、升级和备份坏了重刷即可。5V 电源、一根网线就能跑。有 IT 基础家里已有 NAS 或闲置小主机直接用 Docker 部署不污染现有系统# 一条命令拉起 Home Assistant时区改成自己的 docker run -d --name homeassistant \ --restartunless-stopped -e TZAsia/Shanghai \ -v /data/homeassistant:/config \ --networkhost ghcr.io/home-assistant/home-assistant:stable开发者想读源码或提 PR仓库地址是 https://gitcode.com/GitHub_Trending/co/core 克隆后建虚拟环境安装依赖再用python -m homeassistant --config config启动具体依赖清单在 requirements.txt 里。10 分钟跑通第一个自动化日落自动开灯 第一次用别贪多就做一件小事日落前 30 分钟客厅灯自动亮起。界面路径设置 → 自动化与场景 → 自动化 → 新建→ 点使用对话式编辑器。触发条件里找时间类选日落并填偏移量-00:30:00动作里选light.turn_on目标实体填你的客厅灯亮度拖到 80% 左右。保存当晚就能看到效果。如果你更喜欢 YAML或者界面编辑器不满足你规则长这样# automations.yaml日落前 30 分钟点亮客厅灯 - alias: 日落开灯 trigger: - trigger: time at: 18:30:00 # 或改用 trigger: sun 的 sunset 事件 action: - action: light.turn_on target: entity_id: light.living_room data: brightness_pct: 80先尝到甜头后面所有场景都是这个触发 → 条件 → 动作三段式的组合。把家里的设备接进来按类型找路在设置 → 设备与服务 → 添加集成里输入品牌名大部分设备会被自动发现。五类常见设备的接入路径和坑灯光Hue 同网段会自动弹出按一下网桥按钮配对小米米家用 Xiaomi Miio 集成输入账号或扫码国产 WiFi 灯若被 Tuya 生态支持走 Tuya 集成即可。坑先确认灯在 2.4G 网段5G 频段很多设备连不上。窗帘多数走品牌云集成如 Aqara、Dooya本地派则刷 ESPHome 固件后接入稳定性最好。坑首次配网务必在窗边信号弱会反复掉线。音箱Sonos、Sonance、Apple TV 等均有官方集成接入后即可被自动化调音量、播播单。坑投屏类设备要走 Google Cast 集成而不是品牌 APP 的私有协议。传感器温度、门窗、湿度这类设备Zigbee 协议建议先配好协调器再让 Home Assistant 接管比一个个走云省事。坑电池传感器别开高频轮询换电池周期会砍半。门锁支持 HomeKit 或 Matter 的锁最省心一次配对全屋可用。坑门锁属于高敏感设备建议单独建一个只有家人能控制的分组别放进全部设备。让它更稳、更快、更安全 ️跑起来之后花半小时做这五件事后面半年都省心备份设置 → 系统 → 备份手动建一份再打开自动备份。恢复时按提示上传即可这是最重要的一条。只记该记的历史记录默认保留 10 天在recorder配置里用include白名单只收传感器和关键开关把purge_keep_days调到 7小树莓派也能流畅跑。关掉用不到的集成每多一个集成就多一份扫描开销不用的别留。更新走官方渠道系统页有更新提示时先看更新日志别手动改源码版本。隐私底线能走本地协议的Zigbee、ESPHome、Matter就别走云集成云集成只在你确认其数据用途后开启。避坑速查现象、原因、解法现象常见原因解法设备发现不到设备与主机不在同一网段 / 5G WiFi移到 2.4G 网段或在集成里手动填设备 IP面板明显变卡历史数据全量记录、集成过多用 recorder 白名单瘦身清理无用集成自动化偶发不触发触发实体状态抖动、条件写死单一状态加持续 X 秒防抖条件放宽为组内任意一人到家更新后集成报错第三方库版本冲突看日志里的具体报错回滚一个版本再等官方修复深夜被离家自动化清场手机定位漂移误判 not_home给 person 实体加停留时间阈值夜间免打扰时段内禁止执行从这里继续官方文档入口在 docs每个集成都有自己的配置手册卡住的时候社区论坛按品牌关键词一搜几乎都有前人踩过同款坑。智能家居不需要一步到位——先把一盏灯交给自动化今晚你就能早点睡。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考