如何在OpenWrt上一键安装Home Assistant：2024最新极简部署教程
项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant_on_openwrt 想让你的路由器秒变智能家居控制中心？无需复杂配置，通过homeassistant_on_openwrt项目，任何人都能在OpenWrt设备上快速部署功能完整的Home Assistant智能家居系统。本文将带你用一行命令完成安装，让老旧路由器焕发新生，轻松掌控全屋智能设备！
🚀 为什么选择OpenWrt+Home Assistant组合？
OpenWrt作为轻量级嵌入式系统，以其高效的资源利用率著称，而Home Assistant则是开源智能家居平台的佼佼者。将两者结合，你将获得：
- 极致轻量化：专为嵌入式设备优化，最低仅需256MB存储和256MB内存（推荐配置）
- 原生系统整合：直接运行在路由器系统中，无需额外硬件
- 核心功能预置：默认集成MQTT协议和ZHA zigbee网关，完美支持小米等品牌智能设备
- 2024最新版本：同步官方2024.3.x版本，包含最新智能家居控制特性
Home Assistant在OpenWrt设备上的Web管理界面，直观控制所有智能设备
📋 准备工作：你的设备符合要求吗？
在开始安装前，请确认设备满足以下条件：
- ✅ 已安装OpenWrt 23.05.0或更高版本系统
- ✅ 至少256MB可用存储空间（推荐512MB以上）
- ✅ 至少256MB运行内存（RAM）
- ✅ 稳定的互联网连接（用于下载安装包）
🔧 一键安装步骤：小白也能3分钟搞定
第1步：登录OpenWrt终端
通过SSH工具连接路由器，或直接在OpenWrt管理界面打开系统终端。
第2步：执行安装命令
复制粘贴以下命令并回车，系统将自动完成所有安装流程：
wget https://raw.githubusercontent.com/openlumi/homeassistant_on_openwrt/23.05/ha_install.sh -O - | sh
第3步：启动服务
当终端显示Done.时，输入以下命令启动Home Assistant服务：
service homeassistant start
或直接重启路由器，服务将自动运行。
第4步：访问控制界面
在浏览器中输入路由器IP地址+:8123端口（例如192.168.1.1:8123），即可打开Home Assistant管理界面。首次加载可能需要3-5分钟，请耐心等待组件初始化。
🛠️ 必知配置：让智能设备完美工作
ZHA Zigbee网关设置（小米网关适用）
- 刷写协调器固件：推荐使用JN5169芯片的v3.23版本固件
- 端口配置：在ZHA设置中选择
/dev/ttymxc1端口 - 初始化PDM：首次使用需清除持久数据存储（重要！）：
jntool erase_pdm
注意：执行此命令前需确保ZHA服务已停止
MQTT协议配置
系统已预置MQTT服务，在Home Assistant界面中：
- 进入配置 > 设备与服务
- 点击添加集成，搜索并选择MQTT
- 保持默认设置完成配置，即可接入支持MQTT协议的智能设备
📱 扩展功能：添加更多智能家居组件
默认安装包含核心控制功能，如需扩展其他组件（如蓝牙设备、红外遥控等），可通过两种方式实现：
方法1：手动安装官方组件
- 从PyPI官网下载对应版本的tar.gz安装包
- 解压后将组件文件夹复制到
/usr/lib/python3.11/site-packages/homeassistant/components
方法2：使用自定义组件目录
在/etc/homeassistant目录下创建custom_components文件夹，将第三方组件放入其中即可自动加载。
⚠️ 注意：添加新组件后可能需要重启服务才能生效：
service homeassistant restart
❓ 常见问题解决指南
问题1：界面无法打开？
- 检查服务状态：
service homeassistant status - 确认8123端口未被占用：
netstat -tuln | grep 8123 - 查看日志定位错误：
logread | grep homeassistant
问题2：Zigbee设备无法添加？
- 确保已执行
jntool erase_pdm命令 - 检查Zigbee芯片固件是否为协调器版本
- 保证设备处于配对模式且距离路由器不超过3米
问题3：组件安装后无法使用？
部分组件需要手动安装依赖包，可尝试：
pip3 install -r /path/to/component/manifest.json
🎯 总结：用OpenWrt打造专属智能中心
通过homeassistant_on_openwrt项目，你已成功将路由器改造成功能强大的智能家居控制中心。这个方案不仅节省硬件成本，更实现了网络与智能控制的完美融合。现在你可以：
- ✔️ 统一管理WiFi、蓝牙、Zigbee各类智能设备
- ✔️ 编写自动化场景（如"回家模式"自动开灯开空调）
- ✔️ 通过手机App远程控制家中设备
立即开始探索更多智能家居可能性，用开源方案构建真正属于自己的智能生活体验！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
