dufourc1/emqx

EMQX v4.21 Docker镜像（含emqx-auth-http插件自定义仓库）

镜像概述

本镜像基于EMQX v4.21版本构建，集成了用于emqx-auth-http插件的自定义仓库，提供高性能MQTT消息服务器功能的同时，支持通过HTTP接口实现灵活的认证与授权逻辑。EMQX作为开源MQTT broker，具备高并发处理能力，而emqx-auth-http插件可与外部HTTP服务集成，实现用户认证与权限控制。

核心功能与特性

• 完整MQTT服务：支持MQTT 3.1.1/5.0协议，提供1883(TCP)、8883(SSL)、8083(WebSocket)等标准端口服务
• emqx-auth-http插件集成：通过自定义仓库实现插件快速安装与启用，无需额外配置依赖源
• HTTP认证授权：支持通过HTTP接口与外部系统（如用户数据库、认证服务）集成，实现动态认证与权限管理
• 灵活配置：支持自定义HTTP请求URL、方法(GET/POST)、请求参数映射及超时设置
• 容器化部署：简化环境依赖管理，支持快速启动与扩展

使用场景

• 需要与现有HTTP认证系统（如OAuth2、企业用户管理系统）集成的MQTT服务
• 需实现动态用户认证、细粒度权限控制的物联网平台
• 开发/测试环境中快速搭建带HTTP认证功能的EMQX服务
• 企业级MQTT部署中需灵活扩展认证逻辑的场景

使用方法

基础启动命令

bash
docker run -d --name emqx \
  -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 \
  emqx:v4.21-custom-auth-http

启用emqx-auth-http插件

容器启动后，通过命令行或管理控制台启用插件：

bash
# 进入容器
docker exec -it emqx /bin/sh

# 启用插件
emqx_ctl plugins load emqx_auth_http

配置插件

配置文件方式

创建emqx_auth_http.conf配置文件，示例内容：

ini
## 认证请求配置
auth.http.auth_req.url = http://your-auth-service/auth
auth.http.auth_req.method = post
auth.http.auth_req.content_type = application/x-www-form-urlencoded
auth.http.auth_req.params = clientid=${clientid},username=${username},password=${password}

## 授权请求配置
auth.http.acl_req.url = http://your-auth-service/acl
auth.http.acl_req.method = get
auth.http.acl_req.params = clientid=${clientid},username=${username},topic=${topic},action=${action}

## 超时设置
auth.http.timeout = 5000

挂载配置文件启动：

bash
docker run -d --name emqx \
  -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 \
  -v $(pwd)/emqx_auth_http.conf:/opt/emqx/etc/plugins/emqx_auth_http.conf \
  emqx:v4.21-custom-auth-http

环境变量方式

通过环境变量设置核心配置：

bash
docker run -d --name emqx \
  -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 \
  -e AUTH_HTTP_AUTH_REQ_URL="http://your-auth-service/auth" \
  -e AUTH_HTTP_AUTH_REQ_METHOD="post" \
  -e AUTH_HTTP_ACL_REQ_URL="http://your-auth-service/acl" \
  emqx:v4.21-custom-auth-http

验证插件状态

bash
# 查看插件状态
docker exec -it emqx emqx_ctl plugins list | grep emqx_auth_http

配置参数说明

注意事项

• 确保外部认证服务与容器网络连通，可通过--network参数配置Docker网络
• 生产环境建议启用HTTPS，设置auth.http.ssl = true并配置SSL证书
• 高并发场景下需调整EMQX性能参数，可通过挂载emqx.conf配置文件实现
• 管理控制台默认地址：http://localhost:***，默认账号：admin，密码：public，建议首次登录后修改密码