victoriametrics/vmbackupmanager

VictoriaMetrics vmbackupmanager 镜像文档

镜像概述和主要用途

vmbackupmanager 是一个小型守护进程，设计用于与 VictoriaMetrics 实例一起运行（作为 sidecar 或单独容器），以自动化备份过程。它提供“设置后无需干预”的灾难恢复解决方案，可定期创建快照并将其发送到本地或云存储目标（如 S3、GCS 或 Azure Blob Storage），替代手动运行 vmbackup 的方式，实现备份的自动化调度和旧备份的自动清理。

简言之，vmbackupmanager 是一个用于为 VictoriaMetrics 实例调度备份并管理备份保留策略的简单守护进程。

核心功能和特性

• 自动化备份调度：支持按定义的时间间隔（如每 24 小时）定期创建备份，无需手动执行
• 多存储目标支持：备份可存储至本地文件系统或云存储（S3、GCS、Azure Blob Storage 等）
• 自动清理旧备份：可配置保留备份的最大数量，自动删除超过数量限制的旧备份
• 轻量级设计：作为守护进程运行，可作为 sidecar 或独立容器部署，与 VictoriaMetrics 实例协同工作
• 灾难恢复支持：提供“设置后无需干预”的备份解决方案，确保数据可恢复性

使用场景和适用范围

• VictoriaMetrics 实例的自动化备份：适用于需要定期备份 VictoriaMetrics 数据，且希望减少手动操作的场景
• 灾难恢复部署：作为数据保护策略的一部分，确保在数据丢失时可通过备份恢复
• 容器化环境集成：可作为 sidecar 容器与 VictoriaMetrics 一同部署在 Kubernetes 等容器编排平台中，或作为独立容器运行
• 多存储场景：支持本地存储与云存储目标，满足不同环境的备份需求

使用方法和配置说明

Docker 运行示例

bash
docker run -d --name vmbackupmanager \
  -v /path/to/host/backups:/backups \  # 挂载本地备份目录至容器内
  victoriametrics/vmbackupmanager:latest \
  -storageDataPath=http://victoriametrics-instance:8428/api/v1/snapshot/create \  # VictoriaMetrics 快照 API 地址
  -dst="fs:///backups" \  # 备份目标（本地文件系统）
  -backup-interval="24h" \  # 备份间隔（每 24 小时一次）
  -max-backups=7  # 保留最近 7 个备份

说明：上述命令会启动 vmbackupmanager 容器，每 24 小时从指定的 VictoriaMetrics 实例创建快照，并将备份存储在主机的 /path/to/host/backups 目录中，同时自动清理超过 7 个的旧备份。

Docker Compose 配置示例

若与 VictoriaMetrics 一同部署，可使用以下 docker-compose.yml 配置：

yaml
version: '3'

services:
  victoriametrics:
    image: docker.xuanyuan.run/victoriametrics/victoria-metrics:latest
    ports:
      - "8428:8428"
    volumes:
      - vmdata:/var/lib/victoriametrics
    restart: always

  vmbackupmanager:
    image: docker.xuanyuan.run/victoriametrics/vmbackupmanager:latest
    volumes:
      - /path/to/host/backups:/backups  # 本地备份存储目录
    command:
      - -storageDataPath=http://victoriametrics:8428/api/v1/snapshot/create  # 连接同一网络的 VictoriaMetrics 实例
      - -dst="s3://my-backup-bucket/vm-backups"  # 示例：备份至 S3 存储桶
      - -backup-interval="12h"  # 每 12 小时备份一次
      - -max-backups=14  # 保留 14 个备份（约 7 天）
    depends_on:
      - victoriametrics
    restart: always

volumes:
  vmdata:

配置参数详解

镜像获取

使用以下命令拉取 vmbackupmanager 镜像：

bash
docker pull docker.xuanyuan.run/victoriametrics/vmbackupmanager:{TAG}

说明：将 {TAG} 替换为具体版本号，如 v1.100.0。可从 https://github.com/VictoriaMetrics/VictoriaMetrics/releases 获取可用版本标签。

源代码和官方文档

• 源代码：https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/app/vmbackup
• 官方文档：https://docs.victoriametrics.com/victoriametrics/vmbackupmanager/