缓存数据库 Redis 版提供了连接诊断功能，当您的客户端无法正常通过公网或私网地址连接 Redis 实例时，您可以通过连接诊断功能协助排查连接失败问题。 ## 适用场景缓存数据库 Redis 版支持私网和公网访问方式，且为这两种访问方式均提供了对应的连接诊断功能，您可以根据客户端需要使用的连接地址类型，选择合适的连接诊断场景。 :::tip 关于 Redis 连接地址类型的更多详情，请参见[查看连接地址](../6293/78049)。 ::: |客户端部署类型 |适用的连接诊断场景 | |---|---| |客户端所部署的 [ECS 实例](https://console.volcengine.com/ecs/instance)与 Redis 实例在相同地域下的同一 VPC 网络中。 |此时，您可以通过私网连接地址（包括私网地址和直连地址）访问 Redis 实例。若访问失败，您可以通过[私网访问连接诊断](../6293/1684392#ygxF8o0j)功能协助排查。 | |* 客户端所部署的 [ECS 实例](https://console.volcengine.com/ecs/instance)与 Redis 实例在相同地域，但不在同一 VPC 网络中。|当客户端部署环境为左侧任意一种时，必须通过公网连接地址访问 Redis 实例。若通过公网访问失败，您可以通过[公网访问连接诊断](../6293/1684392#bzWfssRc)功能协助排查。 |\ |* 客户端所部署的 [ECS 实例](https://console.volcengine.com/ecs/instance)与 Redis 实例在不同地域。| |\ |* 客户端部署在本地服务器。| |\ || |\ | | | ## 私网访问连接诊断 1. 登录 [Redis 控制台](https://console.volcengine.com/db/redis)。 2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。 3. 在**实例列表**页，单击目标实例的名称。 4. 在实例详情页，单击**连接管理**页签。 5. 在**连接管理**页签下，单击**私网访问**右侧的**连接诊断**。 6. 在弹出的**连接诊断**面板中，先确认当前实例的配置信息（包括实例名称/ID、可用区、私有网络和子网信息）后，再设置如下配置。 |参数 |说明 | |---|---| |诊断类型 |默认为**私网连接**，无需设置。 | |客户端类型 |固定为**选择 ECS 实例**，无需设置。 | |ECS 实例 |从下拉列表中先勾选客户端所部署的 ECS 实例，再从已选择的 ECS 实例中勾选需要检查的私网 IP 地址。 | 7. 单击**开始检查**。 ## **公网访问连接诊断** :::tip 缓存数据库 Redis 版默认关闭公网访问，如需对公网访问进行连接诊断，需要先手动开启公网访问。具体操作步骤，请参见[开启公网访问](../6293/71640)。 ::: 1. 登录 [Redis 控制台](https://console.volcengine.com/db/redis)。 2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。 3. 在**实例列表**页，单击目标实例的名称。 4. 在实例详情页，单击**连接管理**页签。 5. 在**连接管理**页签下，单击**公网访问**右侧的**连接诊断**。 6. 在弹出的**连接诊断**面板中，先确认当前实例的配置信息（包括实例名称、ID、可用区、私有网络和子网信息）后，再根据客户端部署类型选择对应操作。 ```mixin-react return ( ); ``` 7. 单击**开始检查**。 ## **后续操作** 1. 诊断结束后，您可以在**连接诊断**面板中直接查看诊断结果，并根据诊断建议修改相关设置。 :::warning 本功能仅用于检查客户端 IP 地址是否已正确加入 Redis 的访问白名单。若当前 IP 地址诊断通过但仍无法建立连接，您还需要进行进一步的排查，具体排查步骤，请参见 [Redis 连接失败怎么办](../6293/1392455)。 ::: |诊断结果 |说明 | |---|---| |诊断不通过 |表示刚才检查的 IP 地址未加入当前实例的白名单中。您可以前往**白名单列表**页，将该 IP 地址手动加入指定白名单，具体操作步骤，请参见[编辑白名单](../6293/108324)。 | |诊断通过 |表示刚才检查的 IP 地址已加入当前实例的白名单。 | 2. 连接诊断完成后，您可以在客户端上通过私网或公网地址访问 Redis 实例，具体操作步骤请参见： * [通过 redis-cli 连接实例](../6293/70858) * [通过客户端程序连接实例](../6293/70859) * [通过直连地址连接实例](../6293/70860)