使用Docker搭建MQTT服務器

1. 拉取鏡像

docker pull registry.cn-hangzhou.aliyuncs.com/synbop/emqttd:2.3.6

2. 運行鏡像

• –name 名字
• -p 18083 服務器啟動端口
• -p 1882 TCP端口
• -p 8083 WS端口
• -p 8084 WSS端口
• -p 8883 SSL端口
• -d 指定容器

docker run --name emq -p 18083:18083 -p 1883:1883 -p 8084:8084 -p 8883:8883 -p 8083:8083 -d registry.cn-hangzhou.aliyuncs.com/synbop/emqttd:2.3.6

3. 進入emq服務頁面

  在瀏覽器輸入機器IP:18083 就可以進入emqtt頁面

  初始的賬戶 admin, 密碼 public

4. 配置emq(對於V3.1.0)

  為emq的用戶配置權限 , emq還支持多種數據庫驗證, 包括 mongo, redis, pgsql 等等, 有興趣可以自行研究

# 進入容器, 不能用 /bin/bash 進入 docker exec -it emq /bin/sh 

• 1.首先先關閉匿名認證(默認是開啟的誰都能夠登錄)

# 編輯配置文件 vi /opt/emqttd/etc/emq.conf # 更改允許匿名 True -> false allow_anonymous = false 

• 2.建立用戶和權限的 mysql 表, 可以拉一個 mysql 容器, 也可以直接在你的 ubuntu 里的 mysql 中創建

CREATE DATABASE emq charset utf8; use eqm; CREATE TABLE mqtt_user ( id int(11) unsigned NOT NULL AUTO_INCREMENT, username varchar(100) DEFAULT NULL, password varchar(100) DEFAULT NULL, salt varchar(20) DEFAULT NULL, is_superuser tinyint(1) DEFAULT 0, created datetime DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY mqtt_username (username) ) ENGINE=MyISAM DEFAULT CHARSET=utf8; CREATE TABLE mqtt_acl ( id int(11) unsigned NOT NULL AUTO_INCREMENT, allow int(1) DEFAULT NULL COMMENT '0: deny, 1: allow', ipaddr varchar(60) DEFAULT NULL COMMENT 'IpAddress', username varchar(100) DEFAULT NULL COMMENT 'Username', clientid varchar(100) DEFAULT NULL COMMENT 'ClientId', access int(2) NOT NULL COMMENT '1: subscribe, 2: publish, 3: pubsub', topic varchar(100) NOT NULL DEFAULT '' COMMENT 'Topic Filter', PRIMARY KEY (id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; 

• 3.插入ACL規則 - ACL規則

   tips: !!! 不要直接按照下面的例子設置, 先查看ACL規則了解之后在根據自己情況進行配置

INSERT INTO `mqtt_acl` (`id`, `allow`, `ipaddr`, `username`, `clientid`, `access`, `topic`) VALUES (1,1,NULL,'$all',NULL,2,'#'), (2,0,NULL,'$all',NULL,1,'$SYS/#'), (3,0,NULL,'$all',NULL,1,'eq #'), (5,1,'127.0.0.1',NULL,NULL,2,'$SYS/#'), (6,1,'127.0.0.1',NULL,NULL,2,'#'), (7,1,NULL,'dashboard',NULL,1,'$SYS/#'); 

• 4.插入用戶, 由此開始訂閱與發布的 Client 都必須通過用戶驗證（sha256值請自行轉換）

# 可以配置超級管理員(超級管理員會無視ACL規則對所有的topic都有訂閱和推送的權限) insert into mqtt_user (`username`, `password`) values ('admin', '03ac674216f3e15c761ee1a5e255f067953623c8b388b4459e13f978d7c846f4'); update mqtt_user set is_superuser=1 where id= 超級管理員ID ; ps:注意 auth.mysql.password_hash(默認為sha256) 為sha256的話，新增用戶時需要手動傳遞加密后的值，plain的話則無需加密，明碼存放 

• 5.修改emq的mysql配置文件

vi /opt/emqttd/etc/plugins/emq_auth_mysql.conf
auth.mysql.server = 你的mysql-IP:3306 
auth.mysql.username = root 
auth.mysql.password = xxxxxxxx 
auth.mysql.database = emq

• 6.重啟emq

/opt/emqttd/bin/ emqx stop
/opt/emqttd/bin/ emqx start
/opt/emqttd/bin/emqttd_ctl plugins load emq_auth_mysql   #開啟mysql認證插件 

---

 ACL規則

  規則表字段說明：

• allow：禁止（0），允許（1）
• ipaddr：設置 IP 地址
• username：連接客戶端的用戶名，此處的值如果設置為 $all 表示該規則適用於所有的用戶
• clientid：連接客戶端的 Client ID
• access：允許的操作：訂閱（1），發布（2），訂閱發布都可以（3）
• topic：控制的主題，可以使用通配符，並且可以在主題中加入占位符來匹配客戶端信息，例如 t/%c則在匹配時主題將會替換為當前客戶端的 Client ID
  %u：用戶名
  %c：Client ID

  示例

-- 所有用戶不可以訂閱系統主題 INSERT INTO mqtt_acl (allow, ipaddr, username, clientid, access, topic) VALUES (0, NULL, '$all', NULL, 1, '$SYS/#'); -- 允許 10.59.1.100 上的客戶端訂閱系統主題 INSERT INTO mqtt_acl (allow, ipaddr, username, clientid, access, topic) VALUES (1, '10.59.1.100', NULL, NULL, 1, '$SYS/#'); -- 禁止客戶端訂閱 /smarthome/+/temperature 主題 INSERT INTO mqtt_acl (allow, ipaddr, username, clientid, access, topic) VALUES (0, NULL, NULL, NULL, 1, '/smarthome/+/temperature'); -- 允許客戶端訂閱包含自身 Client ID 的 /smarthome/${clientid}/temperature 主題 INSERT INTO mqtt_acl (allow, ipaddr, username, clientid, access, topic) VALUES (1, NULL, NULL, NULL, 1, '/smarthome/%c/temperature');