VictoriaMetrics vmbackup 镜像文档

镜像概述和主要用途

vmbackup 是一款用于管理 VictoriaMetrics 数据生命周期的命令行工具，作为 Docker 镜像提供。它能够为运行中的 VictoriaMetrics 实例创建即时快照，并将快照上传至指定目标（本地文件系统、S3、GCS 或 Azure Blob Storage），主要用于 VictoriaMetrics 数据的备份管理。

核心功能和特性

• 即时快照：无需停止 VictoriaMetrics 服务，即可为运行中的实例创建数据快照
• 多目标支持：支持将备份存储至多种目标位置，包括本地文件系统、S3、GCS 和 Azure Blob Storage
• 轻量便捷：作为命令行工具，以一次性任务方式运行，适合自动化脚本集成
• 与 VictoriaMetrics 无缝集成：通过 API 端点直接与 VictoriaMetrics 交互，确保数据一致性

使用场景和适用范围

使用场景

• 定期数据备份：为运行中的 VictoriaMetrics 实例创建定时快照，防止数据丢失
• 灾难恢复：在系统故障时，可通过备份数据快速恢复服务
• 数据迁移：将 VictoriaMetrics 数据迁移至不同存储位置或环境
• 数据归档：将历史数据备份至低成本存储介质（如 S3 归档存储）

适用范围

• 使用 VictoriaMetrics 作为时序数据库的用户
• 需要确保监控数据安全性和可恢复性的企业或组织
• 进行 VictoriaMetrics 数据管理和维护的运维人员

使用方法

Docker 拉取命令

docker pull victoriametrics/vmbackup:{TAG}

注意：将 {TAG} 替换为具体版本号，如 v1.91.0，可从 发布页面 获取最新版本。

创建备份示例

vmbackup 作为一次性任务运行，以下是创建备份的基本命令：

docker run --rm -v /path/to/local/backups:/backups \
  victoriametrics/vmbackup:latest \
  -storageDataPath=http://<vm-instance-addr>:8428/api/v1/snapshot/create \
  -dst=fs:///backups

参数说明：

• --rm：备份完成后自动删除容器
• -v /path/to/local/backups:/backups：将本地备份目录挂载到容器内的 /backups 目录（仅本地文件系统备份需要）
• victoriametrics/vmbackup:latest：使用最新版本的 vmbackup 镜像
• -storageDataPath：源 VictoriaMetrics 实例的快照创建 API 端点
• -dst：备份目标路径

配置参数

必选参数

存储类型说明

• 本地文件系统：前缀 fs://，如 fs:///path/to/backups
• S3 兼容存储：前缀 s3://，如 s3://bucket/path（需配置 AWS 访问密钥等环境变量）
• GCS：前缀 gcs://，如 gcs://bucket/path
• Azure Blob Storage：前缀 azblob://，如 azblob://container/path

获取帮助

若有任何问题，可通过以下渠道获取帮助：

• Slack 社区：加入 VictoriaMetrics Slack 社区
• 社区论坛：在 GitHub Discussions 提问
• Bug 报告：在 GitHub 提交 Issue

相关链接

• 官方文档：vmbackup 详细文档
• 恢复工具：vmrestore 镜像（用于从备份恢复数据）
• 发布版本：GitHub Releases（获取最新版本和预构建二进制文件）