在 Linux 上安装 EMQX Edge

本页指导你在 Linux 系统上安装 EMQX Edge。你可以使用以下方式之一安装 EMQX Edge：

• 通过脚本安装：最快的上手方式。单个 curl 命令即可自动下载并安装最新 EMQX Edge 版本。
• 通过安装包安装：手动下载并解压安装包，可完全控制版本和安装位置。

通过脚本安装

安装脚本会自动检测系统架构、下载最新 EMQX Edge 版本、校验 checksum，并安装到 /opt/emqx-edge。

运行以下命令：

curl -fsSL emqx.sh/edge | bash

安装完成后，启动 EMQX Edge：

source /etc/profile.d/emqx-edge.sh && emqx-edge start

注意： 该脚本仅适用于 Linux。它要求已安装 curl、unzip、grep 和 awk，并且需要 sudo 权限写入 /opt/emqx-edge 和 /etc/profile.d/。

安装指定版本

要安装指定版本，请设置 EMQX_VERSION 环境变量：

curl -fsSL emqx.sh/edge | EMQX_VERSION=<version> bash

自定义安装目录

要修改安装目录，请设置 INSTALL_DIR 环境变量：

curl -fsSL emqx.sh/edge | INSTALL_DIR=/custom/path bash

通过安装包安装

访问 EMQX Edge 下载页面获取适合系统架构的 Linux 安装包。

安装示例（arm64）

以下步骤演示如何在 arm64 设备上安装 EMQX Edge。请将 <version> 替换为你下载的版本。

1. 解压安装包：

   unzip ./emqx-edge-<version>-linux-arm64.zip

2. 进入解压后的目录，并启动 EMQX Edge：

   ./emqx-edge start

访问 EMQX Edge Dashboard

EMQX Edge 内置基于 Web 的 Dashboard，可用于监控系统状态、管理配置和配置所需功能。

1. 打开浏览器并访问 http://localhost:8081（可将 localhost 替换为你的 IP 地址）。
2. 使用默认凭据登录 EMQX Edge Dashboard：
   • Username：admin
   • Password：public