Home Assistant 安装变体全解析

两种官方安装方式

Home Assistant 目前官方支持两种安装方式（2025 年 6 月起 Core 和 Supervised 已废弃）：

安装方式	适用场景	技术门槛	可安装 App
Home Assistant OS	新手 / 不想管底层系统	低	✅ 官方 App 商店
Home Assistant Container	有 Docker 经验 / 已有 Linux 服务器	中	❌

Home Assistant OS（推荐）

Home Assistant OS 是一个轻量级定制 Linux 发行版，专门为 Home Assistant 优化。特点：

一键刷写 SD 卡或直接写硬盘，不需要预装任何操作系统
自带 Supervisor（管理后台），可以在界面里一键安装 App、备份、更新
内置 Matter Server、Zigbee 驱动、Python 运行时等所有依赖
自动处理内核模块加载、USB 适配器权限等底层问题
支持的硬件：树莓派 3/4/5、Home Assistant Green/Max、ODroid N2+/C4、x86-64 迷你主机

推荐场景：第一次接触 Home Assistant，或者不想操心 Linux 运维。

Home Assistant Container（Docker）

Home Assistant Container 是一个纯 Docker 镜像，在你自己维护的 Linux 系统上运行。特点：

需要自己装 Docker
需要自己处理端口映射、USB 设备透传、时区设置
没有 Supervisor，无法装 App（HACS 需要手动装）
适合已经在用 Docker 的服务器（如 Unraid、Synology NAS Proxmox 等）

典型 Docker run 命令：

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Asia/Shanghai \
  -v /PATH_TO_YOUR_CONFIG:/config \
  -v /run/dbus:/run/dbus:ro \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

注意：--network=host 让 Home Assistant 直接用宿主机网络，避免端口映射的麻烦；--privileged 是为了访问 USB Zigbee/Z-Wave 适配器。

两种方式的核心差异

Home Assistant OS                 Home Assistant Container
──────────────────                ─────────────────────────
自带 Supervisor                 无 Supervisor
可装官方 App 商店的 App           只能装 HACS（手动）
自动更新内核和驱动               自己维护宿主机
USB 适配器自动识别               需要手动配置设备路径
一键快照备份                     需要自己备份 /config 目录
适合树莓派/迷你主机              适合 NAS/虚拟机/已有服务器

选择建议

如果你是第一次用：选 Home Assistant OS。用树莓派刷一张 SD 卡，插网线插电源，浏览器打开 http://homeassistant.local，就能开始用了。整个过程不需要碰一行命令行。

如果你已经有 Docker 服务器：选 Container。把 Home Assistant 当成另一个容器跑起来即可，和你的其他服务（Portainer、AdGuard Home、Node-RED）共用一台机器。

如果你用 Synology DSM 7+：Synology 有官方 Home Assistant DSM 套件——底层其实就是 Container 方式。

关于废弃的安装方式

2025 年 6 月 Home Assistant 官方宣布废弃 Core、Supervised 和 32 位系统支持。现有 Core 用户可以迁移到 Container，Supervised 用户可以迁移到 OS 或 Container。文档中不再保留旧方式的安装说明。