Skip to content

oldjs/dcoker_backup_script

BranchesTags
 
 

Repository files navigation

Docker容器备份和恢复工具

一个功能完整的Docker容器备份和恢复解决方案，专为Linux系统设计，能够自动识别并备份Docker容器的完整配置、挂载点和数据卷，支持在新服务器上一键恢复。

🚀 一键安装

# 立即安装使用 curl -fsSL https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/install.sh | sudo bash

GitHub仓库: https://github.com/shuguangnet/dcoker_backup_script

就是这么简单！ 🎉

备份 image

恢复 image

定时备份 image

🖥️ 交互式菜单

安装完成后，你可以使用交互式菜单进行所有操作：

# 启动交互式菜单 docker-backup-menu

Snipaste_2025-07-27_00-25-51.png

就是这么简单！ 🎉

🚀 功能特性

核心功能

  • 完整备份：备份容器配置、环境变量、端口映射、网络设置
  • 数据保护：支持Docker volumes和bind mounts的完整备份
  • 镜像备份：可选择性备份容器镜像（完整备份模式）
  • 一键恢复：在新服务器上快速恢复容器和数据
  • 增量支持：智能识别和备份变更的数据
  • 交互式菜单：图形化操作界面，新手友好
  • Docker Compose支持：自动检测并备份docker-compose项目

高级特性

  • 灵活配置：支持配置文件和命令行参数
  • 批量操作：支持备份所有容器或指定容器列表
  • 容器过滤：支持按名称、标签等条件过滤容器
  • 并发备份：支持多容器并发备份提高效率
  • 安全加密：支持GPG加密备份文件
  • 远程存储：支持备份到远程服务器
  • 通知机制：支持邮件、Webhook、Slack通知
  • 定时备份：支持cron定时任务自动备份
  • 智能清理：自动清理过期备份文件

📋 系统要求

必需工具

  • Docker: 18.06+ (支持Docker API v1.38+)
  • Bash: 4.0+
  • jq: 1.5+ (用于JSON解析)
  • tar: GNU tar (用于文件压缩)

可选工具

  • curl: 用于远程上传和通知
  • gpg: 用于备份加密
  • rsync: 用于高效数据同步

安装依赖

Ubuntu/Debian

sudo apt update sudo apt install jq curl tar rsync gnupg

CentOS/RHEL/Rocky Linux

sudo yum install epel-release sudo yum install jq curl tar rsync gnupg2

Alpine Linux

apk add jq curl tar rsync gnupg

🛠️ 安装部署

🚀 一键安装（推荐）

方法1：直接下载并安装

# 一键下载并安装（推荐） curl -fsSL https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/install.sh | sudo bash # 或者使用wget wget -qO- https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/install.sh | sudo bash

方法2：下载脚本后查看再执行（更安全）

# 下载安装脚本 curl -fsSL https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/install.sh -o install.sh # 查看脚本内容（确保安全） cat install.sh # 执行安装 chmod +x install.sh sudo ./install.sh

方法3：克隆整个仓库

# 克隆仓库 git clone https://github.com/shuguangnet/dcoker_backup_script.git # 进入目录并安装 cd dcoker_backup_script sudo ./install.sh

安装选项

# 标准安装 sudo ./install.sh # 自定义安装目录 sudo ./install.sh -d /usr/local/docker-backup # 自定义备份目录 sudo ./install.sh -b /backup/docker # 开发模式（使用当前目录，不需要sudo） ./install.sh --dev-mode # 不创建系统服务 sudo ./install.sh --no-service # 不设置定时任务 sudo ./install.sh --no-cron # 卸载工具 sudo ./install.sh --uninstall

📦 手动安装

如果你需要手动安装或自定义部署：

1. 下载脚本

# 克隆仓库 git clone https://github.com/shuguangnet/dcoker_backup_script.git cd dcoker_backup_script # 或者直接下载脚本文件 wget https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/docker-backup.sh wget https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/docker-restore.sh wget https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/backup-utils.sh wget https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/backup.conf

2. 设置权限

chmod +x docker-backup.sh chmod +x docker-restore.sh chmod +x backup-utils.sh

3. 配置文件

# 复制并编辑配置文件 cp backup.conf backup.conf.local vim backup.conf.local

4. 创建备份目录

sudo mkdir -p /var/backups/docker sudo chown $(whoami):$(whoami) /var/backups/docker

📖 使用指南

🎯 快捷命令（一键安装后）

如果你使用了一键安装脚本，系统会自动创建全局快捷命令：

交互式菜单（推荐新手）

# 启动交互式菜单 docker-backup-menu

备份操作

# 备份单个容器 docker-backup nginx # 备份多个容器 docker-backup nginx mysql redis # 备份所有运行中的容器 docker-backup -a # 备份所有容器（排除镜像，节省空间） docker-backup -a --exclude-images # 完整备份（包含镜像） docker-backup -f nginx # 详细输出模式 docker-backup -v nginx

恢复操作

# 恢复容器 docker-restore /var/backups/docker/nginx_20231201_120000 # 强制恢复（覆盖现有容器） docker-restore -f /var/backups/docker/nginx_20231201_120000 # 恢复到新名称 docker-restore --container-name new-nginx /var/backups/docker/nginx_20231201_120000

管理命令

# 查看定时备份状态 systemctl status docker-backup.timer # 启动定时备份 systemctl start docker-backup.timer # 查看备份日志 journalctl -u docker-backup.service # 手动触发备份 systemctl start docker-backup.service # 清理旧备份文件 docker-cleanup 30 # 查看备份统计 docker-cleanup --preview 30

📋 手动模式（脚本直接使用）

如果你是手动安装或开发模式：

备份单个容器

# 备份nginx容器 ./docker-backup.sh nginx # 备份nginx和mysql容器 ./docker-backup.sh nginx mysql

备份所有容器

# 备份所有运行中的容器 ./docker-backup.sh -a # 完整备份所有容器（包含镜像） ./docker-backup.sh -a -f

高级备份选项

# 指定备份目录 ./docker-backup.sh -o /custom/backup/path nginx # 排除数据卷和挂载点 ./docker-backup.sh --exclude-volumes --exclude-mounts nginx # 使用自定义配置文件 ./docker-backup.sh -c /path/to/custom.conf nginx # 详细输出模式 ./docker-backup.sh -v nginx

容器恢复操作

基础恢复

# 恢复容器（基础模式） ./docker-restore.sh /path/to/backup/nginx_20231201_120000 # 强制恢复（覆盖现有容器） ./docker-restore.sh -f /path/to/backup/nginx_20231201_120000

高级恢复选项

# 恢复但不启动容器 ./docker-restore.sh -n /path/to/backup/nginx_20231201_120000 # 指定新的容器名称 ./docker-restore.sh --container-name new-nginx /path/to/backup/nginx_20231201_120000 # 跳过特定组件恢复 ./docker-restore.sh --no-volumes --no-mounts /path/to/backup/nginx_20231201_120000

🖥️ 交互式菜单详解

Docker Compose自动检测

备份脚本会自动检测容器是否由docker-compose管理：

检测方法

  1. 容器标签检测：检查com.docker.compose.project和com.docker.compose.service标签
  2. 容器名称模式：识别project_service_number命名模式
  3. 网络名称检测：查找project_default网络模式

检测结果

  • Docker Compose容器：自动备份compose文件、环境配置，生成compose恢复脚本
  • 普通容器：使用传统的docker run命令恢复

备份内容差异

内容 普通容器 Docker Compose容器
容器配置 ✓ ✓
数据卷 ✓ ✓
挂载点 ✓ ✓
镜像 ✓ ✓
docker-compose.yml ✗ ✓
.env文件 ✗ ✓
恢复方式 docker run docker-compose up

菜单功能概览

运行 docker-backup-menu 后，你将看到一个包含18个选项的交互式菜单：

📦 备份操作 (选项1-6)

  • 选项1: 备份所有运行中的容器
  • 选项2: 备份所有容器（排除镜像）
  • 选项3: 备份所有容器（排除数据卷）
  • 选项4: 备份所有容器（排除挂载点）
  • 选项5: 备份所有容器（仅配置和日志）
  • 选项6: 完整备份所有容器（包含镜像）

🎯 指定容器备份 (选项7-10)

  • 选项7: 备份指定容器
  • 选项8: 备份指定容器（排除镜像）
  • 选项9: 备份指定容器（排除数据卷）
  • 选项10: 备份指定容器（排除挂载点）

🔄 恢复操作 (选项11-12)

  • 选项11: 恢复容器（交互式向导）
  • 选项12: 列出可恢复的备份

🧹 维护操作 (选项13-15)

  • 选项13: 清理旧备份文件
  • 选项14: 查看备份统计信息
  • 选项15: 检查系统状态

⚙️ 配置和帮助 (选项16-18)

  • 选项16: 编辑配置文件
  • 选项17: 查看帮助信息
  • 选项18: 查看版本信息

⚙️ 配置选项

主要配置参数

基础配置

# 默认备份目录 DEFAULT_BACKUP_DIR="/var/backups/docker" # 备份保留天数 BACKUP_RETENTION_DAYS=30 # 压缩格式（gzip, bzip2, xz） COMPRESSION_FORMAT="gzip" # 详细日志模式 VERBOSE_MODE=false

备份选项

# 默认完整备份（包含镜像） DEFAULT_FULL_BACKUP=false # 排除数据卷备份 DEFAULT_EXCLUDE_VOLUMES=false # 排除挂载点备份 DEFAULT_EXCLUDE_MOUNTS=false # 备份前暂停容器 PAUSE_CONTAINERS_DURING_BACKUP=false

性能配置

# 并发备份数量 MAX_CONCURRENT_BACKUPS=3 # 最大备份文件大小（MB） MAX_BACKUP_SIZE_MB=0 # 磁盘空间缓冲区（MB） DISK_SPACE_BUFFER_MB=1024

容器过滤配置

# 排除容器名称模式 EXCLUDE_CONTAINER_PATTERNS=".*-temp .*-test" # 只备份特定标签的容器 INCLUDE_CONTAINER_LABELS="backup=true" # 排除特定标签的容器 EXCLUDE_CONTAINER_LABELS="backup=false"

📁 备份目录结构

普通Docker容器

backup_dir/ ├── config/ # 容器配置文件 │ ├── container_inspect.json # 完整容器配置 │ ├── container_info.txt # 关键配置信息 │ ├── cmd.txt # 启动命令 │ ├── entrypoint.txt # 入口点 │ ├── network_settings.json # 网络配置 │ └── mounts.json # 挂载信息 ├── volumes/ # 数据卷备份 │ ├── volume1.tar.gz # 数据卷压缩包 │ └── volume1_info.json # 数据卷信息 ├── mounts/ # 挂载点备份 │ ├── mount_0/ # 挂载点0 │ │ ├── mount_info.json # 挂载信息 │ │ └── data.tar.gz # 挂载数据 │ └── mount_1/ # 挂载点1 ├── logs/ # 容器日志 │ └── container.log # 容器运行日志 ├── nginx_image.tar.gz # 容器镜像（完整备份） ├── restore.sh # 自动恢复脚本 ├── generated_run_command.sh # Docker运行命令 └── backup_summary.txt # 备份摘要

Docker Compose容器

backup_dir/ ├── config/ # 容器配置文件 ├── volumes/ # 数据卷备份 ├── mounts/ # 挂载点备份 ├── logs/ # 容器日志 ├── compose/ # Docker Compose文件 │ ├── docker-compose.yml # 主配置文件 │ ├── .env # 环境变量文件 │ ├── compose_info.txt # 项目和服务信息 │ └── compose_directory.txt # 原始目录路径 ├── project_service_image.tar.gz # 容器镜像（完整备份） ├── restore.sh # 自动恢复脚本（支持docker-compose） └── backup_summary.txt # 备份摘要

🔧 实际使用示例

场景1：Web应用备份

# 1. 备份nginx和mysql容器 ./docker-backup.sh -f nginx mysql # 2. 在新服务器恢复 scp -r nginx_20231201_120000/ user@new-server:/tmp/ ssh user@new-server "cd /tmp && ./docker-restore.sh nginx_20231201_120000"

场景2：Docker Compose项目备份

# 1. 备份docker-compose项目（自动检测） ./docker-backup.sh -f myproject_web_1 # 2. 备份会包含： # - 容器配置和数据 # - docker-compose.yml文件 # - .env环境文件 # - 其他配置文件 # 3. 在新服务器恢复 scp -r myproject_web_1_20231201_120000/ user@new-server:/tmp/ ssh user@new-server "cd /tmp/myproject_web_1_20231201_120000 && ./restore.sh" # 恢复脚本会自动使用docker-compose启动服务

场景3：定期自动备份

方法1：使用系统服务（推荐）

# 启用定时备份服务 sudo systemctl enable docker-backup.timer sudo systemctl start docker-backup.timer # 查看服务状态 sudo systemctl status docker-backup.timer

方法2：自定义cron任务

# 创建定时任务脚本 cat > /usr/local/bin/docker-auto-backup.sh << 'EOF' #!/bin/bash cd /opt/docker-backup ./docker-backup.sh -a --exclude-images -o /var/backups/docker docker-cleanup 30 # 清理30天前的备份 EOF chmod +x /usr/local/bin/docker-auto-backup.sh # 添加crontab任务（每天凌晨2点备份） echo "0 2 * * * /usr/local/bin/docker-auto-backup.sh" | sudo crontab -

方法3：rsync同步到远程存储

# 创建备份同步脚本 cat > /usr/local/bin/docker-backup-sync.sh << 'EOF' #!/bin/bash BACKUP_DIR="/var/backups/docker" REMOTE_HOST="backup-server.company.com" REMOTE_USER="backup" REMOTE_PATH="/backups/docker"  # 执行备份 cd /opt/docker-backup ./docker-backup.sh -a --exclude-images -o $BACKUP_DIR  # 同步到远程服务器 rsync -avz --delete $BACKUP_DIR/ $REMOTE_USER@$REMOTE_HOST:$REMOTE_PATH/  # 清理本地旧备份 docker-cleanup 7 # 保留7天本地备份 EOF chmod +x /usr/local/bin/docker-backup-sync.sh # 添加到crontab（每天凌晨3点备份并同步） echo "0 3 * * * /usr/local/bin/docker-backup-sync.sh" | sudo crontab -

场景4：生产环境迁移

# 1. 在源服务器备份所有容器 ./docker-backup.sh -a -f # 2. 打包备份文件 tar -czf docker-backup-$(date +%Y%m%d).tar.gz /var/backups/docker/* # 3. 传输到目标服务器 rsync -avz docker-backup-$(date +%Y%m%d).tar.gz user@target-server:/tmp/ # 4. 在目标服务器解压并恢复 ssh user@target-server << 'EOF' cd /tmp tar -xzf docker-backup-$(date +%Y%m%d).tar.gz cd var/backups/docker for backup_dir in */; do  if [[ -d "$backup_dir" ]]; then  ./docker-restore.sh -f "$backup_dir"  fi done EOF

场景5：容器迁移到新名称

# 备份原容器 ./docker-backup.sh old-app # 恢复为新名称 ./docker-restore.sh --container-name new-app old-app_20231201_120000/

🛡️ 安全最佳实践

1. 备份加密

# 在backup.conf中启用加密 ENCRYPT_BACKUPS=true GPG_RECIPIENT="backup@company.com" # 生成GPG密钥 gpg --gen-key gpg --export backup@company.com > public.key

2. 权限控制

# 设置适当的文件权限 BACKUP_FILE_PERMISSIONS=600 BACKUP_DIR_PERMISSIONS=700 # 限制备份目录访问 sudo chown backup:backup /var/backups/docker sudo chmod 700 /var/backups/docker

3. 远程备份

# 配置SSH密钥认证 ssh-keygen -t rsa -b 4096 ssh-copy-id backup@backup-server # 配置远程备份 REMOTE_BACKUP_ENABLED=true REMOTE_BACKUP_HOST="backup-server.company.com" REMOTE_BACKUP_USER="backup" REMOTE_BACKUP_PATH="/backups/docker"

🚨 故障排除

常见问题及解决方案

1. Docker权限问题

# 错误: permission denied while trying to connect to Docker daemon # 解决: 将用户添加到docker组 sudo usermod -aG docker $USER newgrp docker

2. jq工具缺失

# 错误: jq: command not found # 解决: 安装jq工具 sudo apt install jq # Ubuntu/Debian sudo yum install jq # CentOS/RHEL

3. 磁盘空间不足

# 错误: No space left on device # 解决: 清理旧备份或增加磁盘空间 find /var/backups/docker -type d -mtime +30 -exec rm -rf {} \;

4. 容器启动失败

# 检查容器日志 docker logs container-name # 检查端口冲突 netstat -tulpn | grep :port # 手动启动容器调试 docker run -it --rm image-name /bin/bash

5. 挂载点权限问题

# 检查文件权限 ls -la /path/to/mount # 修复权限 sudo chown -R user:group /path/to/mount sudo chmod -R 755 /path/to/mount

调试模式

启用详细日志

# 使用-v选项启用详细输出 ./docker-backup.sh -v nginx # 或在配置文件中设置 VERBOSE_MODE=true LOG_LEVEL=4

试运行模式

# 在配置文件中启用试运行 DRY_RUN=true # 或者使用测试容器 docker run --name test-container hello-world ./docker-backup.sh test-container

📊 监控和通知

邮件通知配置

EMAIL_NOTIFICATIONS=true EMAIL_SMTP_SERVER="smtp.gmail.com" EMAIL_SMTP_PORT=587 EMAIL_USERNAME="backup@company.com" EMAIL_PASSWORD="app-password" EMAIL_FROM="backup@company.com" EMAIL_TO="admin@company.com"

Slack通知配置

SLACK_NOTIFICATIONS=true SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK"

Webhook通知配置

WEBHOOK_NOTIFICATIONS=true WEBHOOK_URL="https://api.company.com/backup-notifications" WEBHOOK_TIMEOUT=30

🔄 定期维护

定时备份最佳实践

1. 设置定时备份

# 启用系统定时服务 sudo systemctl enable docker-backup.timer sudo systemctl start docker-backup.timer # 查看下次执行时间 sudo systemctl list-timers docker-backup.timer

2. 配置rsync同步

# 设置SSH密钥认证 ssh-keygen -t rsa -b 4096 -f ~/.ssh/backup_key ssh-copy-id -i ~/.ssh/backup_key.pub backup@backup-server # 创建同步脚本 cat > /usr/local/bin/docker-backup-sync.sh << 'EOF' #!/bin/bash BACKUP_DIR="/var/backups/docker" REMOTE_HOST="backup-server.company.com" REMOTE_USER="backup" REMOTE_PATH="/backups/docker" SSH_KEY="~/.ssh/backup_key"  # 执行备份 cd /opt/docker-backup ./docker-backup.sh -a --exclude-images -o $BACKUP_DIR  # 同步到远程服务器 rsync -avz --delete -e "ssh -i $SSH_KEY" $BACKUP_DIR/ $REMOTE_USER@$REMOTE_HOST:$REMOTE_PATH/  # 清理本地旧备份 docker-cleanup 7 # 保留7天本地备份  # 发送通知 echo "Docker backup completed at $(date)" | mail -s "Backup Status" admin@company.com EOF chmod +x /usr/local/bin/docker-backup-sync.sh

3. 添加到crontab

# 编辑crontab crontab -e # 添加以下内容 # 每天凌晨2点执行备份 0 2 * * * /usr/local/bin/docker-backup-sync.sh # 每周日凌晨3点清理远程旧备份 0 3 * * 0 ssh backup@backup-server "find /backups/docker -type d -mtime +30 -exec rm -rf {} \;"

清理旧备份

# 手动清理30天前的备份 find /var/backups/docker -type d -mtime +30 -exec rm -rf {} \; # 使用清理工具 docker-cleanup 30 # 自动清理（在配置文件中设置） BACKUP_RETENTION_DAYS=30

验证备份完整性

# 启用备份验证 RUN_BACKUP_VERIFICATION=true GENERATE_CHECKSUMS=true CHECKSUM_ALGORITHM="sha256"

性能优化

# 调整并发数量 MAX_CONCURRENT_BACKUPS=3 # 使用更快的压缩算法 COMPRESSION_FORMAT="gzip" # 最快 # COMPRESSION_FORMAT="xz" # 最小文件

📞 支持和贡献

🌟 项目信息

🚀 快速开始

# 一键安装 curl -fsSL https://raw.githubusercontent.com/shuguangnet/dcoker_backup_script/main/install.sh | sudo bash # 立即使用 docker-backup-menu # 启动交互式菜单 docker-backup -a # 备份所有容器 docker-cleanup 30 # 清理30天前的备份

获取帮助

  • 查看内置帮助：docker-backup --help 或 ./docker-backup.sh --help
  • 检查配置文件：backup.conf
  • 查看完整文档：README.md
  • 一键安装脚本：install.sh

报告问题

如果遇到问题，请在GitHub提交Issue并提供以下信息：

  1. 操作系统版本
  2. Docker版本
  3. 错误信息和日志
  4. 使用的命令和配置

GitHub Issues: https://github.com/shuguangnet/dcoker_backup_script/issues

贡献代码

欢迎提交Pull Request，请确保：

  1. 代码遵循现有风格
  2. 添加适当的注释
  3. 更新相关文档
  4. 测试新功能

GitHub Pull Requests: https://github.com/shuguangnet/dcoker_backup_script/pulls

📝 版本历史

v1.0.0

  • 初始版本发布
  • 支持完整的容器备份和恢复
  • 包含配置文件和命令行选项
  • 支持数据卷和挂载点备份
  • 提供详细的使用文档

📄 许可证

本项目采用MIT许可证，详见LICENSE文件。

免责声明：在生产环境使用前，请务必在测试环境中验证备份和恢复流程。定期测试备份的完整性和可恢复性。

About

检测docker容器并自动备份挂载卷以及本地挂载目录

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%