Kang Lab

为什么要考虑 Redis 和 Valkey？#

Redis 长期以来几乎是缓存数据库领域的事实标准。无论是缓存、Session 存储、消息队列、分布式锁还是限流组件，大量后端项目都会直接选择 Redis。

但是随着 Redis 许可证变化以及 Valkey 项目的出现，开发者开始面临一个新的问题：

新项目应该继续使用 Redis，还是选择 Valkey？

对于已有项目：

Redis 是否可以无感迁移到 Valkey？

本文主要从实际开发角度，对比两者在：

• 命令兼容；
• 客户端支持；
• Docker 部署；
• 框架生态；
• 数据迁移；

等方面的差异。

Redis 和 Valkey 的关系#

简单来说，Valkey 是基于 Redis 7.2.4 版本代码发展而来的社区分叉项目。

因此，Redis 7.2 系列的大部分功能，在 Valkey 中保持了较好的兼容性。

但是 Redis 后续版本新增功能，不一定会同步到 Valkey。

对于大多数基础使用场景：Redis ≈ Valkey，替换成本较低。

但是：

协议兼容，不代表整个生态完全兼容。

这是迁移时最需要注意的地方。

Redis VS Valkey 核心区别#

从实际使用角度来看，Redis 和 Valkey 的区别并不大。

两者之间最大的差异并不在：

• 数据结构；
• 网络协议；
• 基础命令；

而在于：

• 生态；
• 商业支持；
• 周边工具兼容等方面。

Docker 部署区别#

1
services:
2
  redis:
3
    image: redis:7-alpine
4

5
    container_name: redis
6

7
    ports:
8
      - "6379:6379"
9

10
    volumes:
11
      - ./data:/data
12

13
    command: redis-server --appendonly yes

1
services:
2
  valkey:
3
    image: valkey/valkey:8
4

5
    container_name: valkey
6

7
    ports:
8
      - "6379:6379"
9

10
    volumes:
11
      - ./data:/data
12

13
    command: valkey-server --appendonly yes

Redis 客户端是否支持 Valkey？#

从协议角度来看，大多数 Redis 客户端可以直接连接 Valkey。

因为客户端实际通信使用的是 Redis 协议（RESP），并不会判断服务端到底是 Redis 还是 Valkey。

例如 Python：

1
uv add redis

代码：

1
from redis.asyncio import Redis
2

3

4
redis = Redis(
5
    host="127.0.0.1",
6
    port=6379
7
)
8

9

10
await redis.set(
11
    "name",
12
    "kang"
13
)
14

15

16
value = await redis.get(
17
    "name"
18
)

连接：

Redis：

1
redis://127.0.0.1:6379

Valkey:

1
redis://127.0.0.1:6379

无需修改。

但是需要注意：

客户端兼容，不代表依赖 Redis 的框架完全兼容。

例如：

• redis-py；
• redis-cli；
• Celery Redis Backend；
• Flask-Session；

这些组件虽然底层依赖 Redis 协议，但是部分实现会依赖 Redis 包名或者默认行为。

常见客户端兼容情况：

Redis 命令是否完全兼容？#

基础命令完全一致，例如：

1
SET user:name kang
2

3
GET user:name
4

5
LPUSH queue task1

常用功能：

Redis 可以 100% 平替 Valkey 吗？#

对于缓存、Session、队列等基础场景，大部分情况下可以平替。

但是不能简单认为可以 100% 无差别替换/迁移。

1
Redis Module

1
ACL SETUSER app on >password ~cache:* +get +set

Redis 和 Valkey 如何选择？#

数据是否可以直接迁移？#

1
dump.rdb

1
dump.rdb
2
       |
3
       ↓
4
复制数据文件
5
       |
6
       ↓
7
Valkey启动

1
AOF 文件或持久化目录

1
Redis
2
 ↓
3
同步复制
4
 ↓
5
Valkey

版本兼容问题#

由于 Valkey 基于 Redis 7.2.4 分叉发展，因此，Redis 6.x、Redis 7.0 等版本迁移时， 需要重点确认：

• 数据格式；
• 新特性支持；
• 客户端行为等。

建议迁移前确认 Redis 版本：

1
redis-server --version

不要直接进行迁移。

生态兼容问题#

Redis 与 Valkey 最大的区别，并不是命令兼容性，而是第三方生态兼容。

Redis 协议兼容解决的是：

客户端能不能连接。

但是实际项目中，还有大量组件依赖：

• Redis Python 包；
• Redis 默认导入路径；
• Redis 服务名称；
• Redis 类型判断；
• Redis 特定实现。

因此：

Redis 兼容 ≠ Redis 生态完全兼容。

例如：

Flask-Session 本身只需要一个兼容 Redis 协议的客户端对象。因此，

• 使用 redis-py 时，无需修改；
• 使用 valkey 官方客户端时，需要确认 Flask-Session 版本及 backend 支持情况。

传统配置：

1
SESSION_TYPE = "redis"
2

3
SESSION_REDIS = redis.Redis(
4
    host="localhost",
5
    port=6379
6
)

正常情况下依赖于：

1
import redis

但是部分 Python 生态组件默认依赖 redis 包提供的客户端实现。

因此，当切换到 Valkey 官方客户端时， 可能需要额外调整兼容方式。

例如，原代码：

1
import redis
2

3

4
client = redis.Redis(
5
    host="localhost",
6
    port=6379
7
)

可以通过兼容方式调整为：

1
import valkey
2

3

4
client = valkey.Valkey(
5
    host="localhost",
6
    port=6379
7
)

项目需要同时安装 valkey 和 redis 库。

1
uv add redis valkey

当然，上述代码示例也可通过别的方法实现，本文旨在强调迁移时需要注意三方库支持问题。

常见问题#

总结#

Redis 依靠多年生态积累，仍然是目前最成熟的缓存数据库方案。

Valkey 解决的是：

开源缓存数据库长期维护方向的问题，以及开源许可问题。

从技术角度：

1
Redis ≈ Valkey

从生态角度：

1
Redis > Valkey

从开源路线：

1
Redis < Valkey

实际选择：

• 新项目，可以考虑 Valkey；
• 已有 Redis，无需强制迁移；
• 企业项目，应从多角度综合考虑，更应该关注生态和稳定性。

参考资料#

1. Redis 官方文档：介绍 Redis 数据结构、命令、客户端以及部署方式。
2. Valkey 官方文档：介绍 Valkey 项目、安装部署以及兼容性说明。
3. Redis Python Client 文档：介绍 Python Redis 客户端使用方式。
4. Valkey GitHub Repository：介绍 Valkey 源码、版本发布以及社区维护情况。