在 macOS 上安装 EMQX
本页将指导您如何通过 zip 包在 macOS 系统中下载安装并启动 EMQX。
支持的操作系统:
- macOS 14
- macOS 13
如果您想安装不同版本或在不同系统中安装,请访问 EMQX 开源版下载页面。
使用 Homebrew 安装 EMQX
Homebrew 是一个免费且开源的软件包管理系统,可简化在 macOS 上安装软件的过程。
如果你的 Mac 上还没有安装 Homebrew,可以在终端中运行以下命令来进行安装:
bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装 EMQX:
bashbrew install emqx
使用 Zip 软件包安装 EMQX
- 前往官方下载页面,选择 macOS 页签,选择 Package。
- 选择最新版本
5.8.0
,在安装包类型中根据需要的版本和 CPU 架构选择zip
安装包。 - 点击下方的下载链接。您也可以参照命令行指导步骤进行下载与安装。
启动和停止 EMQX
EMQX 可以以守护进程模式、前台模式或交互模式启动。请注意,默认情况下只能同时运行一个 EMQX 实例。
如果你使用 Homebrew 安装了 EMQX,请按照下面的指示使用 emqx
命令。如果你使用 zip 包安装了 EMQX,请使用 bin/emqx
(假设你在解压 emqx 文件的目录中)。
bash
# 以守护进程模式启动
emqx start
# 以前台模式启动
emqx foreground
# 以交互模式启动,使用 Erlang shell
emqx console
如果以前台模式或交互模式启动,启动成功后,EMQX 将输出以下消息:
bash
EMQX 5.8.0 is running now!
你可能还会看到一些警告消息,这些消息是为生产环境的操作者准备的,如果 EMQX 在本地环境进行测试、实验或客户端开发,可以忽略这些消息:
bash
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.0/etc/emqx.conf or override from environment variable EMQX_NODE__COOKIE
WARNING: NOTE: Use the same cookie for all nodes in the cluster.
你可以使用以下命令检查 EMQX 的状态:
bash
emqx ctl status
打开你的 Web 浏览器,在地址栏中输入 http://localhost:18083/
(localhost
可替换为你的 IP 地址)访问 EMQX Dashboard,从中你可以连接到客户端或查看运行状态。
默认的用户名和密码为 admin
和 public
。登录后,你将被要求更改默认密码。
要停止 EMQX:
- 如果以守护进程模式启动,使用
emqx stop
或bin/emqx stop
。 - 如果以前台模式启动,按下 Ctrl+C。
- 如果以交互模式启动,连续按下两次 Ctrl+C。