【自用】云服务器 使用 docker 搭建 HomeAssistant + MQTT 物联网平台

MicroLindb 2024-07-09 12:37:02 阅读 100

总览

1.搭建流程概述

2.准备工作

3.开始搭建!

4.总结

如果想看 ESP32 或其他使用 MicroPython 编程的单片机如何连接到该云服务器,实现 HomeAssistant 控制 单片机的内容,请看我这篇博客的下一篇。

一、搭建流程概述

0.总体流程

我们需要先有一台云服务器,然后在上面搭建 docker(用宝塔傻瓜式搭建就行了,一会儿我会写怎么搭建),再用 docker 创建 2个 容器,它们分别装着 HomeAssistant 和 MQTT,这相当于我们在 1个 云服务器 上 运行了 2个 “服务(服务器)”。MQTT 网络信协议的具体内容如下,可以把它想象成一个 用于连接 ESP32物联网终端 和 HomeAssistant 平台 的 中转站:

在这里插入图片描述

在这里插入图片描述

二、准备工作

0.购买云服务器

0.1 买一台云服务器(什么阿某云、腾某云、华某云随便,轻量型服务器应该就够用了,看自己。不会买的自己搜去)

1.个人PC上暂时需要下载的软件或服务

1.1 Xshell(用于访问云服务器,没有安装的话自己去搜安装xshell的安装和使用教程,想要控制云服务器没有xshell…除非你用其他的终端访问软件)

2.云服务器上暂时需要下载的软件和服务

2.1 宝塔(用于更简便地使用docker和其他操作)

三、搭建工作开始

1.使用宝塔,访问你的云服务器,并傻瓜式安装 docker

点击左侧栏的 docker,你的页面上应该有一个“安装”。点击后,就进行安装,时间可能会较长,请耐心等待直到安装完成。

在这里插入图片描述

2.docker 安装完成后,直接拉取 HomeAssistant 镜像

2.1 拉取 HomeAssistant

docker -> 镜像 -> 从仓库中拉取 -> 填入内容:homeassistant/home-assistant:latest -> 确认

在这里插入图片描述

2.2 安装 HomeAssistant 步骤:

在这里插入图片描述

在这里插入图片描述

3.创建 docker 容器

3.1 创建容器文件夹

文件 -> 进入到 根目录下的 home/你的用户名/ 路径下,新建一个文件夹“homeassistant-config”,如图所示。

在这里插入图片描述

3.2 打开终端,开始创建容器

在这里插入图片描述

3.3 输入创建容器命令,并回车:

sudo docker run -d --name="homeassistant-v1" -v xxx:/config -p 8123:8123 homeassistant/home-assistant:latest

请注意!上面的命令中“xxx”是创建容器的路径,应替换为你自己的路径!!!如我的命令改为了:

sudo docker run -d --name="homeassistant-v1" -v /home/admin/homeassistant-config:/config -p 8123:8123 homeassistant/home-assistant:latest

3.4 创建容器成功

运行命令没有报错,去看看你刚才创建的空文件夹,现在如果已经有东西了则创建成功。如下面这样:

在这里插入图片描述

4.开放 云服务器 防火墙 8123 端口

4.1 开放端口

我也懒得写了,你直接在宝塔的终端里或者其他什么软件xshell之类的,只要能进到云服务器终端里就行,依次运行如下命令:

firewall-cmd --add-port=8123/tcp --permanent

firewall-cmd --reload

4.2 查看端口是否开放,你能看到 8123/tcp 代表开放成功

firewall-cmd --list-ports

在这里插入图片描述

4.3 在云平台上开放端口

这个根据你使用的是什么云,自已找找,你的服务器的防火墙选项,添加端口即可(我演示的是阿里云):

在这里插入图片描述

5.配置 HomeAssistant

5.1 访问 HomeAssistant

使用你的ip:8123的方式来访问 HomeAssistant 网页。如你的云服务器外网ip如果是182.96.213.203,那么你就在浏览器里访问如下网址:(我只是举个例子,你别填182.96.213.203,填你自己的服务器外网IP!)

182.96.213.203:8123

在这里插入图片描述

6.安装 MQTT 服务器

6.1 访问 EMQX 官网下载区

https://www.emqx.io/zh/downloads

6.2 运行命令 将 EMQX 放入 docker 中

分别在服务器终端上执行下面图中的“获取Docker镜像”和“启动Docker容器”的两段代码。

代码片1:

docker pull emqx/emqx:5.1.4

代码片2:

docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:5.1.4

在这里插入图片描述

6.3 EMQX 下载完成后,查看是否 EMQX 已经在 docker 中:

使用命令:

sudo docker ps

在这里插入图片描述

6.4 开放防火墙上的 18083 和 1883 端口

6.4.1 依次运行命令,开放端口并重启防火墙使其生效:

firewall-cmd --add-port=18083/tcp --permanent

firewall-cmd --add-port=1883/tcp --permanent

firewall-cmd --reload

6.4.2 运行如下命令,看是否我们已经开放了 18083 和 1883 端口:

firewall-cmd --list-ports

在这里插入图片描述

6.4.3 在服务器控制台上开放 18083 和 1883 端口:

在这里插入图片描述

6.5 访问 EMQX 网站

6.5.1 URL :

http://xxx.xxx.xxx.xxx:18083

xxx.xxx.xxx.xxx 代表你云服务器的公网IP地址

在这里插入图片描述

6.5.2 登录

默认的用户名是:admin

默认的密码是:public

6.6 回到 HomeAssistant 网站

6.6.1 操作流程:

i:配置(左边栏) ->

ii:设备与服务 ->

iii:添加集成(右下角)->

iv:搜索“MQTT” ->

v:点击“MQTT” ->

vi:点击“MQTT” ->

vii:输入相关信息(请注意,用户名和密码是你刚才登录 EMQX 的用户名和密码)

viii:提交,成功。我们的 HomeAssistant 已经成功连接了 MQTT 服务

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

6.7 回到 EMQX 网站

6.7.1 操作流程:

监控 -> 客户端 -> 发现一个新连接,好耶

在这里插入图片描述

6.7.2 确认 MQTT 和 HomeAssistant 已经连接成功:

1.去 HomeAssistant 网站

2.进入刚才的 MQTT

3.点击“选项”

4.打开监听后,发送数据包测试,成功。

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

四、总结

至此,在云服务器上使用 docker 搭建 HomeAssistant 平台并 让 MQTT 与 HomeAssistant 平台建立通讯的任务圆满结束。如果想看 ESP32 或其他使用 MicroPython 编程的单片机如何连接的内容,请看我这篇博客的下一篇。



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。