如何通过redis-cli连接Redis_云数据库 Redis 版-阿里云帮助中心

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

免费试用

阿里云免费试用面向符合条件的新用户，提供一定时间段的免费试用阿里云产品的权益，更多信息请参见免费试用。

操作流程	说明
1. 设置Redis账号密码。	选择以下任意方式：设置Redis默认账号的密码，具体操作，请参见修改或重置密码。创建新的账号密码，具体操作，请参见创建与管理账号。
2. 添加白名单。	根据不同设备确定连接的网络类型，并将对应网络IP地址添加至Redis实例中。 ECS实例（推荐）：推荐使用专有网络VPC 。请确保ECS实例与Redis实例属于同一专有网络，并将ECS实例的私网IP地址添加至Redis实例的白名单中。
3. 获取Redis连接信息。	使用专有网络连接时：在Redis控制台，获取该实例的专有网络连接地址。使用公网连接时：在Redis控制台，申请并获取该实例的公网连接地址。
4. 使用redis-cli连接Redis实例。	在redis-cli解压目录下执行相关命令。连接命令： `redis-cli -h hostname -p port` 连接命令示例： `redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379` 密码命令： `AUTH user:password` 密码命令示例： `AUTH testaccount:Rp829dlwa` 具体操作，请参见本文操作步骤。

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

如未安装redis-cli，请参见附录：安装redis-cli 进行安装。
进入redis-cli安装目录下。
- Windows：打开命令行窗口，进入redis-cli所属的目录。
- Linux：进入..\redis-7.0.0\src所属的目录，例如 cd /home/redis-7.0.0/src 。

获取连接信息并执行下述命令连接Redis实例：

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

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

AUTH password

表 2. 参数说明
参数	说明
password	填写账号、密码：使用默认账号（以实例ID命名的账号）：直接填写密码即可。使用新创建的账号：密码格式为 `user:password` 。例如自定义账号为 `testaccount` ，密码为 `Rp829dlwa` ，密码需填写为 `testaccount:Rp829dlwa` 。

AUTH testaccount:Rp829dlwa

报错信息	原因及解决方法
`(error) ERR illegal address`	未设置正确的白名单，请参见快速了解连接Redis实例流程设置正确的白名单。
`(error) ERR client ip is not in whitelist`	未设置正确的白名单，请参见快速了解连接Redis实例流程设置正确的白名单。
`(error) ERR invalid password` `(error) WRONGPASS invalid username-password pair`	密码错误，请使用正确的密码和密码格式。根据选取账号的不同，密码格式有一定区别。默认账号（以实例ID命名的账号）：直接填写密码即可。新创建的账号：密码格式为 `user:password` 。例如自定义账号为 `testaccount` ，密码为 `Rp829dlwa` ，密码需填写为 `testaccount:Rp829dlwa` 。