# Redis-HA-Tool
**Repository Path**: FreeIPCC/Redis-HA-Tool
## Basic Information
- **Project Name**: Redis-HA-Tool
- **Description**: No description available
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-10
- **Last Updated**: 2026-07-18
## Categories & Tags
**Categories**: Uncategorized
**Tags**: Redis, cluster, Master, slave
## README
# Redis-HA-Tool
一站式企业级 Redis 数据治理工具，面向缓存集群迁移、异地灾备、双活多活、数据备份恢复全场景，基于 Redis Replication 协议实现全量+增量数据流转，内置高可用故障切换与断点续传能力，解决传统同步工具无HA、中断重跑、仅单向同步、备份恢复割裂等痛点。
## 一、项目简介
`Redis-HA-Tool` 是面向生产环境打造的一体化 Redis 数据运维套件，统一覆盖**离线备份、数据恢复、跨集群单向复制、双向双活同步**四大核心能力。
兼容 Standalone、Sentinel、Redis Cluster 多架构，适用于机房迁移、异地容灾、同城多活、故障回滚、数据冷热归档等业务场景，具备企业级稳定性与链路自愈能力。
### 核心关键词
Redis同步、Redis双活、跨集群迁移、断点续传、主备高可用、故障自动切换、RDB备份、数据恢复、单向复制、双向同步、增量同步、全量同步、异地多活、缓存灾备、Replication协议、链路自愈
## 二、核心能力一览
### 1. 数据备份 & 恢复（离线数据治理）
- **Dump 全量备份**：解析源库 RDB/AOF，导出标准化备份文件，支持定时自动备份、分片集群并行导出
- **Restore 数据回滚**：本地备份文件一键恢复至任意 Redis 实例/集群，支持分库、Key 前缀过滤导入
- 适配数据归档、故障应急回滚、测试环境快速造数场景
### 2. 单向数据同步（迁移/灾备）
模拟 Redis Slave 拉取 Replication 数据流，全量初始化+实时增量同步：
- 支持单机 ↔ 哨兵 ↔ Cluster 异构集群互通
- 业务不停服迁移、异地只读灾备、数据分流镜像场景专用
### 3. 双向数据同步（同城/异地多活）
内置循环写入防冲突机制，支持双集群实时双向数据流转：
- 双写多活架构、同城双机房高可用、异地单元化业务
- 自动识别同源同步指令，避免环形复制数据风暴
### 4. HA 高可用架构（工具自身高可用）
- 同步服务主备双节点部署，故障自动 Failover
- 主节点宕机后备节点自动接管同步链路，不中断数据流转
- 任务元数据持久化，切换后无缝承接增量同步
### 5. 断点续传（链路自愈核心特性）
- 持久化同步位点（repl offset / AOF 偏移）
- 网络抖动、进程重启、节点宕机后，从上次中断位置增量续传，无需重跑全量
- 支持长断连场景，自动追平积压增量数据，大幅降低重同步耗时
## 三、产品核心特性
✅ **全链路一体化**：备份、恢复、单向同步、双向双活同一工具闭环，无需多组件组合
✅ **原生断点续传**：持久化同步位点，中断免全量重传，大幅节省大集群迁移成本
✅ **工具层 HA 主备切换**：同步服务集群化部署，故障自动切换，保障7×24小时同步稳定
✅ **双模式复制支持**
- 单向同步：集群迁移、异地只读灾备、数据镜像
- 双向同步：同城多活、异地双机房单元化业务
✅ **全架构兼容**：Standalone / Sentinel / Redis Cluster 互通同步
✅ **低侵入同步**：基于 Redis 原生 Replication 协议，源库无需改造、无业务侵入
✅ **全量+增量双通道**：首次全量初始化，后续实时增量追数，支持不停机迁移
✅ **数据一致性保障**：双向同步内置防循环复制策略，避免数据冲突、重复写入
✅ **轻量化部署**：单二进制包运行，支持 Docker、K8s 容器化运维
## 四、典型适用场景
1. **Redis 集群迁移升级**：旧集群 → 新集群单向不停服迁移
2. **异地容灾备份**：生产集群单向同步至异地备用集群
3. **同城/异地双活多活**：双机房 Redis 双向实时同步，业务双写高可用
4. **定时数据归档**：自动 RDB 备份，故障快速 Restore 回滚
5. **多单元业务数据互通**：多地域业务集群双向数据互通
## 五、对比同类工具优势
- 区别 RedisShake / redis-migrate-tool：内置**HA主备故障切换**、原生支持**稳定双向同步**，统一集成备份恢复能力
- 传统工具短板：无高可用、中断需重全量、双向同步需复杂二次开发、备份同步分离；本工具一站式解决
## 六、联系方式
---
# Redis-HA-Tool
All-in-one enterprise Redis data governance toolkit, integrates Redis backup, restore, one-way replication & bidirectional active-active sync.
### Key Capabilities
- Breakpoint resume for sync tasks, no full resync after interruption
- HA master-slave failover architecture for sync service high availability
- Full RDB/AOF backup & point-in-time data restore
- Cross-cluster one-way sync for migration & disaster recovery
- Bidirectional active-active sync with circular write conflict prevention
- Compatible with Standalone, Sentinel, Redis Cluster
### Scenarios
Live cluster migration, cross-region disaster backup, multi-datacenter active-active architecture, cache data archiving & rollback.
# Redis 全系列高可用架构对比 \+ 自研多集群双活增强架构（官方推荐终版架构）
## 一、原生 Redis 官方所有架构汇总（优缺点 \& 适用场景）
为了清晰体现本项目的架构价值，我们先完整梳理业界所有标准 Redis 多机 HA 架构，并明确其**原生天生缺陷**，最后引出本项目自研的企业级终极架构。
### 1\.1 纯主从架构（基础架构，无HA）
**架构拓扑**：1Master \+ N Slave
**能力**：数据单向复制、读写分离、数据备份
**致命缺陷**：无自动故障转移、无监控、无法跨集群同步、不支持异地容灾
**定位**：非高可用架构，生产禁止独立使用
### 1\.2 Sentinel 哨兵架构（单集群HA，中小业务标准）
**架构拓扑**：1主多从 \+ 3/5哨兵节点监控
**能力**：单集群内自动故障转移、节点高可用、数据多副本
**原生短板**：
- **不支持数据分片**，单节点容量瓶颈严重
- **仅支持集群内单向复制**，无法多集群互通
- **无异地多活能力**，只能单集群HA，机房级故障无法兜底
- 无官方备份恢复、断点续传能力
**定位**：单机房、小数据量、无异地容灾需求业务
### 1\.3 Redis Cluster 原生分片集群（分布式HA，业界主流）
**架构拓扑**：3主3从及以上分片架构，每分片自带主从HA
**能力**：数据分片、水平扩容、单集群内故障自动切换、海量数据存储
**原生致命短板（业界长期痛点）**：
- **绝对无法跨集群同步**：多套独立 Cluster 集群完全孤岛，原生不支持集群间数据同步
- **仅单向主从复制**，完全**不支持双向同步、异地双活**
- 无断点续传，集群迁移/同步中断必须全量重传
- 无统一备份恢复体系，数据误删、集群损坏难以回滚
- 多机房部署只能做节点交叉部署，**无法实现真正异地多活互写**
**定位**：单机房分布式缓存，**不具备企业级异地容灾、双活能力**
### 1\.4 Proxy 代理集群（Codis/Redis\-Proxy）
**架构拓扑**：Proxy 接入层 \+ 后端 Cluster 集群
**能力**：屏蔽分片、统一接入、限流路由
**短板**：仅解决接入层问题，**完全没有解决多集群数据互通、双向多活、灾备同步问题**
---
## 二、原生所有架构的共性瓶颈（行业痛点）
无论哨兵、原生 Cluster、Proxy 架构，官方原生能力存在无法突破的天花板：
- ✅ 只能**单集群内部HA**，**多集群数据完全孤岛**
- ✅ 只支持**单向主从复制**，无任何官方双向同步、双活方案
- ✅ 无集群级备份恢复、无断点续传同步机制
- ✅ **无法实现真正异地双活、跨机房容灾**，只能做简单冷备
---
## 三、本项目：Redis 多集群全域双活高可用架构
**本架构为原生 Redis 架构的超集与终极增强**，兼容：单机 / Sentinel / Redis Cluster 所有底层架构，同时补齐官方所有短板，是目前唯一支持**集群级双向多活、跨机房实时同步、全域数据容灾**的一体化架构。
### 3\.1 整体架构拓扑（标准生产架构）
**多集群分层高可用架构**
```Plain Text
# 异地机房A（主业务集群）
Redis Cluster / Sentinel 主集群（提供读写服务）
↕️（本工具双向实时同步+断点续传）
# 异地机房B/备用集群
Redis Cluster / Sentinel 备用集群（双活互写/灾备兜底）
# 本系统核心能力层（贯穿所有集群）
1. 集群级全量/增量数据备份 & 定点恢复
2. 跨集群 单向同步 / 双向双活同步
3. 同步链路断点续传、自动续跑
4. 跟随Redis主备切换，链路无感HA
5. 多集群数据一致性校验、冲突解决
```
### 3\.2 架构核心能力（独有、原生不具备）
#### ✅ 1\. 真正的**集群级跨机房双向双活**
打破原生单集群孤岛限制，支持**多套独立 Redis Cluster / 哨兵集群**之间双向实时数据同步，多机房业务可同时读写，是真正意义上的企业级异地多活架构，而非原生伪双活。
#### ✅ 2\. 灵活的多集群单向/双向同步能力
支持自由切换同步模式：
- **单向同步**：生产→灾备、线上→测试、数据镜像下沉
- **双向同步**：同城双活、异地多活、双集群平滑迁移
#### ✅ 3\. 工业级断点续传同步机制
全量同步、增量同步均支持断点续传，网络抖动、服务重启、集群节点变更后，自动从历史位点继续同步，无需全量重传，解决TB级大集群同步耗时、带宽压力大的行业难题。
#### ✅ 4\. 全域数据备份 \& 定点恢复体系
支持单机、哨兵、Cluster 全架构集群级备份，支持时间点恢复、跨集群恢复、误删数据回滚，补齐 Redis 无官方统一数据恢复能力的短板。
#### ✅ 5\. 同步链路自带高可用（跟随Redis主备切换）
自动感知 Redis 集群主备切换、哨兵故障转移，同步链路自动适配新主节点，无需人工修改配置；同步服务本身支持主备部署，彻底消除同步链路单点故障。
### 3\.3 本架构 VS 原生所有架构 核心差异
|架构能力|原生主从|哨兵Sentinel|原生Cluster|**本项目增强架构**|
|---|---|---|---|---|
|单集群高可用|❌|✅|✅|✅|
|数据分片扩容|❌|❌|✅|✅|
|多集群数据互通|❌|❌|❌|✅ **支持**|
|跨集群双向双活|❌|❌|❌|✅ **支持**|
|断点续传同步|❌|❌|❌|✅ **支持**|
|集群级备份恢复|❌|❌|❌|✅ **支持**|
|异地多活容灾|❌|❌|❌|✅ **支持**|
### 3\.4 架构定位：企业级最终推荐方案
本架构**完全兼容所有原生Redis架构**，不推翻现有部署、无业务侵入、无需改造客户端，同时解决了行业多年无法解决的**多集群孤岛、无双向多活、同步不可靠、数据无兜底**核心问题。
**是目前生产环境下，唯一同时满足「单集群HA \+ 分布式扩容 \+ 跨机房双活 \+ 数据全域兜底」的终极 Redis 高可用架构。**
## 四、适用业务场景
- **异地容灾**：生产集群 ↔ 异地灾备集群 单向同步，数据永久兜底
- **同城双活**：双机房集群双向实时同步，业务无感故障切换
- **集群平滑迁移**：新旧集群双向同步，零停机迁移扩容
- **数据镜像分析**：线上数据同步至离线分析集群，隔离业务压力
- **企业级数据运维**：定时备份、误删恢复、断点稳定同步，保障数据安全
# 🤝欢迎 Star、使用我们团队的其它产品
大模型呼叫中心系统：https://github.com/lihaiya/freeipcc
大模型人力资源系统：https://github.com/FreeAiHR/FreeAiHR
Redis集群双活架构工具：https://github.com/GouSanDian/Redis-HA-Tool
企业私有化部署的软件管家：https://github.com/GouSanDian/AppHub
自然语言对话数据库（目前在设计阶段）：https://github.com/GouSanDian/Talk-To-DB
大模型沙盘系统（目前在设计阶段）：https://github.com/AiSandTable/AiSandTable
大模型智能运维系统（持续迭代中）：https://github.com/lihaiya/FreeAiOps
# 联系我们
## 微信群
## 客服微信
