dotopt/emqx

EMQ Docker

EMQ（Erlang MQTT Broker）是一个分布式、大规模可扩展、高度可扩展的MQTT消息代理，采用Erlang/OTP编写。

当前Docker镜像大小：37.1 MB

获取emqttd

您可以自行构建此Docker镜像：

bash
git clone -b master https://github.com/emqtt/emq_docker.git
cd emq_docker
docker build -t emq:latest .

运行emqttd

在该Docker镜像下执行命令的格式如下：

bash
docker run --rm -ti -v `pwd`:$(somewhere) emq/$(image) $(somecommand)

例如：

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 emq:latest

EMQ Erlang代理在Docker容器中以Linux用户emqtt身份运行。

配置

使用环境变量配置EMQ Docker容器。

环境变量映射规则

• 以EMQ_为前缀的环境变量会映射到配置文件，其中.会被替换为__。

  示例：

  bash
  EMQ_LISTENER__SSL__EXTERNAL__ACCEPTORS <--> listener.ssl.external.acceptors
  EMQ_MQTT__MAX_PACKET_SIZE              <--> mqtt.max_packet_size
  

• 以PLATFORM_为前缀的环境变量会映射到配置文件中的模板字符串。

  示例：

  bash
  PLATFORM_ETC_DIR                   <--> {{ platform_etc_dir }}
  

• 非映射环境变量：

  bash
  EMQ_NAME
  EMQ_HOST
  

  这些环境变量不会用于配置文件。

EMQ配置

注意：https://github.com/emqtt/emqttd/blob/master/etc/emq.conf%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89EMQ%E9%85%8D%E7%BD%AE%E9%83%BD%E5%8F%AF%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E9%85%8D%E7%BD%AE%E3%80%82%E4%BB%A5%E4%B8%8B%E5%88%97%E8%A1%A8%E4%BB%85%E4%B8%BA%E7%A4%BA%E4%BE%8B%EF%BC%8C%E9%9D%9E%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E3%80%82

该列表不完整，可能会随https://github.com/emqtt/emqttd/blob/master/etc/emq.conf%E5%92%8C%E6%8F%92%E4%BB%B6%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%8F%98%E5%8C%96%EF%BC%8C%E4%BD%86%E6%98%A0%E5%B0%84%E8%A7%84%E5%88%99%E7%9B%B8%E5%90%8C%E3%80%82

若设置了EMQ_NAME和EMQ_HOST而未设置EMQ_NODE__NAME，则EMQ_NODE__NAME=$EMQ_NAME@$EMQ_HOST。

例如，将MQTT TCP端口设置为1883：

bash
docker run --rm -ti --name emq -e EMQ_LISTENER__TCP__EXTERNAL=1883 -p 18083:18083 -p 1883:1883 emq:latest

EMQ加载插件配置

默认环境变量EMQ_LOADED_PLUGINS包含：

• emq_recon
• emq_modules
• emq_retainer
• emq_dashboard

bash
# 默认EMQ_LOADED_PLUGINS环境变量
EMQ_LOADED_PLUGINS="emq_recon,emq_modules,emq_retainer,emq_dashboard"

例如，要加载emq_auth_redis插件，将其添加到EMQ_LOADED_PLUGINS中，可使用任意分隔符：

bash
EMQ_LOADED_PLUGINS="emq_auth_redis,emq_recon,emq_modules,emq_retainer,emq_dashboard"
EMQ_LOADED_PLUGINS="emq_auth_redis emq_recon emq_modules emq_retainer emq_dashboard"
EMQ_LOADED_PLUGINS="emq_auth_redis | emq_recon | emq_modules | emq_retainer | emq_dashboard"

EMQ_LOADED_PLUGINS中定义的所有插件都会被加载。

EMQ插件配置

以EMQ_为前缀的环境变量同样适用于所有EMQ插件的配置文件，.会被替换为__。

示例：

bash
EMQ_AUTH__REDIS__SERVER   <--> auth.redis.server
EMQ_AUTH__REDIS__PASSWORD <--> auth.redis.password

无需关心插件配置文件位置，此Docker镜像会自动查找并配置。所有EMQ项目的插件均可按上述环境变量映射规则配置。

假设使用Redis认证插件，示例如下：

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 -p 4369:4369 \
    -e EMQ_LISTENER__TCP__EXTERNAL=1883 \
    -e EMQ_LOADED_PLUGINS="emq_auth_redis,emq_recon,emq_modules,emq_retainer,emq_dashboard" \
    -e EMQ_AUTH__REDIS__SERVER="your.redis.server:6379" \
    -e EMQ_AUTH__REDIS__PASSWORD="password_for_redis" \
    -e EMQ_AUTH__REDIS__PASSWORD_HASH=plain \
    emq:latest

集群

您可以指定初始集群并加入。

注意：EMQ集群必须暴露端口4369和6000-6999端口范围。

例如，使用6000-6100端口范围构建集群：

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 -p 4369:4369 -p 6000-6100:6000-6100 \
    -e EMQ_NAME="emq" \
    -e EMQ_HOST="s2.emqtt.io" \
    -e EMQ_LISTENER__TCP__EXTERNAL=1883 \
    -e EMQ_JOIN_CLUSTER="emq@s1.emqtt.io" \
    emq:latest

内核调优

在Linux主机上，最简单的方法是调优主机内核。

若需通过Docker调优Linux内核，需确保Docker版本为1.12或更高：

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 -p 4369:4369 \
    --sysctl fs.file-max=2097152 \
    --sysctl fs.nr_open=2097152 \
    --sysctl net.core.somaxconn=32768 \
    --sysctl net.ipv4.tcp_max_syn_backlog=16384 \
    --sysctl net.core.netdev_max_backlog=16384 \
    --sysctl net.ipv4.ip_local_port_range=1000 65535 \
    --sysctl net.core.rmem_default=262144 \
    --sysctl net.core.wmem_default=262144 \
    --sysctl net.core.rmem_max=16777216 \
    --sysctl net.core.wmem_max=16777216 \
    --sysctl net.core.optmem_max=16777216 \
    --sysctl net.ipv4.tcp_rmem=1024 4096 16777216 \
    --sysctl net.ipv4.tcp_wmem=1024 4096 16777216 \
    --sysctl net.ipv4.tcp_max_tw_buckets=1048576 \
    --sysctl net.ipv4.tcp_fin_timeout=15 \
    emq:latest

注意：不要以特权模式运行EMQ Docker或挂载系统proc到容器中来调优Linux内核，这是不安全的。

致谢

@je-al https://github.com/emqtt/emq-docker/issues/2 提供了变量名映射（点替换为__）的思路。