Win11在docker环境安装homeassistant，安装HACS并集成小米官方组件

目标是在docker中安装homeassistant，并且将本地目录做为工作目录，方便管理。然后在ha中安装HACS商店，并集成小米官方组件。

拉取ha镜像

首先在docker中配置好加速条件（docker引擎使用阿里云，并挂梯子），然后在powershell（是否是管理员不重要）中执行docker pull homeassistant/home-assistant拉取镜像。

拉取完成可在docker镜像中看到。

创建工作目录并运行ha

下一步就是在powershell中运行homeassistant，不过在这之前要手动创建好ha的本地工作目录，我习惯在Dockers\docker_apps中存放，所以我的目录为Dockers\docker_apps\ha\config。然后执行指令运行ha：

docker run -d --name=ha --restart=unless-stopped -v E:\Dockers\docker_apps\ha\config:/config -e TZ=Asia/Shanghai -p 8123:8123 homeassistant/home-assistant

命令说明

docker run: 这是用于创建并启动一个容器的 Docker 命令。
-d: 表示以“分离”（detached）模式运行容器，即在后台运行容器而不是前台。
–name=ha: 给这个容器指定一个名称 ha，方便以后引用此容器（例如停止、删除或查看日志）。
–restart=unless-stopped: 设置容器的重启策略为 unless-stopped，这意味着除非容器被手动停止，否则 Docker 将自动重启该容器，即使 Docker 守护进程重启后也是如此。
-v E:\Dockers\docker_apps\ha\config:/config: 使用 -v标志来挂载卷。这里将主机上的 E:\Dockers\docker_apps\ha\config:/config 目录挂载到容器内的 /config 目录。这允许你在主机和容器之间共享数据，并且可以在主机上持久化配置文件等重要数据。
-e TZ=Asia/Shanghai: 使用 -e标志设置环境变量。这里设置了时区环境变量 TZ 为 Asia/Shanghai，确保容器内部使用的是中国上海的时间。
-p 8123:8123: 使用 -p标志来发布容器的端口，使外部可以访问。这里的格式是 hostPort:containerPort，即将主机的 8123 端口映射到容器的 8123 端口。Home Assistant 默认使用 8123 端口提供服务。如果和主机别的程序冲突，可以改成别，范围1024~25535。
homeassistant/home-assistant: 这是要运行的镜像名称，然后基于它创建一个容器。

创建账户

在执行完上面的docker run命令后，在docker面板中看到ha在运行，就说明ha安装好了，去浏览器访问localhost:8123可打开ha的欢迎页面，点击创建开始创建用户。（如果改过端口，就使用修改后的端口）

然后在点击创建好账户后，可能会看见这样喜闻乐见的画面，提示“嗯... 无法访问此页面http://localhost:8123/?auth_callback...”，不慌，已经创建好了，访问localhost:8123或者localhost:8123/auth/即可跳转到登陆界面。

输入刚才的用户名和密码进行登录，这里一般不会出问题。然后就是安装HACS商店。

安装HASC商店

HASC商店不用多介绍了吧。访问https://github.com/hacs/integration/releases下载最新版HACS商店，注意是下载ZIP那个文件。

记得之前创建的ha本地工作目录吗，继续在ha\config目录下依次创建两个文件夹（custom_components和hacs），所以会是这样Dockers\docker_apps\ha\config\custom_components\hacs，其中custom_components为组件目录，以后还会在此目录安装更多组件；hacs则是特定组件的名称，这里是给HACS用的。

把刚刚下载的hacs.zip放在custom_components目录下，和hacs文件夹同层，右键hacs.zip选择“解压到hacs\文件夹”。解压完成后，压缩包里的所有内容都应该在同层文件夹hacs中，像下面这样。那个压缩包可以丢到hacs文件夹里。

然后在docker中重启ha，接着去设置/设备与服务。

点右下角添加集成，搜索HACS，选择带网络和黄色盒子的那个，然后勾上所有的I know，点提交。

然后会弹出和Github绑定的提示，不要关这个页面，新标签打开认证链接，输入提示页面提供的code（下面那段超级小的字）。

绑定后返回ha页面，给HACS选个房间。这样就完成了HACS商店的安装（重新进入ha，会在左侧看到HACS图标）。

集成小米官方组件

玩ha智能家居怎么能少了小米呢（就算是苹果用户也逃不过小米），下面准备安装小米官方公布的组件，就在Github上（3年前在树莓派HACS商店装的小米组件是第三方的，因为目前2025年了，小米官方组件仍然没有上架HACS）。

关于安装小米组件，有4个方法，方法1是终端git源码，然后install，可我的电脑是win，所以pass；方法2是去HACS，添加小米仓库，然后下载，可能可以；方法3是将Github源码文件夹放到本地对应的custom_components文件夹；方法4是和安装HACS类似，下载release的ZIP安装。

这里主要介绍方法4。