# 基于Docker的方式安装HomeAssistant

HomeAssistant基于Docker容器技术，可以快速部署和管理.并可与其它主机或服务器共用，有效节省资源。
但Docker容器技术对系统资源有一定要求，且对网络环境有依赖。并且在某些情况下，在全断网完全全离线的情况下部署。
因此，才有了本文档。

### 安装准备
为了能在任意主机上用Docker快速安装HomeAssistant，建议提前准备好Docker环境，但Docker官网被封锁，导致Docker的安装，及镜像的拉取都极为困难。因此，可以使用如下方式安装Docker及Docker Compose：

- [安装Docker基础环境-支持离线安装](如何离线安装Docker(ubunt24.04).md)


### 安装方式
HKO

- [在线安装](如何在线Docker一键安装装HomeAssistant.md)
- [离线安装](如何离线Docker一键安装HomeAssistant.md)


### 服务访问地址：
```
  Home Assistant: http://$(主机IP):8123
  Node-RED:       http://$(主机IP):1880
  Mosquitto MQTT: http://$(主机IP):1883
  PostgreSQL:     http://$(主机IP):5432
  Samba:         //$(主机IP)/HAConfig
  portainer:     http://$(主机IP):9000
``` 

### 使用说明
因为使用了Docker容器技术，所以HomeAssistant的加载项是没有的，官方对Docker不提供加载项功能，也没办安装下。
所以作为替代，我们把加载项中最重要要的几个插件都以docker的方式单独提供，并能与HomeAssistant相互配合工作，它们是
Node-RED, Mosquitto MQTT, PostgreSQL, Samba等。
本文提供的HomeAssistant是自已重新打包的docker集成了HACS，及一些新安常用的主题UI风格，和小米HOME集成等。安装完成后，无需再安装此类插件。
HomeAssistant已配置默认使用容器提供的pgsql数据库来存储数据，并设定了5天可能自动清除数据，容器内的日志，保留置三天。
因为使使用了Docker容器技术，所以HomeAssistant的配置文件是存放在主机的`/dt_opt/ha/config`目录下，可以通过Samba共享访问此目录，或直接在主机上访问此目录来管理配置文件。在HomeAssistant中，不在有FileEditor插件了,因此只能使用共享文件夹来管理配置文件。

#### 登录信息

```
  Home Assistant: http://$(主机IP):8123  用户名:admin 密码:Dtuse1r
  Node-RED:       http://$(主机IP):1880  无用户名
  Mosquitto MQTT: http://$(主机IP):1883  用户名:dtuser 密码:Dtuse1r
  PostgreSQL:     http://$(主机IP):5432  数据库名:dtha 用户名:dtuser 密码:Dtuse1r
  Samba:         //$(主机IP)/HAConfig    无需要密码即可访问
  portainer:     http://$(主机IP):9000   用户名:admin 密码:Dtuse1r_abcd
```

##### 说明
- 关于Samba(共享目录访问配置目录)
    Windows 端访问时，输入正确的用户名和密码。因本服务配置了允许guest访问，所以可直接访问,而无须用户名与密码。但是对于windows10/11,有可能会反复要求输入密码而无法访问，是因为安全策略问题，可在 Windows 本地组策略中调整：
    ```
    打开“本地组策略编辑器”（gpedit.msc），计算机配置 → 管理模板 → 网络 → Lanman工作站，启用“启用不安全的来宾登录”。启用后，即可正常访问此共享的配置目录。
    ```

    如下图是以共享的方式访问配置目录：
    
    ![](https://qncdn.tairongkj.com/docs/images/20250901180539.png)

    ***共享目录访问失败的解决办法***
    
    [windows不能访问HA的共享配置目录的解决办法](windows不能访问HA的共享配置目录的解决办法.md)

- 关于portainer(图型化Docker管理工具)
    Portainer 是一个轻量级的管理UI，可以让你更容易地管理Docker容器。通过Portainer，你可以轻松地创建、管理和监控Docker容器，查看容器日志，管理Docker镜像等。Portainer的Web界面友好，适合Docker新手和需要快速管理Docker环境的用户。
    如下图所示：
    ![](https://qncdn.tairongkj.com/docs/images/20250901180812.png)