云数据库 Redis：通过redis-cli连接Redis

快速了解连接Redis实例流程

操作步骤

1. 登录安装redis-cli的设备，例如ECS实例或本地设备。
   如未安装redis-cli，请参见附录：安装redis-cli进行安装。
2. 进入redis-cli安装目录下。
   • Windows：打开命令行窗口，进入redis-cli所属的目录。
   • Linux：进入..\redis\src所属的目录，例如cd /home/redis-6.0.9/src。
3. 获取连接信息并执行下述命令连接Redis实例：

   redis-cli -h hostname -p port [-c]

   说明 在Windows中使用PowerShell启动redis-cli的命令为.\redis-cli -h hostname -p port [-c]。

   表 1. 参数说明

   参数	说明	获取方式
   hostname	Redis实例的连接地址	通过专有网络连接：需获取Redis实例的专有网络连接地址。 通过公网连接：需获取Redis实例的公网连接地址。 具体操作，请参见查看连接地址。
   port	Redis实例的端口号	端口号默认为6379，您也可以自定义端口号。具体操作，请参见修改连接地址或端口。
   -c	启用集群模式	该模式仅当Redis实例为集群架构，且使用直连地址连接时可用。

   连接示例：

   • 默认地址（适用于通过默认地址连接的场景，例如标准架构实例的连接地址或集群架构实例的代理地址）：

     redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379

   • 集群架构直连地址（适用于集群架构通过直连地址连接的场景）：

     redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c

4. 执行下述命令完成密码验证：

   AUTH password

   表 2. 参数说明

   参数	说明
   password	填写账号、密码： 使用默认账号（以实例ID命名的账号）：直接填写密码即可。 使用新创建的账号：密码格式为user:password。例如自定义账号为testaccount，密码为Rp829dlwa，密码需填写为testaccount:Rp829dlwa。 说明 如果忘记或未设置密码，您可以重置密码。具体操作，请参见修改或重置密码。 如果实例已开启专有网络免密访问，通过专有网络连接Redis实例时无需执行本步骤即可执行Redis命令。

   示例：

   AUTH testaccount:Rp829dlwa

   显示OK表示已成功连接Redis实例，可执行Redis命令。

   • 如果出现报错，请参见常见报错。
   • 关于云数据库Redis支持的命令，请参见Redis命令支持概览。

附录：安装redis-cli

在ECS实例或本地设备上，安装Redis会同步安装redis-cli。通过redis-cli连接时，redis-cli的版本无需与云数据库Redis版实例版本相同。

1. 登录待安装redis-cli的设备，例如ECS实例或本地设备。
2. 下载、安装redis-cli。
   • Linux
     1. 执行下述命令下载Redis源码文件：

        wget https://download.redis.io/releases/redis-6.0.9.tar.gz

        说明 本文以redis-6.0.9版本为例演示操作流程，您也可以安装其他版本。具体操作，请参见Redis官网。
     2. 执行下述命令解压Redis源码文件：

        tar xzf redis-6.0.9.tar.gz

     3. 执行下述命令进入解压后的目录并编译安装Redis源码文件：

        cd redis-6.0.9&&make

        说明 编译安装需要一段时间（通常为2分钟~3分钟）。
   • Windows

     目前仅支持64位的Windows系统。

     1. 下载Redis-x64-3.2.100.zip文件。
        说明 本文以redis-3.2版本为例演示操作流程，您也可以安装其他版本。更多信息，请参见MicrosoftArchive-Redis。
     2. 将Redis-x64-3.2.100.zip解压至待安装的目录。

常见报错