tencent cloud

消息队列 RabbitMQ 版

动态与公告
新功能发布记录
公告
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 RabbitMQ 版
产品优势
应用场景
开源托管版与 Serverless 版差异说明
开源版本支持说明
与开源 RabbitMQ 对比
高可用
使用限制
RabbitMQ 相关概念
开区地域
相关云服务
产品计费
计费概述
价格说明
计费示例
按小时付费转包年包月
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
步骤1:准备工作
步骤2:创建 RabbitMQ 集群
步骤3:配置 Vhost
步骤4:使用 SDK 收发消息
步骤5:查询消息
步骤6:销毁资源
用户指南
使用流程指引
配置账号权限
创建集群
配置 Vhost
连接集群
管理消息
配置高级特性
管理集群
查看监控和配置告警
实践教程
实践教程使用说明
RabbitMQ 客户端实践教程
RabbitMQ 消息可靠性实践教程
RabbitMQ 支持 MQTT 协议说明
迁移集群
迁移方案概述
步骤1:购买云上实例
步骤2:迁移元数据上云
步骤3:开启双读写
API 参考(开源托管版)
API 概览
API 参考(Serverless 版)
History
Introduction
API Category
Making API Requests
Relevant APIs for RabbitMQ Serverless PAAS Capacity
RabbitMQ Serverless Instance Management APIs
Data Types
Error Codes
SDK 文档
SDK 概述
Spring Boot Starter 接入
Spring Cloud Stream 接入
Java SDK
Go SDK
Python SDK
PHP SDK
安全与合规
权限管理
网络安全
删除保护
变更记录
云 API 审计
常见问题
服务等级协议
联系我们
文档消息队列 RabbitMQ 版用户指南连接集群为客户端接入点配置 TLS 加密

为客户端接入点配置 TLS 加密

PDF
聚焦模式
字号
最后更新时间: 2026-01-04 15:30:30
TDMQ RabbitMQ 版支持 TLS 加密功能,可以为集群绑定 SSL 证书,同时支持单向认证和双向认证模式。
当您为接入点开启加密后,将会使用 SSL 证书在客户端和服务端进行数据传输时对数据进行加密,防止数据在网络传输过程中被截取或者窃听,保障数据传输安全,满足敏感业务需求。

单向认证

单向认证由客户端认证服务端,客户端对服务端的认证通过服务端证书完成。服务端会使用您选择的证书和客户端建立连接。服务器证书需要您自行购买或自行签发后,托管到 SSL 证书,再在 RabbitMQ 控制台完成配置。

双向认证

双向认证指客户端与服务端之间相互认证。RabbitMQ 通过服务端证书和客户端 CA 证书完成服务端和客户端的认证,以保证客户端和服务端通信链路的安全及可靠。
客户端对服务端的认证通过服务端证书完成。
服务端对客户端的认证通过CA 证书完成。客户端发起连接请求时,会将设备证书传递到服务端,服务端将根据客户端提前注册的 CA 证书验证该设备证书的正确性,验证通过则允许客户端连接服务端。

约束与限制

仅开源托管版集群支持 TLS 加密功能。
已经开启加密的接入点不允许被直接删除,需要先关闭加密。
绑定 SSL 证书将涉及集群重启,建议先在控制台为集群配置多节点镜像队列后再进行绑定,避免在绑定证书过程中服务中断或数据丢失。具体步骤请参考配置镜像策略
证书绑定过程中,集群的状态为“变配中”,此时不允许进行其他变配操作。绑定完成后,集群状态将恢复正常。
由于 RabbitMQ 的底层限制,一个集群只能绑定一个服务端证书(单向认证),或者绑定一对服务端证书和 CA 证书(双向认证)。多个接入点的场景下,将使用集群绑定的证书进行加密。

配置 TLS 加密

前提条件

请先在 SSL 证书控制台完成自签名证书托管或购买证书。具体步骤请参考SSL 证书快速入门

步骤1:绑定 SSL 证书

2. 在左侧导航栏选择集群管理 > 集群列表,选择好地域后,单击目标集群的 ID,进入集群基本信息页面。
3. 在基本信息页面,选择证书管理页签,单击右上角的绑定证书
4. 在弹窗中配置认证方式和证书信息。
参数
说明
认证方式
支持单向认证双向认证两种方式。
单向认证:由客户端认证服务端。
双向认证:客户端与服务端相互认证。
证书来源
仅支持腾讯云托管的 SSL 证书。
说明:
如果您是第一次使用 RabbitMQ TLS 加密功能,需要点击授权 RabbitMQ 服务可以下载并应用 SSL 证书能力。
服务端证书
在下拉框中选择 SSL 证书,仅支持状态为“已颁发”的证书。服务端证书用于完成客户端对服务端的认证。
CA 证书
当认证方式选择双向认证时,需要在下拉框中选择 SSL 证书。CA 证书用于完成服务端对客户端的认证。

5. 单击提交,集群状态将变为“变配中”,等待3-5分钟后,集群将完成 SSL 证书绑定。


步骤2:为接入点开启加密

1. 在证书管理页面,选择客户端接入页签,单击目标接入点操作栏的 IP 转化为域名,在弹窗中点击确认,完成转换后会在网络列显示端口为5672的接入点
说明:
开启 TLS 加密,需要基于接入点域名操作,因此需要先将接入点的 IP 转化为域名。如果接入点本身已经是域名,则无需进行此操作。

2. IP 转化为域名后,单击接入点操作栏的开启加密。
3. 在弹窗中单击确定,开启完成后,会在网络列展示端口为 5671 加密接入点。


步骤3:使用加密的接入点收发消息

完成 TLS 加密配置后,您可以在客户端中使用加密的接入点(端口为5671)连接集群并收发消息。
具体介绍请参考使用 SDK 收发消息

关闭加密

当您不再需要使用 TLS 加密能力时,可以在控制台关闭加密。
2. 在左侧导航栏选择集群管理 > 集群列表,选择好地域后,单击目标集群的 ID,进入集群基本信息页面。
3. 在基本信息页面,选择客户端接入页签,单击目标接入点操作栏的关闭加密
4. 在弹窗中单击确定,完成关闭。

解绑证书

如果已经有任意一个接入点已开启加密,则证书无法被解绑,需要先将所有接入点加密关闭。
2. 在左侧导航栏选择集群管理 > 集群列表,选择好地域后,单击目标集群的 ID,进入集群基本信息页面。
3. 在基本信息页面,选择证书管理页签,单击右上角的解绑证书
4. 在弹窗中单击删除,集群状态将变为“变配中”,等待3-5分钟后,集群将解绑 SSL 证书。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈