Home Assistant 米家集成部署

Home Assistant 是一款基于 Python 的智能家居开源系统，支持众多品牌的智能家居设备。

Home Assistant官网：https://www.home-assistant.io/

Home Assistant 米家集成

米家集成是一个由小米官方提供支持的 Home Assistant 的集成组件，它可以让您在 Home Assistant 中使用小米 IoT 智能设备。

Home Assistant 版本要求：

Core ≥ 2024.4.4

Operating System ≥ 13.0

1、容器化安装

注意: 请确保您的系统满足上述硬件和软件要求。windows 系统需要进入 wsl 环境。当然直接使用Linux系统也可以。

系统要求： Windows11 22H2 及以上版本 + WSL2

安装 WSL

在系统中搜素终端然后打开，输入wsl --install，等待 WSL 安装完成；如果已经安装，可以使用wsl --update更新到最新版本

下载 WSL2 Linux 发行版

打开 Windows 自带的应用商店，搜索 Ubuntu ，然后下载 Ubuntu24.04.1 LTS

在 Windows 终端可使用wsl --list --online查看在线的发行版，然后输入wsl --install -d Ubuntu-24.04安装

使用 WSL2

在应用商店下载完成后，可以点击打开按钮，然后按照提示输入用户名和密码，完成初始化

在终端输入wsl -d Ubuntu-24.04，然后按照提示输入用户名和密码，完成初始化

安装Docker环境

拉取官方稳定版Home Assistant镜像

创建持久化配置目录

以特权模式运行容器，挂载配置目录和dbus服务

使用主机网络模式，避免端口冲突

访问http://localhost:8123完成初始化配置

支持多种Linux发行版，无需额外依赖

配置文件持久化存储，重启后数据不丢失

复制代码

#!/bin/bash
# 安装Docker
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

# 拉取Home Assistant镜像
docker pull ghcr.io/home-assistant/home-assistant:stable

# 创建配置目录
mkdir -p /data/home-assistant/config

# 运行Home Assistant容器
docker run -d \
  --name=home-assistant \
  --privileged \
  -v /data/home-assistant/config:/config \
  -v /run/dbus:/run/dbus:ro \
  --net=host \
  ghcr.io/home-assistant/home-assistant:stable

2、启动容器

复制代码

docker run -d --name=home-assistant --privileged -v /home/vopo1/home-assistant/config:/config -v /run/dbus:/run/dbus:ro --net=host ghcr.io/home-assistant/home-assistant:stable

指令说明

1.docker run：启动一个新的 Docker 容器

2.-d：以"分离模式"（后台运行）启动容器

3.--name=home-assistant：为容器指定名称为"home-assistant"

4.--privileged：给予容器特权模式，允许访问主机设备（通常用于访问硬件设备）

5.-v /data/home-assistant/config:/config：将主机的 /data/home-assistant/config 目录挂载到容器的 /config 目录，用于存储 Home Assistant 的配置文件

6.-v /run/dbus:/run/dbus:ro：将主机的 D-Bus 系统总线挂载到容器中，以只读模式（ro）访问

7.--net=host：使用主机的网络模式，容器将直接使用主机的网络接口

8.ghcr.io/home-assistant/home-assistant:stable：指定要运行的 Docker 镜像，这里是 Home Assistant 的稳定版

容器创建后的启动

复制代码

#查看容器状态
docker ps -a
#如果停止，重新启动
docker start d9e09ce889f7

3、访问Web界面

在浏览器地址栏输入 http://127.0.0.1:8123 即可访问项目

米家集成是一个由小米官方提供支持的 Home Assistant 的集成组件，它可以让您在 Home Assistant 中使用小米 IoT 智能设备。

4、安装米家集成

Home Assistant 版本要求：

Core ≥ 2024.4.4

Operating System ≥ 13.0

方法 1：使用 git clone 命令从 GitHub 下载

复制代码

cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

推荐使用此方法安装米家集成。当您想要更新至特定版本时，只需要切换至相应的 Tag 。

例如，更新米家集成版本至 v1.0.0

复制代码

cd config/ha_xiaomi_home
git fetch
git checkout v1.0.0
./install.sh /config

5、米家设备控制

重启完成后，再次进入设置 → 设备与服务，"添加集成"，搜索 Xiaomi Home，按照提示登录你的米家账号，完成授权。

完成后，所有米家设备就能在 Home Assistant 中管理。

设置控制面板的卡片类型，创建本地化智能控制中心。