Repolode
offen

offen/docker-volume-backup

轻量级 Docker 伴随容器,可定时将数据卷备份到本地、S3、WebDAV、Azure、Dropbox、Google Drive 或 SSH 存储。

Star
4,069
Fork
161
未关闭 Issue
28
最近提交
3天前

这是什么?

docker-volume-backup 是一个与现有 Docker 环境并行运行的镜像,用于备份 Docker 数据卷。它支持定时备份或单次备份,可保存到本地目录、S3、WebDAV、Azure Blob Storage、Dropbox、Google Drive、SSH 兼容存储,也可以同时输出到多个目标。

备份可按配置自动轮换清理旧文件,支持使用 GPG 加密,并可在备份失败时发送通知。镜像体积小于 25MB。

在 Compose 环境中,只需添加一个 backup 服务并挂载需要备份的卷。对于带有 stop-during-backup 标签的容器,备份期间可以临时停止以保证数据一致性,这需要挂载 Docker socket。也可以使用 docker 命令行执行一次性备份。

核心功能

  • 01支持定时和单次备份 Docker 数据卷
  • 02存储目标包括本地目录、S3、WebDAV、Azure Blob Storage、Dropbox、Google Drive 和 SSH
  • 03可在同一配置中同时使用多个存储目标
  • 04自动轮换清理旧备份
  • 05支持使用 GPG 加密备份
  • 06备份失败时发送通知

适用场景

  • 按计划备份 Docker Compose 应用的数据卷
  • 将卷备份同步到异地 S3 存储桶或 SSH 服务器
  • 在升级前通过命令行执行一次性卷备份

快速上手

  1. 1

    在 compose 文件中添加 backup 服务并挂载要备份的卷

  2. 2

    使用 Docker CLI 运行一次性备份

    docker run --rm \ -v data:/backup/data \ --env AWS_ACCESS_KEY_ID="<xxx>" \ --env AWS_SECRET_ACCESS_KEY="<xxx>" \ --env AWS_S3_BUCKET_NAME="<xxx>" \ --entrypoint backup \ offen/docker-volume-backup:v2

使用前须知

  • 使用 S3、WebDAV、Azure、Dropbox、Google Drive 或 SSH 等远程存储需要进行配置。
  • 备份时停止容器需要挂载 Docker 套接字,这会授予宿主机的较高权限。

标签

常见问题

docker-volume-backup 是什么?
轻量级 Docker 伴随容器,可定时将数据卷备份到本地、S3、WebDAV、Azure、Dropbox、Google Drive 或 SSH 存储。 docker-volume-backup 是一个与现有 Docker 环境并行运行的镜像,用于备份 Docker 数据卷。它支持定时备份或单次备份,可保存到本地目录、S3、WebDAV、Azure Blob Storage、Dropbox、Google Drive、SSH 兼容存储,也可以同时输出到多个目标。
docker-volume-backup 可以免费使用吗?用的什么许可证?
docker-volume-backup 以 MPL-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
docker-volume-backup 还在维护吗?
活跃维护中。docker-volume-backup 最近一次提交是在 2026年11月4日。
docker-volume-backup 适合用来做什么?
按计划备份 Docker Compose 应用的数据卷 将卷备份同步到异地 S3 存储桶或 SSH 服务器 在升级前通过命令行执行一次性卷备份
docker-volume-backup 怎么安装和运行?
在 compose 文件中添加 backup 服务并挂载要备份的卷 使用 Docker CLI 运行一次性备份: docker run --rm \ -v data:/backup/data \ --env AWS_ACCESS_KEY_ID="<xxx>" \ --env AWS_SECRET_ACCESS_KEY="<xxx>" \ --env AWS_S3_BUCKET_NAME="<xxx>" \ --entrypoint backup \ offen/docker-volume-backup:v2
在哪里获取 docker-volume-backup?
源代码和安装说明在 GitHub 上:https://github.com/offen/docker-volume-backup

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目