Mr.Nine 的技术笔记

Appearance

Home Assistant（群晖套件版） ​

Home Assistant (HA) 是智能家居自动化中枢。
本文只讲群晖套件安装方式，适合小白直接照做。

前置条件

  • 群晖 NAS 已完成基础配置（参考 群晖 NAS）
  • DSM 7.2+，已可正常访问套件中心
  • 建议 NAS 使用固定内网 IP

1. 安装套件源 ​

目前 HA 套件常见为第三方套件源提供，常用来源为“我不是矿神”。

  1. 打开 DSM：套件中心。
  2. 进入：设置 → 套件来源。
  3. 点击新增，填写：
    • 名称：imnks
    • 位置：https://imnks.com/pkg/
  4. 保存后刷新套件中心。

提示

第三方套件不属于群晖官方维护，升级前建议先备份配置。

2. 安装 Home Assistant 套件 ​

  1. 在套件中心搜索 Home Assistant。
  2. 点击安装，等待部署完成。
  3. 安装完成后，从“已安装”打开 HA。
  4. 首次启动通常需要数分钟初始化。

3. 首次初始化 ​

  1. 创建管理员账号。
  2. 设置区域、时区（建议 Asia/Shanghai）。
  3. 完成设备自动发现。
  4. 进入“设置 → 备份”创建首个快照。

4. 必做基础配置 ​

  1. 设置固定访问地址（基于 NAS 固定 IP）。
  2. 校准时间与时区，避免自动化触发异常。
  3. 配置通知（移动端 App / 邮件）用于告警。
  4. 先做 2-3 条小自动化验证链路，再扩展复杂场景。

5. 与 HomeKit 联动 ​

  1. 在 HA 中添加 HomeKit Bridge 集成。
  2. 选择要暴露到 HomeKit 的实体。
  3. 用 iPhone“家庭”App 扫码配对。
  4. 在 HomeKit 内按房间整理设备。

6. 推荐目录与备份策略 ​

  • 配置备份频率：每天或每周自动备份。
  • 重大调整前手动备份一次。
  • 备份文件建议同步到群晖共享文件夹并纳入 Hyper Backup。

常见问题 ​

Q: 套件安装成功但页面打不开？

先确认 NAS 固定 IP 未变化，再检查 DSM 防火墙是否拦截了 HA 端口。

Q: 为什么设备在 HA 有但 HomeKit 不显示？

通常是 HomeKit Bridge 未勾选对应实体，重新选择并重新配对即可。

Q: 是否必须用 Docker？

不必须。本文路线就是群晖套件优先，适合小白快速落地。

相关文档 ​

适用方式：群晖套件版 · 最后验证：2026-02-15