为什么选择在 OpenWrt 上安装 Home Assistant?
OpenWrt 是一个高度可定制的 Linux 发行版,广泛用于家用路由器。借助其强大的包管理与容器支持(如 Docker 或 LXC),你可以在不额外购买硬件的情况下,将闲置路由器转变为 7×24 小时运行的 Home Assistant 智能家居服务器。
前置条件
- 已刷入 OpenWrt 系统的设备(建议 x86/ARM 架构,内存 ≥1GB)
- 设备已联网并可 SSH 登录
- 启用 USB 存储或扩展存储空间(Home Assistant 需要持久化数据)
- (推荐)已安装 Docker 或支持 LXC 容器
方法一:通过 Docker 安装(推荐)
确保 OpenWrt 已安装 Docker:
opkg update opkg install docker dockerd docker-compose
启动 Docker 服务:
/etc/init.d/dockerd start /etc/init.d/dockerd enable
创建 Home Assistant 目录并运行容器:
mkdir -p /opt/homeassistant/config docker run -d \ --name="homeassistant" \ --privileged \ --restart=unless-stopped \ -e TZ=Asia/Shanghai \ -v /opt/homeassistant/config:/config \ --network=host \ ghcr.io/home-assistant/home-assistant:stable
方法二:使用 LXC 容器(适用于 x86 OpenWrt)
部分高级 OpenWrt 固件(如 ImmortalWrt)支持 LXC。可导入78TP Home Assistant OS 镜像或 Debian 基础镜像后手动安装 Home Assistant Core。
此方法较复杂,适合有 Linux 系统管理经验的用户。
访问 Home Assistant
安装完成后,打开浏览器访问:http://[你的路由器IP]:8123
首次启动可能需要 2–5 分钟初始化,请耐心等待。
注意事项
- 确保防火墙放行 8123 端口
- 定期备份
/opt/homeassistant/config目录 - 部分插件(如 Z-Wave、Zigbee)需 USB 透传,OpenWrt 支持有限
- 资源受限设备建议关闭日志记录以节省内存