最新

NAS 怎么用 Docker 装 Home Assistant

想把不同品牌的灯和传感器收进一个面板,NAS 上的 Docker 就能跑起来。讲清镜像怎么拉、目录怎么挂,以及设备发现不到先查什么。

Home Assistant 是一个开源的智能家居控制面板,能把不同品牌的灯、插座、传感器收进同一个界面,再用自动化把它们串起来。它不需要专门的硬件,NAS 上只要有 Docker,就能把它跑起来,数据也留在自己手里。

入口在哪

群晖在套件中心装 Container Manager,旧版本里这个套件还叫 Docker;威联通对应的是 Container Station。装好之后打开套件,左侧能看到「容器」「映像」「项目」几个入口。如果你更习惯命令行,也可以在 NAS 上开启 SSH,用 docker 命令操作,两条路最后落到同一个容器上。不同版本菜单名称略有差别,找不到就直接在套件里搜 Docker。

具体步骤

先在 NAS 的共享文件夹里建一个目录给 Home Assistant 存配置,比如 /volume1/docker/homeassistant,再在它下面建一个 config 子目录。这个目录以后就是整个系统的家,账号、集成、自动化都在里面。

接着拉取官方镜像 ghcr.io/home-assistant/home-assistant:stable。用图形界面的话,在「映像」里添加这个地址下载;用命令行就是一条 docker pull。

创建容器时有三处必须对上:端口把容器内的 8123 映射到 NAS 的 8123;存储把刚才的 config 目录挂载到容器内的 /config;网络建议直接选 host 模式,省掉后面发现设备时的麻烦。再把重启策略设成「除非手动停止」,NAS 重启后它会自己起来。

启动后用浏览器打开 http://NAS的局域网IP:8123,第一次会进入初始化页面,按提示建管理员账号、填家庭位置和时区,就进到面板了。

几个坑

  • 设备发现不到,多半是网络模式用了桥接。局域网里的灯和插座靠广播找,桥接模式下只能看到容器自己,改成 host 再重启。
  • 配置文件权限不对,容器会反复重启。日志里出现权限相关的报错时,先确认挂载的目录对容器内的运行用户可写。
  • 容器里默认是 UTC 时间,自动化按点触发会整体偏八小时。创建时加一个环境变量 TZ=Asia/Shanghai。
  • 要接 USB 的 Zigbee 或蓝牙网关,得把设备节点映射进容器,否则集成里看不到硬件。这一步改错不影响启动,但设备永远连不上。
  • 配置目录别放在会被网盘或同步工具实时同步的位置,数据库文件在运行中被改写,同步冲突会把配置弄坏。

怎么验证

先看容器状态是不是「运行中」,再打开 8123 页面能正常登录。然后进「设置 > 设备与服务」,添加一个你手头确实在线的设备,比如同一网段的一盏灯,看它能不能被发现并读出状态。

最后做一次重启测试:重启容器,等它起来后确认账号还能登录、刚才添加的设备还在。如果重启后回到了初始化页面,说明 config 没有真正挂载上,回去检查路径。

常见问题

打开 8123 一直转圈怎么办

先确认容器在运行、端口映射没被别的服务占用;再从 NAS 本机用命令行访问一次,排除是电脑到 NAS 的网络问题。日志里如果有数据库损坏的报错,需要停掉容器,备份后修复配置目录。

升级会不会丢配置

配置都在挂载出来的 config 目录里,换镜像不会动它。但大版本升级前仍建议把整个目录复制一份,升级后如果有集成不兼容,回退镜像版本就能恢复。

ARM 机型能装吗

官方镜像有多架构版本,常见 ARM 机型可以直接拉。少数插件只提供 x86 版本,装之前先看它的说明,别等装完才发现跑不起来。

一句话总结:把配置目录挂出来、网络用 host、时区设对,Home Assistant 在 NAS 上就能稳定跑起来。