Skip to content

macOS

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

支持的操作系统:

  • macOS 13 (只适用于 Homebrew 安装包)
  • macOS 12

安装 EMQX

  1. 前往 EMQX 官方下载页面

  2. 下载 EMQX Enterprise 中,版本选择 5.6.1系统选择 macOS,点击免费下载按钮。

  3. 在安装与下载页面中,安装方式选择 zip,选择合适的 CPU 架构,点击立即下载

    您也可以参照命令行指导步骤进行下载与安装。

启动和停止 EMQX

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

bash
# 以守护进程模式启动
./bin/emqx start

# 以前台模式启动
./bin/emqx foreground

# 以交互模式启动,带有 Erlang shell
./bin/emqx console

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

bash
EMQX Enterprise 5.6.1 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 /path/to/emqx/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
./bin/emqx ctl status

打开您的网页浏览器,在地址栏中输入 http://localhost:18083/localhost 可替换为您的 IP 地址)访问 EMQX Dashboard,您可以在控制台中连接客户端或检查运行状态。

默认的用户名和密码为 adminpublic。登录后,系统将提示您修改默认密码。

要停止 EMQX:

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