作者：
先说说为什么选这条路
智能家居玩久了，手机里装满各种 App：米家管小米、美的美居管空调、海尔智家管冰箱……想搞个联动让开门自动开灯，得折腾半天才发现两个品牌根本不兼容。Home Assistant（简称 HA）就是来解决这个问题的——它像个大管家，把不同品牌的设备全部接管，一个界面控制全屋。1
那为什么非要用NAS+Docker的方案？很简单—— NAS 本身就是一台24 小时不关机的小服务器，功耗低、噪音小，正好适合这种需要持续运行的服务。而 Docker 让安装变得像装手机 App 一样简单，升级不回滚、删容器不丢数据，比直接装在系统里干净太多。2
群晖、飞牛、极空间、威联通这些主流 NAS 都支持 Docker，方法大同小异，看完这篇你基本上哪家的设备都能搞定。
你的 NAS 能不能跑？先过这关
动手之前先确认三件事，不然装到一半卡住很糟心：
系统版本
群晖需要 DSM 6.2 以上，飞牛 fnOS 稳定版即可，极空间 / 威联通同理。版本太老的先升级系统。3
内存容量
至少 2GB 可用，推荐4GB 以上。HA 本身不占多少内存，但加上其他 Docker 服务和设备联动，2GB 容易捉襟见肘。3
存储空间
预留10GB 以上。HA 的配置文件、数据库、日志会慢慢变大，留足余量。4
Docker 环境
套件中心或应用商店里找到 Docker（群晖叫 Container Manager），确认已安装并正常运行。5
硬件确认没问题，接下来才是重头戏。很多人装 HA 失败，不是 HA 本身难，是网络和文件夹权限没搞对。
群晖用户：按这个顺序一步步来
群晖用户最多，我就以 DSM 7.x 为例。流程不复杂，核心就三步：建文件夹、拉镜像、配参数。
第一步：创建专用文件夹
打开 File Station，在 /docker 目录下新建一个 homeassistant 文件夹。这个文件夹用来存放 HA 的所有配置，以后升级或重装容器，数据都丢不了。路径建议写成这样：/docker/homeassistant。6
第二步：下载官方镜像
打开 Container Manager（Docker），左侧点 " 注册表 "，搜索 homeassistant/home-assistant。认准带 OFFICIAL 标识的官方镜像，下载稳定版 latest 标签。这一步可能比较慢，国内访问 Docker Hub 不稳定，耐心等一下。7
第三步：创建容器，关键参数不能错
镜像下载完，双击它开始创建容器。这几步最关键：
容器名称
写成 homeassistant，方便识别，别用中文和特殊字符。
自动重启
勾选 " 启用自动重新启动 "。NAS 断电再恢复，HA 要能自己爬起来。6
网络模式
选host 主机模式，不能用 bridge 桥接。HA 需要发现局域网内的智能设备，host 模式直接用 NAS 的网络，设备才能找到。5
文件夹映射
把 NAS 上的 /docker/homeassistant 映射到容器的 /config。这是 HA 约定好的配置目录，映射错了 HA 会报错。4
环境变量
添加 TZ=Asia/Shanghai，确保 HA 的时间和你所在地区一致，不然自动化触发时间会错乱。7
参数确认无误后点 " 完成 "，等待容器启动。第一次启动需要几分钟初始化，别着急关掉。启动成功后，浏览器输入 class="details-link-number">8
飞牛 fnOS 用户：两种方式都行
飞牛 fnOS 的 Docker 生态做得比较完善，给了用户更多选择。
方式一：应用商店一键安装（推荐新手）
打开飞牛 NAS 应用中心 → 生活分类 → 找到 HomeAssistant → 点击安装。2-3 分钟装完，系统会自动启动服务，点 " 打开 " 进入网页端按向导配置就行。这个方式最简单，但商店版本可能有滞后，想要最新版可以看方式二。9
方式二：Docker Compose（适合进阶玩家）
打开 Docker → Compose → 新建项目，复制以下配置：
version: '3'
services:
homeassistant:
image: homeassistant/home-assistant:latest
container_name: homeassistant
network_mode: host
environment:
- TZ=Asia/Shanghai
volumes:
- /mnt/ 你的路径 /home-assistant/config:/config
restart: unless-stopped10
关键点和群晖一样：host 网络模式、时区设置、配置目录映射，三样缺一不可。
这两个坑踩过的都说香
别看教程写得清楚，真动手了十个人里有八个会在这两个地方翻车。提前知道，能省你半天时间。
坑一：镜像下载卡在 0% 不动
这是Docker Hub 被墙导致的，国内晚间高峰期访问极其不稳定。解决方法：在 Docker 设置里添加国内镜像加速源。群晖在 " 注册表→设置→编辑 " 里添加；威联通在 Container Station 设置里找。加速源地址可以用阿里云、网易等，具体可搜索你设备型号对应的镜像加速配置。11
坑二：容器一启动就自动停止
八成是端口被占用。群晖系统本身占用了 80、443、5000、5001 这些端口，而很多镜像默认用 8080 做 Web 端口。解决方法：创建容器时，把容器内部端口映射到一个 NAS 上没被占用的端口，比如 8124 映射到 8123。11
还有一个更隐蔽的问题：群晖防火墙。DSM 默认开启的防火墙会阻止 Docker 容器访问外网，导致 HA 无法检查更新或下载集成。装好后如果提示网络问题，先去 " 控制面板→防火墙 " 检查一下。12
装好了然后呢？这些事值得做
HA 跑起来只是第一步，真正好玩的是后面的设备接入和自动化。给你几个建议方向：
1. 先装 HACS 扩展生态
HACS 是 HA 的 " 应用商店 "，装了它才能装大量第三方集成。小米、美的、华为等国内品牌的支持基本都在这里面。安装方法不复杂，HA 启动后打开终端，执行一行命令即可，官方和民间教程一大堆。9
2. 把家里的智能设备逐步接入
HA 支持成百上千种设备接入，但不同品牌接入方式不一样。米家设备需要通过特定网关或集成，Zigbee 设备需要 USB Dongle。建议先从一两件设备试起，熟悉了再扩展。
3. 试玩简单的自动化
" 天黑后开门自动开灯 "" 上班后所有设备自动关闭 " 这类自动化用 HA 配置起来比各个品牌 App 里设置方便得多，而且可以跨品牌联动。一旦用顺了，你就再也回不去单独控制的时代了。
4. 记得定期备份
配置文件全部存在 NAS 的那个文件夹里，用 NAS 本身的备份功能定期备份整个目录。或者用 HA 自带的备份功能导出快照，这样即使 NAS 系统崩了，换个机器重新拉起容器，配置还能恢复。13
NAS+Docker 部署 HA 这套组合，适合不想折腾、追求稳定、想长期用的玩家。一次性配置好，以后基本不用管，24 小时在线，功耗也就几瓦。比起买树莓派另起炉灶，在现有 NAS 上跑 Docker 显然更省事。14
如果你家的 NAS 买回来主要就当存储器用，Docker 这个功能真的值得开荒一下。HA 只是其中一个玩法，去广告的 AdGuard、密码管理的 Vaultwarden、私人影院的 Jellyfin …… NAS 的潜力远比你以为的大得多。