redis-cli 是原生 Redis 自带的命令行工具,通过 redis-cli 连接到 Redis 实例,进行数据管理。

Redis Standalone 支持多种连接方式,本小节将为您介绍如何使用 redis-cli 连接 Redis 实例。

前提条件

  • 已获取管理控制台登录账号和密码,且已获取集群操作权限。

  • 已创建 Redis Standalone 集群,且集群状态为活跃

  • 已安装 redis-cli 工具,且安装 redis-cli 的服务器与 Redis 之前网络畅通。

步骤 1:获取连接信息

Redis Standalone 实例创建完成后,您可以在 Redis Standalone 的节点管理页面,查看到 Redis 节点的 IP 地址,此 IP 地址即为连接地址,连接任意一个主节点均可。

  1. 在集群管理页面,点击目标集群 ID,进入集群详情页面。

  2. 节点实时角色页签,获取 master 节点的 IP 地址。

    角色详情
  3. 服务端口信息模块,获取 Redis 服务端口或 TLS 端口。

    连接信息

步骤 2:访问 Redis

  1. 参考通过 redis-cli 方式连接 Redis,编译 Redis 源码,并安装 redis-cli 工具。

  2. 进入 src 目录,执行访问命令或操作命令。

    ./redis-cli -h <node_IP> -p <Port> -a <password> --tls --cert <cert_file_path> --key <key_file_path> --cacert <cacert_file_path>
    说明

    以上参数中,--tls--key--cert--cacert 仅在需要启用 TLS 加密认证时填写。

    TLS 加密说明,请参见 TLS 加密

命令参数说明

参数 参数说明

-h

Redis Standalone 实例的节点 IP 地址。

-p

Redis Standalone 实例的服务端口。数据库端口默认为 6379。若启用了 TLS,则为 TLS 端口,默认为 6479。

-a

Redis Standalone 实例的用户帐号密码。无密码时可不填写。

说明

如果是使用 default 账号,直接填写 <password> 即可。如果是新创建的账号,则填写 <user>:<password>。例如:账号为 test,密码为 redis@123,则填写 test:redis@123

--tls

启用安全 TLS 连接。

--cert

用于进行身份验证的客户端证书。

--key

用于进行身份验证的私钥文件。

--cacert

用于验证的 CA 证书文件。

连接示例

  • 查询主节点的角色。

     $ ./redis-cli -h 192.168.2.47 info replication
     # Replication
     role:master
     connected_slaves:2
     slave0:ip=192.168.2.47,port=6379,state=online,offset=436236,lag=1
     slave1:ip=192.168.2.46,port=6379,state=online,offset=436236,lag=1
     master_replid:9582e5f0afd04a972fc5c01014a4767bc1efb225
     master_replid2:0000000000000000000000000000000000000000
     master_repl_offset:436373
     second_repl_offset:-1
     repl_backlog_active:1
     repl_backlog_size:1048576
     repl_backlog_first_byte_offset:1
     repl_backlog_histlen:436373
  • 插入一个 Key value 对。

     $ ./redis-cli -h <node_IP> set a b
      OK
  • 获取 Key 的 value。

     $ ./redis-cli -h <node_IP> get a
     "b"