动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

应用场景

存储引擎

产品系列

产品版本

规格与性能

读写分离

多可用区部署

地域和可用区

名词解释

购买指南

计费概述

定价中心

购买实例

续费说明（包年包月）

退费说明（包年包月）

欠费说明

按量转包年包月

快速入门

快速创建实例

连接 Redis 实例

操作指南

操作总览

连接数据库实例

管理实例

升级实例

管理节点（Redis/ValKey 版）

管理多可用区

备份与恢复

账号管理

参数配置

慢查询

访问管理

网络与安全

监控与告警

事件管理（Redis/ValKey 版）

数据迁移

Redis 版全球复制

数据库审计

诊断优化

Sentinel 模式

开发准则

命名规则

基本使用准则

Key 与 Value 设计原则

命令使用准则

客户端程序设计准则

连接池配置

命令参考

命令参考概览

Redis 版与 Valkey 版命令兼容性

大版本命令使用差异

Proxy 架构与直连模式的使用差异

命令更多操作（Redis/Valkey 版）

Memcached 版命令兼容性

实践教程

基于 Spring Boot 搭建 Redis 客户端监控

Redis 客户端连接配置策略与实践

集群架构全局 SCAN 使用指南

实例安全下线

热 Key 与大 key

可用区迁移方案

故障处理

连接异常

Redisson 客户端超时重连异常分析及解决方案

性能排查与调优

API 文档

History

Introduction

API Category

Making API Requests

Instance APIs

Parameter Management APIs

Other APIs

Backup and Restoration APIs

Region APIs

Monitoring and Management APIs

Log APIs

Data Types

Error Codes

常见问题

使用常见问题

连接登录问题

购买相关问题

使用 redis-port 进行迁移

PDF

聚焦模式

字号

最后更新时间： 2026-03-18 10:07:33

工具介绍
﻿redis-port（Linux 64 位）是一组开源工具集合，主要用于腾讯云分布式缓存数据库节点间的数据库同步、数据导入、数据导出，支持分布式缓存数据库 Redis 协议的跨版本数据迁移。其包括以下工具：
redis-sync：支持在 Redis 版实例之间进行数据迁移。
redis-restore：支持将 Redis 的备份文件（RDB）导入到指定实例。
redis-dump：支持将 Redis 的数据备份为 RDB 格式文件。
redis-decode：支持将 Redis 备份文件（RDB）解析为可读的文件。
兼容版本
支持源 Redis 2.8、3.0、3.2、4.0 版本。
支持目标实例为 Redis 2.8、3.0、3.2、4.0 及以上版本。
redis-sync 在线迁移
迁移原理
redis-sync工具分为两大模块，该工具模拟位复制节点，从源实例持续同步数据，并将复制的数据翻译成写入命令更新到目标实例。
复制数据分为两个阶段，全量同步阶段和增量同步阶段。
说明：
目标实例的 DB 数量要求大于源实例的 DB 数量，否则迁移将失败。
如果迁移中途因为网络中断或者其他原因断开，需要先清空目标实例然后再次执行迁移，否则可能出现脏数据。
迁移的进度，日志显示 "sync: rdb = 9063349 - [100.00%]" 表示全量数据已经完成同步，正在进行增量数据同步，"speed=(0/0,0/0,0)" 表示增量数据已经完成同步。
停止迁移，通过 Ctrl+C 键或者其他方式终止工具的执行，即可停止数据同步。
参数说明
-n：并发写入的任务数量，建议不设置或者设置为 CPU 核心数量 * 2。
-m：源实例地址，格式为"password"@ip:port，免密码认证下格式为ip:port。
-t：目标实例地址，格式为"password"@ip:port，免密码认证下格式为ip:port。
--tmpfile=FILE：临时文件名称。
--tmpfile-size=SIZE：临时文件最大长度。
--help：查看帮助命令。
使用示例
./redis-sync -m 127.0.0.1:6379 -t "xxx2018"@10.0.5.8:6379
输出日志
[root@VM_5_16_centos bin]# ./redis-sync -m 127.0.0.1:6379 -t "xxx2018"@10.0.5.8:6379
2019/02/21 09:56:00 sync.go:76: [INFO] sync: master = "127.0.0.1:6379", target = "xxx2018@10.0.5.8:6379"
2019/02/21 09:56:01 sync.go:103: [INFO] +
2019/02/21 09:56:01 sync.go:109: [INFO] sync: runid = "f63e2ad58e2fcc15c8cc122f15778389a012c1a4", offset = 18576271
2019/02/21 09:56:01 sync.go:110: [INFO] sync: rdb file = 9063349 (8.64mb)
2019/02/21 09:56:01 sync.go:208: [INFO] sync: (r/f,s/f,s) = (read,rdb.forward,rdb.skip/rdb.forward,rdb.skip)
2019/02/21 09:56:02 sync.go:250: [INFO] sync: rdb = 9063349 - [100.00%] (r/f,s/f,s)=(1703936/71754,0/0,0) ~ (1.62mb/-,-/-,-) ~ speed=(1.62mb/71754,0/0,0)
2019/02/21 09:56:03 sync.go:250: [INFO] sync: rdb = 9063349 - [100.00%] (r/f,s/f,s)=(3407872/153850,0/0,0) ~ (3.25mb/-,-/-,-) ~ speed=(1.62mb/82096,0/0,0)
2019/02/21 09:57:54 sync.go:250: [INFO] sync: rdb = 9063349 - [100.00%] (r/f,s/f,s)=(80487526/411969,0/1587212,0) ~  (76.76mb/-,-/-,-) ~ speed=(0/0,0/0,0)
redis-restore 导入数据
redis-restore 工具支持将 Redis 的备份文件（RDB）导入到指定实例，同时也支持导入 AOF 文件，支持 Redis 2.8、3.0、3.2、4.0 版本的 RDB 文件格式。
参数说明
-n：并发写入的任务数量，建议不设置或者设置为 CPU 核心数量 * 2。
-i：RDB 文件路径。
-t：目标实例地址，格式为"password"@ip:port，免密码认证下格式为ip:port。
-a：AOF 文件路径。
--db=DB：备份文件导入 Redis 目标实例的 DB ID，须和源实例 DB ID 保持一致。
--unixtime-in-milliseconds=EXPR：导入数据的同时更新 Key 过期时间值。
--help：查看帮助命令。
使用示例
./redis-restore dump.rdb -t 127.0.0.1:6379
redis-dump 备份数据
redis-dump 支持将数据备份成 RDB 文件，同时还支持备份 AOF 增量数据。
说明：
﻿腾讯云分布式缓存数据库暂时不支持使用 redis-dump 工具进行备份，您可以使用分布式缓存数据库控制台或者 API 进行数据备份和下载；以及使用 redis-dump 工具来备份您自建的 Redis 实例。
参数说明
-n：并发写入的任务数量，建议不设置或者设置为 CPU 核心数量 * 2。
-m：Redis 实例地址，格式为"password"@ip:port，免密码认证下格式为ip:port。
-o：备份输出的 RDB 文件路径。
-a：备份输出的 AOF 文件路径。
--help：查看帮助命令。
使用示例
./redis-dump  127.0.0.1:6379 -o dump.rdb

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

腾讯云分布式缓存数据库（兼容 Redis）

使用 redis-port 进行迁移

工具介绍

兼容版本

redis-sync 在线迁移

迁移原理

参数说明

使用示例

输出日志

redis-restore 导入数据

参数说明

使用示例

redis-dump 备份数据

参数说明

使用示例

帮助和支持