// redis、valkey 及小伙伴们

一个能够访问每个节点的 Redis 集群和 Sentinel 图形界面

集群常常藏在堡垒机、NAT 和 Docker 端口映射后面,节点通告的地址你的笔记本根本连不上。主节点故障时,哨兵会切换主节点。SQLly 会把每条命令路由到拥有对应槽的节点,重写连不通的地址,逐个追踪节点,并在故障转移时全程跟随,绝不重复应用任何写入。

跟随集群的槽位路由

在服务器字段中填写一个或多个种子节点,以逗号分隔,或直接粘贴一个 redis:// 带有多个主机的 URL。 集群模式 会在会话首次连接时检测集群,你也可以把它设置为始终或从不按槽路由。

  • 每个命令都会路由到其槽位所属的节点。 在故障转移或重新分片之后, MOVED 和 ASK 回复会被跟踪,槽位映射也会更新;消息窗格会说明脚本遇到了多少次重定向。
  • 每个主节点上的所有工具。 键浏览器会逐个遍历主节点,内存分析器按键数拆分采样,批量删除会分批 UNLINK 按槽位,Profiler 和 Pub/Sub 查看器添加了一个 节点 列。
  • 分片发布/订阅。 输入频道名,带前导 #,例如 #orders,它由拥有它的主节点使用 SSUBSCRIBE 在拥有它的主节点上。
MGET user:{42}:profile user:{42}:cart
SQLLY.KEYS user:* 1000
SQLLY.TOPOLOGY
SQLLY.TRACE

共用同一哈希标签的键会落在同一个槽,因此 MGET 运行。 SQLLY.KEYS 以分页方式遍历每个主节点,游标可以在主节点之间延续,并且 SQLLY.TOPOLOGY 和 SQLLY.TRACE 则是以只读命令形式提供的拓扑视图及其跟踪。

为无法拨号的地址准备的节点映射

集群节点用它们配置好的通告地址告诉客户端其他节点在哪里。而在 NAT、Docker 端口映射或 SSH 堡垒机之后,这些往往是内网地址。 集群节点映射 需要 announced => dial 对;通告地址仍会在槽映射中指代节点,用于重定向并作为 TLS 服务器名称,而只有套接字才连接到拨号地址。

10.0.0.5:7001 => 127.0.0.1:17001
10.0.0.6:7002 => 127.0.0.1:17002
10.0.0.7:7003 => 127.0.0.1:17003

每个节点各建一条 SSH 转发

在带 SSH 跳板或 SOCKS 或 HTTP 代理的连接上,SQLly 会经由相同的跳板,为集群列出的每个节点各开一条本地转发,因此只有堡垒机能访问的节点也照样可用。节点映射会先应用,所以它也能改写堡垒机拨号的目标。

节点映射和 SSH →

TLS 按正确的名称进行校验

每个节点的证书都会对照它所宣告的地址来校验,而不是本地转发地址,因此正确签发的证书能通过隧道完成验证。隧道在静默 30 秒后发送 keepalive,并在断开后重新连接。

TLS 模式 →
截图即将提供redis-cluster-node-map-editor.webp —— 7100–7105 集群示例数据的连接编辑器,集群模式设为 Redis Cluster,三条节点映射行把公布地址重写为本地转发
集群节点映射:每行显示一对“公告地址 => 拨号地址”,适用于 NAT、Docker 或堡垒机后方的集群。

这些已报告的 Redis Insight 问题正是节点映射和按节点转发所要应对的场景: #6537 (通过本地转发的 SSH 端口连接的集群报“Failed to refresh slots cache”错误) 和 #5722 (带有 TLS 和主机名的不完整集群拓扑)。请查看功能跟踪表了解各项目目前的进展。

拓扑,外加每个节点的跟踪

打开 集群拓扑… 可以从数据库的右键菜单、命令面板或集群连接的服务器仪表板中获取。它列出了每个节点, CLUSTER SHARDS (或者 CLUSTER NODES 7.0 之前的版本)连同它的角色、槽位、健康状态、复制偏移量、链路状态、它对外宣告的地址、SQLly 实际拨连的地址以及它发送的 TLS 名称。页脚会检查全部 16,384 个槽位是否都已覆盖,并指出任何不健康或被重新映射的节点。

截图即将提供redis-cluster-topology-trace.webp — 7100–7105 集群示例数据上的集群拓扑:三个主节点和三个副本节点,含槽位、健康状态和实际连接地址,页脚确认全部 16,384 个槽位已覆盖,以及一个节点的跟踪行
跟踪会对每个节点执行“测试连接”的各个步骤,因此第一个失败的行会直接说明该修什么。

跟踪 对每个节点执行与“测试连接”相同的逐步检查——名称查找、隧道或代理(结合节点映射)、TCP、TLS、登录、协议与 ping、数据库以及集群状态——每个步骤一行。错误的节点映射条目、被封锁的端口、TLS 名称不匹配或 ACL 问题会显示在第一个失败的行上。

集群会拒绝什么,为什么

以上每一种都会在发送前被拒绝,并附带指明规则和修复方法的消息。

SQLly 在 Redis 集群连接上拒绝的命令
命令原因,以及相应的替代方法
跨槽位的多键命令MGET, MSET,一个多键 DEL, SUNION, RENAME 等类似操作只有在所有键都落在同一个槽里时才能运行。给相关的键指定一个共同的哈希标签: user:{42}:profile 和 user:{42}:cart.
SELECT 除了 0 之外集群只有一个逻辑数据库。复制到数据库…和 MOVE 会改为引导你使用复制到连接…功能。
KEYS 和 SCANKEYS 会阻塞每个主节点和一个 SCAN 游标属于一个节点。使用键浏览器或 SQLLY.KEYS.
MULTI / EXEC每条命令都单独路由,因此在编辑器里无法让事务固定在同一个节点上。

Sentinel:每次都是当前主节点

开启 通过 Sentinel 连接,填入主节点名和哨兵地址,如果哨兵要求密码,再加上哨兵密码。每次连接时,SQLly 会依次询问各个哨兵当前的主节点,确认那台服务器确实是主节点,然后连上去;Test 按钮会报出主节点和应答哨兵的名字。

redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret
  • 读取时优先使用副本。 仅由只读命令组成的脚本在健康的副本上运行;任何写入操作都在主服务器上运行。
  • 故障转移后读取依然可用。 SQLly 每个脚本会再次询问一次哨兵,而只读脚本会重新运行失败的命令并继续执行。
  • 写操作从不重新运行。 执行写入的脚本会停止,并显示 主节点已更改,请重新运行 并指定新的主节点,因为写入可能恰好在旧主节点下线之前才完成。
截图即将提供redis-sentinel-test-result.webp — 开启 Connect through Sentinel 的连接编辑器,主节点名 mymaster,哨兵为 127.0.0.1:26379,测试结果会写明应答的主节点和报告它的哨兵
在 Sentinel 连接上运行测试时,会报出主节点以及指向它的哨兵的名字。

Sentinel 和 Cluster 连接目前还不能做的事情

  • Sentinel 连接会直接拨号连接各 Sentinel 节点、主节点和副本,因此不支持 SSH 隧道、代理和 Kubernetes 端口转发;中继路由也尚不支持 Sentinel。Profiler 和 Pub/Sub 查看器会连接到当前主节点。
  • 在集群中,Kubernetes 端口转发只能到达种子节点,通过中继桥的连接尚不支持集群模式。
  • ElastiCache 集群模式和 MemoryDB 尚未针对实际的 AWS 实例进行测试。

ElastiCache 集群模式和 MemoryDB

对于集群模式的 ElastiCache,将连接指向集群的配置端点;启用传输中加密时使用 TLS Require 或 Verify full。MemoryDB 始终是集群且始终使用 TLS,在 Username 字段中填写其 ACL 用户名,集群拓扑视图会列出其分片。两者都按与上面相同的规则把每条命令路由到拥有对应槽的分片。用户由 AWS 管理,因此不提供 ACL 页面。

关于 Cluster 和 Sentinel 的问题

SQLly 可以连接到 SSH 堡垒机后面的 Redis Cluster 吗?

可以。在带 SSH 多级跳板或 SOCKS、HTTP 代理的连接上,SQLly 会沿同一路由为集群里的每个节点各开一条独立转发;集群节点映射会重写堡垒机或你本机无法直连的宣告地址。Kubernetes 端口转发一次只能带一个端口,所以只能到达种子节点。

集群节点映射的作用是什么?

集群节点会通告它们配置的地址,而在 NAT 或 Docker 端口映射之后,这些地址往往是内网地址。每个节点写一行,例如 10.0.0.5:7001 => 127.0.0.1:17001,告诉 SQLly 实际应连接的地址;通告地址则继续用作重定向时的节点名称和 TLS 服务器名称。

为什么 SQLly 在集群上拒绝执行 KEYS、SCAN 或 MGET?

集群无法原样执行这些命令:KEYS 会阻塞每个主节点,SCAN 游标只属于单个节点,多键命令要求所有键都在同一个槽中,集群只有数据库 0,而 MULTI/EXEC 无法从编辑器保持在单个节点上。SQLly 会在发送前拒绝这些命令,并给出说明规则的消息;可以为相关的键加上相同的哈希标签,例如 {42},或者使用键浏览器。

发生 Sentinel 故障转移时,写操作会发生什么?

它不会替你重新执行。SQLly 会向哨兵询问一次新的主节点,然后把连接转移过去;只读脚本会继续执行,而会写入的脚本会停止并提示“主节点已更换,请重新运行”,因为写入可能已经落到旧的主节点上。先检查,然后再重新运行。

哨兵连接可以从副本读取吗?

可以。开启“读取首选副本”后,仅由只读命令组成的脚本会在哨兵报告健康的副本上运行,没有健康的副本时就由主节点响应。任何写操作、用到 SELECT 或读取服务器级信息的操作都在主节点上执行。副本是异步的,所以读到的数据可能短暂落后于主节点。

SQLly 是否支持 ElastiCache 集群模式和 MemoryDB?

是的,这是有意设计:把 ElastiCache 连接指向集群的配置端点即可;MemoryDB 本身就是集群,集群拓扑视图会列出它的分片。两者都还没在真实的 AWS 实例上测过。

// 在你自己的集群上试试

每个节点,一个窗口

可在 macOS、Windows 和 Linux 上免费开始使用,无需账户。