文档中心

缓存数据库 Redis 版

连接实例

连接诊断

缓存数据库 Redis 版提供了连接诊断功能，当您的客户端无法正常通过公网或私网地址连接 Redis 实例时，您可以通过连接诊断功能协助排查连接失败问题。

适用场景

缓存数据库 Redis 版支持私网和公网访问方式，且为这两种访问方式均提供了对应的连接诊断功能，您可以根据客户端需要使用的连接地址类型，选择合适的连接诊断场景。

说明

关于 Redis 连接地址类型的更多详情，请参见查看连接地址。

客户端部署类型	适用的连接诊断场景
客户端所部署的 ECS 实例与 Redis 实例在相同地域下的同一 VPC 网络中。	此时，您可以通过私网连接地址（包括私网地址和直连地址）访问 Redis 实例。若访问失败，您可以通过私网访问连接诊断功能协助排查。
客户端所部署的 ECS 实例与 Redis 实例在相同地域，但不在同一 VPC 网络中。客户端所部署的 ECS 实例与 Redis 实例在不同地域。客户端部署在本地服务器。	当客户端部署环境为左侧任意一种时，必须通过公网连接地址访问 Redis 实例。若通过公网访问失败，您可以通过公网访问连接诊断功能协助排查。

私网访问连接诊断

参数	说明
诊断类型	默认为私网连接，无需设置。
客户端类型	固定为选择 ECS 实例，无需设置。
ECS 实例	从下拉列表中先勾选客户端所部署的 ECS 实例，再从已选择的 ECS 实例中勾选需要检查的私网 IP 地址。

公网访问连接诊断

说明

缓存数据库 Redis 版默认关闭公网访问，如需对公网访问进行连接诊断，需要先手动开启公网访问。具体操作步骤，请参见开启公网访问。

客户端部署在 ECS 实例

客户端部署在本地服务器

参数	说明
诊断类型	默认为公网连接，无需设置。
客户端类型	默认为选择 ECS 实例，无需设置。
ECS 实例	从下拉列表中先勾选客户端所部署的 ECS 实例，再从已选择的 ECS 实例中勾选需要检查的公网 IP 地址。

后续操作

注意

本功能仅用于检查客户端 IP 地址是否已正确加入 Redis 的访问白名单。若当前 IP 地址诊断通过但仍无法建立连接，您还需要进行进一步的排查，具体排查步骤，请参见 Redis 连接失败怎么办。

诊断结果	说明
诊断不通过	表示刚才检查的 IP 地址未加入当前实例的白名单中。您可以前往白名单列表页，将该 IP 地址手动加入指定白名单，具体操作步骤，请参见编辑白名单。
诊断通过	表示刚才检查的 IP 地址已加入当前实例的白名单。

最近更新时间：2026.07.29 14:49:12

这个页面对您有帮助吗？

有用

无用