NAS 与运维

Home Assistant Container:接入智能家居

  • 0 次阅读
  • 0 条评论
文章摘要

Home Assistant 统一接入设备和自动化规则。Container 方式适合已有 Docker 主机,但与 Home Assistant OS 的管理功能不同,不自带 OS 方案的应用商店与 Supervisor。 集成把不同设备转换成实体,自动化根据状态和条件执行动作。Container 与 OS 方案的管理功能不同。 适合已有 Docker 的家庭主机。先接一台设备,再写简单规则,逐步扩展。

项目介绍

Home Assistant 统一接入设备和自动化规则。Container 方式适合已有 Docker 主机,但与 Home Assistant OS 的管理功能不同,不自带 OS 方案的应用商店与 Supervisor。

集成把不同设备转换成实体,自动化根据状态和条件执行动作。Container 与 OS 方案的管理功能不同。

适合已有 Docker 的家庭主机。先接一台设备,再写简单规则,逐步扩展。

核心功能

功能 作用与使用方式
设备集成 连接支持的硬件
实体状态 统一查看数值与开关
自动化 设置触发条件动作
仪表板 组织家庭操作
配置备份 保存规则和集成

功能示意

Home Assistant Container 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 home-assistant/core
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 创建 /volume1/docker/homeassistant/config,确认宿主机 8123 端口空闲。下面配置采用 Linux host 网络,适合局域网发现;它不会改变端口冲突的事实。
  2. 启动后打开 http://NAS_IP:8123,创建自己的管理员并设置家庭区域、时区和单位。
  3. 先接入一台官方支持的设备,检查状态更新和基本控制,再建立一个简单自动化;先确认手动操作有效,再排查触发条件。
  4. 蓝牙、Zigbee 或其他 USB 设备需额外核对驱动和设备映射,按实际需要增加。HACS 是第三方扩展渠道,安装前分别检查依赖。

首次使用与操作检查

先手动控制测试灯,再设一条无风险自动化,检查日志中的触发与动作。

局域网发现失败查网络模式。USB 和蓝牙需要实际设备支持,Container 不自带 Supervisor 应用商店。

Docker Compose

按官方容器方式整理基础配置,使用 host 网络;硬件接入所需的 D-Bus、设备与额外权限按实际设备配置。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/homeassistant/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/homeassistant /volume1/docker/homeassistant/config
cd /volume1/docker/homeassistant
HALO_PREPARE
cd /volume1/docker/homeassistant
services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:stable
    restart: unless-stopped
    network_mode: host
    environment:
      TZ: Asia/Shanghai
    volumes:
      - /volume1/docker/homeassistant/config:/config

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 示例只提供基本容器与网络,不加入蓝牙 D-Bus、USB 或广泛特权配置,硬件功能按需补充。
  • Container 与 OS 的升级和备份方式不同,不能把 OS 教程中的管理按钮套过来。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

备份整个 config 与凭据,重要自动化导出副本;更新前检查集成的兼容说明。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料