admin 管理员组

文章数量: 1184232

自行查阅的资料有些分散,这里进行一个汇总,供自己后续翻看,也分享给需要的同学。
核心是使用docker容器安装HomeAssistant。试过使用VMWare虚拟机安装,但是各种问题没有走通,后续需要可能会再进行尝试。
默认做这件事的人不是纯小白,这里只列举大概框架。具体内容查看引用大牛的文章。
文章中的一些步骤会去到github这个网址下载,但是国内访问较慢,多访问几次应该可以访问通。但是最好先搞定github访问慢的问题,推荐两个搜索关键字:【SwitchHosts安装使用】、【FastGithub安装使用】,这两个主要是用于访问github加速

本文所提到需要下载的软件已上传至网盘,链接永久有效,按需下载
链接:https://pan.baidu/s/14ErxVVZkTbcBvXPYnMBLoQ
提取码:tr6w

目录

  • 一、安装Docker Desktop(docker 桌面版)
    • 1.下载
    • 2.安装
    • 3.汉化
  • 二、Docker安装HomeAssistant
    • 1.配置镜像加速
    • 2.docker命令拉取HomeAssistant镜像
    • 3. 创建并运行HomeAssistant容器
  • 三、安装HACS(HomeAssistant的商店)
    • 1.下载hacs
    • 2.安装hacs插件
    • 3.启用hacs插件

一、安装Docker Desktop(docker 桌面版)

1.下载

Docker Desktop下载官方地址:https://www.docker
参考大牛文章:Docker Desktop 安装使用教程

2.安装

安装完成后,可能会存在提示,需安装或更新WSL到最新版本,但是通过wsl.exe --update更新很慢。
那么访问:https://github/microsoft/WSL/releases
找到Latest版本,选择相应.msi软件包下载,下载时可以右键复制链接地址,打开迅雷使用迅雷下载。

下载完成后,打开下载好的.msi进行安装,安装完成后重启电脑。
再次打开DockerDesktop即可。
参考大牛文章:Windows Subsystem for Linux——解决WSL更新速度慢的方案

3.汉化

DockerDesktop默认不支持中文,可以进行汉化。
访问github地址:https://github/asxez/DockerDesktop-CN
下载DockerDesktop相应版本的汉化包
最新版的DockerDesktop版本可在右下角查看,或者设置中查看。

参考大牛文章:Windows Docker Desktop设置中文

二、Docker安装HomeAssistant

1.配置镜像加速

理论上只要Docker Desktop安装成功,那么可以打开命令窗口,使用命令的方式下载HomeAssistant镜像。但是docker的仓库源国内访问也是很慢。可进行如下配置。

打开Docker Desktop,找到Docker引擎,将此配置内容粘贴进去,替换掉原有的配置。目的是配置docker的镜像源仓库。

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "dns": [
    "114.114.114.114",
    "8.8.8.8"
  ],
  "experimental": false,
  "registry-mirrors": [
    "https://xxx.xxx.xxx.xxx",
    "https://registry.docker-cn",
    "http://hub-mirror.c.163",
    "https://docker.mirrors.ustc.edu",
    "https://noohub.ru",
    "https://huecker.io",
    "https://dockerhub.timeweb.cloud",
    "https://hub.rat.dev/",
    "https://docker.1panel.live/",
    "https://docker.nju.edu",
    "https://dockerproxy"
  ]
}

配置内容,其中第一个阿里云镜像地址自行获取,进行替换,访问:https://cr.console.aliyun/cn-hangzhou/instances/mirrors

替换完成点击Apply&restart,重启DockerDesktop。此时docker仓库源镜像配置完成。

2.docker命令拉取HomeAssistant镜像

使用管理员打开命令窗口,执行命令

复制命令,回车,等待拉取完成。

docker pull homeassistant/home-assistant


HomeAssistant镜像大约1.8G,过程网络不好可能会慢。
拉取成功后,在Docker Desktop的镜像列表中会看到。

3. 创建并运行HomeAssistant容器

还是打开命令窗口,执行命令:(其中【D:\ha\config】文件路径,电脑上没有则手动创建。)

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

复制命令,回车,等待执行完成

此时回到DockerDesktop的容器页面,可以看到HomeAssistant已经启动成功。
后续HomeAssistant的停止、启动、重启,都可以在界面中操作。

附上刚刚的命令解释

docker run: 这是用于创建并启动一个容器的 Docker 命令。

-d: 表示以“分离”(detached)模式运行容器,即在后台运行容器而不是前台。

–name=ha: 给这个容器指定一个名称 ha,方便以后引用此容器(例如停止、删除或查看日志)。

–restart=unless-stopped: 设置容器的重启策略为 unless-stopped,这意味着除非容器被手动停止,否则 Docker 将自动重启该容器,即使 Docker 守护进程重启后也是如此。

-v D:\ha\config:/config: 使用 -v标志来挂载卷。这里将主机上的 D:\ha\config 目录挂载到容器内的 /config 目录。这允许你在主机和容器之间共享数据,并且可以在主机上持久化配置文件等重要数据。

-e TZ=Asia/Shanghai: 使用 -e标志设置环境变量。这里设置了时区环境变量 TZ 为 Asia/Shanghai,确保容器内部使用的是中国上海的时间。

-p 8123:8123: 使用 -p标志来发布容器的端口,使外部可以访问。这里的格式是 hostPort:containerPort,即将主机的 8123 端口映射到容器的 8123 端口。Home Assistant 默认使用 8123 端口提供服务。

homeassistant/home-assistant: 这是要运行的镜像名称,然后基于它创建一个容器。

至此HomeAssistant已经安装完成,打开浏览器访问:http://127.0.0.1:8123
跳转至HomeAssistant的首页。

剩下的操作就是创建账号,不再赘述,自行查阅,搜索关键字【HomeAssistant使用教程】

三、安装HACS(HomeAssistant的商店)

通过上方步骤已经安装完成HomeAssistant,可以进行使用。但是现在HomeAssistant中是缺少商店插件的。
接下来就是安装商店插件HACS‌(Home Assistant Community Store)是一个为Home Assistant用户提供的开源插件商店,它允许用户轻松地发现、安装和管理各种自定义组件、集成和主题‌。‌

1.下载hacs

github地址:https://github/hacs/integration/releases

找到Latest版本下载。

2.安装hacs插件

下载完成后,找到刚刚 【二、】-【3. 创建并运行HomeAssistant容器】步骤,在D盘创建的目录:D:\ha\config,打开此目录,再创建文件夹【custom_components】,进入【custom_components】再创建文件夹【hacs】。
完整路径:D:\ha\config\custom_components\hacs

进入【hacs】目录,将hacs.zip复制到此目录下并解压。

解压之后,hacs.zip可删除也可保留都行。

3.启用hacs插件

回到DockerDesktop,重启容器。

再访问HomeAssistant:http://127.0.0.1:8123

这里演示从最初进入页面创建账号及配置hacs插件。
进入HomeAssistant

点击【创建我的智能家庭】,输入信息,点击【创建账户】。

因为国内原因,定位肯定不准,需要自己手动拖拽 图标 选择地址。
这可以选择自己的地址,也可不选。后续还可以修改。
继续【下一步】

继续【下一步】

继续【下一步】

完成

登录

【设置】-【设备与服务】

点击右下角【添加集成】,搜索框中搜索【ha】,选择HACS,点击。

转圈加载…

全选,提交。

等待加载完成

出现此步骤,恭喜你被墙了,自行解决(梯子),你懂得。

正常应该是这样,左侧列表出现HACS菜单,然后点击进入,就可以在商店中下载各种插件,包括小米的ha集成!

其实最好的方式还是在linux环境,进行部署。生态教程都比较多。
使用windows环境纯纯折腾人
尤其是国内的网络环境倒腾太费劲了,哎~
肯定会有安装hacs插件卡住的同学。等我后续有空,我把已经安装好hacs插件商店的HomeAssistant镜像打包一下,上传到网盘,分享给同学们。

通篇结束,别忘点赞!

本文标签: 环境 Windows HomeAssistant