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 地址。

    node role pub
  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"