1、下载 https://www.emqx.io/cn/downloads#broker
查看centos版本的方法:
(1)、在centos桌面右键“打开终端”。或者用WinSCP客户端。
(2)、接着会弹出终端窗口。
(3)、在里面输入“cat /etc/redhat-release”命令。
(4)、回车后就可以输出centos系统的版本。
(5)、使用“uname -a”命令可以查看内核版本等信息。
2、解压缩 unzip emqx-centos7-4.2.5-x86_64.zip上传至服务器(可以用./bin/emqx start启动)。
2.1 另一种方式是采用命令行方式进行安装。
(1)、安装所需要的依赖包
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
(2)、使用以下命令设置稳定存储库,以 CentOS7 为例
$ sudo yum-config-manager --add-repo https://repos.emqx.io/emqx-ce/redhat/centos/7/emqx-ce.repo
(3)、安装最新版本的 EMQ X Broker
$ sudo yum install emqx
3、运行 emqx start
EMQ X 提供了 emqx
命令行工具,方便用户对 EMQ X 进行启动、关闭、进入控制台等操作。
emqx start
后台启动 EMQ X Broker;emqx stop
关闭 EMQ X Broker;emqx restart
重启 EMQ X Broker;emqx console
使用控制台启动 EMQ X Broker;emqx foreground
使用控制台启动 EMQ X Broker,与emqx console
不同,emqx foreground
不支持输入 Erlang 命令;emqx ping
Ping EMQ X Broker。
4、登录Web控制台,在浏览器打开http://127.0.0.1:18083,输入默认用户名“admin”和默认密码“public”,进入EMQ管理控制台。
用户可通过 Web 控制台,查看服务器运行状态、统计数据、客户端(Client)、会话(Session)、主题(Topic)、订阅(Subscription)、插件(Plugin)。
5、EMQ X 默认开启的 MQTT 服务 TCP 端口。(需要注意的是采用阿里云服务器,需要在防火墙中添加规则,放行以下端口。)
端口 | 说明 |
---|---|
1883 | MQTT 协议端口 |
8883 | MQTT/SSL 端口 |
8083 | MQTT/WebSocket 端口 |
8084 | MQTT/WebSocket/SSL 端口 |
8081 | 管理 API 端口 |
18083 | Dashboard 端口 |
6、EMQ X 其目录结构会有所不同,具体如下。
描述 | 使用 ZIP 压缩包安装 | 使用二进制包安装 |
---|---|---|
可执行文件目录 | ./bin |
/usr/lib/emqx/bin |
数据文件 | ./data |
/var/lib/emqx/data |
Erlang 虚拟机文件 | ./erts-* |
/usr/lib/emqx/erts-* |
配置文件目录 | ./etc |
/etc/emqx/etc |
依赖项目录 | ./lib |
/usr/lib/emqx/lib |
日志文件 | ./log |
/var/log/emqx |
启动相关的脚本、schema 文件 | ./releases |
/usr/lib/emqx/releases |
以上目录中,用户经常接触与使用的是 bin
、etc
、data
、log
目录。
文档参考:https://docs.emqx.cn/cn/broker/latest/
7、WebSocket ssl 配置,必须重启emqx。
上传证书。
修改emqx.conf文件。
设置wss listener.wss.external.keyfile = etc/certs/{你的域名}.key listener.wss.external.certfile = etc/certs/{你的域名}_public.crt 设置tcp的ssl listener.ssl.external.keyfile = etc/certs/{你的域名}.key listener.ssl.external.certfile = etc/certs/{你的域名}_public.crt