企业官网建设流程全解析

Home Assistant 本地智能家居如何入门：从装机到跑通第一个自动化的完整指南

【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core

21:40 推开门，玄关灯自己亮，窗帘半合，空调已经调到 24 度——你没碰任何 APP。这个画面就是 Home Assistant 跑通之后的日常：开源、本地优先、隐私自持，全屋设备收进一个面板，靠"本地自动化"替你干活。

值不值得装：先用三个问题自检

• 家里是否已有至少 3 个智能设备，且日常要开 2 个以上品牌 APP？是，收益明显。
• 有没有一台能 7×24 开机的设备（闲置小主机、NAS、树莓派）做常驻中枢？没有就先买硬件。
• 这周末能否抽出 2 小时装、连、测？装不完就等下次。

如果你是"只想要品牌自家 APP 的云联动、不需要统一面板"，或者设备只有 1～2 个，就别装了——设备原生 APP 或品牌云场景更省事，装 Home Assistant 纯属给自己加工作量。

跑起来之后的样子，就是下面这样：灯、温度、能源状态同一屏，不用换 APP 找开关。

三个答案都点头，就进入装机；答案含糊，建议先只装演示模式体验一轮再决定。

Home Assistant 最短安装路径：三种方式按门槛选

默认方案是官方预装镜像，零门槛：仓库 machine/ 目录列出了全部官方支持机型——树莓派 4/5、x86 小主机、各种开发板。选树莓派 5，配 16GB 以上 Class 10 存储卡，用官方工具把镜像写进卡，5V 电源加网线通电，开机十几分钟后浏览器进地址提示页，按向导设账号、时区即可。

进阶两条各一句话：已有 NAS 或 Linux 主机的，用 Docker 跑，不污染系统；要读源码、提 PR 的，克隆仓库 https://gitcode.com/GitHub_Trending/co/core 后建虚拟环境，依赖清单见 requirements.txt，python -m homeassistant --config config启动。

# Docker 方式：一条命令拉起，时区与配置目录按需改 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

装完先别急着接设备，下一个目标只要 10 分钟。

第一个 10 分钟自动化：日落前点亮客厅灯

• 入口路径：设置 → 自动化与场景 → 自动化 → 新建，选"使用对话式编辑器"。
• 关键配置项：触发条件选"时间"类的"日落"，偏移量填-00:30:00；动作选light.turn_on，实体指向客厅灯，亮度 80%。
• 如何验收：保存后点"运行一次"，灯应立即点亮；当晚日落前 30 分钟再观察一遍自动触发。

习惯 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

跑通后你会发现，后面所有场景都是"触发 → 条件 → 动作"的排列组合。接下来把系统先调稳，再谈扩展。

跑稳必做的 5 件事

1. 备份：设置 → 系统 → 备份手动建一份并开启自动备份，恢复功能顺手试一次。
2. 瘦身：recorder里用include白名单只记关键实体，purge_keep_days设 7，小机器也流畅。
3. 关停用不到的集成：homeassistant/components/ 下有 1519 个集成，每留一个就多一份扫描开销。
4. 更新只走官方渠道：系统页提示更新时先看更新日志，别手改源码版本。
5. 本地优先：能用 Zigbee、Matter、ESPHome 走本地的就别走云集成；云集成确认数据用途后再开。

稳定运行一两天，就可以按场景往外扩了。

按使用场景扩展：四个方向各带一个坑

集成入口在设置 → 设备与服务 → 添加集成，输入品牌名多数设备会被自动发现，列表长这样：

• 安防联动：门窗传感器触发本地摄像头截图加通知推送。坑：无线传感器先移到 2.4G 网段再配对，5G 下会反复掉线。
• 能耗管理：电价类集成算分时电价，用电表实体做功率监控。坑：本地电表优先，纯云电价接口会随断网失效。
• 语音控制：配对音箱或支持语音的设备后，自动化就能被一句话触发。坑：设备离路由器太远时唤醒词识别率明显下降，先测距离。
• 演示模式：接真硬件前，可开启 homeassistant/components/demo/ 的演示集成，整套界面先摆一遍。坑：演示实体全是假的，验收完记得关掉再连真设备。

故障速查：新手真实会撞上的 6 个问题

问题都解决后，剩下的事就是持续往里填场景。

出口：文档与社区

官方文档在 docs，每个集成都有独立配置手册；社区论坛在 community，按品牌关键词搜，多数坑都有前人踩过。把今晚的第一盏灯交给自动化，剩下的交给时间。

【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core