文档中心

缓存数据库 Redis 版

连接实例

通过 redis-cli 连接实例

redis-cli 是社区原生 Redis 自带的命令行工具，您可以在 ECS 实例或本地设备上通过 redis-cli 连接缓存数据库 Redis 版，进行数据管理。

连接 Redis 使用的网络类型

网络类型	说明
私有网络	私有网络 VPC（Virtual Private Cloud）是独享的私有网络。当 redis-cli 部署在 ECS 实例上时，通过私有网络连接至 Redis 实例，可获得更高的安全性和更好的性能。
公网	公网即互联网。您可以在本地设备上部署 redis-cli，并通过公网连接 Redis 实例进行测试。说明公网访问不会产生流量费用，但相较于私网访问，公网访问的延迟更高且存在一定的安全隐患，建议仅在测试环境中使用，生产环境推荐使用私网访问。当 VPC 外的设备不再需要访问 Redis 实例时，建议您及时关闭公网访问功能。

准备工作

根据 redis-cli 的安装位置，完成相关准备工作。

说明

由于 redis-cli 是原生 Redis 自带的命令行工具，通常您需要通过在 ECS 实例或本地设备上安装 Redis 服务的方式，完成 redis-cli 的安装。具体安装方法，请参见附录：安装 redis-cli。

redis-cli 的版本可以与 Redis 实例的版本不同。

注意事项

若需要在开启 SSL 加密后，使用 redis-cli 客户端连接实例，那么：

redis-cli 6 以下版本的客户端不支持连接时验证证书，请使用 redis-cli 6 或以上版本的客户端。

连接实例前，需要先执行 make BUILD_TLS=yes 命令编译 redis-cli 客户端文件。

设置 SSL 加密的方法，请参见设置 SSL 加密。

操作步骤

登录已安装了 redis-cli 的设备，例如 ECS 实例或本地设备。

如未安装 redis-cli，请参见附录：安装 redis-cli 进行安装。

打开本地设备的命令行窗口或命令终端工具，并进入 redis-cli 安装目录下。

Windows 操作系统：cd /d <redis-cli 所属的目录>，例如 cd /d D:redis-6.2.13。

Linux 操作系统： cd ../<redis-cli 所属的目录>，例如 cd root/redis-6.2.13。

macOS 操作系统： cd ../<redis-cli 所属的目录>，例如 cd home/redis-6.2.13。

获取连接信息并执行下述命令连接 Redis 实例。获取连接地址的具体方法，请参见查看连接地址。

src/redis-cli -h <hostname> -p <port> [-c]

参数	说明	获取方式
<hostname>	Redis 实例的连接地址	ECS 实例通过私有网络连接：需获取 Redis 实例的私有网络连接地址。本地设备通过公网连接：需开启公网访问来获取 Redis 实例的公网连接地址。开启公网访问的方法，请参见开启公网访问。
<port>	Redis 实例的端口号	默认端口号为 6379。
-c	启用集群模式	只有启用分片集群的 Redis 实例会使用该参数，当您需要使用直连地址连接时，需要在连接实例时加上 -c。关于直连地址的更多信息，请参见申请直连地址。

不同类型连接地址的连接代码示例如下，关于连接地址类型的更多信息，请参见连接地址类型。

私网地址连接示例

src/redis-cli -h redis-cng6qap*****.redis.ivolces.com -p 6379

公网地址连接示例

src/redis-cli -h redis-cng6qap*****.redis.volces.com -p 6379

直连地址连接示例

src/redis-cli -h redis-cng6qap*****.redis.ivolces.com -p 6379 -c

执行 AUTH 命令完成账密验证。

您可以选择如下任一方式完成账密校验：

同时输入账号和密码进行验证，命令如下。

AUTH <username> <password>

AUTH <username>:<password>

直接填写密码进行验证，命令如下。

AUTH <password>

说明

仅使用 default 默认账号时支持直接填写密码进行验证。

如果忘记密码，您可以重置密码。具体操作，请参见重置密码。

示例如下。

AUTH testuser Test@Password

验证成功后，会返回 OK。

后续操作

完成验证后您可以先为当前连接设置连接级别的读写分类策略，然后即可根据业务需要执行 Redis 相关命令，例如执行 DBSIZE 命令查询当前库有多少个键（Key）。关于缓存数据库 Redis 版支持的命令详情，请参见命令支持。

附录：安装 redis-cli

常见问题

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

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

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

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

最近更新时间：2025.11.18 14:19:13

这个页面对您有帮助吗？

有用

无用