文档中心

缓存数据库 Redis 版

请输入

连接实例

通过直连地址连接实例

缓存数据库 Redis 版支持使用直连地址进行访问。本文介绍如何通过直连地址访问 Redis 实例。

功能介绍

申请直连地址（即开启直连模式）后，缓存数据库 Redis 版会为实例中所有分片分配一个统一的虚拟 IP（VIP）地址，但每个分片使用的端口号不同。客户端在首次向直连地址发送请求前，会通过 DNS 服务器解析直连地址，解析结果即为 Redis 分配的固定 VIP 地址。获取 VIP 后，客户端即可通过 Redis Cluster 协议访问 Redis 实例中的数据。

前提条件

已申请直连地址。申请直连地址的方法，请参见申请直连地址。

已将客户端地址加入 Redis 实例的 IP 白名单中。设置白名单的方法，请参见设置白名单。

客户端所在的 ECS 实例与目标 Redis 实例在同一 VPC 网络。

注意事项

仅已启用分片集群的 Redis 实例支持使用直连地址。关于已启用分片集群的更多信息，请参见产品架构。

仅支持 Redis Cluster 协议的客户端（如 Jedis、PhpRedis 等）才可通过直连地址访问 Redis 实例。

由于部署架构的不同，相对于不启用分片集群的实例，启用分片集群的实例在对原生 Redis 的命令上有一定区别。关于 Redis 实例支持的命令详情，请参见命令支持。

部分 Redis Cluster 客户端不支持 SELECT 命令，如果使用该类客户端只能使用 DB0。

连接方法

通过客户端使用直连地址访问 Redis 实例的具体方法，请参见通过客户端程序连接 Redis。

常见问题

Q：Redis 实例连接失败时，该如何进行排查？

A：当出现无法连接 Redis 实例问题时，您可以尝试如下步骤进行排查：

使用连接诊断功能检查客户端 IP 地址是否已正确加入 Redis 的访问白名单。

若诊断通过但仍无法建立连接，您还需要进行进一步的排查，具体排查步骤，请参见 Redis 连接失败怎么办。

最近更新时间：2025.12.23 19:45:34

这个页面对您有帮助吗？

有用

无用