EMQ X 是基於 Erlang/OTP 平臺開發的開源物聯網 MQTT 訊息伺服器，目前廣泛應用於全球各行業物聯網平臺建設中。其設計目標是實現高可靠承載海量物聯網終端的 MQTT 連線，支援在海量物聯網裝置間低延時訊息路由。

本文將以 EMQ X v4.3.10（開源版）為例，介紹 EMQ X 在 Docker、Kubernetes、Windows 和 Linux 上的安裝方法以及常見問題，為大家利用 MQTT 訊息伺服器快速搭建物聯網平臺提供幫助。

## 安裝前檢查

絕大多數情況下作業系統的環境依賴、監聽埠都不會出現問題，測試環境下可以直接安裝啟動，EMQ X 會檢查可能存在的問題並停止啟動、報出錯誤。

但是我們仍然建議當生產環境存在升級 EMQ X 版本、升級其他服務等環境變動之後，再次啟動 EMQ X 前務必進行測試和檢查，避免產生不必要的損失。

### 檢查環境依賴

常見的由於環境依賴導致的問題如下：

- OpenSSL 版本不正確：常見於 CentOS 系統上，需要更新 OpenSSL 版本
- 缺失 MSVCRxxx.dll 檔案：Windows 系統特有，需要安裝對應的依賴庫
- 安裝包與作業系統不符：EMQ X 需要對應作業系統和版本下載，否則無法啟動並報 `cannot execute binary file` 錯誤

更多的問題和解決方法詳見：[EMQ X - 常見錯誤](https://docs.emqx.com/zh/emqx/v4.3/faq/error.html)

### 檢查埠占用

埠占用會導致 EMQ X 無法啟動或部分功能異常，常見的症狀有：

- 執行 `emqx start` 時提示啟動超時
- 無法開啟 Dashboard 或開啟後一直報 404 Not Found 錯誤

出現以上情況，可以使用 `emqx console` 命令啟動 EMQ X，console 模式下可以列印詳細的錯誤日誌。

EMQ X 預設情況下監聽以下埠：

| **埠**     | **說明**                 |
| :----------- | :----------------------- |
| **叢集通訊** |                          |
| 4369-4380    | 叢集通訊                 |
| 5370-5380    | 叢集 RPC 通訊            |
| **協議接入** |                          |
| 1883         | MQTT 協議埠            |
| 11883        | MQTT 協議埠            |
| 8883         | MQTT/SSL 埠            |
| 8083         | MQTT/WebSocket 埠      |
| 5683         | LwM2M 埠               |
| **管理監控** |                          |
| 8081         | HTTP API 埠            |
| 18083        | Dashboard 管理控制檯埠 |

## 使用 Docker 安裝 EMQ X

使用 Docker 不需要建立安裝執行環境，可以更快安裝啟動 EMQ X，Docker 安裝教程請見 [Install Docker Engine](https://docs.docker.com/engine/install/) 。

### 執行單個 EMQ X 節點

Docker 安裝完成之後，可以透過 [Docker Hub](https://hub.docker.com/r/emqx/emqx) 獲取 EMQ X 映象：

```shell
docker pull emqx/emqx:4.3.10
```

啟動 Docker 容器，建立埠對映：

```shell
docker run -d --name emqx \
  -p 1883:1883 \
  -p 8081:8081 \
  -p 8083:8083 \
  -p 8084:8084 \
  -p 8883:8883 \
  -p 18083:18083 \
emqx/emqx:4.3.10

```

啟動成功之後，訪問 Dashboard 管理控制檯 [http://localhost:18083](http://localhost:18083/)。

### docker-compose 簡單叢集

透過 docker-compose 可以在本地快速建立 EMQ X 叢集。

建立 `docker-compose.yaml` 檔案：

```shell
version: '3'

services:
    emqx1:
    image: emqx/emqx
    environment:
    - "EMQX_NAME=emqx"
    - "EMQX_HOST=node1.emqx.io"
    - "EMQX_CLUSTER__DISCOVERY=static"
    - "EMQX_CLUSTER__STATIC__SEEDS=emqx@node1.emqx.io, emqx@node2.emqx.io"
    healthcheck:
        test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
        interval: 5s
        timeout: 25s
        retries: 5
    networks:
        emqx-bridge:
        aliases:
        - node1.emqx.io

emqx2:
    image: emqx/emqx
    environment:
    - "EMQX_NAME=emqx"
    - "EMQX_HOST=node2.emqx.io"
    - "EMQX_CLUSTER__DISCOVERY=static"
    - "EMQX_CLUSTER__STATIC__SEEDS=emqx@node1.emqx.io, emqx@node2.emqx.io"
    healthcheck:
        test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
        interval: 5s
        timeout: 25s
        retries: 5
    networks:
        emqx-bridge:
        aliases:
        - node2.emqx.io

networks:
    emqx-bridge:
    driver: bridge

```

啟動 docker-compose 叢集：

```shell
docker-compose -p my_emqx up -d
```

檢視叢集：

```shell
docker exec -it my_emqx_emqx1_1 sh -c "emqx_ctl cluster status"
Cluster status: #{running_nodes => ['emqx@node1.emqx.io','emqx@node2.emqx.io'],
                    stopped_nodes => []}

```

## 在 Kubernetes 上安裝 EMQ X

EMQ X Kubernetes Operator 是 EMQ 推出的一種封裝、部署和管理 EMQ X 的方法，也是一個特定的應用控制器，允許 DevOps 人員在 Kubernetes 上編排 EMQ X 叢集，管理他們的生命週期。

EMQ X Kubernetes Operator 可以幫助使用者在 Kubernetes 的環境上快速建立和管理 EMQ X 叢集，不僅極大簡化部署和管理流程，也降低了管理和配置的專業技能要求。

它將使部署和管理工作變成一種低成本、標準化、可重複性的能力，高效實現叢集擴容、無縫升級、故障處理和統一監控。

詳細的部署和使用方式請檢視：[https://github.com/emqx/emqx-operator](https://github.com/emqx/emqx-operator)。

## 在 Windows 上安裝 EMQ X

> EMQ X 生產部署建議使用 Linux 伺服器，不推薦 Windows 伺服器，EMQ X 企業版中沒有提供 Windows 版本，如需測試可以使用 Docker 或者虛擬機器的方式安裝。

透過 [EMQ X 下載頁面](https://www.emqx.com/zh/try?product=broker) 下載要安裝的 EMQ X 版本的 ZIP 包，解壓安裝包後，使用命令列進入解壓目錄執行即可：

```
cd D:\emqx
.\bin\emqx start

```

## 在 Linux 上安裝 EMQ X

### Linux 一鍵安裝

EMQ X 提供一鍵安裝指令碼進行安裝，指令碼將自動識別並下載對應作業系統的安裝包進行安裝：

```shell
curl https://repos.emqx.io/install_emqx.sh | bash
```

### Linux 二進位制包安裝

透過  [EMQ X 下載頁面](https://www.emqx.com/zh/try?product=broker) 下載要安裝的 EMQ X 版本的 ZIP 包，解壓程式包後，使用命令列進入解壓目錄執行即可：

```shell
cd /opt/emqx
./bin/emqx start
```

### yum 包管理工具安裝

安裝所需要的依賴包

```shell
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```

使用以下命令設定穩定儲存庫，以 CentOS 7 為例

```shell
sudo yum-config-manager --add-repo https://repos.emqx.io/emqx-ce/redhat/centos/7/emqx-ce.repo
```

安裝最新版本的 EMQ X

```shell
sudo yum install emqx
```

### 其他包管理工具和作業系統安裝

訪問 [EMQ X 安裝文件](https://docs.emqx.com/zh/emqx/v4.3/getting-started/install.html) 檢視更多安裝教程。

## 部署說明

EMQ X 支援不同的部署方式，您可以透過雲服務或私有部署的方式來使用 EMQ X。

EMQ 提供了全託管的雲原生 MQTT 訊息服務 EMQ X Cloud：自動化、全託管部署，無需管理伺服器基礎設施，可以為您的物聯網應用帶來輕鬆便捷的 MQTT 雲服務。

如果您需要私有部署，EMQ X 也提供了企業版，支援在物理機、容器/K8s、私有云、混合雲和公有云（如阿里雲、華為雲和 AWS ）中的任何地方執行，不受位置限制，不受廠商鎖定。

EMQ X Cloud 和 EMQ X 企業版均提供免費試用服務和試用版版本，您可以在數分鐘內完成部署，立即開始探索和測試更豐富的產品功能。

以下是不同版本之間的主要區別，您可以根據自身情況選擇不同的部署方式。

![EMQ X 版本區別](http://img.blog.itpub.net/blog/2021/12/22/0be989e809f3a820.png?x-oss-process=style/bb "EMQ X 版本區別")

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/install-emqx-mqtt-broker](https://www.emqx.com/zh/blog/install-emqx-mqtt-broker)

MQTT 伺服器搭建：EMQ X 安裝指南和常見問題

相關文章