seertenedos/resticker

Resticker

https://img.shields.io/docker/pulls/mazzolino/restic.svg](https://hub.docker.com/r/mazzolino/restic/) ![Build status]([***]

镜像概述

通过Docker容器运行自动https://restic.github.io/%E5%A4%87%E4%BB%BD%EF%BC%8C%E7%AE%80%E5%8C%96%E6%95%B0%E6%8D%AE%E5%A4%87%E4%BB%BD%E6%B5%81%E7%A8%8B%E5%B9%B6%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E5%9C%BA%E6%99%AF%E3%80%82

核心功能

• 运行定时备份任务
• 支持restic兼容的所有本地/远程备份目标
• 为备份快照添加自定义标签
• 自动清理旧备份（需配置参数）
• 作为Docker Swarm全局服务备份集群所有节点
• 多架构支持：amd64、armv7

使用场景

适用于服务器数据定期备份、Docker集群节点数据保护、应用数据一致性备份（结合预备份命令）等场景。

配置说明

Docker Compose部署

调整docker-compose.example.yml配置后运行：

bash
docker-compose up -d

Docker Swarm部署

修改docker-swarm.example.yml后以栈形式部署：

bash
docker stack deploy -f docker-swarm.yml backup

数据恢复

若容器通过Compose运行，可通过以下命令恢复：

bash
# 查找当前主机最新快照ID
docker-compose exec app snapshots -H <主机名>
# 恢复指定文件
docker-compose exec app restore --include /path/to/file <快照ID>

Swarm模式需SSH到目标节点执行docker exec命令。

高级用法

执行任意restic命令：

bash
docker-compose run --rm app <restic参数>
# 示例：查看所有快照
docker-compose run --rm app snapshots

环境变量配置

• BACKUP_CRON：Cron表达式（如0 30 3 * * *表示每日3:30执行）
• RESTIC_REPOSITORY：备份仓库路径（默认/mnt/restic）
• RESTIC_BACKUP_SOURCES：需备份的源目录（默认/data，需挂载为卷）
• RESTIC_PASSWORD：仓库密码（用于初始化和访问）
• RESTIC_BACKUP_TAGS：快照标签（逗号分隔，如swarm,db-backup）
• RESTIC_FORGET_ARGS：清理旧备份参数（如--prune --keep-last 14）
• TZ：时区设置（确保Cron时间准确）
• 备份目标额外变量（如Backblaze B2的B2_ACCOUNT_ID）

rclone仓库支持

需将rclone.conf挂载到容器/root/.config/rclone/rclone.conf路径。

预备份命令

通过PRE_COMMANDS执行备份前操作（如数据库dump）：

yaml
PRE_COMMANDS: |-
  docker exec nextcloud-db pg_dumpall -U nextcloud -f /data/nextcloud.sql
  docker stop my-app

需挂载Docker socket（/var/run/docker.sock:/var/run/docker.sock）以执行主机Docker命令。

后备份命令

通过以下变量执行备份后操作：

• POST_COMMANDS_SUCCESS：备份成功后执行（如发送成功邮件）
• POST_COMMANDS_FAILURE：备份失败后执行（如发送告警）
• POST_COMMANDS_EXIT：无论结果均执行（如重启容器）

构建自定义镜像

使用Makefile构建：

bash
make image IMAGE=myuser/restic
# 构建arm架构镜像
make image IMAGE=myuser/restic ARCH=arm

致谢

本项目基于https://github.com/Lobaro/restic-backup-docker%E5%BC%80%E5%8F%91%EF%BC%8C%E6%84%9F%E8%B0%A2%E5%8E%9F%E4%BD%9C%E8%80%85%E8%B4%A1%E7%8C%AE%E3%80%82