creativeprojects/resticprofile

resticprofile 备份镜像

镜像概述和主要用途

本镜像基于Alpine Linux构建，集成了resticprofile、restic和rclone工具，提供一站式文件备份解决方案。其中，restic是轻量级、安全的开源备份工具；rclone支持多种云存储服务的文件同步；resticprofile作为restic的配置与调度管理器，可简化备份任务的配置、定时执行及监控。三者结合，便于用户高效管理文件备份流程。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低，适合各类环境部署
• 工具集成：整合resticprofile（配置/调度）、restic（备份核心）、rclone（云存储同步），无需单独安装依赖
• 配置管理：通过resticprofile支持HCL/YAML格式配置文件，集中管理备份策略、仓库信息和调度规则
• 多存储支持：借助rclone兼容Amazon S3、Google Drive、Dropbox等主流云存储及本地存储
• 调度功能：支持定时备份任务（如每日/每周执行），满足自动化备份需求

使用场景和适用范围

• 个人文件备份：需定期备份本地文档、照片等数据到外部存储的个人用户
• 服务器数据备份：对服务器应用数据、日志文件、数据库等进行定时备份的场景
• 多存储策略：需要将数据备份到多个存储后端（如本地磁盘+云存储）的需求
• 自动化备份流程：希望简化备份配置、减少手动操作的开发者或系统管理员

使用方法和配置说明

基本运行命令

通过docker run启动容器，需挂载备份源目录、配置文件目录及必要的存储路径：

bash
docker run -d \
  -v /path/to/local/data:/data \  # 挂载需备份的源文件目录
  -v /path/to/config:/etc/resticprofile \  # 挂载resticprofile配置文件目录
  -v /path/to/rclone/config:/root/.config/rclone \  # 挂载rclone配置（如需云存储）
  -e RESTIC_PASSWORD="your-repo-password" \  # restic仓库密码
  --name restic-backup \
  creativeprojects/resticprofile:latest

关键配置说明

挂载目录

• /data：备份源文件目录，需将本地需备份的文件路径挂载至此
• /etc/resticprofile：存放resticprofile配置文件（如profile.hcl或profile.yaml）
• /root/.config/rclone：rclone配置目录，包含云存储访问凭证（如s3、gdrive等）

环境变量

• RESTIC_PASSWORD：必填，restic仓库的加密密码
• RESTIC_REPOSITORY：指定备份仓库路径（如/backup/repo或rclone:myremote:bucket/path）
• 其他restic/profile相关变量：可在配置文件中通过${VAR_NAME}引用，如BACKUP_RETENTION_DAYS

配置文件示例

在/path/to/config目录下创建profile.hcl配置文件，定义备份策略：

hcl
version = "1"

[profile "daily-backup"]
  repository = "rclone:my-s3-remote:my-backup-bucket"  # 使用rclone云存储
  password-file = "/etc/resticprofile/password.txt"  # 从文件读取密码（替代环境变量）
  source = ["/data"]  # 备份源路径（对应容器内/data）
  schedule = "0 3 * * *"  # 每日凌晨3点执行备份（crontab格式）
  check-after = true  # 备份后校验数据完整性
  keep-daily = 7  # 保留7天的每日备份

  [profile "daily-backup.backup"]
    exclude = ["/data/temp", "*.log"]  # 排除临时文件和日志

环境变量

可在配置文件中通过环境变量动态注入参数，例如：

hcl
[profile "env-example"]
  repository = "s3:${S3_BUCKET}/backup"  # 引用环境变量S3_BUCKET
  password-file = "/etc/resticprofile/${PROFILE_NAME}.password"

启动容器时添加对应环境变量：

bash
-e S3_BUCKET="my-backup-bucket" -e PROFILE_NAME="default"

docker-compose配置示例

使用docker-compose.yml简化部署：

yaml
version: "3"
services:
  restic-backup:
    image: creativeprojects/resticprofile:latest
    volumes:
      - /home/user/documents:/data
      - ./restic-config:/etc/resticprofile
      - ./rclone-config:/root/.config/rclone
    environment:
      - RESTIC_PASSWORD=secure-password-123
      - RESTIC_REPOSITORY=rclone:gdrive:my-backups
    restart: unless-stopped  # 容器退出后自动重启，确保调度任务持续运行

参考链接

• https://github.com/creativeprojects/resticprofile/
• https://creativeprojects.github.io/resticprofile/installation/docker/index.html
• https://github.com/creativeprojects/resticprofile/blob/master/build/Dockerfile