您可以通过 redis-cli 工具来连接和管理 Redis 数据库。本文介绍如何使用 redis-cli 工具通过私网连接 Redis 实例。

前提条件

• 已创建 Redis 实例。创建方法，请参见创建实例。
• 已创建数据库账号和密码。创建方法，请参见创建与管理账号。
• 确保 redis-cli 工具已正确安装。安装方法，请参见安装 redis-cli。

  说明

  为保障兼容性，建议安装与 Redis 版本兼容的 redis-cli，并将 redis-cli 安装在火山引擎 ECS 中，ECS 需与 Redis 实例在同一 VPC 网络。

• 确保安装 redis-cli 的设备 IP 地址已经加入到白名单中。白名单设置方法，请参见设置白名单。
• redis-cli 不支持在连接时验证证书。因此若您已开启了 SSL，将无法通过 redis-cli 进行登录。此时您可以选择其它客户端登录，比如 Redisson 等。

操作步骤

1. 登录 Redis 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 在实例列表页面，单击目标实例名称。
4. 在实例详情页面，单击连接管理页签。
5. 在私网访问区域，单击私网地址后的图标，即可复制私网地址。
6. 登录安装了 redis-cli 的 ECS 实例，执行以下命令：

   src/redis-cli -h <Redis 实例连接地址> -p <端口号> [-c]
   

   参数	说明
   Redis 实例连接地址	即步骤 5 中获取的私网地址连接地址。例如 redis-cnlf12q67ynjy****.redis.ivolces.com
   端口号	Redis 实例的端口号，默认为 6379。
   -c	启用集群模式，只有启用分片集群的 Redis 实例会使用该参数，当您需要使用直连地址连接时，需要在连接实例时加上 -c。关于直连地址的更多信息，请参见开通直连访问。

7. 输入用户名、密码完成验证。如果还未创建账号，请先创建账号。账号创建方法，请参见创建与管理账号。
   您可以选择如下任一方式完成密码验证：
   • 同时输入账号和密码进行验证，命令如下。

     AUTH <username> <password>
     

     或

     AUTH <username>:<password>
     

   • 直接填写密码进行验证，命令如下。

     AUTH <password>
     

   说明

   • 仅使用 default 默认账号时支持直接填写密码进行验证。
   • 如果忘记密码，您可以重置密码。具体操作，请参见修改或重置密码。
   当出现 OK 字样的时候，表示已成功连接 Redis 实例。