将本地设备的公网IP地址添加至Redis实例的白名单中。具体操作,请参见设置白名单。
在安装了redis-cli的ECS实例或本地设备上,使用Windows键+R组合键打开运行对话框,然后输入cmd并单击确定。
系统将为您打开Windows命令行窗口。图1.Windows命令行窗口
执行下述命令,进入redis-cli所属的目录。
cd /d
:Redis-x64-3.2.100.zip解压后的完整路径,本案例为D:\Redis-x64-3.2.100。
示例:
cd /d D:\Redis-x64-3.2.100
获取连接信息并执行下述命令连接Redis实例:
redis-cli -h
-p[-c]表2.参数说明
参数说明获取方式
Redis实例的连接地址ECS实例通过专有网络连接:需获取Redis实例的专有网络连接地址。本地设备通过公网连接:需获取Redis实例的公网连接地址。
Redis实例的端口号端口号默认为6379,您也可以自定义端口号。具体操作,请参见修改连接地址或端口。
直连地址连接示例(适用于通过直连地址连接的场景):redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c
执行下述命令完成密码验证:
AUTH
说明如果实例已开启专有网络免密访问,通过专有网络连接Redis实例时无需执行本步骤即可正常执行Redis命令。
:账号的密码,根据选取账号的不同,密码的填写格式有一定区别。如果忘记密码,您可以重置密码。具体操作,请参见修改或重置密码。默认账号:直接填写密码即可。
说明默认账号为default,如果没有default则默认账号为以实例ID命名的账号(例如r-bp10noxlhcoim2****)。
新创建的账号:密码格式为:。例如自定义账号为testaccount,密码为Rp829dlwa,密码需填写为testaccount:Rp829dlwa。
示例:
AUTH testaccount:Rp829dlwa
验证成功后,返回如下结果:OK
说明如果出现报错,请参见常见连接报错。
完成验证后,即可执行Redis命令,例如执行DBSIZE命令查询当前库有多少个键(Key)。
关于云数据库Redis支持的命令,请参见Redis命令支持概览;关于所有Redis命令的介绍和使用方法,请参见Redis官网。

常见连接报错

说明如果实例的小版本过低,报错信息可能不准确,建议将实例升级至最新的小版本。具体操作,请参见升级小版本。
报错信息原因及解决方法
(error) ERR illegal address未设置正确的白名单,具体操作,请参见redis-cli连接方法(Linux系统)或redis-cli连接方法(Windows系统)中的步骤2。
(error) ERR client ip is not in whitelist
(error) ERR invalid password密码错误,请确认使用正确的密码和密码格式。根据选取账号的不同,密码格式有一定区别。默认账号(即以实例ID命名的账号):直接填写密码即可。新创建的账号:密码格式为:。例如自定义账号为testaccount,密码为Rp829dlwa,密码需填写为testaccount:Rp829dlwa。
说明如果忘记密码,您可以重置密码。具体操作,请参见修改或重置密码。

视频演示

您可以通过观看以下视频来了解如何通过redis-cli连接Redis实例,视频时长约2分钟。