Docs

# EMQX 企业版安装

EMQX 消息服务器可跨平台运行在 Linux 服务器上。

# EMQX License 文件获取

联系商务或登陆 https://www.emqx.com 注册账号获取免费的试用 License 文件

# EMQX 程序包下载

EMQX 消息服务器每个版本会发布 CentOS、Ubuntu、Debian 平台程序包与 Docker 镜像。

下载地址: https://www.emqx.com/zh/downloads

# CentOS

  • CentOS 7 (EL7)
  • CentOS 8 (EL8)

# 使用 rpm 包安装 EMQX

  1. 访问emqx.com (opens new window) 选择 CentOS 版本，然后下载要安装的 EMQX 版本的 rpm 包。

  2. 安装 EMQX

    $ sudo rpm -ivh emqx-ee-centos7-v4.0.0.x86_64.rpm
    1

  3. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    1

  4. 启动 EMQX

    • 直接启动

      $ emqx start
emqx  is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
      1
      2
      3
      4
      5
      6

    • systemctl 启动

      $ sudo systemctl start emqx
      1

    • service 启动

      $ sudo service emqx start
      1

# 使用 zip 包安装 EMQX

注意

ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用

  1. 通过 emqx.com (opens new window) 选择 Centos 版本，然后下载要安装的 EMQX 版本的 zip 包。

  2. 解压程序包

    $ unzip emqx-ee-centos7-v4.0.0.zip
    1

  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    1

  4. 启动 EMQX

    $ ./bin/emqx start
emqx v4.0.0 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
    1
    2
    3
    4
    5
    6

# Ubuntu

  • Bionic 18.04 (LTS)
  • Xenial 16.04 (LTS)

# 使用 deb 包安装 EMQX

  1. 通过 emqx.com (opens new window) 选择 Ubuntu 版本，然后下载要安装的 EMQX 版本的 deb 包。

  2. 安装 EMQX

# for ubuntu
$ sudo apt install ./emqx-ee-ubuntu18.04-v3.1.0_amd64.deb
# for debian
$ sudo dpkg -i emqx-ee-ubuntu18.04-v3.1.0_amd64.deb
1
2
3
4
  1. 导入License文件:
$ cp /path/to/emqx.lic /etc/emqx/emqx.lic
1
  1. 启动 EMQX
  • 直接启动
$ emqx start
emqx  is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
1
2
3
4
5
6
  • systemctl 启动
$ sudo systemctl start emqx
1
  • service 启动
$ sudo service emqx start
1

# 使用 zip 包安装 EMQX

注意

ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用

  1. 通过 emqx.com (opens new window) 选择 Ubuntu 版本，然后下载要安装的 EMQX 版本的 zip 包。

  2. 解压程序包

$ unzip emqx-ee-ubuntu18.04-v4.0.0.zip
1
  1. 导入License文件:
$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
1
  1. 启动 EMQX
$ ./bin/emqx start
emqx v4.0.0 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
1
2
3
4
5
6

# Debian

  • Debian 9
  • Debian 10

# 使用 deb 包安装 EMQX

  1. 通过 emqx.com (opens new window) 选择 Debian 版本，然后下载要安装的 EMQX 版本的 deb 包。

  2. 安装 EMQX

    # for ubuntu
$ sudo apt install ./emqx-ee-debian9-v3.1.0_amd64.deb

# for debian
# 首先确保已安装 libodbc
$ sudo dpkg -i emqx-ee-debian9-v3.1.0_amd64.deb
    1
    2
    3
    4
    5
    6

  3. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    1

  4. 启动 EMQX

    • 直接启动

      $ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
      1
      2
      3
      4
      5
      6

    • systemctl 启动

      $ sudo systemctl start emqx
      1

    • service 启动

      $ sudo service emqx start
      1

# 使用 zip 包安装 EMQX

注意

ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用

  1. 通过 emqx.com (opens new window) 选择 Debian 版本，然后下载要安装的 EMQX 版本的 zip 包。

  2. 解压程序包

    $ unzip emqx-ee-debian9-v4.0.0.zip
    1

  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    1

  4. 启动 EMQX

    $ ./bin/emqx start
emqx v4.0.0 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
    1
    2
    3
    4
    5
    6

# macOS

# 使用 ZIP 包安装 EMQX

  1. 通过 emqx.com (opens new window) ，选择 EMQX 版本，然后下载要安装的 zip 包。

  2. 解压压缩包

    $ unzip emqx-ee-macos-v4.0.0.zip
    1

  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.li
    1

  4. 启动 EMQX

    $ ./bin/emqx start
emqx v4.0.0 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
    1
    2
    3
    4
    5
    6

# Docker

注意

由于 emqx 将数据存储在 data/mnesia/<节点名> 目录，所以在使用容器启动 emqx 的时候， 必须使用 hostname 或者 FQDN 来组建 emqx 的节点名。否则数据存储目录将发生切换，导致数据丢失。

# 启动单个容器

  1. 获取 docker 镜像
$ docker pull emqx/emqx-ee:v4.0.0
1
  1. 启动 docker 容器
$ docker run -d \
    --name emqx-ee \
    -p 8081:8081 \
    -p 1883:1883 \
    -p 8083:8083 \
    -p 8883:8883 \
    -p 8084:8084 \
    -p 18083:18083 \
    -v /path/to/emqx.lic:/opt/emqx/etc/emqx.lic \
    emqx/emqx-ee:v4.0.0
1
2
3
4
5
6
7
8
9
10

更多关于 EMQX Docker 的信息请查看 Docker Hub (opens new window)

# 使用 docker-compose 创建一个简单的静态集群

  1. 创建 docker-compose.yaml 文件

    version: '3'

services:
  emqx1:
    image: emqx/emqx-ee:v4.0.0
    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"
    volumes:
        - ./tmp/emqx.lic:/opt/emqx/etc/emqx.lic
    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-ee:v4.0.0
    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"
    volumes:
        - ./tmp/emqx.lic:/opt/emqx/etc/emqx.lic
    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
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45

  2. 启动 docker-compose 集群

    $ docker-compose -p my_emqx up -d
    1

  3. 查看 cluster

    $ 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 => []}
    1
    2
    3

关于 EMQX 企业版容器的更多信息，请参看 Docker Hub (opens new window)

# 使用 Helm 安装 EMQX 集群 (K8S、K3S)

  1. 添加 helm 仓库
$ helm repo add emqx https://repos.emqx.io/charts
$ helm repo update
1
2
  1. 查询 EMQX 仓库
helm search repo emqx
NAME         CHART VERSION APP VERSION DESCRIPTION
emqx/emqx    v4.0.0        v4.0.0      A Helm chart for EMQX
emqx/emqx-ee v4.0.0        v4.0.0      A Helm chart for EMQX
emqx/kuiper  0.1.1         0.1.1       A lightweight IoT edge analytic software
1
2
3
4
5
  1. 启动 EMQX 集群
$ helm install my-emqx emqx/emqx-ee
1
  1. 查看 EMQX 集群状态
$ kubectl get pods
NAME       READY  STATUS             RESTARTS  AGE
my-emqx-0  1/1     Running   0          56s
my-emqx-1  1/1     Running   0          40s
my-emqx-2  1/1     Running   0          21s

$ kubectl exec -it my-emqx-0 -- emqx_ctl cluster status
Cluster status: #{running_nodes =>
                      ['my-emqx@my-emqx-0.my-emqx-headless.default.svc.cluster.local',
                       'my-emqx@my-emqx-1.my-emqx-headless.default.svc.cluster.local',
                       'my-emqx@my-emqx-2.my-emqx-headless.default.svc.cluster.local'],
                  stopped_nodes => []}
1
2
3
4
5
6
7
8
9
10
11
12

← 基于 k8s 部署 EMQX 集群 →

本页导航