tencent cloud

消息队列 MQTT 版

动态与公告
新功能发布记录
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 MQTT 版
应用场景
技术架构
产品系列
MQTT 协议兼容说明
开源对比
高可用
产品约束与使用配额
基本概念
开服地域
购买指南
计费概述
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
准备工作
公网接入
VPC 网络接入
用户指南
使用流程指引
配置账号权限
新建集群
管理 Topic
连接集群
查询消息
管理客户端
管理集群
查看监控和配置告警
数据集成
集成数据到云函数 SCF
集成数据到 CKafka
集成数据到 RocketMQ
开发指南
MQTT 5 高级特性
数据面 HTTP 接口说明
配置自定义域名
配置 SQL 过滤
配置点对点订阅
MQTT over QUIC
管理客户端订阅
消息增强规则
实践教程
MQTT 客户端开发注意事项
可观测能力
Topic 与通配符订阅
API 参考
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message Enhancement Rule APIs
Message APIs
Data Types
Error Codes
SDK 参考
接入点格式
Java SDK
C SDK
Javascript/Node.JS/小程序
Go SDK
iOS SDK
JavaScript SDK
Dart SDK
Python SDK
.NET
安全与合规
权限管理
常见问题
相关协议
隐私协议
数据处理和安全协议
消息队列 MQTT 版服务等级协议
联系我们

配置自定义域名

PDF
聚焦模式
字号
最后更新时间: 2026-01-30 15:23:29
用户可以使用自定义域名连接 TDMQ MQTT 集群。 这个方式有一下几个优势:
当 MQTT 接入点提供给用户的客户时,保持用户品牌统一;
迁移后端集群时,通过重新解析 DNS 即可完成,保持接入点不变;
可以复用企业已有的 PKI 设施。

配置实例使用自定义域名包含以下步骤:
1. 上传服务端证书到 SSL证书服务;
2. 配置服务端证书对、信任证书到 MQTT 实例;
3. 创建 DNS 记录;

上传证书对、信任证书到 SSL 证书服务

为了确保证书正常轮转更新、过期提醒,不影响业务连续性,MQTT实例仅支持配置SSL证书服务托管的证书。

证书要求

1. 服务端证书(End Entity Certificate)必须包含 X.509 v3 Extended Key Usage 扩展,扩展必须包含 serverAuth(TLS Web Server Authentication), 参考RFC 5280; 即证书应包含必要的 Subject Alternative Name(SAN) 扩展和 Common Name(CN)。如果您的证书系 CA 机构签发,一般均包含该扩展。
注意:
如果证书同时包含 CN 和 SAN, TLS Server Name Indication(SNI) 选择证书时,优先在 SAN 扩展包含域名中选择;如果 SAN 不存在,兼容使用 CN 进行选择。
主流浏览器已忽略 CN 匹配,如 Chrome 58后忽略 CN, 使用 Web Secure Socket 作为 MQTT 传输层时,务必确保 SAN 扩展和 Server Auth 值。
2. 证书链最多包含5个证书;
3. 证书链文件不超过16KiB。

证书上传、托管、购买

详情请参见 上传 SSL 证书指引

配置证书、信任证书到MQTT实例

MQTT 控制台 > 集群管理/实例页面,切到认证管理/X.509证书管理页面:


根据是否验证客户端证书,选择合适的认证模式:
单向认证:不校验客户端证书
双向认证:校验客户端证书

假设选择的服务端证书 Subject Alternative Name 包含以下域名:mqtt-abc.compay.com

创建 DNS 记录

参考 云解析-CNAME 记录,创建一个 CNAME 记录,将 mqtt-abc.compay.com 解析到实例的接入点提供的域名: mqtt-xxx-sh-public.mqtt.tencenttdmq.com

后续通过 mqtt-abc.company.com访问。

帮助和支持

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

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

文档反馈