1、拉取 eclipse-mosquitto:2.0.14

[root@Tseng-HW ~]# docker pull eclipse-mosquitto:2.0.14
2.0.14: Pulling from library/eclipse-mosquitto
97518928ae5f: Already exists 
b491d2bad818: Pull complete 
1c67a7209b6c: Pull complete 
Digest: sha256:64b7c1729f7d1fff46b5e884fc389071686b2f7ed116c3fc7e17cbcb50fa147e
Status: Downloaded newer image for eclipse-mosquitto:2.0.14
docker.io/library/eclipse-mosquitto:2.0.14
[root@Tseng-HW ~]# docker images
REPOSITORY                                    TAG       IMAGE ID       CREATED         SIZE
eclipse-mosquitto                             2.0.14    457fe4154880   9 months ago    11.8MB
[root@Tseng-HW ~]# 

2、创建配置文件、数据文件、日志文件目录

[root@Tseng-HW ~]# mkdir -p /data/mosquitto/config
[root@Tseng-HW ~]# mkdir -p /data/mosquitto/data
[root@Tseng-HW ~]# mkdir -p /data/mosquitto/log
[root@Tseng-HW config]# cd /data/mosquitto/config/
-- 创建配置文件、创建密码文件
[root@Tseng-HW config]# vim mosquitto.conf
[root@Tseng-HW config]# vim userpass.conf
[root@Tseng-HW config]# ls
mosquitto.conf  userpass.conf

        mosquitto.conf 配置文件

listener 1883
persistence true
persistence_location /mosquitto/data/
log_dest file /mosquitto/log/mosquitto.log
password_file /mosquitto/config/userpass.conf
per_listener_settings false
allow_anonymous false

1. listener 1883:

   这一行指示 Mosquitto 在端口 1883 上监听 MQTT 连接请求。这是 MQTT 协议的标准端口，客户端通常会连接到这个端口与 MQTT 代理交互。如果您没有特别指定端口，客户端默认也会尝试连接到这个端口。

2. persistence true:

   此配置开启 Mosquitto 的持久化存储功能。当设置为 true 时，Mosquitto 会将未被客户端接收的消息保存到磁盘上。这样，即使 Mosquitto 服务重启，这些消息也不会丢失，而是会在服务恢复后继续发送给相应的订阅者。这对于确保消息可靠传输和防止消息丢失至关重要，特别是在处理重要通知、命令或状态更新等场景。

3. persistence_location /mosquitto/data/:

   这一行定义了 Mosquitto 用于存储持久化消息的目录。此处指定的路径是 /mosquitto/data/，意味着 Mosquitto 会在容器内部（如果是 Docker 容器）或宿主机（如果是直接安装）的相应目录下创建和管理持久化数据文件。确保该目录存在且具有足够的权限供 Mosquitto 写入。

4. log_dest file /mosquitto/log/mosquitto.log:

   这行配置指定了 Mosquitto 的日志输出目的地及文件路径。在这里，日志被定向到文件 /mosquitto/log/mosquitto.log。所有 Mosquitto 的运行日志、错误信息和其他诊断消息都将写入到这个文件中，便于管理员监控服务状态、排查问题或进行审计。
   

5. password_file /mosquitto/config/userpass.conf:

   这个配置告诉 Mosquitto 使用指定的密码文件 /mosquitto/config/userpass.conf 进行用户身份验证。密码文件通常包含用户名和经过哈希处理的密码对，用于限制客户端访问。只有在密码文件中注册的用户才能成功连接到 Mosquitto，并根据其配置的权限进行发布或订阅操作。启用此配置可以增强 MQTT 服务的安全性，防止未经授权的访问。

6. per_listener_settings false:

   此配置项指示 Mosquitto 是否为每个监听器（listener）单独应用特定的设置。当设置为 false 时，所有监听器共享相同的全局设置，如用户认证、ACL（访问控制列表）、持久化存储等。如果设置为 true，则可以为不同的监听器配置不同的认证方式、权限规则等。此处设为 false 表示所有监听器（如上面定义的 1883 端口）使用相同的认证、权限等设置。

7. allow_anonymous false:

   这个配置禁止 Mosquitto 接受匿名（未经身份验证）的连接请求。当设置为 false 时，所有试图连接到 Mosquitto 的客户端必须提供有效的用户名和密码（通过 password_file 配置的文件进行验证），否则连接请求将被拒绝。可以防止未经授权的设备或客户端访问 MQTT 服务。

3、启动容器

[root@Tseng-HW mosquitto]# docker run -d --name eclipse-mosquitto -v /data/mosquitto/config/mosquitto.conf:/mosquitto/config/mosquitto.conf -v /data/mosquitto/config/userpass.conf:/mosquitto/config/userpass.conf -v /data/mosquitto/data:/mosquitto/data -v /data/mosquitto/log:/mosquitto/log -p 20011:1883 eclipse-mosquitto:2.0.14
68ab8f107a90dfc4943258a45b550379474b769a2228ddab4a26547c605dbe85
[root@Tseng-HW mosquitto]# docker ps
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS         PORTS                                         NAMES
68ab8f107a90   eclipse-mosquitto:2.0.14   "/docker-entrypoint.…"   11 seconds ago   Up 9 seconds   0.0.0.0:20011->1883/tcp, :::20011->1883/tcp   eclipse-mosquitto
[root@Tseng-HW mosquitto]#

4、进入容器，设置密码（设置密码成功后，重启容器），注意密码长度，长度过长可能会失败

[root@Tseng-HW mosquitto]# docker ps
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS          PORTS                                         NAMES
68ab8f107a90   eclipse-mosquitto:2.0.14   "/docker-entrypoint.…"   13 minutes ago   Up 13 minutes   0.0.0.0:20011->1883/tcp, :::20011->1883/tcp   eclipse-mosquitto
[root@Tseng-HW mosquitto]# docker exec -it 68ab sh
/ # mosquitto_passwd -b mosquitto/config/userpass.conf tseng Tseng@2022
/ # exit
[root@Tseng-HW mosquitto]# cat /data/mosquitto/config/userpass.conf 
tseng:$7$101$LGsXChp3eUUNBiPx$D0ctHVj46/Qv0EcM1VOOUxCsxA1K3Gj27sppnndaOJYg21NUmUXK9M6a2OKe8sCHGodkZNC7nKliLp9esNrXyg==
[root@Tseng-HW mosquitto]# docker restart 68ab
68ab
[root@Tseng-HW mosquitto]# 

        添加新用户、删除用户，操作后重启容器

[root@Tseng-HW ~]# docker exec -it 68ab sh
/ # cat /mosquitto/config/userpass.conf 
tseng:$7$101$ZJyWnsIKF4k4v6xs$Jf3oKACgopIpjxSMnPDHlynMOa5h5F8AZjIsCO4Aly9QbVDedlzpYgqaMdOQBUSCtpP07neJyWTDjNKquQkhhg==
# 添加新用户
/ # mosquitto_passwd -b mosquitto/config/userpass.conf tseng1 tseng#2023
/ # mosquitto_passwd -b mosquitto/config/userpass.conf tseng2 tseng#2023
/ # cat /mosquitto/config/userpass.conf 
tseng:$7$101$ZJyWnsIKF4k4v6xs$Jf3oKACgopIpjxSMnPDHlynMOa5h5F8AZjIsCO4Aly9QbVDedlzpYgqaMdOQBUSCtpP07neJyWTDjNKquQkhhg==
tseng1:$7$101$WCEf4zBR7JkVZD9F$zCYCjnNJmqIs8Y47s7iSE/jldoFOt7ZwbEEotwdlCDvx4T7U/tmH83kOHrBMc3HFyXLhiGHMfIIk4tkduPo38Q==
tseng2:$7$101$4CqD7hUZSeZWx34/$+/QQNmt0mRwbFh7Dbd9eLDHMmPhqzs9Jd2P8uddOgjB9kb4TxvMKmXvKe7wNycXkJDiN4dh4gw5efI8Q+IZIUg==
## 删除用户
/ # mosquitto_passwd -D mosquitto/config/userpass.conf tseng2
/ # cat /mosquitto/config/userpass.conf 
tseng:$7$101$ZJyWnsIKF4k4v6xs$Jf3oKACgopIpjxSMnPDHlynMOa5h5F8AZjIsCO4Aly9QbVDedlzpYgqaMdOQBUSCtpP07neJyWTDjNKquQkhhg==
tseng1:$7$101$WCEf4zBR7JkVZD9F$zCYCjnNJmqIs8Y47s7iSE/jldoFOt7ZwbEEotwdlCDvx4T7U/tmH83kOHrBMc3HFyXLhiGHMfIIk4tkduPo38Q==
/ # 

5、测试（使用MQTTX测试）

       注意：开启MQTT的端口

    MQTTX下载地址：MQTT X：跨平台 MQTT 5.0 桌面客户端工具

 5.1 添加订阅

5.2 发送消息