Docker Homeassistant 安装(超详细)
环境配置前提
安装环境：
? version:
Docker（20.10.17）
Homeassistant （core-2021.12.8）
centos7
软件准备：
vmware 15.5PRO(window)
Xshell7(window)
Xftp7(window)
vim(linux)
部分软件参考下载网址：
这两个软件个人使用是有免费版本的
Xftp 下载 - NetSarang Website (xshell.com)
文献参考：
Docker部署homeassitant - 知乎 (zhihu.com)
docker下载太慢怎么办？（更换镜像源）_曾尚仁的博客-CSDN博客_docker 下载太慢
[让docker容器开机启动 - nmap - 博客园 (cnblogs.com)](https://www.cnblogs.com/nmap/p/9384908.html#:~:text=网上有些文章说，要让docker 的容器自动在开机启动，是写脚本，比如在 rc.local 中写。 其实完全没必要这么麻烦，docker,有相关指令，docker run 指令中加入 --restart%3Dalways 就行。)
(2条消息) Docker Homeassistant安装HACS遇到的问题_ 一叶晨风的博客-CSDN博客_docker homeassistant安装hacs
(2条消息) Home Assistant 2021.6 以后版本HACS安装失败 - 解决方法_阿小飞飞飞的博客-CSDN博客_hacs安装
[hacs安装 - rainsc - 博客园 (cnblogs.com)](https://www.cnblogs.com/rainsc/p/16506856.html#:~:text=hacs安装 直接使用docker 的 可视化管理面板portainer或者 使用命令行进入这个docker镜像的容器中%2C然后执行下面的安装命令 wget,-O - https%3A%2F%2Fget.hacs.xyz | bash -)
Release 1.6.0 · hacs/integration (github.com) hacs 下载地址
linux开放指定端口命令 - 伤心木乃伊 - 博客园 (cnblogs.com) 开放linux 端口
linux如何查看ip地址-linux运维-PHP中文网 用来查看IP
Docker run 命令 | 菜鸟教程 (runoob.com) Docker 学习
(2条消息) 安装Home Assistant 历程+遇到的问题_酷酷小鬼kkxg的博客-CSDN博客_homeassistant拒绝访问
(2条消息) Home Assistant插件ESPHome+NodeMCU的使用_COOOYOOO的博客-CSDN博客_homeassistant安装esphome
(2条消息) （二）Mac使用Docker来搭建Home-Assistant之安装HACS_沐羊星的博客-CSDN博客_docker homeassistant安装hacs
拓展文献：
树莓派HomeAssistant系列（四）NodeRed安装配置 - 知乎 (zhihu.com)
Docker安装Home Assistant (Hassio Supervisor) - 郑羊羊咩的窝 (zyyme.com)
centos镜像_centos下载地址_centos安装教程-阿里巴巴开源镜像站 (aliyun.com)
(2条消息) homeassistant 在虚拟机中通过supervised方式安装_王敬明的博客-CSDN博客_homeassistant安装supervisor
(2条消息) HomeAssistant添加HACS商店_一阵风°的博客-CSDN博客_homeassistant安装hacs
(2条消息) 笔记（三）Home Assistant配置（基础组件、HACS）_SameWorld的博客-CSDN博客_homeassistant配置
一：安装Centos 系统
下载centos7系统
这里自己设置对应的内存及处理器数量
需要注意的是homeassistant 本身运行不会占用太多系统，何况是使用docker部署，虚拟硬件配置按需而来
点击回车进行安装
正在安装
等待一下，需要等待他们全部按钮都被激活
记住你的IP地址后面有用，点击完成，后面就不赘述
这里需要注意的是你的存储空间是否充足
安装centos7系统(采用带GUI的服务器)
点击 完成
设置好的你的账号密码，及管理员密码
设置完成后自动安装，不需要弄其他的
因为我们是用虚拟机，（当你里面不是很重要的文件时，我推荐你做一个账号密码备份到window中，防止忘记）
当你设置的密码过于简单时，需要点击两次done
安装时间看个人电脑配置而定，只要在动就没有问题
安装中
安装完成重启
中间省略
如果这里是第一次安装的，需要安装下VMware tools 只要挂载了，运行之后 ，一直按回车就可以了
二：安装Docker
文本教程
- 切换root 用户 ，安装环境
yum install -y yum-utils device-mapper-persistent-data lvm2
- 添加阿里源软件源
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
- 安装Docker 社区版
yum -y install docker-ce
- 启动Docker
systemctl start docker
- 设定开机启动Docker
systemctl enable docker
- 查看Docker 运行状态
systemctl status docker
- 查看Docker 版本信息
docker version
图片教程：
打开终端
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gjlh2K0O-1664183037400)(C:/Users/Administrator/AppData/Local/Temp/WeChat Files/243d03dc9d0b3fe14dfb7cf2ab18309.png)]
获取权限
执行命令 ：
yum install -y yum-utils device-mapper-persistent-data lvm2
添加阿里源
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
安装docker-ce(这里文件有点大，需要耐心等待下)
yum -y install docker-ce
注意: 有下载的地方就不要开科学上网软件
安装完毕
启动docker
systemctl start docker
systemctl enable docker
查看docker 运行状态
systemctl status docker
查看版本
docker version
自此，安装docker 完成
三：设置阿里云镜像加速
创建一个文件夹（安装完docker 就自动创建了，如果没有创建那就手动创建一下）
sudo mkdir /etc/docker
编辑配置文件，如果文件不存在就创建一个，有则打开
sudo vim /etc/docker/daemon.json
注意的是：这里不是ubuntu系统，如果是Ubuntu系统需要安装文本编辑软件
写入下列内容
{ “registry-mirrors”: [ “https://ustc-edu-cn.mirror.aliyuncs.com” ] }
里面的网址是阿里的镜像源网址
重启docker服务
sudo systemctl daemon-reload
sudo systemctl restart docker
至此，设置镜像源完成
参考文献：docker下载太慢怎么办？（更换镜像源）_曾尚仁的博客-CSDN博客_docker 下载太慢
四：安装Portainer 容器管理图形界面
文字教程
- 拉取最近镜像
docker pull portainer/portainer
- 运行容器
docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer
#参数说明：
-d：容器在后台运行；
-p 9000:9000：把容器的9000端口映射到宿主的9000端口，这是访问portainer管理页面需要用的端口
-v /var/run/docker.sock:/var/run/docker.sock ：把宿主机目录挂载到容器中同样的位置
-v portainer_data:/data #把宿主机portainer_data数据卷挂载到容器/data目录
访问：IP+9000端口，就会看到 portainer 管理页面了
图片教程：
安装portainer
拉取镜像
docker pull portainer/portainer
运行容器：
docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer
这里我是先装了portainer 后才设置镜像源的，所有这里的图片流程是颠倒一部分的
浏览器打开网址：
IP+9000 (端口)或者是127.0.0.1:9000
需要注意的是这里不要出现中文符号
密码至少8位
五：部署HASS
文字教程
- 拉取对应的镜像（需要注意的是选择对应的版本）
docker pull homeassistant/home-assistant:latest
? (这里说明一下，这个镜像并不是唯一的)
? 有两种途径可以查看关于HomeAssistant的镜像有那些
- Docker 命令
Docker search homeassistant
- docker hub （Docker Hub Container Image Library | App Containerization）这里需要自己判断是否需要supervisor，以及找到对应的镜像
Docker Hub - Docker 在Docker Hub中找对应的镜像 然后 pull 就可以了
这两种其实是一种，看个人习惯
【网上对应版本的截图】
- 创建容器运行
docker run -d --name hass -v /home/hass/config:/config -p 8123:8123 homeassistant/home-assistant:latest
解释:
-d：表示在后台运行
–name：给容器设置一个名称，用于识别，这里起名叫做hass
-v：配置目录映射（容器内的指定目录直接映射到本地主机的对应目录，比如上面那句命令，意思就是将容器里hass的 config 目录映射到 /home/hass/config 这个目录里面）
-p：映射端口（将容器内的8123端口直接映射到物理机的8123端口，这样服务器的IP地址+端口号即可访问hass页面）
最后就是运行刚才下载的容器镜像了，对于其他的版本了，注意要加上tag,避免自动下载最新版本。
注意：
- 这里的name 后面的字符串不需要 “ ”
- 不能创建同一名称的容器
图文教程：
拉取HomeAssistant 镜像
docker pull homeassistant/home-assistant:latest
这里的文件有点大，大概一两个G
等待pull complete
HomeAssistant 下载完成
运行容器：
docker run -d --name hass -v /home/hass/config:/config -p 8123:8123 homeassistant/home-assistant:latest
这里需要设置好，待机休眠的时间，不然影响下载，失败就要重新安装，可能又会有其他的问题
这里不能打开科学上网软件
Portainer 启动HomeAssistant
查看portainer 是否还在运行，不行就重启（我在安装时，portainer 就因为HomeAssistant 安装完成后，运行出现问题的情况）
或者重启下docker (下面的两个语句可选)
sudo systemctl daemon-reload
sudo systemctl restart docker
在portainer中就可以看见我的镜像正在运行，没有的话就 启动下
如果没有看见对应的镜像 刷新下
docker 和 portainer 都在运行
配置HomeAssistant
在浏览器上输入你的IP:8123 或者是127.0.0.1:8123(这里的符号是英文的)你就会打开一个页面
填写你需要设置的账号密码
中间的过程是这个 （图片丢失了）
全部勾选
点击下一步
这里是没有hacs 需要我们自己安装
点击完成即可
我们通过Docker 安装的这个HomeAssistant 是没有supervisor，大家可以发挥下能力看是否能装上这个supervisor ，记得告诉评论告诉我
以后我们就在portainer对homeassistant进行启动和关闭即可
这里已经基本可以是使用了
可以在集成中添加一些插件了
六：安装HACS
文字教程
这步其实不太重要，因为按照完上述版本的HASS 里面已经是可以安装集成了，一些 像小米 插件已经是可以安装上了，并且也有ESPHome 等
1.方法一：(不可行)
- 安装HACS
docker exec -it hass bash
wget -O - https://get.hacs.xyz | bash -
其实这步有好多人都安装不上，因为服务的问题
为此，我寻找到了一些解决方案，可供参考：
【图片】
vi /etc/hosts
将raw.githubusercontent.com和github.com的IP，添加到hosts中：（这是我寻找来的IP地址，不一定准确）
在host 中写入下面的代码
185.199.108.133 raw.githubusercontent.com
20.205.243.166 github.com
IP/服务器raw.githubusercontent.com的信息 - 站长工具 (chinaz.com) raw.githubusercontent.com
IP/服务器github.com的信息 - 站长工具 (chinaz.com) github.com
详细请参考：
Docker Homeassistant安装HACS遇到的问题_ 一叶晨风的博客-CSDN博客_docker homeassistant安装hacs
这里面还提到了另外一种显示错误的方法，我没有遇到过，遇到过的小伙伴也可以参考尝试下
但结果还是报错
【图】
你们可以挨个测试下，万一成功了呢（这里可以尝试一下科学上网，我在这个地方使用科学上网坚持的比没有用科学上网的时间久 🤭）
2.方法二：（可行）
**手动安装HACS ：**
- 下载HACS 1.6.0 压缩文件(github 下载 ，需要科学上网)
Release 1.6.0 · hacs/integration (github.com) 主页
HACS1.6.0下载地址
【图片】
-
下载完成解压
【图片】
-
连接Xftp
【图片】
-
将HASS 文件夹设置成所有都可访问
? （连接完成，需要在/home/hass/config创建一个custom_components）
-
创建custom_components文件夹
-
将hacs压缩包解压处理的hacs 文件直接复制到创建的custom_components文件下
-
在manifest.json 文件中的最前面行添加（记住最后需要写上 “ ,” )
“version”:“1.6.0”,
-
? 这个是hacs 的版本
-
- 在manifest.json 文件中的最前面行添加（记住最后需要写上 “ ,” )
- 重启HomeAssistant，然后在集成中搜索hacs 即可
- 点击安装写入github 密钥
- 勾选四个选项
- 完成
图片教程：
方法一：（我执行是有问题的）
输入下列命令
docker exec -it hass bash
wget -O - https://get.hacs.xyz | bash -
推荐你们修改时先复制一个副本
vi /etc/hosts
写入：
185.199.108.133 raw.githubusercontent.com
20.205.243.166 github.com
保存退出
重新运行下Docker
结果：
这是运行的结果，一个正常连接 一个科学上网（后）
方法二：（可以安装HACS）
需要先下载Xftp
连接虚拟机
找到hass 文件夹
在虚拟机中在/home 文件夹中 打开命令行, 输入：
chmod 777 文件或文件夹 -R
修改权限为所有者
修改结果
在hass/config 文件夹下创建一个名为：custom_components 的文件夹
打开进入，将解压好的hacs文件上传到对应的文件夹下面
结果：
打开hacs 文件夹找到 manifest.json 文件，右键打开记事本编辑
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-88Qr53Ao-1664183037414)(https://gitee.com/kysfh/csdnimage1/raw/master/DockerHomeAssistantImage/%E6%89%93%E5%BC%80hacs%E4%BF%AE%E6%94%B9%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6.jpg)]
写入：
“version”:“1.6.0”,
如图：
保存
获取Github token
打开GitHub (这里需要科学上网，以及创建一个GitHub账号)
打开个人主页 setting-> Developer settings
输入你的密码
滑动到最下面
里面一个也没有勾选
将这个accesstokens 保存下来
然后重启home assistant即可
在集成中添加 hacs 即可
这里等待的时间有点久
将你的token 填写上去
重启HomeAssistant 即可看见下面的配置
至此，教程结束
虚拟机开放端口，允许外部访问
/sbin/iptables -I INPUT -p tcp --dport 9000 -j ACCEPT
访问IP+9000
这样子就可以在本地计算机上访问portainer
一定要记得关闭加速器
详细请参考：
? [Home Assistant 2021.6 以后版本HACS安装失败 - 解决方法_阿小飞飞飞的博客-CSDN博客_hacs安装](https://blog.csdn.net/zhaojy_/article/details/120107322#:~:text=下载完后解压到Home,Assistant的custom_components文件夹 此时重启HomeAssistant，会发现无法在添加集成中找到HACS，这是因为2021.6版本以后的HomeAssistant要求在安装包的manifest.json文件中注明版本号码。)
? linux开放指定端口命令 - 伤心木乃伊 - 博客园 (cnblogs.com)
作者有话
安装其他的镜像
可以参考下面的配置
注意：Docker中的镜像是否支持supervisor功能，有些镜像是没有supervisor的
参考这个文章
(2条消息) homeassistant 在虚拟机中通过supervised方式安装_王敬明的博客-CSDN博客_homeassistant安装supervisor
cle/details/120107322#:~:text=下载完后解压到Home,Assistant的custom_components文件夹 此时重启HomeAssistant，会发现无法在添加集成中找到HACS，这是因为2021.6版本以后的HomeAssistant要求在安装包的manifest.json文件中注明版本号码。)
? linux开放指定端口命令 - 伤心木乃伊 - 博客园 (cnblogs.com)
作者有话
安装其他的镜像
可以参考下面的配置
[外链图片转存中…(img-CE71SwGs-1664183037419)]
注意：Docker中的镜像是否支持supervisor功能，有些镜像是没有supervisor的
参考这个文章
(2条消息) homeassistant 在虚拟机中通过supervised方式安装_王敬明的博客-CSDN博客_homeassistant安装supervisor