Home Assistant 零基础指南:30分钟装机并跑通第一个自动化
2026/9/15 10:32:03 网站建设 项目流程

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

反直觉的事实:断网那一刻,多数人的智能家居就瘫痪了,因为逻辑跑在厂商的云端。Home Assistant 是开源本地智能家居平台,把全屋设备收进一个面板,控制逻辑跑在你自己的设备上——断网后灯照样亮。

每台设备一个 APP,每个 APP 一套规则,规则还都存在别人家的服务器上,网一断,整个家"掉线"。这是大多数人放弃智能家居的真正原因。Home Assistant 的解法只有四个字:跑在本地。下文带你从空机器到跑通第一个联动,全程点选,不用写代码。

三种安装路径,各配一条路

路径需要什么耗时适合谁
树莓派官方镜像树莓派 4/5 + 16GB Class 10 存储卡约10分钟纯新手
Docker有 Docker 的 NAS 或闲置主机约5分钟有 IT 基础
源码运行任意 Linux 机器 + Python 环境半天开发者

纯新手:把官方镜像写入存储卡、通电,浏览器能打开页面就算成功——系统、升级、备份都打包在里面,各机型的官方镜像在 machine/ 目录里,硬件选型有官方背书。

有 IT 基础:一条命令拉起,时区改成自己的,不碰现有系统:

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

跑两三分钟看到初始化向导,跟着填账号和时区即可。

开发者:克隆源码后建虚拟环境装依赖,用python -m homeassistant --config启动,依赖清单见 requirements.txt。

我的判断:十个人里九个选树莓派路线,理由是一条——坏了重刷就行,没有任何损失。

硬件决定上限,但决定你能否跑通的,是下面的两步。

2分钟接上第一个"设备",不花一分钱 🧩

想最快跑通,先别买硬件,用官方内置的模拟数据:

  1. 设置 → 设备与服务 → 添加集成
  2. 搜索 demo,回车,不需要账号和网络
  3. 约30秒后,设备页会多出一整套模拟的灯、传感器、音箱

去状态页拨动一下light.demo,开关能翻转,环境就算就绪。搜不到 demo 说明版本偏旧,先到系统页更新。后面所有教程都基于这套模拟数据练手,练熟后把目标换成真实设备即可,步骤完全一样。

假的房子比真的房子教你快。

你的第一个自动化:开门就亮灯

目标只有一个:模拟门传感器变成"开"时,模拟灯自动点亮。全程点选:

  1. 设置 → 自动化与场景 → 自动化 → 新建
  2. 选"使用对话式编辑器",用一句话描述:门传感器开启时,打开模拟灯
  3. 保存后手动拨一下传感器,运行日志里能看到灯被触发

习惯 YAML 的话,整条规则就这些:

- alias: 开门亮灯 trigger: - trigger: state entity_id: binary_sensor.demo to: "on" action: - action: light.turn_on target: entity_id: light.demo

触发是状态,动作是命令,效果是一条日志——这套"触发→动作→效果"三段式是自动化的全部核心,后面看到的每个玩法都只是它的组合。

换成真设备:三种协议三条路

打开设置 → 设备与服务 → 添加集成,输入品牌名,大部分设备会被自动发现。按协议选路:

  • 云接入:飞利浦 Hue 同网段自动弹出,按一下网桥按钮完成配对;走 Tuya 生态的 WiFi 设备直接选 Tuya 集成。坑:先确认设备在 2.4G 网段,5G 频段会让很多设备发现不到。
  • 本地接入:Zigbee 先买一个协调器,再让 Home Assistant 批量接管;支持 Matter 的设备一次配对全屋可用;刷 ESPHome 固件的稳定性最好。
  • 拿不准:品牌名单维护在 brands/ 目录,1500 多个集成都在 homeassistant/components/,买设备前查一眼自家牌子在不在。

能走本地就走本地——断的是网,断不了你手里的逻辑。

再走一步:从一盏灯到全屋 📺

第一盏灯跑通后,补三件小事就进入"全屋"阶段:

  1. 分组:客厅 5 盏灯放进一个组,一条命令同开同关,不用在实体名里翻找。
  2. 场景:"灯调暗到 20% + 电视开 + 音箱音量 10"合成一个"观影模式",一点就触发。
  3. 媒体:电视、音箱接入后都能被自动化指挥,下面这张演示图里的家庭客厅,就是内置演示集成放的一集动画。

一盏灯和全屋之间,差的只是"分组"这一步。

你一定会踩的5个坑:速查

这五条不是玄学,是高频现象,对号入座:

现象常见原因解法
设备发现不到5G WiFi / 与主机不同网段移到 2.4G,或手动填设备 IP
自动化偶发不触发实体状态抖动触发里加"持续 X 秒"
Zigbee 传感器掉线信号弱 / 电池耗尽协调器挪近,换电池
面板用一个月变慢历史数据全量堆积用 recorder 白名单限定记录范围
更新后集成报错第三方依赖冲突看日志里的具体报错,等官方修复

接下来7天:3件能打卡的事

  • 今天:设置 → 系统 → 备份,手动建一份备份并开启自动备份,这是全部清单里最重要的一条。
  • 第2天:接一台真灯,把自动化的目标从演示实体换成真实实体。
  • 第3-4天:做第一个"观影模式"场景,把电视、灯、音箱编进同一组。

别急着添设备,一个稳定跑着的自动化,比十个半成品值钱。

那么,你明天要写的第二个自动化是什么?

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询