[Python] 树莓派CM0 NANO部署Home Assistant与HACS：集成Xiaomi Home实现智能家居本地化

本文详细介绍了在资源受限的树莓派 CM0 NANO 单板计算机上，通过 Docker 容器化部署 Home Assistant 智能家居平台，并为其安装 HACS 商店及 Xiaomi Home 集成，从而实现米家设备本地化接入的完整流程。

项目概述

本项目旨在利用树莓派 CM0 NANO 搭建一个轻量级的本地智能家居中枢。核心步骤包括：在 Docker 中部署特定版本的 Home Assistant，安装强大的第三方集成商店 HACS，并通过 HACS 快速添加 Xiaomi Home 插件，最终将小米智能家居设备无缝对接到本地系统中，为工业 IoT 应用或家庭自动化提供参考。

准备工作

在开始部署前，需要完成硬件连接和基础软件环境的搭建。

硬件连接
根据你的使用方式，连接必要的硬件：

• SSH远程登录：需要连接 5V 3A 电源和网线。
• 本地桌面操作：除了电源和网线，还需连接 HDMI 显示器、USB 键盘和鼠标。

操作系统
使用树莓派官方的 Raspberry Pi OS。建议选择 Lite 版本以节省资源，例如 Raspberry Pi OS(Lite) 64-bit-trixie (Debian 13)。

Docker 安装
通过官方脚本快速安装 Docker，这是后续所有容器化技术部署的基础。
打开终端，执行以下命令：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

部署 Home Assistant

考虑到树莓派 CM0 NANO 的硬件资源，我们选择了一个体积较小且兼容性良好的 Home Assistant 版本进行部署。

更换 Docker 镜像源
为了加速镜像下载，首先需要配置 Docker 镜像源。执行以下命令修改 daemon.json 配置文件，这是常见的Linux系统配置操作。

sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
        "https://docker.m.daocloud.io",
        "https://docker.imgdb.de",
        "https://docker-0.unsee.tech",
        "https://docker.hlmirror.com",
        "https://docker.1ms.run",
        "https://func.ink",
        "https://lispy.org",
        "https://docker.xiaogenban1993.com"
    ]
}
EOF

配置完成后，重启 Docker 服务使配置生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

拉取 Home Assistant 镜像
这里我们选择 2024.11.3 版本，在终端执行拉取命令：

sudo docker pull homeassistant/home-assistant:2024.11.3
sudo docker tag homeassistant/home-assistant:2024.11.3 \
                homeassistant/home-assistant:2024.11.3

创建并运行容器
使用以下 Docker 命令创建容器，并限制其内存使用以适应 CM0 NANO 的资源：

sudo docker run -d --name hass \
  --restart unless-stopped \
  --memory 250m --memory-swap 350m \
  -v /srv/homeassistant:/config \
  -v /etc/localtime:/etc/localtime:ro \
  --network host \
  --log-opt max-size=10m --log-opt max-file=2 \
  homeassistant/home-assistant:2024.11.3

等待容器启动后，可以通过命令查看日志确认：

sudo docker logs -f hass | grep -m1 'Home Assistant Core'

在浏览器中访问 http://<你的树莓派IP地址>:8123（例如：http://192.168.1.102:8123），即可进入 Home Assistant 的 Web 界面，首次访问需要创建管理员账户。

安装 HACS 集成商店

HACS 是 Home Assistant 的第三方集成商店，可以极大扩展其功能。

下载 HACS
首先，进入 Home Assistant 的容器内部进行操作：

sudo docker exec -it hass bash

在容器内，依次执行以下命令以下载 HACS 极速版：

cd /config
mkdir -p custom_components
cd custom_components
wget -O- https://get.hacs.vip | bash -

执行 exit 退出容器，然后重启 Home Assistant 服务：

sudo docker restart hass

添加 HACS 集成
重启后，在 Home Assistant 网页界面中，依次点击：
配置 -> 设备与服务 -> 添加集成，然后搜索并添加 HACS。按照提示完成授权（通常选择公共 GitHub 授权即可）。添加成功后，侧边栏会出现 HACS 的菜单项。

添加 Xiaomi Home 集成

通过 HACS，我们可以一键安装米家设备集成。

安装插件
在 HACS 页面中，点击右下角的“浏览并下载存储库”，在搜索框中输入 Xiaomi Home。找到该集成后，点击进入详情页，然后点击“下载”按钮进行安装。

登录小米账号
插件安装完成后，需要在 Home Assistant 中添加该集成。

1. 进入 配置 -> 设备与服务 -> 添加集成。
2. 搜索 Xiaomi Home 并选择。
3. 在配置页面点击登录链接，使用你的小米账号完成授权。

导入设备
授权成功后，会弹出对话框让你选择小米智能家庭。选择你需要接入的家庭，该家庭内的所有米家设备将自动被导入到 Home Assistant 中。

总结

至此，我们成功在树莓派 CM0 NANO 上建立了一个本地的智能家居控制中心。通过 Docker 部署 Home Assistant，利用 HACS 扩展其生态，并最终接入了 Xiaomi Home 设备，实现了对小米智能家居产品的本地化控制。这套方案充分利用了边缘计算设备的特性，为注重隐私和本地执行的智能家居场景提供了一种可行的实践路径。