emqx学习 — 第一章 基础知识

1 参考文档

1. 官网 latest（v5.7）（截至2024-07-30是最新版）
2. 官网v5.6

2 配置介绍

本文以v5.7版本为例，有涉及docker单机版和docker-compose集群版安装方式的讲解，所以需要提前搭建好docker以及docker-compose环境。Centos7安装docker、centos安装docker-compose

安装 EMQX 开源版，注意有多个安装方式的下载。

2.1 EMQX使用的文件和目录

参考：文件和目录
常用的目录（主要是etc、data、log），不同安装方式得到的文件和目录位置有所不同，具体如下:

序号	目录	权限	描述	压缩包解压安装	二进制包安装	Docker安装	作用
1	etc	读	存放配置文件	./etc	/etc/emqx	/opt/emqx/etc	emqx.conf：EMQX 的主配置文件，默认包含常用的配置项。 emqx-example-en.conf：EMQX 示例配置文件，包含所有可选的配置项。 acl.conf：默认 ACL 规则。 vm.args：Erlang 虚拟机的运行参数。 certs/：X.509 的密钥和证书文件。这些文件被用于 EMQX 的 SSL/TLS 监听器；当要与和外部系统集成时，也可用于建立 SSL/TLS 连接。
2	data	写	存放 EMQX 的运行数据	./data	/var/lib/emqx	/opt/emqx/data	authz：Dashboard 或 REST API 上传的 基于文件进行授权 规则内容。 certs：Dashboard 或 REST API 上传的证书。 configs：启动时生成的配置文件，或者从 Dashboard/REST API/CLI 进行功能设置时覆盖的配置文件。 mnesia：内置数据库目录，用于存储自身运行数据，例如告警记录、客户端认证与权限数据、Dashboard 用户信息等数据，一旦删除该目录，所有业务数据将丢失。 — 可包含以节点命名的子目录，如emqx@127.0.0.1；如节点被重新命名，应手动将旧的目录删除或移走。 — 可通过emqx_ctl mnesia命令查询 EMQX 中 Mnesia 数据库的系统信息，具体请查看 管理命令 CLI。 patches：用于存储热补丁.beam文件，用于补丁修复。 trace: 在线日志追踪文件目录。 在生产环境中，建议定期备份该文件夹下除trace之外的所有目录。
3	log	读	日志文件	./log	/var/log/emqx	/opt/emqx/log	emqx.log.*：EMQX 运行时产生的日志文件，具体请查看日志。
4	releases	未知	存放启动相关的脚本	./releases	/usr/lib/emqx/releases
5	bin	读	存放可执行文件	./bin	/usr/lib/emqx/bin		emqx 和 emqx.cmd：EMQX 的可执行文件，具体使用可以查看命令行接口。
6	lib	未知	存放Erlang 代码	./lib	/usr/lib/emqx/lib
7	erts-*	未知	存放Erlang 虚拟机文件	./erts-*	/usr/lib/emqx/erts-*
8	plugins	未知	插件	./plugins	/usr/lib/emqx/plugins

提示：docker下可通过docker exec -it {容器ID} /bin/sh查看相关配置文件。

EMQX 的配置项存储在 etc</