部署homeassisent
NAS 也能玩转全屋智能：Home Assistant 终极部署指南
前言：你的智能家居大脑，为何应该安在 NAS 上？
你是否曾梦想过这样的场景：清晨，窗帘缓缓拉开，柔和的音乐响起；离家时，灯光、电器自动关闭，扫地机器人开始工作；夜晚归来，家中的空调早已调至舒适的温度。这一切，就是全屋智能的魅力。
而实现这一切的核心，需要一个稳定、强大、且永远在线的“大脑”——Home Assistant (简称 HA)。
Home Assistant 是一个开源的智能家居自动化平台，它的强大之处在于无与伦比的兼容性和定制性，可以连接数千种不同品牌的智能设备，让你摆脱厂商生态壁垒，真正实现“万物互联”。
那么，这个“大脑”应该安装在哪里呢？虽然树莓派是很多人的入门选择，但如果你拥有一台 NAS (网络附属存储)，那么恭喜你，你已经拥有了运行 Home Assistant 的完美平台。
为什么选择 NAS + Home Assistant？
- 7x24 小时不间断运行：NAS 天生就是为全天候工作而设计的，保证了智能家居中枢的绝对稳定。
- 低功耗与高性能：相比于一台完整的电脑，NAS 功耗更低，但其性能（尤其是 x86 架构的型号）足以流畅运行 HA 及众多插件。
- 数据安全与隐私：HA 的核心理念之一就是“本地优先”，所有数据和自动化逻辑都存储在你自己的设备上，而非上传到厂商的云端。NAS 作为你的私有数据中心，完美契合了这一理念。
- 一机多用：你的 NAS 在作为数据仓库的同时，也能化身智能家居服务器，物尽其用。
本篇博客将详细介绍在 NAS 上部署 Home Assistant 的两种主流方法：Docker 容器化部署和虚拟机部署，并深入剖析其原理、步骤及优缺点，助你轻松开启真正的智能家居之旅。
部署方式对比：Docker vs. 虚拟机，我该如何选？
在 NAS 上部署 HA，主要有两种技术路径。理解它们的区别，能帮助你做出最适合自己的选择。
| 特性 | Docker 方式 (Home Assistant Container) | 虚拟机方式 (Home Assistant OS) |
|---|---|---|
| 核心系统 | 纯净的 HA Core | 完整的 HA 操作系统 (HAOS)，带 Supervisor |
| 资源占用 | 占用内存和 CPU 极低，非常轻量 | 占用资源较高，需要分配独立的 CPU 和内存 |
| 加载项(Add-ons) | ❌ 不支持。需要手动通过 Docker 部署 | ✅ 支持。可一键安装、管理和备份各种强大插件 |
| 系统更新 | 相对手动，需要重新拉取镜像并创建容器 | ✅ 一键更新。核心、系统、插件均可在网页上完成 |
| 备份与恢复 | 需手动备份 /config 配置文件目录 |
✅ 一键创建/恢复 整个系统的完整快照 |
| 易用性 | 对 Docker 有一定了解的用户更顺手 | 对新手极其友好，提供“保姆级”体验 |
| 适合人群 | 熟悉 Docker、喜欢折腾、NAS 性能有限的用户 | 强烈推荐新手、追求省心和完整功能体验的用户 |
结论建议：
- 如果你是新手，或者你的 NAS 性能足够（建议4GB内存以上），请毫不犹豫地选择虚拟机方式。 它提供的 Supervisor 和 Add-on 商店会让你感觉如虎添翼，极大地降低了入门和后续折腾的门槛。
- 如果你是 Docker 高手，或者你的 NAS 性能比较紧张，选择 Docker 方式，它更灵活、更高效，能让你更深刻地理解 HA 的运行机制。
实战篇（一）：Docker 容器化部署 (以群晖 DSM 为例)
这种方式的核心原理，是将 Home Assistant 应用本身打包在一个隔离的“箱子”（即容器）里运行，配置文件则通过“卷映射”的方式存储在 NAS 的本地文件夹中，从而实现应用与数据的分离。
步骤 1：安装 Docker 套件
登录你的 NAS 后台（这里以群晖 DSM 为例），进入“套件中心”，搜索并安装 Docker 套件。
步骤 2：创建 HA 配置文件目录
为了持久化存储 HA 的所有配置，我们需要在 NAS 上创建一个专属文件夹。
- 打开
File Station。 - 在
docker共享文件夹下，创建一个名为homeassistant的子文件夹。 - 记下这个文件夹的完整路径，通常是
/volume1/docker/homeassistant。
步骤 3：拉取 Home Assistant 镜像
打开 Docker 套件，在“映像”页面，点击“新增” > “从 URL 新增”。在弹出的对话框中输入以下官方镜像地址，然后点击“新增”开始下载。
1 | ghcr.io/home-assistant/home-assistant:stable |
步骤 4：创建并运行容器
这是最关键的一步。镜像下载完成后，选中它并点击“启动”。
对于熟悉命令行的用户，你可以直接通过 SSH 登录 NAS，运行以下命令，一步到位：
1 | docker run -d \ |
命令参数详解：
docker run -d: 在后台分离模式下运行容器。--name home-assistant: 给容器起一个名字。--restart=unless-stopped: 容器退出时自动重启，除非手动停止。保证了开机自启。-e TZ=Asia/Shanghai: 设置环境变量，将时区设置为上海，确保 HA 内时间正确。-v /volume1/docker/homeassistant:/config: 核心操作。将我们创建的本地文件夹挂载到容器内的/config目录。--network=host: 核心操作。让容器直接使用宿主机（NAS）的网络，极大地方便 HA 发现和连接局域网内的各种智能设备。ghcr.io/home-assistant/home-assistant:stable: 使用的镜像。
对于使用图形界面的用户，请按以下步骤配置：
- 网络：勾选“使用与 Docker Host 相同的网络”。
- 常规设置：勾选“启用自动重新启动”。
- 卷设置：点击“添加文件夹”，将本地的
/volume1/docker/homeassistant文件夹映射到容器的/config路径。 - 环境：添加一个环境变量，变量为
TZ，值为Asia/Shanghai。 - 应用设置并启动容器。
步骤 5：访问 Home Assistant
等待几分钟让 HA 完成首次初始化。然后，在浏览器中输入 http://<你的NAS_IP地址>:8123，即可看到欢迎界面。
实战篇（二）：虚拟机部署 (以群晖 VMM 为例)
这种方式是在 NAS 上创建一个完整的虚拟电脑，然后在其中运行官方打包好的 Home Assistant 操作系统 (HAOS)。
步骤 1：安装虚拟机套件
在“套件中心”搜索并安装 Virtual Machine Manager。
步骤 2：下载 Home Assistant OS 镜像
访问 Home Assistant 官网的 OS 镜像发布页面。找到最新的版本，在 Assets 中下载适用于虚拟机的镜像文件，通常是 .ova 格式（推荐）或 .vmdk 格式。
步骤 3：创建并配置虚拟机
- 打开
Virtual Machine Manager，选择“虚拟机” > “新增” > “导入”。 - 选择“从 OVA 文件导入”，上传你刚刚下载的
.ova文件。 - 配置虚拟机资源：
- CPU：建议至少分配 2 个核心。
- 内存：建议至少分配 2 GB (2048 MB)，4GB 更佳。
- 网络：选择默认的网络即可，确保其与你的局域网联通。
- 开机选项：将固件设置为 UEFI。
- 根据向导完成创建。
步骤 4：启动并访问 Home Assistant
- 在虚拟机列表中，启动刚刚创建的 HA 虚拟机。
- 系统启动后，你可以在虚拟机详情页看到它自动获取到的 IP 地址。
- 等待 5-20 分钟，让 HAOS 完成首次启动和配置。
- 在浏览器中输入
http://<虚拟机的IP地址>:8123，即可看到欢迎界面。
初始化与后续探索
无论你使用哪种方式，首次访问 HA 时，系统都会引导你：
- 创建一个管理员账户：这是你未来管理整个智能家居系统的账号。
- 设置家庭位置：用于日出日落等自动化。
- 发现设备：HA 会自动扫描你的网络，并列出它发现的可以集成的设备。
接下来去哪里探索？
- 集成 (Integrations)：在“配置” > “设备与服务”中，你可以手动添加和管理所有智能设备。
- HACS (Home Assistant Community Store)：这是必装的“第三方应用商店”。你需要手动安装它，之后便能轻松下载由全球开发者贡献的、官方商店里没有的自定义集成和前端卡片，极大扩展 HA 的能力。
- 自动化 (Automations)：在“配置” > “自动化与场景”中，开始创建你的第一个自动化流程，例如“日落时开灯”。
结语
将 Home Assistant 部署在 NAS 上，是你迈向高阶智能家居玩家的关键一步。它为你提供了一个稳定、私密且功能强大的平台，让你的奇思妙想得以落地。
- 追求极致性能和灵活性，请拥抱 Docker。
- 渴望轻松上手和完整生态，虚拟机是你的不二之选。
现在，选择适合你的方式，开始动手吧！一个真正听你指挥的家，正在等待你的创造。
ARB1网络(usdt)