vault backup: 2025-12-11 15:42:44

trphoenix

2025-12-11 a7eb97fc18f24c13b3c79350b1941f429f41150b

 Help/docs/Usages/initConfig/initConfig.md

@@ -575,7 +575,39 @@



##### 利用 Docker 安装 PostgreSQL
##### 安装go2rtc插件

go2rtc插件是为了对视流转发用的专用插件,如果想把监控视频流接入,则可以使用这个插件,安装方法是,加载项中,搜索go2rtc,

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418150624562.png)

点击安装

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250418150851886.png)

安装完成后开启自动恢复,自动更新

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418151926288.png)

其设置中基本没什么要改的.

##### 安装VLC可以播放视频等功能,需要的话可以安装

在加载商店中搜索vlc

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418153825278.png)

点击安装

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250418153923072.png)

安装成功如下所示

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418154157793.png)

配置中基本没要要配置的东西

#### 利用 Docker 安装 PostgreSQL

虽然 Home Assistant OS 本身不允许直接访问系统底层，但它内置了 Docker 支持，因此可以直接运行 PostgreSQL 的 Docker 容器。

@@ -594,16 +626,577 @@
   - 在 SSH 或 Web Terminal 中运行以下命令：

     ```
     BASHdocker run -d \
     docker run -d \
       --name=postgresql \
       -e POSTGRES_USER=homeassistant \
       -e POSTGRES_PASSWORD=yourpassword \
       -e POSTGRES_DB=homeassistant \
       -v /mnt/data/supervisor/postgresql:/var/lib/postgresql/data \
       -e POSTGRES_USER=dtuser \
       -e POSTGRES_PASSWORD= **pwd** \
       -e POSTGRES_DB=dtha \
       -v /db/pgsqldata:/var/lib/postgresql/data \
       -p 5432:5432 \
       postgres
     ```

     - 替换 `yourpassword` 为您想要设置的数据库密码。
     - 数据库名称为 `homeassistant`，用户名为 `homeassistant`。
     - 替换 `**pwd**` 为您想要设置的数据库密码,些密码,需要管理员咨询
     - 数据库名称为 `dtha`，用户名为 `dtuser`。
     - 数据将存储在 `/mnt/data/supervisor/postgresql`，确保数据在重启后不会丢失。

登录ssh,并查看已安装的docker镜像如下

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418154852933.png)

先创建pgsql存储卷需要的目录,这个我们统一定为如下目录,并给777权限
```
/db/pgsqldata
```

即在根目录下,创建db目录,然后在db目录中创建pgsqldata,并给足权限

```
/ # cd homeassistant
homeassistant # ls
automations.yaml          configuration.yaml        home-assistant.log        home-assistant.log.fault  home-assistant_v2.db-shm  scenes.yaml               secrets.yaml
blueprints                deps                      home-assistant.log.1      home-assistant_v2.db      home-assistant_v2.db-wal  scripts.yaml              tts
homeassistant # mkdir db
homeassistant # sudo chmod -R 7777 ./db
homeassistant # cd db
db # ls
db # pwd
/homeassistant/db
db # sudo mkdir pgsqldata
db # sudo chmod -R 7777 ./pgsqldata
db # ls
pgsqldata
db # cd pgsqldata
pgsqldata # ls -l ./
total 0
pgsqldata # cd ..
db # ls -l ./
total 4
drwsrwsrwt    2 root     root          4096 Apr 18 16:30 pgsqldata
```

接下来,拉取镜pgsql的镜像,并指向/mnt/data/pgsqldata,此处要注意不是所有的目录都有写入权限,homeAssitant中大部份目录都没有写入权限,要注意找有写入权限的目录

```
data # docker run -d   \
--name=postgresql   \
-e POSTGRES_USER=dtuser   \
-e POSTGRES_PASSWORD=Dtuse1r   \
-e POSTGRES_DB=dtha   \
-v /mnt/data/pgsqldata:/var/lib/postgresql/data   \
-p 5432:5432   \
--restart unless-stopped   postgres
# 执行完成后,返回:
9a4721cccb0d5c63671da5cba4a6b6c13721f48ac664de03312cddaa216a2e56

```

系统会自动拉取镜像,并启动,此过程务必保证秒学上网的畅通

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418160447867.png)

如下图,所示,

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418160956787.png)

说明目录没有权限,

```
chown -R root:root mnt/data/pgsqldata
chmod -R 7777 /mnt/data/pgsqldata
```

给够目录权限后,再次运行,安装指令

```
data # docker run -d   \
--name=postgresql   \
-e POSTGRES_USER=dtuser   \
-e POSTGRES_PASSWORD=Dtuse1r   \
-e POSTGRES_DB=dtha   \
-v /mnt/data/pgsqldata:/var/lib/postgresql/data   \
-p 5432:5432   \
--restart unless-stopped   postgres
# 执行完成后,返回:
docker: Error response from daemon: Conflict. The container name "/postgresql" is already in use by container "f5b838e28f30ff3bde9f90276b8aa4924b4f1ecec2cdbd4e38dfe27e2c988edb". You have to remove (or rename) that container to be able to reuse that name.
See 'docker run --help
```

上述说明pgswl的容器已经存在,需要删除

```
docker stop postgresql
docker rm postgresql
```

然后,再次执行,即可成功

```
data # docker run -d   \
--name=postgresql   \
-e POSTGRES_USER=dtuser   \
-e POSTGRES_PASSWORD=Dtuse1r   \
-e POSTGRES_DB=dtha   \
-v /mnt/data/pgsqldata:/var/lib/postgresql/data   \
-p 5432:5432   \
--restart unless-stopped   postgres
# 执行完成后,返回:
9a4721cccb0d5c63671da5cba4a6b6c13721f48ac664de03312cddaa216a2e56
```

用ps -a 查询一下,如下图所示,说明docker 启动成功,

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418164459153.png)

为了验证重新启动后,pgsql容器是否启动,可以重启后,再次查看一下,此容器是否跟随系统启动成功.

接下来,我们可以在局域网中找台机器来做一下数据库连接测试

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418165956219.png)

如上图,说明pgsql已经安装成功了,并能正常访问.

###### 更改homeAssistant默认的数据库为pgSql

HomeAssistant默认的数据库为sqlite,我们需要把其换成我们新安装的pgsql,

通过我们安装的插件File editor 打开配置文件 /homeassistant/configruration.yaml

增加recorder中的配置如下

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418174329014.png)

然后,保存退出,重启,看看ha有滑的给出错误提示,也可以通过,连接工具来查看,ha有没有在数据库中建表,写入数据

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418174634684.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418174713239.png)

如上图,说明数据已功功折写入PGSQL,此时，我们可以把系统默认的数据库删除了

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418175114702.png)

这个文件是homeAssistant默认的sqlite数据库文件，可以删除了，点右则的三个点，在弹出的菜单中，点delete

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418175225430.png)

点击yes确认

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418175508507.png)

然后重启,再次查看,是否重新生成此文件, 如果没有重新生成此文件 ,说明,系统已经在用pgsql了

####　安装HACS

###### hacs简介

HACS，全称 Home Assistant Community Store（Home Assistant 社区商店），是一个用于 Home Assistant 的第三方扩展插件管理器。它为用户提供了一个方便的方式来安装和管理社区开发的自定义集成、插件、主题和其他扩展组件。

这个插件集中了许多大屏用的主题与插件，属于必装插件．

######　安装hacs　

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418181153341.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418181342200.png)

进入ssh登 录后,输入如下指令

```
wget -O - https://get.hacs.xyz | bash -
```

回车后,系统会自动下载HACS，并放到指定的目录，且提示重启，我们按要求重启，即可。

###### 启用HACS

安装完成后，您需要在 Home Assistant 的界面中启用 HACS：

1. 打开 Home Assistant UI。

2. 点击 **设置** > **设备与服务** > **集成**。

3. 点击右下角 **添加集成**。

   ![](https://dhcdn.leon056.com/bpfStudy/docs/20250418182141542.png)

4. 搜索并选择 **HACS**，然后按照屏幕上的提示完成设置。
   ![](https://dhcdn.leon056.com/bpfStudy/docs/20250418182217781.png)

点击后,在弹出的窗口中,全打勾,点提交
![](https://dhcdn.leon056.com/bpfStudy/docs/20250418182302438.png)

引时,弹出新的窗口,验证github授权

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250418182504439.png)

点击这个github链接,并记住下方的授权码后面会用到

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418182735517.png)

在弹出的页面中,输入,记住的授权码,点Continue

提示具体的授权对像为hacs,点击Autuorize hacs

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418182839101.png)

授权成功

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418182924523.png)

返回hacs后,提示成功,并显示已发现如下设备,hacs,选择区域,可以自定义个区域,然后点完成

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418183032110.png)

看到如下界面hacs就安装好了

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418183101328.png)

点击配置,启用App Daemon apps discovery & tgracking.

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418183240218.png)

以上配置 完成后,重新启动HA，则可以在左侧栏中找到HACS菜单了

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418183847192.png)

#### 更改HomeAssistant左上角LOGO标题

homeAssistant 左上角默认的标题为 Home Assistant 我们希望改成自已的标识如:岱特智能

###### 下载第三方插件hass-favicon的Releases到本地目录

[点击链接]([thomasloven/hass-favicon: 🔹 Change the favicon of your Home Assistant instance](https://github.com/thomasloven/hass-favicon)),到其github的官方页面

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418184710407.png)

下载其源码

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418184735514.png)

###### 解压下载的源码

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418184843193.png)

###### 将插件复制到ha上

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418184913549.png)

打开源码目录,进入custom_commponents目录,把favicon目录整体复制

然后,进入ha的config-custom_compoents目录粘贴,复制到的favicon

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418185131376.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418185659978.png)



然后创建目录

```
\\ha-o[\config\www\favicons
```

并把胜透的logo文件st-logo.,png放到目录中

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418185756212.png)

然后在配置文件中增加如下内容

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418190110615.png)

然后,重启HomeAssistant即可

![](https://dhcdn.leon056.com/bpfStudy/docs/20250418190515179.png)

重启后,左上脚的LOGO，已变为岱特智能.

#### 安装米家集成插件

米家集成是一个由小米官方提供支持的 Home Assistant 的集成组件，它可以让您在 Home Assistant 中使用小米 IoT 智能设备。

这个插件,可以直接把所有小米的各种传感器集成到HomeAssistant中,所以这个是必装插件.

其官方仓库地址为:[ Xiaomi Home Integration for Home Assistant](https://github.com/XiaoMi/ha_xiaomi_home)

```
https://github.com/XiaoMi/ha_xiaomi_home
```

其安装方法有三种,我们为了方便选择第一种,其它两种方法,可以自行尝试.官方描述的方装主式如下:

```
cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config
```

其也提供[中文的安装说明]([ha_xiaomi_home/doc/README_zh.md at main · XiaoMi/ha_xiaomi_home](https://github.com/XiaoMi/ha_xiaomi_home/blob/main/doc/README_zh.md))

###### 安装

首先,登录SSH.然后进入config目录

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419091154969.png)

先拉取代码

```
config # git clone https://github.com/XiaoMi/ha_xiaomi_home.git
Cloning into 'ha_xiaomi_home'...
remote: Enumerating objects: 1322, done.
remote: Counting objects: 100% (761/761), done.
remote: Compressing objects: 100% (342/342), done.
remote: Total 1322 (delta 628), reused 419 (delta 419), pack-reused 561 (from 2)
Receiving objects: 100% (1322/1322), 847.87 KiB | 1.64 MiB/s, done.
Resolving deltas: 100% (817/817), done.
```

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419091433438.png)

然后,再切换到ha_xiaomi_home目录

```
cd ha_xiaomi_home
```

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419091407697.png)

然后执行安装指令

```
./install.sh /config

# Xiaomi Home installation is completed. Please restart Home Assistant.
```

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419091913176.png)

安装完成,提示需要重启.

###### 配置

在重新启动后,在设置-设备与服务-添加集成中,搜索“`Xiaomi Home`” 

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419092851229.png)

点击,会提示风险提示

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419092928630.png)

勾选,我知悉,点击下一步,会进入基础配置页面,如下图

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419093447515.png)

勾选集成网络配置,同蛙,注意一下,认证跳转地址,此处显款为http://homeassistant.lcaol:8123,这个地址,估计不可能通过,只因为我们是在局域网其它机器操作这一步的,实际上我们的地址,应是地址栏中折实际地址,如上图,我们的认证地址是:http://192.168.3.2:8123, 在下一步跳转转小米后,打开的网址时,不出意外的话估计是打不开的,需要把那个地址的前半段,换成这个实际地址.

点击下一步,

此处为检测网络,网络检测通过时,才能进行下一步

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094057861.png)

当弹出如下界面时,说明网络检测通过了,

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094122194.png)

点击,"请点此处进行登录",

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094248419.png)

此时,跳转到小米折认证网页,此时输入正确米家帐号与密码,点登录

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094348660.png)

弹出 友情提示,点击,同意并继续

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094434242.png)

小米的安全验证,点下一步,

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094514847.png)

点击 发送验证码 

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094551241.png)

输入验证码后,点确定

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419094650763.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250419094809037.png)

跳转到了认证窗口,但是却是无方访问此页面,说明认证地址,错了,我们需要把它换成我们正确的HA地址：http://192.168.3.2:8123,如下图所示

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250419095023617.png)

手工将正确的地址替换地址头部后,回车,打开这个地址,类似如下格式:

```
http://192.168.3.2:8123/api/webhook/3062281226000218850?code=C3_B7440E147BCCA71A76831877D510611F&state=d90a727abad348efee834884dae174b80a15de14
```

如果,用上述方式,仍然不能访问,则可用如下方法,更改host文件,强行指定本地DNS,指向homeassistant.local,方法如下:

**修改 Windows `hosts` 文件的方法**

使用管理员身份用记事本打开如下文件 :C:\Windows\System32\drivers\etc\hosts
在最后一行增加

```
192.168.3.2   homeassistant.local
```

如下图

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419100949549.png)

然后,再重新试过一次

不出意外的话,就会自动认证通过

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419101109184.png)

可以根据提示自动选 则房间同步模式,这个要根据具体情况选择,点击下一步,将提示插件集成成功.如下示意图

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419101406365.png)

看到如下图,就说明集成完成了

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419101429977.png)

不出意外的话概览中,就已经自动增加了许多设备.

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419101640136.png)

#### 安装WebRTC Camera

WebRTC camera插件以实现频流播放.如果ha要接入视频监控,则需要安装这个组件,

[仓库地址](https://github.com/AlexxIT/WebRTC):

```
https://github.com/AlexxIT/WebRTC
```

这个插件也有多种安装方法,hacs安装,直接复制等方法,因为上文,我们已经安装过了HACS插件，所以我们选择使用HACS方式安装。

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419102728322.png)

点击后，弹出如下页面

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419102904947.png)

点击DownLoad按钮

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250419102948033.png)

点击DownLoad

当然,我们也可以选择不同折版本
![](https://dhcdn.leon056.com/bpfStudy/docs/20250419103037398.png)

当弹出窗口自动消失,点击上方的返回(**注意:不会自动返回,须人工返回**),返回如下图

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419103346586.png)

看到上方的等待重启,说明组件已经安装上,需要重启,我们执行重启.

重启完成后,会看到,Downloaded中已经显示,了安装成功折WebRTC Camera组件.

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419103804928.png)

然后,进入设置-设备与服务-添加集成,搜索WebRTC

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419104327438.png)

点击WebRtc Camera

![](https://dhcdn.leon056.com/bpfStudy/docs/image-20250419104536359.png)

弹出go2rtc url地址窗口,此插件,我们之前已装过,就在本机,所地址不用改,直接点提交

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419104656703.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419104719116.png)

点完成.WebRTC安装成功.如下图所示

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419104758351.png)

为了演示如何显示监控视频,我们新增加一个sample的仪表盘.

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419105206240.png)

点击,添加仪表盘

![image-20250419105243922](C:\Users\trphoenix\AppData\Roaming\Typora\typora-user-images\image-20250419105243922.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419105311039.png)

在弹出折对话框中,输入仪表盘标题

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419110150389.png)

这样我样就增加了一个仪表盘dashboard-sampale,我们可以在这个仪表盘中增加演示用的组件,此处,我们想增加一个演示用的监控摄像头.点击右上角的编辑按钮.

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419110222025.png)

点击创建一个组件

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419110919529.png)

然后,新建卡片,选择自定义WebRTC卡片,如果没有这个组件,则需要刷新几次,就能看到这个组件.

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419112102073.png)

我样在卡片设置中输入url的视频流地址

![](https://dhcdn.leon056.com/bpfStudy/docs/20250419112451043.png)

```
type: custom:webrtc-camera
url: "rtsp://admin:Camera_data2018@192.168.50.131:554/stream2"

```

#### 安装motionEye

**motionEye** 是一个流行的摄像头软件（称为 motion）的前端。本插件同时提供了前端和摄像头软件，让您可以将摄像头添加到 **Hass.io**（Home Assistant）系统中。

**motionEye** 是一个开源的闭路电视（CCTV）和网络视频录像机（NVR），它设计优雅且非常易于使用。它可以用作婴儿监视器、建筑工地监控、商店摄像头录像机、花园安防等。

###### motionEye 的一些特点：

- 支持大量摄像头，包括 IP 摄像头。
- 可以通过将多个 **motionEye** 实例连接在一起添加多个摄像头。例如，可以在网络中使用运行 MotionEyeOS 的 Pi Zero 和 Pi 摄像头。
- 支持将录像上传到 Google Drive 和 Dropbox。
- 支持运动检测，包括邮件通知和计划任务。
- 可以连续录像、运动录像或延时录像，并支持保留设置。
- 支持配置中的“操作按钮”。

###### 安装方法

在设置-加载项中,搜索"motionEye",

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420105654026.png)

点击查看详情页,并安装

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420102823888.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420103843598.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420104034424.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420104313277.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420104356114.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420104650504.png)

![](https://dhcdn.leon056.com/bpfStudy/docs/20250420105025406.png)

motioneye默认的用户名为admin,密码为空.