Redis单节点主从复制数据迁移

Redis 单节点主从复制迁移

1. 背景说明

适用于 Redis 单节点迁移场景。

两个 独立的单节点 Redis 实例，需要将旧 Redis 中的数据迁移到新 Redis.

本方案采用 Redis 主从复制方式迁移，优点：

流程简单
支持 不停机 / 最小停机，最小业务影响
官方推荐方案

2. 环境信息（供参考）

2.1 Redis 信息

部署模式：部署2个单节点的Redis服务，Standalone（节点数为1）
Redis 内核版本：7.0.4
Sentinel：未启用（ps -ef | grep sentinel）

2.2 节点信息（供参考）

角色	IP	端口
旧 Redis（源）	172.172.10.185	6379
新 Redis（目标）	172.172.10.126	6379

3. 前置检查

3.1 Redis 版本检查

确保 新 Redis 版本 ≥ 旧 Redis 版本

我这里的命令供参考，实际命令根据自身情况修改，比如直接redis-cli --version

bash 复制代码

/opt/redis/bin/redis-cli --version

4. 迁移流程

4.1 建立主从复制关系

在 目标 Redis（172.172.10.126） 上执行：

bash 复制代码

/opt/redis/bin/redis-cli

redis 复制代码

# 源Redis服务ip端口
REPLICAOF 172.172.10.185 6379

返回结果：

text 复制代码

OK

4.2 验证主从状态

目标 Redis（从库）

redis 复制代码

info replication

关键字段应为：

text 复制代码

role:slave
master_host:172.172.10.185
master_port:6379
master_link_status:up

源 Redis（主库）

redis 复制代码

info replication

应看到：

text 复制代码

connected_slaves:1

4.3 等待数据同步完成

Redis 会自动执行：

RDB 全量同步
命令增量同步

在新 Redis 上确认：

redis 复制代码

info persistence

text 复制代码

loading:0

表示同步完成。

5. 数据校验

5.1 Key 数量对比

bash 复制代码

/opt/redis/bin/redis-cli -h 172.172.10.185 dbsize
/opt/redis/bin/redis-cli -h 172.172.10.126 dbsize

结果应一致或极接近。

5.2 抽样校验数据

bash 复制代码

/opt/redis/bin/redis-cli -h 172.172.10.185 get some_key
/opt/redis/bin/redis-cli -h 172.172.10.126 get some_key

6. 迁移完成后解除主从关系

在 目标 Redis（172.172.10.126） 上执行：

redis 复制代码

REPLICAOF no one

验证：

redis 复制代码

info replication

text 复制代码

role:master

至此，完成迁移。

7. 注意事项

新 Redis 非空，无法建立复制
忘记使用重命名命令（KREPLICAOF）
网络 / 防火墙未放行 6379
数据未同步完成就切业务
先解除主从再切业务