OpenWrt 安装 Home Assistant 完整指南

在基于 OpenWrt 的路由器上部署 Home Assistant,打造轻量级智能家居中枢

为什么选择在 OpenWrt 上安装 Home Assistant?

OpenWrt 是一个高度可定制的 Linux 发行版,广泛用于家用路由器。借助其强大的包管理与容器支持(如 Docker 或 LXC),你可以在不额外购买硬件的情况下,将闲置路由器转变为 7×24 小时运行的 Home Assistant 智能家居服务器。

前置条件

方法一:通过 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 分钟初始化,请耐心等待。

注意事项