Home Assistant 本地智能家居完整指南从硬件选购到零代码跑通第一条自动化【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core出差途中看到暴雨预警阳台上还晾着衣服你却只能干瞪手机——如果家里有 Home Assistant收衣服提醒、关窗、开灯这些事早就写进自动化里了。本文带你从零搭建这套本地优先的开源智能家居系统走完装机、接入第一台灯、配好第一条联动的全部步骤。它到底帮你解决什么问题一个面板管全屋原来灯在 A 应用、窗帘在 B 应用现在所有设备都收进同一块界面状态一眼看全。断网照样联动控制逻辑跑在你自己的机器上外网断了家里该亮的灯照亮。不碰代码就能配规则触发、条件、动作全部在界面上点选十分钟内能配出一条可用的联动。兼容面足够宽homeassistant/components/ 目录下内置了 1519 个集成覆盖 homeassistant/brands/ 中登记的上百家品牌买设备前可先查名单。一句话记住它不负责替你买东西但负责把买回来的东西管到一起。需要准备什么硬件和成本用途型号建议大致花费主机最低下限树莓派 4 或 54GB 内存即可约 400~500 元存储16GB 以上 Class 10 存储卡约 40 元电源官方 5V 电源套装约 50 元网络一根网线或能连 2.4G WiFi 的设备已有则 0 元替代方案闲置小主机 / NAS装 Docker0 元利用存量够用的下限就是第一行一台树莓派 一张卡 官方电源百元到五百元的预算就能让全家设备跑起来有存量服务器就直接用 Docker 跑一分钱硬件不用添。装上去会卡在哪三条路按你的情况选一条不用都试纯新手烧录官方镜像后开机即用镜像支持树莓派、x86 等机型仓库 machine/ 目录里列着官方适配的机型清单照着买硬件不踩雷。有 IT 基础一台 NAS 或闲置主机一条 Docker 命令起服务不碰宿主系统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 依赖清单在 requirements.txt 装好依赖后用python -m homeassistant --config config启动。坑提示新手别跳过官方镜像直接裸装官方镜像自带升级和备份通道出问题重刷就行。第一台设备怎么接进来以最常见的灯光为例接入步骤不超过 5 步打开设置 → 设备与服务 → 添加集成搜索品牌名如 Hue。同网段的设备多数会被自动发现直接确认。按集成提示完成配对Hue 需要按一下网桥上的按钮。等待设备出现在实体列表确认开关状态能同步。回面板手动开关一次确认双向都通。坑提示先确认灯连的是 2.4G 频段大量国产 WiFi 灯不支持 5G连不上十有八九是这个问题。第一条自动化怎么写界面路径设置 → 自动化与场景 → 自动化 → 新建选对话式编辑器触发条件里选日落并填偏移-00:30:00动作选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所有自动化都是触发什么时候→ 条件满不满足→ 动作做什么三段式后面想加任何场景都是往这三格里填空。剩下的设备怎么批量接 按类型找路每类一条捷径和一个坑传感器温湿度/门窗Zigbee 协议的设备先配好协调器再让系统统一接管比逐个走云端省事。坑设备发现不到 → 多半不在同一网段或挂在 5G 频段换到 2.4G 或手动填 IP。窗帘多数品牌走云集成Aqara、Dooya 等追求稳定就刷 ESPHome 固件走本地协议。坑首次配网反复掉线 → 到窗边靠近配网信号弱是主因。音箱Sonos、Apple TV 等都有官方集成接入后就能被自动化调音量、放单。坑投屏类设备要认 Google Cast 这类标准协议别用品牌私有的。门锁支持 HomeKit 或 Matter 的锁一次配对全屋可用。坑门锁属高敏感设备建议单独建只有家人可控的分组别混进全部设备。批量接入的顺序建议先传感器数据多、联动最多再灯光窗帘体验最直观门锁放最后单独处理。怎么让它稳、快、隐私可控 ️先做备份设置 → 系统 → 备份里手动建一份再开启自动备份这一条比后面所有调优加起来都重要。本地协议优先Zigbee、ESPHome、Matter 能走本地的就别走云数据不出屋云集成只在确认过数据用途后再开。历史记录做减法recorder配置里用include白名单只收传感器和关键开关把purge_keep_days调到 7小机器也不卡。集成只留用到的每多挂一个集成就多一份扫描开销没用的及时下线。更新只走官方渠道系统页提示更新时先看更新日志别手动改源码版本。出问题了先查这里现象原因解法电池传感器没电特别快开了高频轮询功耗翻倍降低轮询频率够用即可自动化偶尔不触发触发实体状态抖动条件卡得死触发后加持续 X 秒防抖条件放宽为组内任意一人到家面板明显变卡历史数据全量记录 集成挂太多recorder 白名单瘦身清理无用集成深夜被离家自动化清场手机定位漂移误判 not_home给 person 实体设停留时间阈值夜间免打扰时段禁执行更新后某集成报错第三方库版本冲突看日志定位具体报错回滚一个版本等官方修复设备发现不到不同网段 / 设备在 5G 频段移到 2.4G 网段或在集成里手动填设备 IP排查顺序先记住看日志 → 对现象 → 动配置别一上来就重装。下一步官方文档在 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），仅供参考