概览

本章将向您介绍如何下载和安装 EMQX，运行 EMQX 所需满足的最低硬件规则，以及安装完成后 EMQX 所在目录的文件夹结构，以便后续的配置和维护操作。

安装环境

EMQX 所使用的 Erlang 虚拟机依赖于系统区域设置来启用各种功能的 Unicode 支持，包括交互式 Erlang Shell 中的文件名 (opens new window)和终端 IO (opens new window)。

如果您使用的是 Linux 操作系统，在启动 EMQX 前建议确认系统环境中已启用了 UTF-8 区域设置。关于如何在不同平台上启用 UTF-8 区域设置，点击下列标签：

使用 cloud-init (opens new window) 配置启用 UTF-8 locale 区域设置：

cat <<EOF | sudo tee /etc/cloud/cloud.cfg.d/99_locale.cfg
#cloud-config
locale: C.utf8
EOF

通过 systemd，通常可以使用 localectl 命令启用 UTF-8 locale 区域设置：

sudo localectl set-locale LANG=C.UTF-8

UTF-8 区域设置可以通过两种方式启用。

• 通过 systemd，通常使用 localectl (opens new window) 命令启用：

  sudo localectl set-locale LANG=C.UTF-8

• 否则，使用 update-locale (opens new window) 命令启用：

  sudo update-locale LANG=C.UTF-8

可以使用 update-locale (opens new window) 命令启用：

sudo update-locale LANG=C.UTF-8

下载

在每个 EMQX 版本中，我们都会针对不同的操作系统与平台发布不同的安装包选项，您可点击以下链接下载：

• 官网下载：https://www.emqx.io/zh/downloads (opens new window)

此外，您还可在我们的 GitHub Release 页面 (opens new window) 下载 alpha、beta、rc 等版本的安装包。

提示

除了私有部署外，我们也提供了全托管的 EMQX Cloud 服务，您只需几步注册即可轻松体验 EMQX 提供的 MQTT 消息服务，欢迎前往 EMQX Cloud 门户 (opens new window)页面免费试用。

支持的操作系统与平台

EMQX 可以跨平台的在多种操作系统和硬件平台上运行，以下是支持情况：

硬件规格

EMQX 的硬件要求根据客户端连接数、消息消息速率和消息大小以及启用的功能而异。 下面的最低硬件规格适用于运行 EMQX 并进行简单的功能验证，推荐配置能够支撑 10 万客户端连接以及每秒 10 万条消息吞吐。

提示

在生产环境中，您可通过我们的配置估算计算器 (opens new window)来计算不同连接与消息吞吐下的推荐硬件规格。

文件和目录

EMQX 安装完成后会创建一些目录用来存放运行文件和配置文件，存储数据以及记录日志。

不同安装方式得到的文件和目录位置有所不同，具体如下:

提示

1. 压缩包解压安装时，目录相对于软件所在目录；
2. Docker 容器使用压缩包解压安装的方式，软件安装于 /opt/emqx 目录中；
3. data、log、plugins 目录可以通过配置文件设置，建议将 data 目录挂载至高性能磁盘以获得更好的性能。但对于属于同一集群的节点， data 目录的配置应该相同。更多关于集群的介绍，见集群章节。

接下来我们将详细介绍下其中的部分目录，其中包含的文件和子文件夹。

提示

EMQX 的配置项存储在 etc 和 data/configs 目录下，二者的主要区别是 etc 目录存储只读的配置文件，用户通过 Dashboard 和 REST API 提交的配置将被保存到 data/configs 目录下，并支持在运行时进行热更新。

• etc/emqx.conf
• data/configs/cluster.hocon

EMQX 读取这些配置并将其合并转化为 Erlang 原生配置文件格式，以便在运行时应用这些配置。