macOS

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

支持的操作系统：

• macOS 13 （只适用于 Homebrew 安装包）
• macOS 12

使用 Homebrew 安装 EMQX

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

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

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

2. 安装 EMQX：

   bashCopy code
   brew install emqx

使用 Zip 软件包安装 EMQX

1. 下载 适用于你的操作系统和架构的 EMQX 软件包。这是适用于搭载 macOS 12（Monterey）和 Apple Silicon 的 Mac 电脑的 zip 软件包的链接：

   wget https://www.emqx.com/zh/downloads/broker/5.6.1/emqx-5.6.1-macos12-arm64.zi

2. 安装 EMQX。

   mkdir -p emqx && unzip emqx-5.6.1-macos12-arm64.zip -d emqx

启动和停止 EMQX

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

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

# 以守护进程模式启动
emqx start

# 以前台模式启动
emqx foreground

# 以交互模式启动，使用 Erlang shell
emqx console

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

EMQX 5.6.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.
WARNING: Configure node.cookie in /opt/homebrew/Cellar/emqx/5.6.1/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。