Home Assistant 智能中控上手指南如何免费搭建全屋智能系统【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io你有没有经历过这样的夜晚卧室的小米灯要用一个 App 关客厅的窗帘要在另一个 App 拉出门前还得打开第三个 App 确认摄像头开了没有。App 多到手机桌面放不下而任何一家厂商的 App 升级改版你精心调好的一键离家就可能莫名其妙失灵。这种每个品牌都有自己的小生态的割裂感是玩智能家居的人共同的翻车现场。Home Assistant中文社区常叫它小爱或HA本文指开源智能中控平台就是为了解决这个问题而生的它是一个跑在你自己硬件上的开源智能中枢把小米、飞利浦、涂鸦、Aqara、Apple HomeKit 等上千种设备拉进同一张网用同一套自动化逻辑统一指挥。设备数据全部留在家里不依赖厂商云也不需要付费订阅。先说结论它到底帮你解决什么一句话Home Assistant 是一个设备翻译官 自动化大脑。普通智能设备的痛点是各说各话——Zigbee一种短距离低功耗无线协议常用于传感器和灯设备、Wi-Fi 设备、红外遥控器、Matter 设备各自为政。Home Assistant 内置了数千个集成integration可以理解为设备驱动包每种品牌、每种协议都有对应的接入方式。你不用再记住 5 个 App只需要面对一个本地网页。对普通用户来说它意味着三件事一个入口浏览器打开本地地址所有设备、所有控制都在这一页一套逻辑不管设备来自哪个品牌都能写进同一条自动化automation即当发生 X 时就执行 Y的规则一份主权数据和自动化逻辑在你家硬件上运行断外网时家里的灯、锁、传感器照常工作。最快 30 分钟上线树莓派安装步骤结论先行树莓派 一张 SD 卡是上手 Home Assistant 成本最低的路径整个流程不需要敲一行代码。1. 备齐硬件。树莓派 4 或 5至少 2GB 内存、一张 32GB 以上的 SD 卡认准卡面 A2 标识小文件读写速度会明显更快、一根网线安装阶段必须用网线Wi-Fi 会在系统装好后再配。2. 刷官方镜像。在电脑上下个免费刷机工具 Raspberry Pi Imager打开后依次选其他专用系统 → 智能家居 → Home Assistant选对硬件版本再选你的 SD 卡点写入。3. 开机等待。SD 卡插进树莓派接上网线和电源。一两分钟后在浏览器里输入homeassistant.local打开管理界面如果你的系统解析不了这个域名就去路由器里找到树莓派的 IP 地址用http://IP地址:8123访问8123 是它默认的网页端口。4. 走完引导onboarding。界面会引导你设置用户名密码、所在时区和城市这决定日出日落等自动化的时间基准并联网下载常用组件。全程点选几分钟完成。不想折腾树莓派旧电脑、NAS、Mac 上跑 Docker 容器也是官方支持的路线见 Docker 安装文档 和 Linux 原生安装文档。新手优先推荐树莓派方案——它是官方开箱即用的 Home Assistant OS后续升级、备份、装插件都最省心。先把家里三盏灯连上设备接入装好系统后第一件事让设备出现在你的面板里。打开设备与服务页点右下角添加集成在搜索框里输品牌名比如Zigbee2MQTT帮你把 Zigbee 传感器接入 HA 的中转集成或你灯具品牌的集成按提示填账号或让设备自动发现即可。三个实用要点自动发现大多数 Wi-Fi 设备摄像头、音箱、扫地机开机后会被 HA 主动发现你只需点一下配置确认接入后出现两类东西设备物理实体如客厅吸顶灯和实体entity可被控制或读取的最小单元如客厅吸顶灯.开关、温湿度传感器.温度。后面写自动化时操作的都是实体装不上先别急部分集成要求设备与 HA 在同一网段、同一 Wi-Fi 频段或者需要先在设备端配好。卡住了先看该集成页面的说明90% 的情况是网络问题。把如果…就…变成日常自动化编排自动化是 Home Assistant 的灵魂。它的表达方式和人脑几乎一样当触发……如果条件……就动作。全程用界面点选完成不用写配置。触发器trigger什么时机启动规则——固定时间、日出日落、实体状态变化、地理围栏进出等等条件condition可选的附加检查——比如且现在不在家动作action触发后做什么——开灯、调温、发通知、调用媒体播放器可以串好几个。两条适合新手第一周的自动化天黑开灯触发 日落动作 客厅灯开 30% 亮度。一条规则换掉你每天回家后的第一个手动动作起床流程触发 每天 07:00动作 卧室灯渐亮 音响播放音乐。界面不会用官方有专门的 自动化入门文档 逐步演示。把家变成一块大屏仪表盘可视化设备都进来了接下来把常用控制摆到一眼可见的地方。Home Assistant 的仪表盘Lovelace可自由编排的卡片式主页支持拖拽点编辑就能把灯光开关卡、温度卡、场景卡加进主页按房间分组深色模式一键切换。进阶一点可以把整面墙交给电视用 Cast 集成把仪表盘投到电视或 Chromecast 上家里谁都不用拿手机就能控制。再配上官方移动 AppAndroid 在 应用商店说明出门在外也能远程查看。动嘴不动手语音与远程联动Home Assistant 支持本地语音助手放一台小硬件或树莓派本身对它说打开客厅的灯指令在本地解析执行不需要把对话内容传给第三方云。除了语音联动的另一半是推送通过通知集成把家里有人闯入扫地机任务完成推到你的手机。控制流是人 → 设备通知流是设备 → 人两条流都通了才叫闭环。端到端实战打造离家自动布防现在把前面的能力串起来完整走一个真实场景家人全部离开家 → 自动布防 全屋关灯 手机收到通知。第一步让 HA 知道谁在家。给每个家人装上 HA 官方手机 App在 App 里开启位置跟踪。HA 会根据手机位置生成一个device_tracker设备跟踪器实体家人到家时状态是home离开时变成not_home。这是很多自动化的基础官方 存在检测指南 有详细说明。第二步装一个报警集成。在添加集成里搜Alarm内置的基础报警面板按提示创建。它提供armed_away离家布防等状态后续可以对接真实的门磁和报警主机。第三步创建自动化。点设置 → 自动化 → 新建在界面上依次配置alias: 离家自动布防 trigger: # 触发任意家人的手机离开家 - type: device_trackerany_of: [家人A, 家人B]to: not_home condition: # 条件所有人都不在家 - device_tracker 全部为 not_home action: # 动作布防、关灯、通知 - alarm_control_panel 切换到 armed_away - light 全屋关闭 - notify 推送已离家布防上面这段 YAML 只用于展示结构实际操作中对应位置全部用界面点选完成先选触发器类型和实体再加条件最后依次添加三个动作。第四步验证。关掉 Wi-Fi 把手机放到 4G 环境观察 HA 的自动化页面里这条规则是否亮起已触发检查报警面板状态和通知是否到达。到这一步你已经拥有了一个完整的离家模式。想加回家自动开灯放音乐复制同一条自动化把触发条件从not_home改成home即可。新手最容易踩的 5 个坑1.homeassistant.local打不开。这是域名解析问题不代表系统挂了。解决去路由器后台确认树莓派已获取 IP 地址然后用http://IP:8123访问如果 80 端口被占用常见于 NAS 同机部署记得手动加端口号。2. 插卡通电后 5 分钟以上还没反应。大概率是镜像没刷好或 SD 卡太慢。解决换一张 A2 等级的卡重新刷镜像还不行就接个 HDMI 显示器看启动画面卡在哪。3. 某个集成死活装不上。先别怀疑设备坏了。解决确认设备与 HA 在同一网络/同一 Wi-Fi 频段设备端恢复出厂再重试最后手段是重启 HA 再让它重新发现。4. 自动化感觉没触发。触发器条件太苛刻比如要求所有家人离开而某台手机定位没更新是首因。解决打开该自动化的状态页查看最近一次触发的详细日志逐步放宽条件测试确认每个触发源都按预期变化。5. 升级前没备份。Home Assistant 升级绝大多数情况很稳但绝大多数不值得赌。解决养成动大手术前先建快照的习惯——设置 → 系统 → 备份一键生成完整备份之后还能按时间点精确恢复。成长路径从入门到深度玩家入门第 1 周把基础闭环跑通。接入 3~5 个设备改掉默认仪表盘按房间摆好卡片写出前 3 条自动化天黑开灯、起床流程、离家布防。进阶第 1~3 个月从控制走向感知。装上语音助手尝试一句打开客厅的灯用 ESPHome 入门套件一套便宜的传感器套件做一个温湿度/人体感应节点体验设备 → 自动化的反向联动进阶玩家还可以装 Node-RED 插件做流程图式的复杂逻辑。深度玩家3 个月以后追求稳定与极致。建立定期备份 备份异地存档NAS 或 Git的运维习惯把升级从冒险变成例行公事读一读官方文档里的 概念与术语把实体/设备/服务这套心智模型吃透——这是看懂一切社区高级玩法的地基有余力就去社区分享一个自己的自动化模板给项目做贡献。生态与资源遇到问题去哪找官方文档本仓库从 安装指南 到 上手教程再到 上千个集成的参考手册全部在这里是遇到任何问题的第一站官方论坛全球最大的 HA 社区问题基本都有人踩过搜索关键字命中率很高社区上手指南加入社区 一页列全了论坛、社交频道和各种活动入口常用扩展方向自动化进阶、语音控制、仪表盘自定义、第三方 App。从一盏灯开始到全屋联动Home Assistant 的成长曲线完全由你自己掌握——今天刷好镜像今晚就能听见家里第一声已布防。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考