为什么选择在 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 homeassistantQ：能否使用 Zigbee/Z-Wave？
A：可以，但需确保 USB 串口设备（如 CC2652）被正确识别，并在 volumes 中添加设备映射，例如：
devices:
- /dev/ttyUSB0:/dev/ttyUSB0结语
通过在 OpenWrt 上部署 Home Assistant，你不仅充分利用了现有硬件资源，还构建了一个完全本地化、隐私安全的智能家居中枢。随着配置的深入，你可以集成更多传感器、自动化场景，打造真正属于自己的智慧家庭。
祝你搭建顺利！