通过 redis-cli 连接实例--缓存数据库 Redis 企业版-火山引擎

文档中心

立即注册

导航

通过 redis-cli 连接实例

最近更新时间：2024.12.04 10:53:40首次发布时间：2024.05.10 10:18:41

redis-cli 是社区原生 Redis 自带的命令行工具，您可以在 ECS 实例上通过 redis-cli 连接缓存数据库 Redis 企业版实例，进行数据管理。

连接 Redis 使用的网络类型

网络类型	说明
私有网络	私有网络 VPC（Virtual Private Cloud）是独享的私有网络。当 redis-cli 部署在 ECS 实例上时，通过私有网络连接至 Redis 实例，可获得更高的安全性和更好的性能。
公网	公网即互联网。您可以在本地设备上部署 redis-cli，并通过公网连接 Redis 实例进行测试。说明公网访问不会产生流量费用，但相较于私网访问，公网访问的延迟更高且存在一定的安全隐患，建议仅在测试环境中使用，生产环境推荐使用私网访问。当 VPC 外的设备不再需要访问 Redis 实例时，建议您及时关闭公网访问功能。

网络类型

说明

私有网络

私有网络 VPC（Virtual Private Cloud）是独享的私有网络。当 redis-cli 部署在 ECS 实例上时，通过私有网络连接至 Redis 实例，可获得更高的安全性和更好的性能。

公网

公网即互联网。您可以在本地设备上部署 redis-cli，并通过公网连接 Redis 实例进行测试。

说明

公网访问不会产生流量费用，但相较于私网访问，公网访问的延迟更高且存在一定的安全隐患，建议仅在测试环境中使用，生产环境推荐使用私网访问。当 VPC 外的设备不再需要访问 Redis 实例时，建议您及时关闭公网访问功能。

准备工作

根据 redis-cli 的安装位置，完成相关准备工作。

说明

由于 redis-cli 是原生 Redis 自带的命令行工具，通常您需要通过在 ECS 实例或本地设备上安装 Redis 服务的方式，完成 redis-cli 的安装。具体安装方法，请参见附录：安装 redis-cli。
redis-cli 的版本可以与 Redis 实例的版本不同。

redis-cli 安装位置需完成的操作

redis-cli 安装位置	需完成的操作
ECS 实例	确保 ECS 实例与 Redis 实例属于同一 VPC 网络中。获取 ECS 实例的私网 IP 地址。将 ECS 实例的私网 IP 地址添加至 Redis 实例的白名单中。设置白名单的方法，请参见创建白名单。
本地	缓存数据库 Redis 企业版默认仅提供私网地址。本地应用程序访问 Redis 实例前，需要先为 Redis 实例开启公网访问。开启公网访问的方法，请参见开启公网访问。打开本地设备的命令行窗口或命令终端，参考如下方法选择合适的命令获取本地设备公网 IP 地址： Linux 操作系统：在命令终端中执行 `curl ifconfig.me` 命令。 Windows 操作系统：在命令行窗口中执行 `curl ip.me` 命令。 MacOS 操作系统：在命令终端中执行 `curl ifconfig.me` 命令。将本地客户端的公网 IP 地址添加到 Redis 实例的 IP 白名单中。设置白名单的方法，请参见创建白名单。

ECS 实例

确保 ECS 实例与 Redis 实例属于同一 VPC 网络中。
获取 ECS 实例的私网 IP 地址。
将 ECS 实例的私网 IP 地址添加至 Redis 实例的白名单中。设置白名单的方法，请参见创建白名单。

本地

缓存数据库 Redis 企业版默认仅提供私网地址。本地应用程序访问 Redis 实例前，需要先为 Redis 实例开启公网访问。开启公网访问的方法，请参见开启公网访问。
打开本地设备的命令行窗口或命令终端，参考如下方法选择合适的命令获取本地设备公网 IP 地址：
1. Linux 操作系统：在命令终端中执行 curl ifconfig.me 命令。
2. Windows 操作系统：在命令行窗口中执行 curl ip.me 命令。
3. MacOS 操作系统：在命令终端中执行 curl ifconfig.me 命令。
将本地客户端的公网 IP 地址添加到 Redis 实例的 IP 白名单中。设置白名单的方法，请参见创建白名单。

操作步骤

登录已安装了 redis-cli 的 ECS 实例。
如未安装 redis-cli，请参见附录：安装 redis-cli 进行安装。
打开本地设备的命令行窗口或命令终端工具，进入 redis-cli 安装目录下。不同操作系统进入安装目录命令参考如下：
- Windows 操作系统：cd /d <redis-cli 所属的目录>，例如 cd /d D:redis-6.2.13。
- Linux 操作系统： cd ../<redis-cli 所属的目录>，例如 cd root/redis-6.2.13。
- macOS 操作系统： cd ../<redis-cli 所属的目录>，例如 cd home/redis-6.2.13。
获取连接信息并执行下述命令连接 Redis 实例。
```
src/redis-cli -h <hostname> -p <port>
```
说明
参数说明如下：
- <hostname>：Redis 实例的私网连接地址。获取连接地址的具体方法，请参见查看连接地址。
- <port>：Redis 实例的端口号，默认端口号为 6379。
不同类型连接地址的连接代码示例如下，关于连接地址类型的更多信息，请参见连接地址类型。
- 私网地址连接示例
```
src/redis-cli -h redis-cng6qap*****.redis.ivolces.com -p 6379
```
- 公网地址连接示例
```
src/redis-cli -h redis-cng6qap*****.redis.volces.com -p 6379
```
执行 AUTH 命令完成账密验证。您可以选择如下任一方式完成账密校验：
- 同时输入账号和密码进行验证，命令如下。
```
AUTH <username> <password>
```
- 直接填写密码进行验证，命令如下。
```
AUTH <password>
```
说明
- 仅使用 default 默认账号时支持直接填写密码进行验证。
- 如果忘记密码，您可以重置密码。具体操作，请参见修改或重置密码。
示例如下。
```
AUTH testuser Test@Password
```
验证成功后，会返回 OK。

后续操作

完成验证后即可执行 Redis 命令，例如执行 DBSIZE 命令查询当前库有多少个键（Key）。

附录：安装 redis-cli

说明

在 ECS 实例或本地设备上，安装 Redis 会同步安装 redis-cli。通过 redis-cli 连接时，redis-cli 的版本无需与缓存数据库 Redis 版实例版本相同。
本文操作步骤中以 redis-6.2.13 版本为例，您也可以根据业务需要安装其他版本。更多信息，请参见 Redis downloads。

登录待安装 redis-cli 的设备，例如 ECS 实例或本地设备。
根据操作设备使用的操作系统，选择对应的方法完成下载和安装 redis-cli。
1. Linux
  - 执行下述命令下载 Redis 源码文件。
```
wget https://download.redis.io/releases/redis-6.2.13.tar.gz
```
  - 执行下述命令解压 Redis 源码文件。
```
tar xzf redis-6.2.13.tar.gz
```
  - 执行下述命令进入解压后的目录并编译安装 Redis 源码文件。
```
cd redis-6.2.13 && make
```
2. Windows
  说明
  目前仅支持 64 位的 Windows 系统。
  1. 下载 Redis-x64-3.0.zip文件。
  2. 将 Redis-x64-3.0.zip 解压至待安装的目录。