RedisShake同步单机Redis数据至哨兵集群的配置要点

问题背景

在使用RedisShake工具进行数据迁移时，用户尝试将单机Redis实例的数据同步到哨兵(Sentinel)集群环境中，遇到了配置问题导致同步失败。本文将通过分析这一案例，详细介绍RedisShake在单机到哨兵集群同步场景下的正确配置方法。

错误现象分析

用户最初遇到的错误日志显示："dial tcp: missing address"，这表明RedisShake无法正确解析目标地址。进一步检查发现，用户在配置文件中同时设置了sentinel=true和address参数，但未正确配置master名称。

配置详解

源端配置（单机Redis）

对于单机Redis作为源端的情况，配置相对简单：

[sync_reader]
cluster = false
address = "192.168.101.24:6480"
password = "your_password"

关键点：

• cluster必须设为false
• address填写单机Redis的完整地址和端口
• 如果启用了认证，需要填写正确的password

目标端配置（哨兵集群）

这是最容易出错的部分。根据RedisShake的实现机制，当目标端是哨兵集群时，有两种配置方式：

方式一：直接连接主节点

[redis_writer]
cluster = false
sentinel = false
address = "主节点IP:端口"

这种方式适用于：

• 已知主节点地址且地址稳定
• 不关心哨兵自动故障转移的情况

方式二：通过哨兵发现主节点

[redis_writer]
cluster = false
sentinel = true
master = "哨兵中注册的主节点名称"
address = "哨兵节点IP:端口"

这种方式适用于：

• 需要自动感知主从切换的场景
• 主节点地址可能变化的环境

配置误区与修正

用户遇到的典型错误包括：

1. 同时设置sentinel=true和address参数：当sentinel=true时，address应该指向哨兵节点而非Redis主节点。

2. 未正确配置master名称：通过哨兵连接时必须指定在哨兵中注册的主节点名称。

3. 混淆连接对象：需要明确是直接连接Redis主节点还是通过哨兵代理连接。

正确配置应该根据实际需求选择上述两种方式之一。在用户的案例中，由于可以直接访问主节点，采用方式一更为简单可靠。

最佳实践建议

1. 网络连通性检查：确保RedisShake能够访问源Redis和目标Redis/哨兵的所有相关端口。

2. 认证信息验证：确认密码等认证信息在源端和目标端都配置正确。

3. 版本兼容性：虽然Redis 6.x版本间兼容性较好，但仍建议测试环境先行验证。

4. 监控同步状态：通过RedisShake的状态端口或日志监控同步进度和异常。

5. 大Key处理：对于可能存在的超大Key，适当调整target_redis_proto_max_bulk_len参数。

总结

RedisShake作为Redis数据迁移的强大工具，支持多种部署架构间的数据同步。理解其配置参数的实际含义，特别是源端和目标端不同部署模式下的配置差异，是成功实施迁移的关键。对于单机到哨兵集群的同步场景，根据是否依赖哨兵的自动发现功能选择合适的配置方式，可以避免常见的连接错误。