在 macOS 上安装 EMQX ​

本页将指导您如何通过 zip 包在 macOS 系统中下载安装并启动 EMQX。

支持的操作系统：

• macOS 14
• macOS 13

如果您想安装不同版本或在不同系统中安装，请访问 EMQX 开源版下载页面 。

使用 Homebrew 安装 EMQX ​

Homebrew 是一个免费且开源的软件包管理系统，可简化在 macOS 上安装软件的过程。

1. 如果你的 Mac 上还没有安装 Homebrew，可以在终端中运行以下命令来进行安装：

   bash

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 EMQX：

   bash

   brew install emqx

使用 Zip 软件包安装 EMQX ​

1. 前往官方下载页面，选择 macOS 页签 ，选择 Package 。
2. 选择最新版本 5.8.1 ，在 安装包类型 中根据需要的版本和 CPU 架构选择 zip 安装包。
3. 点击下方的下载链接。您也可以参照命令行指导步骤进行下载与安装。

启动和停止 EMQX ​

EMQX 可以以守护进程模式、前台模式或交互模式启动。请注意，默认情况下只能同时运行一个 EMQX 实例。

如果你使用 Homebrew 安装了 EMQX，请按照下面的指示使用 emqx 命令。如果你使用 zip 包安装了 EMQX，请使用 bin/emqx （假设你在解压 emqx 文件的目录中）。

# 以守护进程模式启动
emqx start
# 以前台模式启动
emqx foreground
# 以交互模式启动，使用 Erlang shell
emqx console

如果以前台模式或交互模式启动，启动成功后，EMQX 将输出以下消息：

EMQX 5.8.1 is running now!

你可能还会看到一些警告消息，这些消息是为生产环境的操作者准备的，如果 EMQX 在本地环境进行测试、实验或客户端开发，可以忽略这些消息：

ERROR: DB Backend is RLOG, but an incompatible OTP version has been detected. Falling back to using Mnesia DB backend.
WARNING: ulimit -n is 256; 1024 is the recommended minimum.
WARNING: Default (insecure) Erlang cookie is in use.