總覽

1.搭建流程概述
2.準備工作
3.開始搭建！
4.總結
如果想看 ESP32 或其他使用 MicroPython 編程的單片機如何連接到該云服務器，實現(xiàn) HomeAssistant 控制 單片機的內容，請看我這篇博客的下一篇。

一、搭建流程概述

0.總體流程

我們需要先有一臺云服務器，然后在上面搭建 docker（用寶塔傻瓜式搭建就行了，一會兒我會寫怎么搭建），再用 docker 創(chuàng)建 2個 容器，它們分別裝著 HomeAssistant 和 MQTT，這相當于我們在 1個 云服務器 上 運行了 2個 “服務（服務器）”。MQTT 網(wǎng)絡信協(xié)議的具體內容如下，可以把它想象成一個 用于連接 ESP32物聯(lián)網(wǎng)終端 和 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.創(chuàng)建 docker 容器

3.1 創(chuàng)建容器文件夾
文件 -> 進入到 根目錄下的 home/你的用戶名/ 路徑下，新建一個文件夾“homeassistant-config”，如圖所示。
3.2 打開終端，開始創(chuàng)建容器

3.3 輸入創(chuàng)建容器命令，并回車：

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

請注意！上面的命令中“xxx”是創(chuàng)建容器的路徑，應替換為你自己的路徑！！！如我的命令改為了：

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

3.4 創(chuàng)建容器成功

運行命令沒有報錯，去看看你剛才創(chuàng)建的空文件夾，現(xiàn)在如果已經(jīng)有東西了則創(chuàng)建成功。如下面這樣：

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 在云平臺上開放端口

這個根據(jù)你使用的是什么云，自已找找，你的服務器的防火墻選項，添加端口即可（我演示的是阿里云）：

5.配置 HomeAssistant

5.1 訪問 HomeAssistant

使用你的ip:8123的方式來訪問 HomeAssistant 網(wǎng)頁。如你的云服務器外網(wǎng)ip如果是182.96.213.203，那么你就在瀏覽器里訪問如下網(wǎng)址：（我只是舉個例子，你別填182.96.213.203，填你自己的服務器外網(wǎng)IP！）

182.96.213.203:8123

6.安裝 MQTT 服務器

6.1 訪問 EMQX 官網(wǎng)下載區(qū)
https://www.emqx.io/zh/downloads
6.2 運行命令 將 EMQX 放入 docker 中
分別在服務器終端上執(zhí)行下面圖中的“獲取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 已經(jīng)在 docker 中：

使用命令：

sudo docker ps

6.4 開放防火墻上的 18083 和 1883 端口

6.4.1 依次運行命令，開放端口并重啟防火墻使其生效：

firewall-cmd --add-port=18083/tcp --permanentfirewall-cmd --add-port=1883/tcp --permanentfirewall-cmd --reload

6.4.2 運行如下命令，看是否我們已經(jīng)開放了 18083 和 1883 端口：

firewall-cmd --list-ports

6.4.3 在服務器控制臺上開放 18083 和 1883 端口：

6.5 訪問 EMQX 網(wǎng)站
6.5.1 URL ：
http://xxx.xxx.xxx.xxx:18083
xxx.xxx.xxx.xxx 代表你云服務器的公網(wǎng)IP地址

6.5.2 登錄

默認的用戶名是：admin
默認的密碼是：public

6.6 回到 HomeAssistant 網(wǎng)站

6.6.1 操作流程：
i：配置（左邊欄） ->
ii：設備與服務 ->
iii：添加集成（右下角）->
iv：搜索“MQTT” ->
v：點擊“MQTT” ->
vi：點擊“MQTT” ->
vii：輸入相關信息（請注意，用戶名和密碼是你剛才登錄 EMQX 的用戶名和密碼）
viii：提交,成功。我們的 HomeAssistant 已經(jīng)成功連接了 MQTT 服務

6.7 回到 EMQX 網(wǎng)站

6.7.1 操作流程：

監(jiān)控 -> 客戶端 -> 發(fā)現(xiàn)一個新連接，好耶

6.7.2 確認 MQTT 和 HomeAssistant 已經(jīng)連接成功：
1.去 HomeAssistant 網(wǎng)站
2.進入剛才的 MQTT
3.點擊“選項”
4.打開監(jiān)聽后，發(fā)送數(shù)據(jù)包測試，成功。

四、總結

至此，在云服務器上使用 docker 搭建 HomeAssistant 平臺并 讓 MQTT 與 HomeAssistant 平臺建立通訊的任務圓滿結束。如果想看 ESP32 或其他使用 MicroPython 編程的單片機如何連接的內容，請看我這篇博客的下一篇。