
Home Assistant 入门指南零基础 10 分钟跑通第一个自动化【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core周五 23 点半你躺在床上发现客厅那盏灯还亮着。先打开手机摄像头 App确认前门真的锁上了再切到灯光 App把客厅灯关掉躺回去的路上门铃又推来一条消息你还得再确认一次。灯没关成人先困了。这种设备越买越多、控制越切越碎的夜晚就是 Home Assistant 想替你结束的事。本文带你用 10 分钟不写代码把 Home Assistant 的第一个自动化跑起来。装之前先看清它替你省了什么本地优先控制逻辑跑在你自己家里的机器上断网那天灯照开、锁照关设备数据不出家门。免代码自动化触发条件和执行动作全在界面上点选太阳落山就开灯这条规则从新建到保存 10 分钟配完。兼容面广homeassistant/components/ 下有 1500 多个内置集成从飞利浦 Hue 到 Shelly、Zigbee、KNX 都见得到homeassistant/brands/ 里维护着 100 多个品牌与集成的对应关系买设备前可以先查自家牌子在不在名单里。硬件有官方背书machine/ 目录列出树莓派 4/5、x86 迷你主机、Odroid 等 12 种机型的官方镜像硬件选型不用自己猜兼容性。它不会让你少买一台设备但会让已经买来的设备不再各说各话。按你的情况选安装方式纯新手最推荐找一台常开的机器就行——树莓派 4/5 加一张 16GB 以上的 Class 10 存储卡最便宜家里吃灰的迷你小主机也可以。三步走挑硬件树莓派 4/5 16GB 存储卡或一台常年通电的老电脑。部署树莓派把官方镜像写进存储卡通电即开用老电脑的话在终端跑下面这条命令同样拉起来。打开浏览器输入那台机器的 IP路由器后台能查到局域网地址按向导完成三步账号初始化。# 一条命令拉起 Home Assistant 官方稳定镜像 docker run -d --name homeassistant \ --restartunless-stopped -e TZAsia/Shanghai \ -v /data/homeassistant:/config \ --networkhost ghcr.io/home-assistant/home-assistant:stable这段在做什么用 Docker 把官方稳定版跑起来-v把配置目录固定到磁盘上-e设定你所在时区路径和时区按自己的机器改。有 IT 基础家里已有 NAS 的话用同样的方式直接部署在上面只改挂载路径官方支持的机型清单在 machine/。想读源码clone https://gitcode.com/GitHub_Trending/co/core 按 requirements.txt 装好依赖建好虚拟环境再用python -m homeassistant --config config在本地启动。10 分钟跑通第一个自动化 第一次只干一件小事日落前 30 分钟客厅灯自己亮起来。界面路径设置 → 自动化与场景 → 自动化 → 新建点使用对话式编辑器。触发条件里选时间再选日落偏移量填-00:30:00动作选打开灯目标实体挑客厅那盏灯亮度拖到 80%。保存——当晚日落时分就能看到效果。如果你更喜欢配置文件等价写法是这样的# 等价于界面里那条日落开灯规则 - alias: 日落开灯 trigger: - trigger: sun event: sunset offset: -00:30:00 # 比日落早 30 分钟 action: - action: light.turn_on target: entity_id: light.living_room data: brightness_pct: 80这段在做什么trigger 定义日落提前 30 分钟action 定义把客厅灯开到 80% 亮度和界面上点的完全是同一件事。注意它的通用骨架是触发 → 条件 → 动作三段式触发和动作必填条件可留空。后面所有玩法——到家开灯、深夜降亮度——都是这个骨架的重组。把家里的设备接进来在设置 → 设备与服务 → 添加集成里输入品牌名大部分设备会被自动发现。五类最常见设备的路径和坑灯光飞利浦 Hue 网桥在网段里通电就会自己冒出来小米设备走 Xiaomi Miio 集成。坑这类灯大多只支持 2.4G WiFi搜不到时先把设备切到 2.4G 网段再试。传感器Zigbee 的温度、门窗传感器先配好 Zigbee 协调器再让 ZHA 或 ESPHome 集成接管。坑电池供电的传感器别开高频轮询换电池的周期会砍半。音箱Sonos、Apple TV 都有官方集成接入后就能被自动化调音量、播歌单投屏走 Google Cast 集成。坑别用品牌 App 的私有协议去控自动化够不到那边。门锁支持 HomeKit 或 Matter 的锁一次配对全屋可用。坑门锁属于高敏感设备别把控制权限塞进全部设备这种大分组里。摄像头主流摄像头走 ONVIF 协议或品牌云集成接入。坑视频流很吃带宽不关键的路由把码率调低再录。让它长期活着五件必做的事 ️备份永远排第一。设置 → 系统 → 备份先手动建一份再打开自动备份。以后任何环节出乱子这是唯一能救你回来的保险单。只记该记的。历史记录recorder默认保留 10 天用include白名单只收传感器和关键开关把purge_keep_days调到 7小树莓派也能跑得流畅。关掉用不到的集成。每多留一个集成启动时多一轮扫描运行中多一个出错面不用的不留。更新走官方渠道。系统页有更新提示时先看更新日志再升级别手动去改源码里的版本号。守住隐私底线。能走 Zigbee、Matter、ESPHome 这类本地协议的就不走云云集成确认过数据去向之后再开。常见现象速查现象常见原因解法装完打不开初始页面机器不在局域网 / 防火墙拦了查路由器后台 IP确认同一网段某个集成加载失败第三方库版本冲突看日志里的具体报错等官方修复自动化偶发不触发状态抖动、条件写太死加持续 X 秒防抖用久了面板变卡历史数据全量记录recorder 白名单缩短保留天数设备夜里频繁掉线云服务不稳定改本地协议降低轮询频率从这里继续每个集成在官方文档站www.home-assistant.io都有自己的配置手册卡住的时候去社区论坛按品牌关键词搜基本都有人踩过同款坑。今晚就把客厅那盏灯交给自动化——23 点半你再想起它的时候家里已经是该亮的样子了。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考