Apache不直接支持MQTT，但可通过mod_proxy_wstunnel代理MQTT over WebSocket流量；需后端Broker启用WebSocket监听，并在Apache中配置ProxyPass映射/ws路径、透传Upgrade/Connection头且设置足够超时。
apache 本身不直接支持 mqtt 协议，但可以代理 mqtt over websocket（即运行在 websocket 连接之上的 mqtt 流量），前提是后端服务（如 apache activemq artemis、emqx、mosquitto 等）已启用 websocket 接受器，并将 mqtt 封装在标准 http upgrade 流程中。
确认后端已暴露 MQTT over WebSocket 端点
这是前提——Apache 只负责反向代理，不解析或转换 MQTT 协议。你需要先确保消息中间件已正确配置 WebSocket 接受器：
- ActiveMQ Artemis 示例：在
broker.xml中添加接受器：<acceptor name="ws">tcp://0.0.0.0:61614?protocols=MQTT&useWebSocket=true</acceptor> - EMQX 默认开启
ws://<host>:8083/mqtt和wss://<host>:8084/mqtt - Mosquitto 需启用
listener 8083 0.0.0.0 ws并编译时支持 WebSocket
验证方式：用浏览器控制台执行 new WebSocket("ws://your-server:61614") 或使用 MQTT.js 连接 mqtt://...?protocol=ws，确认能完成 Upgrade 握手并收发消息。
启用 Apache 必需模块
Apache 不靠新增模块来“理解”MQTT，而是复用 mod_proxy_wstunnel 透传 WebSocket 流量。必须启用：
-
mod_proxy（基础代理框架） -
mod_proxy_http（mod_proxy_wstunnel的依赖） -
mod_proxy_wstunnel（唯一能识别Upgrade: websocket并建立隧道的模块）
Ubuntu/Debian 执行：sudo a2enmod proxy proxy_http proxy_wstunnel && sudo systemctl restart apache2
CentOS/RHEL 检查 httpd.conf 中三行未被注释：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
LoadModule proxy_module modules/mod_proxy.so<br>LoadModule proxy_http_module modules/mod_proxy_http.so<br>LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
配置 ProxyPass 映射 WebSocket 路径
在 <VirtualHost> 块中，用 ws:// 或 wss:// 前缀指向后端 MQTT WebSocket 端点：
- 若后端监听
ws://127.0.0.1:61614（无 TLS 终止）：ProxyPass "/mqtt" "ws://127.0.0.1:61614/" - 若前端是 HTTPS 站点，且希望 Apache 终止 TLS（WSS → WS）：
ProxyPass "/mqtt" "ws://127.0.0.1:61614/"（仍写ws://，不是wss://） - 路径需与后端实际 WebSocket 路由一致（例如 EMQX 默认用
/mqtt，Artemis 默认无路径，直接根路径）
⚠️ 注意顺序：WebSocket 规则必须放在通用 ProxyPass / 之前，否则会被 HTTP 代理规则提前截获。
关键参数与头信息透传
避免握手失败或连接静默断开：
- 同步设置超时：
Timeout 3600<br>ProxyTimeout 3600
（默认 60 秒会主动关闭空闲 WebSocket 连接） - 强制透传协议升级头：
RequestHeader set Upgrade "websocket"<br>RequestHeader set Connection "upgrade"
- 禁用可能清洗 hop-by-hop 头的模块（如
mod_security对Upgrade的拦截）
完整示例（HTTPS 站点）：
<VirtualHost *:443><br> ServerName mqtt.example.com<br> SSLEngine on<br> SSLCertificateFile /etc/ssl/certs/fullchain.pem<br> SSLCertificateKeyFile /etc/ssl/private/privkey.pem<br><br> Timeout 3600<br> ProxyTimeout 3600<br><br> RequestHeader set Upgrade "websocket"<br> RequestHeader set Connection "upgrade"<br><br> ProxyPass "/mqtt" "ws://127.0.0.1:61614/"<br> ProxyPassReverse "/mqtt" "ws://127.0.0.1:61614/"<br></VirtualHost>
