如何在OpenWrt上一键安装Home Assistant：轻量级智能家居终极指南
项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant_on_openwrt Homeassistant on OpenWrt 是一款专为OpenWrt系统设计的轻量级智能家居解决方案，让你无需高端设备也能轻松部署最新版Home Assistant（2024.3.x）。该工具通过自动化脚本实现快速安装，仅保留核心组件并优化资源占用，特别适合路由器、嵌入式设备等资源受限的硬件，完美兼容OpenWrt 23.05及以上版本。
📋 核心优势：为什么选择OpenWrt版Home Assistant？
✅ 超轻量设计，低配置设备也能跑
仅需256MB存储空间+256MB内存即可流畅运行，比完整版Home Assistant节省60%系统资源，老旧路由器也能变身为智能家居中枢。
✅ 一键自动化安装，3分钟搞定
告别复杂命令行操作！通过单个Shell脚本自动完成依赖下载、环境配置和服务部署，小白也能轻松上手。
✅ 保留核心智能家居组件
默认集成MQTT协议、ESPHome设备管理和ZHA zigbee网关三大刚需功能，覆盖90%智能家居设备连接场景。
图：OpenWrt设备上运行的Home Assistant控制面板，界面简洁功能完整（alt: Home Assistant OpenWrt轻量级智能家居系统界面）
🚀 快速安装步骤：3步部署智能家居中枢
1️⃣ 确认设备满足要求
- ✅ OpenWrt 23.05.0或更高版本系统
- ✅ 至少256MB可用存储空间
- ✅ 至少256MB运行内存
2️⃣ 执行一键安装命令
通过OpenWrt终端或SSH工具运行以下命令：
wget https://raw.githubusercontent.com/openlumi/homeassistant_on_openwrt/23.05/ha_install.sh -O - | sh
3️⃣ 启动服务并访问界面
当脚本显示Done.时，表示安装完成：
- 手动启动服务：
/etc/init.d/homeassistant start - 访问控制面板：在浏览器输入
http://设备IP:8123
⚙️ 进阶配置：Zigbee设备连接指南
Xiaomi Gateway用户必看：ZHA协议配置
-
刷写协调器固件
推荐使用v3.23版本Zigate固件（JN5169芯片专用），确保波特率设置为115200。 -
配置串口路径
在ZHA集成页面选择端口 /dev/ttymxc1，该路径为小米网关内置Zigbee芯片默认接口。 -
清除PDM数据（首次连接必做）
执行以下命令清除设备缓存，避免添加设备失败：jntool erase_pdm注意：操作前需确保ZHA服务已停止
🛠️ 扩展功能：添加自定义组件教程
手动安装额外组件的2种方法
方法1：复制官方组件到系统目录
- 从PyPI下载对应版本Home Assistant源码包
- 提取
homeassistant/components目录下需要的组件 - 复制到OpenWrt设备的
/usr/lib/python3.11/site-packages/homeassistant/components
方法2：使用自定义组件目录（推荐）
- 在
/etc/homeassistant目录创建custom_components文件夹 - 将第三方组件直接放入该目录
- 重启Home Assistant服务：
/etc/init.d/homeassistant restart
⚠️ 注意：部分组件可能需要手动安装依赖，建议通过
pip3 install命令预先处理。
❓ 常见问题解决
Q：安装后无法访问8123端口？
A：检查服务状态/etc/init.d/homeassistant status，首次启动需等待2-3分钟加载组件。
Q：Zigbee设备添加失败？
A：确认已执行jntool erase_pdm清除缓存，并确保协调器固件与芯片型号匹配。
Q：如何更新Home Assistant版本？
A：重新运行安装脚本即可自动更新到最新版，配置文件会自动保留。
📌 总结：轻量级智能家居的理想选择
Homeassistant on OpenWrt 通过极致精简设计，让普通路由器也能承担智能家居控制中心的角色。无论是想低成本搭建智能家居系统，还是为现有OpenWrt设备扩展功能，这个工具都能帮你以最低的硬件成本实现专业级智能家居体验。
现在就用旧路由器改造一个24小时不间断运行的智能家居中枢吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
