# macOS

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

支持的操作系统：

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

# 使用 Homebrew 安装 EMQX

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

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

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

1
2

安装 EMQX：
```
bashCopy code
brew install emqx
```
1
2

# 使用 Zip 软件包安装 EMQX

下载适用于你的操作系统和架构的 EMQX 软件包 (opens new window)。这是适用于搭载 macOS 12（Monterey）和 Apple Silicon 的 Mac 电脑的 zip 软件包的链接：
```
wget https://www.emqx.com/zh/downloads/broker/5.2.1/emqx-5.2.1-macos12-arm64.zi
```
1

安装 EMQX。

mkdir -p emqx && unzip emqx-5.2.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

1
2
3
4
5
6
7
8

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

EMQX 5.2.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.2.1/etc/emqx.conf or override from environment variable EMQX_NODE__COOKIE
WARNING: NOTE: Use the same cookie for all nodes in the cluster.

1
2
3
4
5

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

emqx ctl status

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

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

要停止 EMQX：

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

← CentOS/RHEL Kubernetes (opens new window) →