在 OpenWrt 上安装 Home Assistant

为什么选择在 OpenWrt 上运行 Home Assistant？

OpenWrt 是一个高度可定制的 Linux 发行版，专为嵌入式设备（如家用路由器）设计。通过在其上部署 Home Assistant（简称 HA），你可以：

节省额外硬件成本（无需树莓派或服务器）
利用路由器 7×24 小时运行的优势
集中管理网络与智能设备
提升本地自动化响应速度

注意：并非所有 OpenWrt 设备都适合运行 Home Assistant。建议使用内存 ≥512MB、存储 ≥8GB 的设备（如 x86 软路由或高端 ARM 路由器）。

前置条件

已刷入 OpenWrt 系统（推荐 23.05 或更新版本）
设备具备足够存储空间（建议挂载 USB 存储）
已开启 SSH 访问权限
网络连接稳定

安装步骤

安装必要软件包

opkg update

opkg install docker.io docker-compose

创建 Home Assistant 配置目录
```
mkdir -p /mnt/usb/homeassistant/{config,media}
```
（假设你已将 USB 存储挂载到 /mnt/usb）

创建 docker-compose.yml 文件

cat > /mnt/usb/homeassistant/docker-compose.yml <



        启动服务

          cd /mnt/usb/homeassistant

docker-compose up -d

        

        访问 Home Assistant

          浏览器打开：http://[你的路由器IP]:8123





    

      常见问题

      Q：Home Assistant 启动失败怎么办？

      A：检查 Docker 是否正常运行，确认存储路径权限是否正确，可通过以下命令查看日志：

      docker logs homeassistant



      Q：能否使用 Zigbee/Z-Wave？

      A：可以，但需确保 USB 串口设备（如 CC2652）被正确识别，并在 volumes 中添加设备映射，例如：

      devices:

  - /dev/ttyUSB0:/dev/ttyUSB0

    



    

      结语

      通过在 OpenWrt 上部署 Home Assistant，你不仅充分利用了现有硬件资源，还构建了一个完全本地化、隐私安全的智能家居中枢。随着配置的深入，你可以集成更多传感器、自动化场景，打造真正属于自己的智慧家庭。

      祝你搭建顺利！