在 macOS 上安装 EMQX

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

支持的操作系统：

• macOS 14
• macOS 13

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

使用 Homebrew 安装 EMQX

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

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

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

2. 安装 EMQX：

   brew install emqx

使用 Zip 软件包安装 EMQX

1. 前往官方下载页面，选择 macOS 页签，选择 Package。
2. 选择最新版本 5.8.3，在安装包类型中根据需要的版本和 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.3 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.
WARNING: Configure node.cookie in /opt/homebrew/Cellar/emqx/5.8.3/etc/emqx.conf or override from environment variable EMQX_NODE__COOKIE
WARNING: NOTE: Use the same cookie for all nodes in the cluster.

你可以使用以下命令检查 EMQX 的状态：

emqx ctl status

打开你的 Web 浏览器，在地址栏中输入 http://localhost:18083/（localhost 可替换为你的 IP 地址）访问 EMQX Dashboard，从中你可以连接到客户端或查看运行状态。

默认的用户名和密码为 admin 和 public。登录后，你将被要求更改默认密码。

要停止 EMQX：

• 如果以守护进程模式启动，使用 emqx stop 或 bin/emqx stop。
• 如果以前台模式启动，按下 Ctrl+C。
• 如果以交互模式启动，连续按下两次 Ctrl+C。