文档中心
文档
备案
控制台
登录
立即注册
导航
云原生消息引擎
搜索目录或文档标题
搜索目录或文档标题
产品动态
新功能发布记录
产品计费
计费说明
续费说明
欠费或说明
退订或变配费用说明
代金券管理
BMQ 实例用户指南
BMQ 简介
什么是 BMQ
应用场景
实例规格
名词解释
地域和可用区
快速入门
创建 BMQ 资源
使用 Java SDK 收发消息
控制台指南
实例管理
实例生命周期管理
创建 BMQ 实例
查看 BMQ 实例详情
变更实例规格
删除 BMQ 实例
实例配置管理
切换子网和安全组
修改全局消息保留时长
实例连接管理
配置私网访问
修改私有网络
配置私网地址公网解析
配置公网访问
配置 DTS 访问
Topic 管理
创建 Topic
扩容 Topic 分区数
预览 Topic 数据
查看 Topic 详情
修改消息保留时长
删除 Topic
Group管理
创建 Group
重置消费位点
查看 Group 详情
删除 Group
消息查询
消息查询
下载消息
SASL 用户管理
创建 SASL 用户
配置用户 All Permitted 功能
查看 SASL 用户密码
删除 SASL 用户
ACL 管理
创建 ACL
删除 ACL
监控告警
查看监控数据
配置告警策略
最佳实践
Topic 单分区流量监测
通过函数服务消费云原生消息引擎 BMQ
消费者最佳实践
SDK参考
Java SDK
Go SDK
Python SDK
API 参考
开发前必读
API 概览
如何调用API
请求结构
公共参数
认证鉴权
返回结果
实例规格
ListSpecifications - 查询 BMQ 售卖规格列表
实例管理
CreateInstance - 创建实例
DeleteInstance - 删除实例
ModifyInstanceTag - 编辑实例标签
DescribeInstance - 查询实例详情
SearchInstances - 查询实例
UpdateInstanceMessageRetention - 修改实例消息保留时长
ListInstanceResourceStats - 查询多个实例资源
DescribeInstanceResourceStat - 查询单个实例资源
实例连接管理
EnableOverlayAccess - 开启私有网络访问
DisableOverlayAccess - 关闭私有网络访问
ModifyOverlayAccess - 修改私有网络
ListAvailableVPCForBMQ - 查询可用 VPC 列表
ListAvailableSecurityGroupsForBMQ - 查询可用安全组列表
EnablePublicAccess - 开启公网访问
DisablePublicAccess - 关闭公网访问
Topic 管理
CreateTopic - 创建 Topic
DeleteTopic - 删除 Topic
ScaleUpTopic - 扩容 Topic 分区数量
TopicExist - 判断 Topic 是否存在
DescribeTopic - 查询 Topic 详情
SearchTopics - 查询 Topic
DescribePartitionsInTopic - 查询 Topic 分区
DescribeGroupsInTopic - 查询订阅消费组列表
UpdateTopicMessageRetention - 修改 Topic 消息保留时长
PreviewTopicData - 预览 Topic 数据
DescribeTopicTimeRange - 查询 Topic 消息生产时间范围
Group 管理
CreateGroup - 创建消费组
DeleteGroup - 删除消费组
GroupExist - 判断消费组是否存在
DescribeGroup - 查询消费组详情
SearchGroups - 查询消费组列表
DescribeTopicsInGroup - 查询订阅 Topic 列表
DescribeSubscription - 查询订阅分区列表
ResetSubscriptionOffset - 重置消费位点
BMQ 常见问题
MQTT 实例用户指南
MQTT 简介
什么是 云原生消息引擎MQTT版
功能特性
名词解释
MQTT 扩容及升级风险须知
快速入门
MQTT 消息转发到 BMQ 实例
控制台指南
MQTT 实例管理
创建 MQTT 实例
查看 MQTT 实例信息
扩容 MQTT 实例
删除 MQTT 实例
监听器管理
添加公网监听器
添加私网监听器
删除监听器
用户管理
创建用户
编辑用户
修改用户密码
删除用户
API 密钥管理
创建 API 密钥
启停 API 密钥
编辑 API 密钥
删除 API 密钥
Dashboard指南
登录 Dashboard
监控
集群概览
客户端
订阅管理
保留消息
延迟发布
访问控制
客户端认证
客户端认证概述
创建客户端认证
创建 Password-Based 认证
创建 JWT 认证
创建 SCRAM 认证
管理客户端认证
用户管理
查看认证概览
客户端授权
客户端授权概述
创建客户端授权
管理客户端授权
配置内置数据库授权规则
查看授权概览
配置授权
黑名单
创建黑名单
删除黑名单
连接抖动
配置连接抖动
集成
Flow 设计器
创建 Flow
查看 Flow
规则
创建规则
管理规则
查看规则
连接器
创建连接器
管理连接器
管理
集群配置
MQTT 配置
日志
监控
MQTT 高级特性
主题重写
自动订阅
延迟发布
问题分析
主题监控
慢订阅
日志追踪
系统设置
审计日志
备份与恢复
最佳实践
快速开始-构建第一个mqtt连接
MQTTx CLI测试 EMQx
eMQTT-Bench 测试 EMQx
通过自动订阅实现 p2p 指令发布
设备状态汇报到 Kafka
导出 OpenTelemetry 数据
使用 RestAPI 修改集群状态
proxy protocol 协议透传
实时获取主题下丢弃的消息条数
遗嘱消息获取设备异常下线
从 EMQx v5 迁移到 MQTT 云服务
相关协议
云原生消息引擎(BMQ)服务等级协议
文档首页
/
云原生消息引擎
/
MQTT 实例用户指南
/
最佳实践
/
proxy protocol 协议透传
proxy protocol 协议透传
最近更新时间:2025.06.17 16:48:01
首次发布时间:2025.06.17 16:48:01
我的收藏
有用
有用
无用
无用
文档反馈
背景
如您使用 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】
【监听器】-【具体的监听器】-【代理协议】
true 代表开启 proxy protocol 协议
false 代表关闭 proxy protocol 协议
注意:修改 改配置会导致监听器重启,所连接的客户端会断连