RedisShake：Redis数据转换与迁移工具

)](https://github.com/tair-opensource/RedisShake/actions/workflows/ci.yml) )](https://tair-opensource.github.io/RedisShake/)

• https://tair-opensource.github.io/RedisShake/
• https://tair-opensource.github.io/RedisShake/en/

概述

RedisShake是一款功能强大的Redis数据转换与迁移工具，主要特性包括：

1. 零停机迁移：实现无缝数据迁移，无数据丢失或服务中断，确保迁移过程中业务持续运行。

2. Valkey/Redis兼容性：支持Redis（2.8至8.4.x）和Valkey（8.x至9.x），涵盖单机、主从、哨兵和集群部署。详见https://tair-opensource.github.io/RedisShake/zh/others/compatibility.html%E4%BA%86%E8%A7%A3%E8%AF%A6%E7%BB%86%E5%8A%9F%E8%83%BD%E6%94%AF%E6%8C%81%E3%80%82

3. 云服务集成：与主流云厂商的类Redis数据库无缝对接：

• 阿里云：Tair (Redis® OSS-Compatible)
• AWS：ElastiCache, MemoryDB

6. 高级数据处理：支持基于https://tair-opensource.github.io/RedisShake/zh/filter/function.html%E5%92%8C%E6%98%93%E7%94%A8%E7%9A%84https://tair-opensource.github.io/RedisShake/zh/filter/filter.html%E3%80%82

如何获取RedisShake

面向用户

1. 从https://github.com/tair-opensource/RedisShake/releases%E4%B8%8B%E8%BD%BD%E3%80%82

2. 使用Docker：

docker run --network host \
-e SYNC=true \
-e SHAKE_SRC_ADDRESS=127.0.0.1:6379 \
-e SHAKE_DST_ADDRESS=127.0.0.1:6380 \
ghcr.io/tair-opensource/redisshake:latest

3. 自行构建：

[!IMPORTANT] 前提条件：运行构建脚本前，系统必须已安装并配置Go环境。

git clone https://github.com/tair-opensource/RedisShake
cd RedisShake
sh build.sh

面向LLM智能体

复制以下提示词到LLM智能体（如Claude Code、Cursor等）：

阅读RedisShake使用指南并协助我完成任务：

如何使用RedisShake

如需在两个Redis实例间迁移数据并跳过部分键：

1. 创建名为shake.toml的文件，包含以下设置：

[sync_reader]
address = "127.0.0.1:6379"

[redis_writer]
address = "127.0.0.1:6380"

[filter]
# 跳过以"temp:"或"cache:"为前缀的键
block_key_prefix = ["temp:", "cache:"]

2. 运行RedisShake：

./redis-shake shake.toml

更多帮助，请查阅https://tair-opensource.github.io/RedisShake/zh/guide/mode.html%E3%80%82

限制

[!IMPORTANT] 不支持可恢复传输（检查点）：RedisShake 4.x不支持可恢复传输。与阿里云DTS或Tair全球多活等商业解决方案不同，后者在中断后可从上次检查点恢复，而RedisShake重启后将从头开始执行全量同步。

[!IMPORTANT] 不支持集群拓扑变更感知：RedisShake假设集群拓扑是静态的。任何拓扑变更（如扩容、故障转移或槽迁移）都会导致进程崩溃。结合缺乏检查点支持，RedisShake最适合一次性数据迁移场景，而非长期持续同步。

跨版本迁移

在不同Redis主版本间迁移数据前，建议使用https://github.com/tair-opensource/resp-compatibility/ 工具进行兼容性检查，并参考**https://github.com/tair-opensource/resp-compatibility/blob/main/compatibility_report_en_US.md**%EF%BC%8C%E4%BB%A5%E9%81%BF%E5%85%8D%E5%B7%B2%E7%9F%A5%E7%9A%84%E7%A0%B4%E5%9D%8F%E6%80%A7%E5%8F%98%E6%9B%B4%E5%92%8C%E7%BC%BA%E9%99%B7%E3%80%82

历史沿革

RedisShake由阿里云https://github.com/tair-opensource%E7%A7%AF%E6%9E%81%E7%BB%B4%E6%8A%A4%EF%BC%8C%E5%85%B6%E5%89%8D%E8%BA%AB%E4%B8%BAhttps://github.com/CodisLabs/redis-port%E3%80%82%E5%85%B3%E9%94%AE%E9%87%8C%E7%A8%8B%E7%A2%91%EF%BC%9A

• https://github.com/tair-opensource/RedisShake/tree/v2%EF%BC%9A%E6%8F%90%E5%8D%87%E7%A8%B3%E5%AE%9A%E6%80%A7%E5%92%8C%E6%80%A7%E8%83%BD%E3%80%82
• https://github.com/tair-opensource/RedisShake/tree/v3%EF%BC%9A%E5%AE%8C%E5%85%A8%E9%87%8D%E5%86%99%E4%BB%A3%E7%A0%81%E5%BA%93%EF%BC%8C%E6%8F%90%E9%AB%98%E6%95%88%E7%8E%87%E5%92%8C%E6%98%93%E7%94%A8%E6%80%A7%E3%80%82
• https://github.com/tair-opensource/RedisShake/tree/v4%EF%BC%9A%E5%A2%9E%E5%BC%BA%E8%AF%BB%E5%8F%96%E5%99%A8%E3%80%81%E9%85%8D%E7%BD%AE%E3%80%81%E5%8F%AF%E8%A7%82%E6%B5%8B%E6%80%A7%E5%92%8C%E5%8A%9F%E8%83%BD%E3%80%82

许可证

RedisShake基于https://github.com/tair-opensource/RedisShake/blob/v2/license.txt%E5%BC%80%E6%BA%90%E3%80%82