# 目录结构

不同安装方式得到的 EMQX 其目录结构会有所不同,具体如下:

描述使用 ZIP 压缩包安装使用二进制包安装Homebrew(MacOS)安装
可执行文件目录./bin/usr/lib/emqx/bin/usr/local/bin
数据文件./data/var/lib/emqx/data/usr/local/Cellar/emqx/*/data
Erlang 虚拟机文件./erts-*/usr/lib/emqx/erts-*/usr/local/Cellar/emqx/*/erts-
配置文件目录./etc/etc/emqx/etc/usr/local/Cellar/emqx/*/etc
依赖项目录./lib/usr/lib/emqx/lib/usr/local/Cellar/emqx/*/lib
日志文件./log/var/log/emqx/usr/local/Cellar/emqx/*/log
启动相关的脚本、schema 文件./releases/usr/lib/emqx/releases/usr/local/Cellar/emqx/*/releases

以上目录中,用户经常接触与使用的是 binetcdatalog 目录。

# bin 目录

emqx、emqx.cmd

EMQX 的可执行文件,具体使用可以查看 基本命令

emqx_ctl、emqx_ctl.cmd

EMQX 管理命令的可执行文件,具体使用可以查看 管理命令 CLI

# etc 目录

EMQX 通过 etc 目录下配置文件进行设置,主要配置文件包括:

配置文件说明
emqx.confEMQX 配置文件
acl.confEMQX 默认 ACL 规则配置文件
plugins/*.confEMQX 各类插件配置文件
certsEMQX SSL 证书文件
$ cat loaded_plugins
{emqx_management, true}.
{emqx_dashboard, true}.
{emqx_schema_registry, true}.
{emqx_rule_engine, true}.
1
2
3
4
5

mnesia

Mnesia 数据库是 Erlang 内置的一个分布式 DBMS,可以直接存储 Erlang 的各种数据结构。

EMQX 使用 Mnesia 数据库存储自身运行数据,例如告警记录、规则引擎已创建的资源和规则、Dashbaord 用户信息等数据,这些数据都将被存储在 mnesia 目录下,因此一旦删除该目录,将导致 EMQX 丢失所有业务数据。

可以通过 emqx_ctl mnesia 命令查询 EMQX 中 Mnesia 数据库的系统信息,具体请查看 管理命令 CLI

# log 目录

emqx.log.*

EMQX 运行时产生的日志文件,具体请查看 日志与追踪

crash.dump

EMQX 的崩溃转储文件,可以通过 etc/emqx.conf 修改配置,具体内容可以查看 配置项

erlang.log.*

emqx start 方式后台启动 EMQX 时,控制台日志的副本文件。