文档首页/ 分布式缓存服务 DCS/ 用户指南（吉隆坡区域）/ 快速入门/ 连接实例/ 使用redis-cli连接Redis实例
更新时间：2024-07-29 GMT+08:00
查看PDF
分享

使用redis-cli连接Redis实例

介绍使用同一VPC内弹性云服务器ECS上的redis-Cli连接Redis实例的方法。更多的客户端的使用方法，请参考https://redis.io/clients。

  • Redis 3.0不支持定义端口，端口固定为6379，Redis 4.0及以上版本实例支持定义端口，如果不自定义端口，则使用默认端口6379。本文操作步骤涉及实例端口时，统一以默认端口6379为例，如果已自定义端口，请根据实际情况替换。
  • 在使用redis-cli连接Cluster集群时，请注意连接命令是否已加上-c。在连接Cluster集群节点时务必正确使用连接命令，否则会出现连接失败的问题。
    • Cluster集群连接命令：

      ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} -c

    • 单机、主备、Proxy集群连接命令：

      ./redis-cli -h {dcs_instance_address} -p 6379 -a {password}

    具体连接操作， 请查看3和4。

  • 当Redis 6.0单机、主备实例开启了SSL时，需要配置SSL证书路径：

    ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} --tls --cacert {certification file path}

  • 通过SSL加密连接Redis时，请使用6.x及以上版本的redis-cli客户端。

前提条件

  • 已成功申请Redis实例，且状态为“运行中”。
  • 已创建弹性云服务器，创建弹性云服务器的方法，请参见《弹性云服务器用户指南》。
  • 如果弹性云服务器为Linux系统，该弹性云服务器必须已经安装gcc编译环境。

操作步骤（Linux版）

  1. 查看并获取待连接Redis实例的IP地址和端口。

    具体步骤请参见查看实例信息。

  2. 安装redis-cli客户端。

    以下步骤以客户端安装在Linux系统上为例进行描述。

    1. 登录弹性云服务器。
    2. 执行以下命令，获取Redis客户端源码，下载路径为https://download.redis.io/releases/redis-6.2.13.tar.gz。

      wget http://download.redis.io/releases/redis-6.2.13.tar.gz

      此处以安装redis-6.2.13版本为例，您也可以安装其他版本。具体操作，请参见Redis官网。

    3. 执行如下命令，解压Redis客户端源码包。

      tar -xzf redis-6.2.13.tar.gz

    4. 进入Redis目录并编译Redis客户端源码。

      cd redis-6.2.13

      make

      cd src

  3. 连接Redis非Cluster集群实例。

    如果是单机/主备实例，请执行以下操作。

    ./redis-cli -h ${dcs_instance_address} -p 6379 -a ${password}

    1. 如果实例为免密实例，连接实例使用命令：./redis-cli -h ${dcs_instance_address} -p 6379
    2. 如果实例为非免密实例，连接实例使用命令：./redis-cli -h ${dcs_instance_address} -p 6379 -a ${password}
    3. 如果忘记实例访问密码或需要重置密码，可以重置密码，参考重置缓存实例密码。

  4. 连接Redis Cluster集群实例。

    如果是Cluster集群实例，请执行以下操作。

    1. 执行以下命令连接Redis实例。

      ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} -c

      其中，{dcs_instance_address}为Redis实例的IP地址，“6379”为Redis实例的端口，{password}为Cluster集群实例的密码，-c连接集群节点时使用。IP地址和端口获取见1。

      如下所示，具体请根据实际情况修改： 
      root@ecs-redis:~/redis-6.2.13/src# ./redis-cli -h 192.168.0.85 -p 6379 -a ****** -c
192.168.0.85:6379>
    2. 查看Cluster集群节点信息。

      cluster nodes

      Cluster集群每一个分片都是一主一从的双副本结构，执行该命令可以查看该实例的所有节点信息，如下所示。

      192.168.0.85:6379> cluster nodes
0988ae8fd3686074c9afdcce73d7878c81a33ddc 192.168.0.231:6379@16379 slave f0141816260ca5029c56333095f015c7a058f113 0 1568084030
000 3 connected
1a32d809c0b743bd83b5e1c277d5d201d0140b75 192.168.0.85:6379@16379 myself,master - 0 1568084030000 2 connected 5461-10922
c8ad7af9a12cce3c8e416fb67bd6ec9207f0082d 192.168.0.130:6379@16379 slave 1a32d809c0b743bd83b5e1c277d5d201d0140b75 0 1568084031
000 2 connected
7ca218299c254b5da939f8e60a940ac8171adc27 192.168.0.22:6379@16379 master - 0 1568084030000 1 connected 0-5460
f0141816260ca5029c56333095f015c7a058f113 192.168.0.170:6379@16379 master - 0 1568084031992 3 connected 10923-16383
19b1a400815396c6223963b013ec934a657bdc52 192.168.0.161:6379@16379 slave 7ca218299c254b5da939f8e60a940ac8171adc27 0 1568084031
000 1 connected

      备节点只能进行只读操作，不能进行写操作。在进行数据写入时，key存储在哪个slot中，由Crc16(key) mod 16384的值决定。

      如下所示，数据写入时，根据Crc16(key) mod 16384的值决定key存储位置，并跳转到该slot所在的节点上。

      192.168.0.170:6379> set hello world
-> Redirected to slot [866] located at 192.168.0.22:6379
OK
192.168.0.22:6379> set happy day
OK
192.168.0.22:6379> set abc 123
-> Redirected to slot [7638] located at 192.168.0.85:6379
OK
192.168.0.85:6379> get hello
-> Redirected to slot [866] located at 192.168.0.22:6379
"world"
192.168.0.22:6379> get abc
-> Redirected to slot [7638] located at 192.168.0.85:6379
"123"
192.168.0.85:6379>

操作步骤（Windows版）

Windows版本的Redis客户端安装包，请单击这里下载编译包（非Source code包）。下载后直接解压安装到自定义目录，然后使用cmd工具进入该目录，执行以下命令连接redis实例：

redis-cli.exe -h XXX -p 6379

其中：“XXX”为Redis实例的IP地址，“6379”为Redis实例的端口。IP地址和端口获取见查看实例信息，请按实际情况修改后执行。

父主题： 连接实例