Docker-EMQX(MQTT服务器)

[EMQX](https://www.emqx.com/zh/try?product=enterprise) 物联网 MQTT 消息服务器，高效可靠连接海量物联网设备

**相关链接：**
- EMQX：https://www.emqx.com/zh/try?product=enterprise
- EMQX_Doc：https://docs.emqx.cn/broker/v4.3/getting-started/install.html
  - 端口/目录解释：https://docs.emqx.com/zh/emqx/latest/deploy/install.html
  - 命令行：https://docs.emqx.com/zh/emqx/latest/admin/cli.html

# [Docker 安装](https://www.emqx.com/zh/try?product=broker)

```bash
docker run -d --name emqx -p 1883:1883 -p 8081:8081 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx
```
管理后台：`http://[IP]:18083`
默认帐号：`admin`		默认密码：`public`

## [登录认证](https://www.emqx.io/docs/zh/v4.3/advanced/auth.html)
安装默认是开启了 **匿名登录** 的，任何人都可以白嫖服务器
```bash
docker exec -it emqx bash		# 进入容器
	vi /opt/emqx/etc/emqx.config		# 编辑 emqx 配置文件
		allow_anonymous = false		# 设置不允许匿名登录
```
修改后需要重启服务

**`clientid认证` 和 `username认证`**
- clientid认证，登录时使用 client id+密码 进行登录，无需用户名
- username认证，登录时使用 用户名+密码 进行登录，无需 client id

### [Mnesia 认证](https://www.emqx.io/docs/zh/v4.3/advanced/auth-mnesia.html)
EMQX Web——插件——启用 `emqx_auth_mnesia` 插件

#### 预设认证数据
```bash
vi /opt/emqx/etc/plugins/emqx_auth_mnesia.conf		# 编辑 Mnesia 配置
	auth.mnesia.password_hash = plain		# 改成明文密码
	# 也可不改，但是存储的密码就必须转换成相应的密文才有效

# 选择你所需的方式进行添加认证
	## clientid 认证数据(客户id+密码登录)
	auth.client.1.clientid = admin
	auth.client.1.password = public

## username 认证数据(用户名+密码登录)
	auth.user.2.username = admin
	auth.user.2.password = public
```
修改后重新启用该插件

#### [使用 HTTP API 管理认证数据](https://www.emqx.io/docs/zh/v4.3/advanced/auth-mnesia.html#%E4%BD%BF%E7%94%A8-http-api-%E7%AE%A1%E7%90%86%E8%AE%A4%E8%AF%81%E6%95%B0%E6%8D%AE)
`API 使用的账户并非 WEB登录的账户`
在 EMQX Web——通用——应用——新建APP 进行添加
App ID就是账户，App密钥就是密码(生成的)
> EMQX默认 API端口:`8081`，账户密码：`admin`:`public`，认证方式：`Basic auth`
> 使用时带上完整链接，如： `nas.918178.xyz:8081/api/v4/auth_clientid`
> 可以使用 [Apipost](https://v7.apipost.cn/#/apis/run) 进行在线调试
```JSON
/*
注意，clientid 和 username 认证只需更换相应名称即可
下面我会已 username 为主进行列举
遇到带有 auth_username 的替换成 auth_clientid，就可以使用 clientid 的了
*/
// 批量添加认证
POST api/v4/auth_username
[
    {
		"username": "emqx_1",
		"password": "emqx"
    },
    {
		"username": "emqx_2",
		"password": "emqx"
    }
]

// 查看已添加认证
GET api/v4/auth_username

// 更改认证
PUT api/v4/auth_username/<你需要更改的 username 名称>
{
    "password": "emqx_new"
}

// 删除指定的认证数据
DELETE api/v4/auth_username/<你需要删除的 username 名称>
```

### [MySQL 认证](https://www.emqx.io/docs/zh/v4.3/advanced/auth-mysql.html)
EMQX Web——插件——启用 `emqx_auth_mysql` 插件，`配置完成后再启用，不然会报错`

#### 配置链接数据库
```bash
vi /opt/emqx/etc/plugins/emqx_auth_mysql.conf		# 编辑 MySQL 配置
	auth.mysql.password_hash = plain		# 改成明文密码
	# 也可不改，但是存储的密码就必须转换成相应的密文才有效

auth.mysql.server = 127.0.0.1:3306		# 数据库服务器地址，兼容 MariaDB
	auth.mysql.pool = 8		# 连接池大小
	auth.mysql.username = emqx		# 数据库/服务器账户，推荐使用数据库账户
	auth.mysql.password = public		# 数据库/服务器密码
	auth.mysql.database = mqtt		# 链接的数据库名
	auth.mysql.query_timeout = 5s		# 查询超时
```

#### 创建EMQX数据库 `v4.3`
```myqsl
mysql -uroot -p		# 登录 MySQL 数据库
CREATE DATABASE mqtt;		# 创建名为 mqtt 的数据库
USE mqtt;		# 选中 mqtt 数据库(只有选中才能操作)

## 新建名为 mqtt_user 的表单
CREATE TABLE `mqtt_user` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `username` varchar(100) DEFAULT NULL,
  `password` varchar(100) DEFAULT NULL,
  `salt` varchar(35) DEFAULT NULL,
  `is_superuser` tinyint(1) DEFAULT 0,
  `created` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `mqtt_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

## 试着往表单中添加一个用户
INSERT INTO `mqtt_user` ( `username`, `password`, `salt`)
VALUES
	('emqx', '123456', NULL);
# 注意如果开启sha256加密，那么输入的密码也应加密
```

# [Linux 安装](https://www.emqx.com/zh/try?product=broker)
解决 Docker版 容易出现重启后，创建的账号丢失问题
这里使用的是 `Debian11` 来运行的
```bash
wget https://www.emqx.com/zh/downloads/broker/5.0.9/emqx-5.0.9-debian11-amd64.deb		# 下载 emqx包
sudo apt install ./emqx-5.0.9-debian11-amd64.deb		# 使用本地包进行安装
sudo systemctl start emqx		# 启动 emqx 服务
sudo systemctl enable emqx		# 设置为自启动
```

# MQTT软件
[MQTTX](https://github.com/emqx/MQTTX/releases)，EMQ家的软件
MQTT Dashboard，安卓端