使用英语阅读

通过

将 Redis 命令行工具与 Azure Redis 缓存配合使用

  • 项目
  • 2025/05/07
  • 适用于: ✅ Azure Cache for Redis

本文介绍如何使用 redis-cli 命令行接口 作为客户端与 Azure Redis 缓存进行交互。 可以使用 redis-cli 直接与 Azure Redis 缓存实例交互，以及调试和故障排除。

先决条件

访问 Azure Cache for Redis 服务器实例。

安装 redis-cli

redis-cli 工具会自动安装 Redis 包，该包适用于 Linux、macOS 和 Windows。 有关详细的安装说明，请参阅开源 Redis 文档。

在 Linux 上安装

redis-cli 工具在 Linux 上本机运行，大多数 Linux 分发版都包含一个包含 redis-cli 的 Redis 包。 例如，使用以下命令在 Ubuntu 上安装 Redis 包：

sudo apt-get update
sudo apt-get install redis

在 Windows 上安装

在 Windows 上使用 redis-cli 的最佳方法是安装 适用于 Linux 的 Windows 子系统 （WSL），这样就可以直接在 Windows 上运行 Linux 工具。 若要安装 WSL，请参阅 如何使用 WSL 在 Windows 上安装 Linux。

安装后，使用 WSL 安装 Linux 发行版，然后使用所选 Linux 发行版的可用包管理安装 redis-cli。 WSL 的默认发行版为 Ubuntu。 有关详细信息，请参阅开源 Redis 文档。

使用 redis-cli 进行连接

若要使用 redis-cli 作为客户端连接到 Azure Redis 缓存，必须指定缓存主机名、端口和密钥。 可以通过以下方法检索这些值：

以下部分介绍如何从 Azure 门户获取这些值。

从 Azure 门户检索主机名、端口和访问密钥

若要连接到你的 Azure Cache for Redis 服务器，缓存客户端需要该缓存的主机名、端口和密钥。 在某些客户端中，这些项的名称可能略有不同。 可以从 Azure 门户检索主机名、端口和访问密钥。

  • 若要获取访问密钥，请从“资源”菜单中选择“身份验证”。 然后，选择“访问密钥”选项卡。

    显示 Azure Cache for Redis 访问密钥的屏幕截图。

  • 若要获取缓存的主机名和端口，请从“资源”菜单中选择“概述”。 主机名的格式为 <DNS 名称>.redis.cache.chinacloudapi.cn。

    屏幕截图显示 Azure Cache for Redis 属性。

获取其他缓存信息

可能还需要为 redis-cli 指定以下选项：

  • TLS：默认情况下，Azure Redis 实例使用 TLS 加密进行连接。 如果缓存使用 TLS，则必须使用 --tls 此选项为 redis-cli 启用 TLS。
  • 群集：如果有使用群集的高级层缓存，请添加该 -c 选项以确保可以访问所有分片。

运行 redis-cli 连接命令

若要连接到缓存，请在安装了 Redis 包的计算机上打开 shell 或终端。 在 Windows 上，可以将 WSL 与 Windows 终端 配合使用来打开 Linux 命令行。

根据 TLS、端口和群集选项运行以下命令行之一。 将 <cache name> 和 <access key> 占位符替换为缓存的值。

  • 连接到使用 TLS 的基本层、标准层或高级层 Azure Redis 实例：

    redis-cli -p 6380 -h <cache name>.redis.cache.chinacloudapi.cn -a <access key> --tls

  • 连接到不使用 TLS 的基本层、标准层或高级层 Azure Redis 实例：

    redis-cli -p 6379 -h <cache name>.redis.cache.chinacloudapi.cn -a <access key>

  • 连接到使用 TLS 和群集的高级层 Azure Redis 实例：

    redis-cli -p 6380 -h <cache name>.redis.cache.chinacloudapi.cn -a <access key> --tls -c

现在已连接到 Azure Redis 缓存实例。

将 redis-cli 命令与 Azure Redis 缓存配合使用

建立连接后，可以在 redis-cli 命令提示符下向 Azure Redis 实例发出命令。 以下示例演示了与名为contoso的缓存的连接，该缓存使用端口6380。

测试连接的一种简单方法是使用 PING 命令。 该命令在控制台中返回 PONG。

contoso.redis.cache.chinacloudapi.cn:6380> PING
PONG

还可以运行类似 SET 和 GET. 的命令。

contoso.redis.cache.chinacloudapi.cn:6380> SET hello world
OK
contoso.redis.cache.chinacloudapi.cn:6380> GET hello
"world"

redis-cli 的替代项

虽然 redis-cli 是一个有用的工具，但也可以使用以下其他方法连接到缓存进行故障排除或测试：

  • Redis 控制台 允许你发出命令，而无需安装 redis-cli。 Redis 控制台目前仅适用于基本、标准和高级层。 如果 Redis 控制台可用，可以通过在 Azure 门户的缓存概述页顶部工具栏中选择“控制台”来使用它。
  • RedisInsight 是一种丰富的开源图形工具，用于发出 Redis 命令和查看 Redis 实例的内容。 RedisInsight 适用于 Azure Redis 缓存，在 Linux、Windows 和 macOS 上受支持。