犀牛派X1 + HomeAssistant 打造高性能智能家居系统(安装篇)

ysora959 2026-09-21 13:21:37

0x01 什么是HomeAssistant

Home Assistant是一个开源、社区驱动的智能家居自动化平台。它的核心目标是打破不同品牌智能设备之间的壁垒，将它们统一到一个系统中进行集中管理和自动化控制。

可能有人会问：现在米家、HomeKit等智能家居平台也可以实现智能家居控制，为什么还需要HA?

这是因为设备厂商提供的APP往往只能接入其自家产品，不同厂商/平台的设备需要使用不同的APP来控制，无法实现信息互联互通。厂商现有产品也难以满足丰富多样的个性化需求。若想实现多个不同智能设备的集中管理，就需要用到 HA。

0x02 部署方案选型

HomeAssistant 有三种主流部署方式：直接安装在宿主机 Ubuntu 系统中、通过 Docker 容器运行、以及使用 HomeAssistant OS 镜像。考虑到犀牛派 X1 出厂预装 Ubuntu 22.04、且需要同时运行其他边缘计算服务，Docker 方案在隔离性、升级便利性和资源利用率之间取得了最佳平衡。本文采用 Docker 部署 HomeAssistant Docker版本。

0x03 Docker安装

# 安装依赖
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

# 添加国内镜像源
sudo install -m 0755 -d /etc/apt/keyrings

curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg -o /tmp/docker.gpg
sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/docker.gpg /tmp/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list

sudo apt-get update

# 安装Docker
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

0x04 使用国内镜像源

sudo mkdir -p /etc/docker

sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockercf.jmirror.top",
    "https://dockerproxy.com"
  ]
}
EOF

sudo systemctl restart docker

0x05 验证

运行以下命令

sudo docker run --rm hello-world

看到 “Hello from Docker!” 即表示 Docker 安装成功

0x06 HomeAssistant部署

# 创建数据目录
mkdir -p ~/homeassistant

# 安装并启动HA容器
sudo docker run -d \
  --name homeassistant \
  --restart unless-stopped \
  --privileged \
  --network host \
  -v ~/homeassistant:/config \
  -v /run/dbus:/run/dbus:ro \
  -e TZ=Asia/Shanghai \
  homeassistant/home-assistant:stable

参数	说明
-d	后台运行
--name homeassistant	容器名称
--restart unless-stopped	开机自启，异常时自动重启
--privileged	授予特权，支持访问硬件
--network host	宿主机网络，支持设备发现
-v ~/homeassistant:/config	配置文件持久化
-v /run/dbus:/run/dbus:ro	支持蓝牙等设备通信
-e TZ=Asia/Shanghai	时区

0x07 访问HomeAssistant

待安装完成后，浏览器打开 http://<犀牛派X1的IP>:8123，按向导完成初始化设置后，即可完成安装。

0x08 日常管理命令

# 启动
sudo docker start homeassistant

# 停止
sudo docker stop homeassistant

# 重启
sudo docker restart homeassistant

# 查看状态
sudo docker ps --filter name=homeassistant

# 查看日志（实时）
sudo docker logs -f homeassistant

# 进入容器 Shell
sudo docker exec -it homeassistant bash

...全文