一、文件和目录说明
1、MQTT安装时的文件和目录
EMQX 安装完成后会创建一些目录用来存放运行文件和配置文件,存储数据以及记录日志。
不同安装方式得到的文件和目录位置有所不同,具体如下:
注意:
- 压缩包解压安装时,目录相对于软件所在目录;
Docker 容器使用压缩包解压安装的方式,软件安装于 /opt/emqx 目录中
;- data、log、plugins 目录可以通过配置文件设置,建议将 data 目录挂载至高性能磁盘以获得更好的性能。但对于属于同一集群的节点, data 目录的配置应该相同。
2、文件和目录说明
这里介绍一下其中的部分目录,其中包含的文件和子文件夹。
注意:
EMQX 的配置项存储在 etc 和 data/configs 目录下,二者的主要区别是 etc 目录存储只读的配置文件,用户通过 Dashboard 和 REST API 提交的配置将被保存到 data/configs 目录下,并支持在运行时进行热更新。
EMQX 读取这些配置并将其合并转化为 Erlang 原生配置文件格式,以便在运行时应用这些配置。
配置文件手册:https://www.emqx.io/docs/zh/v5.1/configuration/configuration.html
二、通过Docker Compose安装MQTT
1、下载emqx-5.1.6的安装包
后面通过 Docker Compose启动时,发现报错,会提示我们缺少一些文件等问题。所以,我们提前将下载压缩包中需要的文件复制到我们映射的数据卷中。文件在压缩包里面的 /opt/emqx/中。
通过我再三的试错摸索,emqx-5.1.6版本需要提前把下面几个文件复制到我们对应的数据卷中。
shell
└── emqx
├── data
│ └── configs
├── etc
├── acl.conf
├── certs
│ ├── cacert.pem
│ ├── cert.pem
│ ├── client-cert.pem
│ ├── client-key.pem
│ ├── key.pem
│ └── README
├── emqx.conf
└── vm.args
2、准备文件和目录
1)在任意目录创建一个 mqtt_emqx5文件夹和数据卷所挂载的目录。
shell
[root@centos7 ~]# mkdir /usr/local/src/mqtt_emqx5
[root@centos7 ~]# cd /usr/local/src/mqtt_emqx5
# 数据卷
[root@centos7 mqtt_emqx5]# mkdir -p ./emqx/data
[root@centos7 mqtt_emqx5]# mkdir -p ./emqx/etc
[root@centos7 mqtt_emqx5]# mkdir -p ./emqx/log
2)将上面压缩包中提到的那几个文件复制到我们的数据卷目录中
shell
# 复制完之后,给挂载目录赋予权限
[root@centos7 mqtt_emqx5]# chmod 777 -R ./emqx/
创建并编写docker-compose.yaml
3)创建并编写docker-compose.yaml
shell
[root@centos7 mqtt_emqx5]# cat docker-compose.yaml
version: '3.7'
services:
emqx5_s1:
image: "emqx/emqx:5.1.6"
container_name: "emqx5_s1"
environment:
- "EMQX_NAME=emqx5_s1"
- "EMQX_HOST=127.0.0.1"
ports:
- 1883:1883
- 8083:8083
- 8084:8084
- 8883:8883
- 18083:18083
volumes:
- $PWD/emqx/etc:/opt/emqx/etc
- $PWD/emqx/data:/opt/emqx/data
- $PWD/emqx/log:/opt/emqx/log
#restart: always
[root@centos7 mqtt_emqx5]#
EMQX默认开启的MQTT服务各个端口说明:
- 1883:MQTT 协议端口
- 8883:MQTT/SSL 端口
- 8083:MQTT/WebSocket 端口
- 8084:MQTT/WebSocket/SSL端口
- 8080:HTTP API 端口
- 18083:Dashboard 管理控制台端口
最终 mqtt_emqx5文件夹中的内容如下:
shell
[root@centos7 mqtt_emqx5]# tree
.
├── docker-compose.yaml
└── emqx
├── data
│ └── configs
├── etc
│ ├── acl.conf
│ ├── certs
│ │ ├── cacert.pem
│ │ ├── cert.pem
│ │ ├── client-cert.pem
│ │ ├── client-key.pem
│ │ ├── key.pem
│ │ └── README
│ ├── emqx.conf
│ └── vm.args
└── log
6 directories, 10 files
3、启动MQTT
- 使用 docker-compose up启动的容器都在前台,控制台将会同时打印所有容器的输出信息,可以很方便进行调试,通过 Ctrl-C停止命令时,该容器也会停止。
- 使用 docker-compose up -d命令,则将会在后台启动并运行该容器,一般推荐使用。
一般进入到 docker-compose.yml的上下文目录中,执行命令:
- 启动项目:docker-compose up -d
- 停止项目:docker-compose down
shell
[root@centos7 mqtt_emqx5]# docker-compose up
Starting emqx5_s1 ... done
Attaching to emqx5_s1
emqx5_s1 | WARNING: Default (insecure) Erlang cookie is in use.
emqx5_s1 | WARNING: Configure node.cookie in /opt/emqx/etc/emqx.conf or override from environment variable EMQX_NODE__COOKIE
emqx5_s1 | WARNING: NOTE: Use the same cookie for all nodes in the cluster.
emqx5_s1 | EMQX_RPC__PORT_DISCOVERY [rpc.port_discovery]: manual
emqx5_s1 | EMQX_NODE__NAME [node.name]: emqx5_s1@127.0.0.1
emqx5_s1 | Listener ssl:default on 0.0.0.0:8883 started.
emqx5_s1 | Listener tcp:default on 0.0.0.0:1883 started.
emqx5_s1 | Listener ws:default on 0.0.0.0:8083 started.
emqx5_s1 | Listener wss:default on 0.0.0.0:8084 started.
emqx5_s1 | Listener http:dashboard on :18083 started.
emqx5_s1 | EMQX 5.1.6 is running now!
通过浏览器就可以访问 ip:18083端口(默认的用户名是admin,密码为public),登录成功后会打开一个管理控制台网页。主界面如下:
三、MQTTX客户端
官方下载,傻瓜式安装:https://mqttx.app/zh
1、建立连接
新建MQTT服务端连接。
2、订阅主题
MQTT 协议根据主题来转发消息。主题被用来标识和区分不同的消息,它是 MQTT 消息路由的基础。
主题通过 / 来区分层级,类似于 URL 路径。MQTT 主题支持以下两种通配符:+ 和 #。
- +:表示单层通配符,例如 a/+ 匹配 a/x 或 a/y。
- #:表示多层通配符,例如 a/# 匹配 a/x、a/b/c/d。
注意:
通配符主题只能用于订阅,不能用于发布。
关于 MQTT 主题的更多详情,请参阅文章通过案例理解 MQTT 主题与通配符:https://www.emqx.com/zh/blog/advanced-features-of-mqtt-topics
MQTTX客户端的更多使用,查看官方文档。
-- 求知若饥,虚心若愚。