Home Assistant 智能家居自动化完整指南：从零基础到跑通第一个联动只需 30 分钟
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
改造前，走廊一盏灯要切 3 个设备 APP 配合才能关掉；改造后，全屋 20 多台设备收进一块本地面板，开灯、关窗、降温都在一处自动完成。Home Assistant 是开源的智能家居自动化平台，内置 1518 个集成，不写代码，一台树莓派就能装起来。
Home Assistant 是什么：一块本地面板接管全屋
Home Assistant 把控制逻辑装在你自己的设备上：断网时家里照样联动，数据不出门，规则全在界面里点选完成，不需要写代码。
它适合三类人：手里有 2 到 30 台智能设备、被多个 APP 切换搞到头疼的；在意隐私、希望数据留在本地的；愿意花 30 分钟做首次安装，换取之后长期省事的。
前提只有一个：放弃"每台设备各开一个 APP"的旧习惯。
安装前准备清单：硬件、存储、网络一次备齐 📦
- 主机（二选一）：树莓派 4/5 最主流；老电脑、NAS 也行。仓库 machine/ 目录收录了 13 种官方机型镜像，从树莓派 3 到通用 x86 都有
- 存储：树莓派方案用 16GB 以上 Class 10 存储卡；x86 方案预留 20GB 以上磁盘空间
- 网络：主机插网线最稳；家里的智能设备尽量连 2.4G WiFi，相当一部分设备不支持 5G
- 电源：用主机对应的原装适配器（树莓派 4 需要 5V/3A），杂牌电源是启动失败的高频原因
- 品牌账号：小米、飞利浦、Sonos 等各备一个账号。本地安装本身不消耗云账号，接入品牌时才用
- 时间预算：从通电到跑通第一条自动化，预留 30 分钟
主线走查：安装、接第一台设备、配第一条自动化 🚀
里程碑 1：安装 Home Assistant 官方镜像（约 15 分钟）
界面路径：官网下载官方镜像 → 用写入工具刷进存储卡 → 插卡通电 → 等 2~3 分钟完成首启 → 浏览器打开homeassistant.local:8123（打不开就换设备获取的局域网 IP）。
做完后你应该看到：首次设置向导，依次让你选语言、时区、给系统起名字、设管理员密码。全部填完就进主面板了。
有闲置 x86 设备的读者走可选分支，一条命令用 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这一步做完你应该看到：docker ps里有一个 Up 状态的容器，浏览器访问 8123 端口同样进入设置向导。
里程碑 2：接入第一台智能灯（约 5 分钟）
界面路径：设置 → 设备与服务 → 添加集成→ 输入品牌名。集成目录 有 1518 个集成，主流品牌基本都在；买新设备前，先翻 品牌列表 确认牌子在不在 104 个品牌名单里。同网段设备多数会被自动发现，确认一下即可，不用手动填参数。
做完后你应该看到：这盏灯出现在"设备"列表里，在面板上点一下就能真的开和关。
里程碑 3：配出第一条自动化（约 10 分钟）
界面路径：设置 → 自动化与场景 → 自动化 → 新建→ 点"使用对话式编辑器"。
- 触发：选"时间"类，选"日落"，偏移量填
-00:30:00，意思是日落前 30 分钟 - 动作：选
light.turn_on，目标实体填客厅灯，亮度 80%
做完后你应该看到：列表里多出一条已启用的自动化；当晚日落前 30 分钟，客厅灯自己亮起来。之后所有场景，都是这套"触发 → 判断 → 动作"三段式的排列组合。
先别贪多，把一盏灯交给它就算成功。
三个高频智能家居自动化场景：触发、判断、动作
回家自动亮灯
- 触发：任意 person 实体从"离家"变"在家"
- 判断：持续 60 秒（防定位漂移误触发），且玄关灯当前是关的
- 动作：开玄关灯，亮度 60%
傍晚自动开灯（附 YAML）
- 触发：日落前 30 分钟（sunset 事件加
-00:30:00偏移） - 判断：无需条件，这条规则优先级最高
- 动作：
light.turn_on，客厅灯亮度 80%
- 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这一步做完你应该看到：粘贴进自动化编辑器保存后，触发栏显示"Sun - Sunset"，动作栏显示light.turn_on，到点灯光如约亮起。
天热自动降温
- 触发：客厅温度传感器数值大于 28°C
- 判断：持续 5 分钟，排除瞬间尖峰
- 动作：打开风扇或 climate 实体，目标温度 24°C
新手最容易卡住的问题 Q&A ❓
装完打不开面板页面？
按顺序查三件事：设备和主机是否同一局域网；端口对不对（默认 8123）；换 IP 直连试试。多数情况是主机还没启动完（多等 2 分钟），或者你的手机连的是访客网络、5G 频段。
添加集成为什么发现不了设备？
三个高频原因：设备连了 5G WiFi；设备与主机不同网段；云接入品牌需要手动填账号凭据而不是等自动发现。先切 2.4G 再试，或在集成页面手动填设备 IP。
自动化为什么偶尔不触发？
状态抖动。在触发条件上加"持续 X 秒"防抖，判断条件不要写死某个瞬时值，放宽成"组内任意一人到家"这类区间条件。
用了一段时间面板变卡？
默认历史记录什么都收。在recorder配置里用include白名单只收关键实体，把purge_keep_days调到 7 天，小树莓派也能保持流畅。
更新之后某个集成报错了？
看日志里的具体报错信息，回滚一个版本等官方修复。不要手动改源码里的版本号，那会让后续升级更难处理。
装完当天就做三件事：备份、瘦身、核对 ✅
- 立即备份：设置 → 系统 → 备份，手动建一份并打开自动备份。恢复时按提示上传文件即可，这三件事里它排第一。
- 核对自动化记录：打开当天那条自动化的执行历史，确认每次触发都真的执行了动作；有跳过的，当天把条件修掉，别拖到"之后再看看"。
- 瘦身：把用不到的集成禁用掉，每少一个就少一份扫描开销。
从这里继续：浏览器搜索"Home Assistant 官方文档"进入文档入口，每个集成都有独立配置手册；卡住时到社区论坛按品牌关键词搜索，同类问题几乎都有前人踩过。智能家居不需要一步到位，今天把三个里程碑走完，你就已经跑赢大多数只买设备不接自动化的人了。
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
