You need to enable JavaScript to run this app.
文档中心
缓存数据库 Redis 版

缓存数据库 Redis 版

复制全文
下载 pdf
连接实例
通过私网连接实例
复制全文
下载 pdf
通过私网连接实例
您可以通过 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 控制台。​
  1. 在顶部菜单栏选择实例所属的项目和地域。​
  1. 在实例列表页面,单击目标实例名称。​
  1. 在实例详情页面,单击连接管理页签。​
  1. 在私网访问 > 代理私网访问区域,单击代理私网地址后的图标,即可复制代理私网地址。​
  1. 登录安装了 redis-cli 的 ECS 实例,执行以下命令:​
  • ​
    src/redis-cli -h <Redis 实例连接地址> -p <端口号> [-c]​
    ​
  • ​
    参数​
    说明​
    Redis 实例连接地址​
    即步骤 5 中获取的私网地址连接地址。例如 redis-cnlf12q67ynjy****.redis.ivolces.com。​
    端口号​
    Redis 实例的端口号,默认为 6379。​
    -c​
    启用集群模式,只有启用分片集群的 Redis 实例会使用该参数,当您需要使用直连地址连接时,需要在连接实例时加上 -c。关于直连地址的更多信息,请参见申请直连地址。​
    ​
  1. 输入账号和密码完成验证。如果还未创建账号,请先创建账号。账号创建方法,请参见创建与管理账号。​
  • 您可以选择如下任一方式完成账密验证:​
  • 同时输入账号和密码进行验证,命令如下。​
  • ​
    AUTH <username> <password>​
    ​
  • 或​
  • ​
    AUTH <username>:<password>​
    ​
  • 直接填写密码进行验证,命令如下。​
  • ​
    AUTH <password>​
    ​
说明​
  • 仅使用 default 默认账号时支持直接填写密码进行验证。​
  • 当出现 OK 字样的时候,表示已成功连接 Redis 实例。​
后续操作​
完成验证后您可以先为当前连接设置连接级别的读写分类策略,然后即可根据业务需要执行 Redis 相关命令,例如执行 DBSIZE 命令查询当前库有多少个键(Key)。关于缓存数据库 Redis 版支持的命令详情,请参见命令支持。​
​
最近更新时间:2026.10.16 11:34:42
这个页面对您有帮助吗?
有用
有用
无用
无用