SSL 加密

最近更新时间:2026-07-09 11:16:42

我的收藏

操作场景

SSL(Secure Sockets Layer )认证用于在客户端与云数据库服务端之间建立安全连接。开通 SSL 加密后,服务端将启用安全证书,用户可以获取(下载)相应的 CA 证书并配置在客户端。客户端连接数据库时将激活安全协议,在客户端与数据库服务端之间建立一条加密通道,实现数据在传输过程中的加密,有效防止数据被截取、篡改或窃听,保障数据传输的安全性。
说明:
存储引擎 Memcached 版不支持 SSL 加密。

计费说明

开启 SSL 加密不收取任何费用,您可免费使用。

使用前须知

开启 SSL 加密可保障数据访问及传输的安全,但可能会略微影响实例性能。建议仅在有加密需求时开通 SSL 加密。
开启 SSL 加密后,无法支持免密访问。
开启 SSL 加密功能后再关闭,加密连接的客户端程序将无法正常连接,请提前调整业务配置。
开启 SSL 加密时,证书默认仅绑定所选的连接地址,使用其他地址连接将报错。
SSL 证书有效期为20年,目前不支持证书失效场景的处理。

版本架构说明

SSL 加密对实例的兼容版本与代理版本有要求,具体如下。
新建实例:兼容版本4.0及以上均支持直接开通 SSL 加密。
存量实例
兼容版本为2.8时,需先升级兼容版本至4.0或以上,才能开通 SSL 加密。具体操作,请参见 版本升级
兼容版本为4.0及以上时,需升级代理版本至5.6.0才能支持。具体操作,请参见 代理升级
标准架构与集群架构均支持 SSL 加密。

证书绑定地址说明

开启 SSL 加密时,需选择一个连接地址作为证书绑定地址。证书签发时会将该地址写入证书的服务端地址字段(SAN),客户端发起 SSL 连接时,会校验实际连接地址与证书绑定地址是否一致。两者不一致时,TLS 握手将校验失败,连接被拒绝。请选择客户端实际使用的连接地址作为证书绑定地址。
连接地址类型
展示条件
说明
内网地址(推荐)
始终展示
实例的默认连接地址,优先展示并默认选中。
外网地址
实例已开通外网访问时展示
适用于通过外网接入的客户端。如需通过外网进行 SSL 加密连接,请选择外网地址。
不绑定地址
仅白名单业务开放
证书不绑定特定地址,可使用任意地址进行 SSL 连接,用于兼容存量实例场景。

前提条件

实例状态为运行中,且无其他任务正在执行。
当前为业务低峰时段,或客户端已具备自动重连机制。

操作步骤

步骤1:开启 SSL 加密并选择连接地址

2. 在实例列表上方,选择地域。
3. 在实例列表中,单击目标实例的实例 ID,进入实例详情页面。
4. 选择 SSL 加密页签,若页面提示需升级版本,请单击版本升级,等待版本升级成功。
5. SSL 加密状态右侧,单击

,弹出确认开通 SSL 加密对话框。
6. 证书绑定地址的下拉列表中,选择证书绑定的加密连接地址。

7. 单击确定SSL 加密状态显示为 SSL 状态更新中。等待状态显示为已开通,即完成 SSL 加密开通。如下图所示。证书绑定地址:显示证书当前绑定的加密连接地址,与开通时所选地址一致,单击复制可复制该地址。


步骤2:查看状态并下载证书

1. SSL 加密设置区域,单击下载 CA 证书,获取 CA 证书。
2. 将证书放置在服务端,使用 SSL 加密方式访问数据库。客户端连接示例,请参见 Java 连接示例Python 连接示例

步骤4:变更加密连接地址

SSL 加密开通后,证书绑定的连接地址不支持直接修改。如需变更绑定地址,请按以下路径操作:先关闭 SSL 加密,再重新开启并选择新的加密连接地址。关闭 SSL 加密的操作,请参见下文 步骤5

步骤5:关闭 SSL 加密

1. SSL 加密页签,单击 SSL 加密状态右侧的

,弹出确认关闭 SSL 加密对话框。
2. 确认提示信息后,单击确定即可。
说明:
关闭后,原已绑定的加密连接地址信息将失效,加密连接的客户端程序将无法正常连接。关闭后再次开启 SSL 加密时,可重新选择加密连接地址。

更换网络与更换访问地址的影响

实例的 SSL 证书绑定了具体的加密连接地址,更换网络或更换访问地址(VIP)可能导致原绑定地址失效。请在执行以下操作前确认 SSL 加密的影响。
更换网络:将实例切换至其他私有网络或子网后,原内网地址将变更。若 SSL 证书绑定的是受影响的内网地址,更换完成后原证书绑定地址将失效,使用 SSL 加密连接的客户端将无法连接。请在更换网络完成后,关闭并重新开启 SSL 加密,重新选择加密连接地址。更换网络的操作,请参见 更换网络
更换访问地址(VIP):手动更换实例的 VIP 后,原绑定地址同样失效,需重新开启 SSL 加密并重新选择加密连接地址。
注意:
更换网络或更换访问地址前,若实例已开启 SSL 加密且当前绑定地址受影响,请提前评估对业务的影响,并在变更完成后重新签发证书,否则使用 SSL 加密连接的客户端将无法正常连接。

相关 API

接口名称
功能描述
接口文档链接
OpenSSL
开启 SSL 加密,支持指定加密连接地址
CloseSSL
关闭 SSL 加密

常见问题

开启 SSL 加密后客户端无法连接,如何处理?

请确认客户端实际使用的连接地址与证书绑定的加密连接地址一致。在 SSL 加密页签的证书绑定地址处可查看当前证书绑定的加密连接地址。若两者不一致,请关闭 SSL 加密后重新开启,并选择与客户端一致的连接地址。

如何变更证书绑定的加密连接地址?

证书绑定地址不支持直接修改。请先关闭 SSL 加密,再重新开启并在下拉列表中选择新的加密连接地址。

更换网络后 SSL 加密连接失败,如何恢复?

更换网络会导致原内网地址变更,原证书绑定地址随之失效。请在更换网络完成后,关闭并重新开启 SSL 加密,选择更换后的连接地址重新签发证书。

相关文档