1、安装预设条件
EMQX 可以在 Linux、FreeBSD、MacOS 或 Windows 服务器甚至 Blueberry Pi 上跨平台运行。
服务器最低配置为512MB显存，并至少预留1GB硬盘空间。
2. 两补包安装
EMQ 官网提供流行 Linux 发行版、MacOS、Windows 操作系统和 Docker 镜像的补码包下载。 目前支持的操作系统和平台，请查看官网下载页面。
3.源码编译安装
一些官网未提供二进制补码包的操作系统和平台如LinuxARM、FreeBSB等可以使用源码编译安装。
EMQX 基于 Erlang/OTP 平台开发，由项目托管的 GitHub 进行管理和维护。 源码编译依赖Erlang环境和git客户端。
EMQX3.0+ 依赖于 ErlangR21+ 版本。
EMQXEnterprise 暂不提供源码编译和安装。 如果您有特殊运行环境要求debian系统源码编译环境，请联系 contact@emqx.io
4.首次安装EMQX
在安装 EMQX 之前，请确保满足安装先决条件。
版本选择
EMQX 支持多种操作系统，请选择适合您的版本下载。
1.Linux下安装
对于 Linux 发行版，EMQX 提供两种安装形式。 一种是基于各种Linux发布的安装包。 使用安装包安装 EMQX 后，您可以轻松使用系统管理工具来启动和停止 EMQX 服务。 第二种是使用zip压缩方式打包的通用包。 要安装 zip 包，只需解压 zip 文件即可。 您可以使用 zip 包在同一系统上安装多套 EMQX。 在开发/实验室环境中使用 zip 包安装 EMQX 非常实用。
CentOS/RHEL
目前 EMQX 支持 CentOS/RHEL6 和 7，这两个版本的安装过程是相同的。 以下安装过程以CentOS7为例。
使用zip包安装
解压 zip 文件
unzip emqx-centos7-v3.0.zip在控制台调试模式下启动 emqx，检查 EMQX 是否能够正常启动：
cd emqx && ./bin/emqx console如果安装成功，可以在控制台看到如下输出：
starting emqx on node 'emqx@127.0.0.1'emqx ctl is starting...[ok]emqx hook is starting...[ok]emqx router is starting...[ok]emqx pubsub is starting...[ok]emqx stats is starting...[ok]emqx metrics is starting...[ok]emqx pooler is starting...[ok]emqx trace is starting...[ok]emqx client manager is starting...[ok]emqx session manager is starting...[ok]emqx session supervisor is starting...[ok]emqx wsclient supervisor is starting...[ok]emqx broker is starting...[ok]emqx alarm is starting...[ok]emqx mod supervisor is starting...[ok]emqx bridge supervisor is starting...[ok]emqx access control is starting...[ok]emqx system monitor is starting...[ok]dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.mqtt:tcp listen on 0.0.0.0:1883 with 8 acceptors.mqtt:ssl listen on 0.0.0.0:8883 with 4 acceptors.mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.Erlang MQTT Broker 3.0 is running nowCTRL+C 关闭控制台。 以守护进程模式启动：
./bin/emqx start使用rpm包安装
CentOS 下使用 rpm 工具安装 EMQX：
rpm -ivh emqx-centos7-v3.0-beta.4.rpm安装完成后，EMQX 的配置文件、日志文件和数据文件位于以下目录： 系统配置文件：/etc/emqx/emqx.conf 插件配置文件：/etc/emqx/plugins/*。日志文件：/var/log/emqx 数据文件：/var/lib/emqx/
在命令行上启动和停止 EMQX：
systemctl start|stop|restart emqx.service乌班图
目前 EMQX 支持 Ubuntu12.04、14.04、16.04 和 18.04，这些版本上的安装过程是相同的。 以下安装过程以Ubuntu18.04为例。
使用zip包安装
解压 zip 文件
unzip emqx-ubuntu18.04-v3.0.zip在控制台调试模式下启动 emqx，检查 EMQX 是否能够正常启动：
cd emqx && ./bin/emqx console如果安装成功，可以在控制台看到如下输出：
starting emqx on node 'emqx@127.0.0.1'emqx ctl is starting...[ok]emqx hook is starting...[ok]emqx router is starting...[ok]emqx pubsub is starting...[ok]emqx stats is starting...[ok]emqx metrics is starting...[ok]emqx pooler is starting...[ok]emqx trace is starting...[ok]emqx client manager is starting...[ok]emqx session manager is starting...[ok]emqx session supervisor is starting...[ok]emqx wsclient supervisor is starting...[ok]emqx broker is starting...[ok]emqx alarm is starting...[ok]emqx mod supervisor is starting...[ok]emqx bridge supervisor is starting...[ok]emqx access control is starting...[ok]emqx system monitor is starting...[ok]dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.mqtt:tcp listen on 0.0.0.0:1883 with 8 acceptors.mqtt:ssl listen on 0.0.0.0:8883 with 4 acceptors.mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.Erlang MQTT Broker 3.0 is running nowCTRL+C 关闭控制台。 以守护进程模式启动：
./bin/emqx start使用 deb 包安装
sudo dpkg -i emqx-ubuntu18.04-v3.0_amd64.deb安装完成后，EMQX 的配置文件、日志文件和数据文件位于以下目录： 系统配置文件：/etc/emqx/emqx.conf 插件配置文件：/etc/emqx/plugins/*。日志文件：/var/log/emqx 数据文件：/var/lib/emqx/
在命令行上启动和停止 EMQX：
service emqx start|stop|restart德班
目前 EMQX 支持 Debian7、8 和 9，这些版本上的安装过程是相同的。 以下安装过程以Debian9为例。
使用zip包安装
解压 zip 文件
unzip emqx-debian9-v3.0.zip在控制台调试模式下启动 emqx，检查 EMQX 是否能够正常启动：
cd emqx && ./bin/emqx console如果安装成功，可以在控制台看到如下输出：
starting emqx on node 'emqx@127.0.0.1'emqx ctl is starting...[ok]emqx hook is starting...[ok]emqx router is starting...[ok]emqx pubsub is starting...[ok]emqx stats is starting...[ok]emqx metrics is starting...[ok]emqx pooler is starting...[ok]emqx trace is starting...[ok]emqx client manager is starting...[ok]emqx session manager is starting...[ok]emqx session supervisor is starting...[ok]emqx wsclient supervisor is starting...[ok]emqx broker is starting...[ok]emqx alarm is starting...[ok]emqx mod supervisor is starting...[ok]emqx bridge supervisor is starting...[ok]emqx access control is starting...[ok]emqx system monitor is starting...[ok]dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.mqtt:tcp listen on 0.0.0.0:1883 with 8 acceptors.mqtt:ssl listen on 0.0.0.0:8883 with 4 acceptors.mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.Erlang MQTT Broker 3.0 is running nowCTRL+C 关闭控制台。 以守护进程模式启动：
./bin/emqx start使用 deb 包安装
sudo dpkg -i emqx-debian9-v3.0_amd64.deb安装完成后，EMQX 的配置文件、日志文件和数据文件位于以下目录： 系统配置文件：/etc/emqx/emqx.conf 插件配置文件：/etc/emqx/plugins/*。日志文件：/var/log/emqx 数据文件：/var/lib/emqx/
在命令行上启动和停止 EMQX：
service emqx start|stop|restart2.MacOS下安装
目前 EMQX 在 MacOS 下提供 zip 包安装： 解压 zip 文件
unzip emqx-macos-v3.0.zip在控制台调试模式下启动 emqx，检查 EMQX 是否能够正常启动：
cd emqx && ./bin/emqx console如果安装成功，可以在控制台看到如下输出：
starting emqx on node 'emqx@127.0.0.1'emqx ctl is starting...[ok]emqx hook is starting...[ok]emqx router is starting...[ok]emqx pubsub is starting...[ok]emqx stats is starting...[ok]emqx metrics is starting...[ok]emqx pooler is starting...[ok]emqx trace is starting...[ok]emqx client manager is starting...[ok]emqx session manager is starting...[ok]emqx session supervisor is starting...[ok]emqx wsclient supervisor is starting...[ok]emqx broker is starting...[ok]emqx alarm is starting...[ok]emqx mod supervisor is starting...[ok]emqx bridge supervisor is starting...[ok]emqx access control is starting...[ok]emqx system monitor is starting...[ok]dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.mqtt:tcp listen on 0.0.0.0:1883 with 8 acceptors.mqtt:ssl listen on 0.0.0.0:8883 with 4 acceptors.mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.Erlang MQTT Broker 3.0 is running nowCTRL+C 关闭控制台。 以守护进程模式启动：
./bin/emqx start3. 在 Microsoft Windows 下安装
目前 EMQX 提供 Windows 下的 zip 包安装。 下载并解压程序包后，打开Windows命令行窗口并cd到程序目录。
以控制台模式启动：
binemqx console4. 在 Docker 中安装
解压emqxdocker镜像包：
unzip emqx-docker-v3.0.zip加载图像：
docker load < emqx-docker-v3.0启动容器：
docker run -tid --name emq30 -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx-docker-v3.0停止容器：
docker stop emq30打开容器：
docker start emq30进入 Docker 控制台：
docker exec -it emq30 /bin/sh5.使用源码安装
EMQX 消息服务器基于 Erlang/OTP 平台开发。 项目由GitHub管理和维护，源码编译依赖Erlang环境和git客户端。
本文中的以下说明适用于 Linux 环境。
git clone -b win30 https://github.com/emqx/emqx-rel.gitcd emqx-relx && makecd _rel/emqx && ./bin/emqx console编译成功后，包发布目录：
_rel/emqx从控制台启动程序：
复制代码cd _rel/emqx && ./bin/emqx console5. 首次运行 EMQX
安装后您可以直接运行 EMQX 来获得最初步的体验。 不仅在控制台，您还可以通过浏览器访问：18083 使用 EMQX Web 管理控制界面。 默认登录名是admin，密码是public。
通过浏览器访问：18083，您将看到 EMQX 登录界面：
输入用户名和密码后，您可以使用 EMQXDashboard 的各项功能。 首次登录后，您将看到 EMQX 控制台的信息摘要。 该页面显示系统信息、节点信息、运行统计信息以及一些统计指标。
您还可以在 EMQX 上进行一些简单的配置，使其适应您的操作环境和需求。
EMQX 的简单配置
EMQX 的所有配置都可以通过更改配置文件来完成。 配置文件位置：
修改仪表板界面语言
在 Web 界面上选择“管理”->“设置”菜单。 您可以更改仪表板使用的语言。 点击应用后即可生效。 目前 EMQX 支持英语和法语。
更改仪表板默认登录名和密码
Dashboard 插件以 Web 界面的形式为 EMQX 提供管理和控制功能。 它是随系统启动的 EMQX 默认插件之一。 安装后，您可以通过编辑配置文件来更改Dashboard的默认用户名和密码。 配置文件：
etc/plugins/emqx_dashboard.conf修改以下两行内容，将等号左边的值修改为需要的值：
dashboard.default_user.login = admindashboard.default_user.password = public或者通过网络管理仪表板用户。 在ADMIN->Users菜单下，您可以更改用户密码以及减少/删除用户。 admin用户只能修改密码，不能删除。
配置端口
安装后，EMQX 将默认使用以下端口：
如需更改合约端口，请编辑 EMQX 系统配置文件“etc/emqx.conf”，找到以下行，并根据需要更改端口号：
listener.tcp.external = 0.0.0.0:1883listener.ssl.external = 8883listener.ws.external = 8083如需更改 HTTP API 端口debian系统源码编译环境，请编辑 emqx_management 插件的配置文件“etc/plugins/emqx_management.conf”，找到以下行，根据需要更改端口号：
management.listener.http = 8080如需更改 Dashboard 管理控制台端口，请编辑 emqx_dashboard 插件的配置文件 etc/plugins/emqx_dashboard.conf，找到以下行，根据需要更改端口号：
dashboard.listener.http = 18083在WebDashboard的MANAGEMENT->Listeners菜单下，您可以查看当前正在使用的窃听器端口和属性。
启动/停止插件
插件是 EMQX 的重要组成部分，EMQX 的扩展功能基本都是通过插件来实现的。 包括Dashbard也是插件实现。 您可以通过软件附带的命令行工具 emqx_ctl 来启动和停止各个插件。
启动插件：
bin/emqx_ctl plugins load plugin_name停止插件：
bin/emqx_ctl plugins unload plugin_name您还可以在 Dashboard 的 MANAGEMENT->plugins 菜单下启动和停止插件，或者对插件进行简单的配置。
EMQX 的 Dashboard 本身也是一个插件。 如果您在 Web 界面中停止 Dashboard 插件，您将无法再使用仪表板，直到您使用命令行工具再次启动 Dashboard。
更改Erlang虚拟机启动参数
EMQX 运行在 Erlang 虚拟机上，etc/emqx.conf 中有两个限制，限制虚拟机允许的最大连接数。 这两个参数可以在运行 EMQX 之前更改以适应连接要求：
这两个参数可以设置为：
![编译驱动的内核源码-[OpenWrt] 使用SDK编译Linux内核驱动](https://www.wkzy.net/wp-content/themes/ceomax/timthumb.php?src=https://www.wkzy.net/wp-content/uploads/2024/04/1714318441748_1.png&h=200&w=300&zc=1&a=c&q=100&s=1)
