跳转到主要内容

Redis 插件

Redis 插件是一个由 runtime 管理的 UniversalClient 能力层，而不只是单机模式下的 *redis.Client。

Runtime 事实​

项目值
Go modulegithub.com/go-lynx/lynx-redis
配置前缀lynx.redis
Runtime 插件名redis.client
公开 APIGetRedis()、GetUniversalRedis()

实现里真正支持什么​

这个插件基于 go-redis UniversalClient，支持：

  • 单机、集群、哨兵三种拓扑
  • TLS
  • 启动期和就绪态健康检查
  • 命令级指标与连接池指标
  • 作为更高层插件的共享 runtime 资源

GetRedis() 只会在单机模式下返回 *redis.Client；跨拓扑稳定的 API 是 GetUniversalRedis()。

配置​

lynx:
  redis:
    addrs:
      - "127.0.0.1:6379"
    db: 0
    min_idle_conns: 5
    max_active_conns: 20
    dial_timeout: 5s
    read_timeout: 5s
    write_timeout: 5s

旧文档里用 addr 的示例已经过时，当前配置中心是 addrs。

官方模板实际怎么配​

lynx-layout/configs/bootstrap.local.yaml 当前对 Redis 的配置是：

lynx:
  redis:
    network: tcp
    addrs:
      - 127.0.0.1:6379
    password: lynx123456
    db: 0

这说明模板已经和当前插件形状对齐了：

  • 用的是 lynx.redis
  • 用的是 addrs，不是过时的 addr
  • 本地模板从单机友好的形态起步，但插件本身依然支持 cluster 和 sentinel

如何使用​

import redisplug "github.com/go-lynx/lynx-redis"

universal := redisplug.GetUniversalRedis()
singleNode := redisplug.GetRedis()

除非你明确只跑单机模式，否则应该优先使用 GetUniversalRedis()。

官方模板当前在 internal/data/data.go 里用的是 lynx-redis.GetRedis()，这在它的本地单机 Redis 配置下是成立的。

相关页面​