文档中心

云原生消息引擎

请输入

最佳实践

Proxy Protocol 协议透传

如您使用 Nginx、HA proxy、火山引擎 NLB 等产品做为代理产品，设置解析到内网的 TCP 接入点的情况下，依然有拿到源 IP 的诉求，可以在代理层配置 Proxy Protocol。在代理层配置 Proxy Protocol 后，因为 Proxy Protocol 协议会修改原始报文，故需要同步在 MQTT 产品中设置对 Proxy Protocol 的解析能力。本文阐述如何在 MQTT 产品中修改代理协议。

架构说明

约束限制

消息队列 MQTT 版支持 PPv1 和 PPv2，可以自动识别并解析 PPv1 和 PPv2 协议。

Nginx 开源版通常只支持 PPv1，如希望使用 PPv2，请使用其他产品。

HA proxy 支持 PPv2。

火山引擎 NLB 支持 PPv2。

操作步骤

详细操作请参见登录 Dashboard。

在导航栏选择管理 > 集群配置 > 监听器，单击待修改的监听器名称。

在代理协议下拉菜单中，选择开启或关闭 Proxy Protocol 协议。

true：代表开启 Proxy Protocol 协议

false：代表关闭 Proxy Protocol 协议

注意

修改配置会导致监听器重启，所连接的客户端会断连，请谨慎操作。

最近更新时间：2025.08.04 17:30:06

这个页面对您有帮助吗？

有用

无用