您可以使用原生工具redis-cli来连接阿里云Redis。

redis-cli连接简介

redis-cli是原生Redis自带的命令行工具,可以帮助您通过简单的命令连接Redis实例,进行数据管理。

使用redis-cli,您可以在阿里云ECS实例上的Linux系统中连接云数据库Redis版实例,或者在本地主机上通过公网访问Redis实例。通过阿里云内网访问Redis实例能够提供更高的安全和性能保障,您可以在ECS上使用redis-cli与同一VPC内的Redis实例或者同地域的经典网络Redis实例建立连接;如果您的场景需要在本地主机上从公网访问Redis实例,请先参见公网连接,申请公网连接地址,再使用本文介绍的连接方法。

redis-cli安装方法

在Linux环境中安装原生Redis即可使用redis-cli。具体步骤请参见Redis社区版官网

前提条件

内网连接

  • ECS实例与Redis实例的网络类型同为VPC时,二者需在同一地域的同一VPC中。
  • ECS实例与Redis实例的网络类型同为经典网络时,二者需在同一地域。
  • Redis实例的白名单中加入了ECS实例的内网IP地址。
  • ECS中已安装原生Redis。
  • 如果使用自定义账号连接Redis,连接密码格式需为<user>:<password>。例如,自定义账号的用户名为admin,密码为Rp829dlwa,则连接Redis时的密码为admin:Rp829dlwa

公网连接

  • Redis实例申请了公网连接地址,申请方式参见公网连接
  • Redis实例的白名单中加入了本地主机的公网IP地址。
  • 本地主机的系统为Linux。
  • 本地主机已安装原生Redis。
  • 如果使用自定义账号连接Redis,连接密码格式需为<user>:<password>。例如,自定义账号的用户名为admin,密码为Rp829dlwa,则连接Redis时的密码为admin:Rp829dlwa

注意事项

  • 如果通过内网地址访问Redis实例并开启了VPC免密,连接时无需密码验证,开启方式请参见VPC免密
  • 如果通过公网地址访问Redis实例并开启了VPC免密,连接时仍然需要密码验证。
  • 如果连接遇到问题,请参见Redis连接问题排查与解决

连接方法

在Linux命令行使用如下命令连接Redis实例:

redis-cli -h <host> -p <port> -a '<password>'
说明 使用直连地址访问Redis集群实例需要设置-c选项,示例如下。
redis-cli -h <host> -p <port> -a '<password>' -c
表 1. 选项说明
选项 说明
-h

Redis实例的连接地址。

  • 内网连接:系统默认提供内网连接地址,查看方式请参见查看连接地址
  • 公网连接:您需要申请公网连接地址才能从公网连接实例,申请方式请参见公网连接
-p

Redis实例的服务端口。默认的内网连接和公网连接端口均为6379,可自定义,修改方式参见修改连接端口

-a Redis实例的连接密码,使用单引号(')包裹连接密码,例如'Rp829dlwa'
说明 为提高安全性,您也可以不设置该选项,在执行连接命令后再输入auth <password>来验证密码(如下图所示)。
-c 使用直连地址访问云Redis集群版实例时需要设置该参数。
图 1. 连接示例

常见问题

Q:通过redis-cli连接时提示“ERR invalid password”。

A:Redis实例未添加正确的白名单,请添加正确的白名单。
说明 由于实例的小版本过低,提示的内容可能不准确。将实例升级至最新的小版本后,如果遇到未添加正确的白名单,命令行会提示“ERR illegal address”,升级方法请参见升级小版本