安装方式

OS 系统安装

直接安装成系统，系统有完整HomeAssistant功能
Container 容器安装

通过虚拟容器安装，功能缺失：Supervisor，Add-ons，Managed Restore，Managed OS。推荐Docker安装，省时省力，本文采用该安装方式。
Core 核心安装

安装核心，没装过，看文档，主要是安装Python库，然后创建用户权限啥的，反正很多功能不支持：Uses container，Supervisor，Add-ons，Managed Restore，Managed OS
Supervised 完整安装

直接安装到设备，不支持Managed OS，除OS安装外，功能最全的，但是官方文档表明只支持Debian系统，Debian衍生开发系统不支持（Ubuntu,Armbian等），网上能找到非Debian系统安装解决问题的文章，但是处于稳定考虑，我不推荐

Docker安装服务

请先确认您安装了docker，没有安装先安装，本文不介绍docker安装，你也可以直接sudo apt install docker.io 注意：【】标记内容需要替换 注意：本文全程ROOT执行，避免麻烦建议先执行 su root

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=【时区】 \
  -v 【主机路径】:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

【时区】：见名思意，我填的 Asia/Shanghai
【主机路径】：容器中文件映射到主机的位置，很重要，配置时需要，比如我的是/data/docker/homeassistant
修改服务端口
我这里以我的主机路径为例，修改时需要将/data/docker/homeassistant替换为自己的路径
```
cd /data/docker/homeassistant
vim configuration.yaml
```
需要在configuration.yaml文件末尾添加以下内容，比如我设置的是8120
```
http:
server_port: 8102
```
重启homeassisant docker服务
```
docker restart homeassistant
```
接着就可以通过浏览器访问了,例如我的 http://192.168.3.81:8102
可能涉及到端口开放问题，我的端口属于我默认开放的端口段，所以没遇到问题，遇到问题可以尝试修改,8102端口记得改成自己的
```
# 开放端口
iptables -I INPUT -p tcp --dport 8102 -j ACCEPT
# 保存修改
service iptables save
# 查看结果
iptables -L -n
```
打开服务网页后，Homeassistant的引导配置我就不介绍了
安装HACS商店

国内安装因为github受到DNS污染等问题，安装很慢，所以需要本文介绍方法与官网的有些不同
1.进入容器的bash终端
```
docker exec -it homeassistant bash
```
2.通过ghproxy下载安装脚本，但是不执行（官网直接执行了,且通过域名转发了下载文件，我这里直接提取了转发的文件连接）
```
wget -O - https://ghproxy.com/https://raw.githubusercontent.com/hacs/get/main/get > hacs.sh
```

3.修改脚本，使用ghproxy下载

sed 's/https:\/\/github.com\//https:\/\/ghproxy.com\/https:\/\/github.com\//' ./hacs.sh

4.可以使用脚本安装了
```
bash ./hacs.sh
exit #退出docker终端
```
安装完成后重庆Homeassistant
5.配置进入Homeassistant的Web控制页面配置 > 设备与服务 > 添加集成 > 搜索HACS添加 HACS配置按着引导走就行了,不清楚的看官网说明

配置好后，会存在下载插件慢，甚至下载不动的问题，通过以下方案解决修改hacs的源码文件

vim /data/docker/homeassistant/custom_components/hacs/base.py

找到 async_download_file 方法，如下方 解决下载慢的问题中文注释处添加注释中的内容

......
async def async_download_file(self, url: str, *, headers: dict | None = None) -> bytes | None:
"""Download files, and return the content."""
if url is None:
    return None

"""解决下载慢的问题 START"""
if "https://raw.githubusercontent.com" in url:
    url="https://ghproxy.com/"+url
"""解决下载慢的问题 END"""

if "tags/" in url:
    url = url.replace("tags/", "")
self.log.debug("Downloading %s", url)
......

好了，到这里homeassistan基本的配置就OK了

个人安装的插件

华为路由器插件：Huawei Router
小米IOT插件：Xiaomi Miot Auto 我还有很多天猫精灵设备，找了半天教程，就是没有找到天猫设备的接入方式，烦烦烦！
参考信息来源
参考信息 HomeAssistant官网 HACS Store官网 Github DrJohnT的配置 bilibili 洛川川川川川川的视频

目录CONTENT

HomeAssistant第一弹：基本环境搭建

安装方式

Docker安装服务

修改服务端口

安装HACS商店

个人安装的插件

参考信息来源

评论区