waja/calcardbackup

Docker-Calcardbackup

镜像概述

Docker-Calcardbackup是calcardbackup工具的Docker化实现，专为备份Nextcloud实例中的日历和联系人数据设计。该镜像集成了自动化备份机制，支持定时任务配置、初始备份触发及灵活的路径与参数自定义，帮助用户轻松维护Nextcloud数据安全。

核心功能和特性

• 定时备份：通过CRON表达式定义备份频率，默认每天4:05执行备份任务
• 初始备份：容器启动时可立即执行首次备份（通过环境变量控制）
• 路径自定义：支持指定备份存储目录、Nextcloud配置文件路径等关键路径
• 参数灵活配置：可自定义Nextcloud服务地址、端口及数据库连接信息
• 工具原生支持：无缝集成calcardbackup工具，可传递额外选项扩展功能

使用场景和适用范围

适用于所有运行Nextcloud服务的用户场景，尤其是需要定期备份日历和联系人等核心个人数据的个人用户或企业管理员。可满足自动化数据保护需求，避免手动备份遗漏导致的数据丢失风险。

使用方法和配置说明

基本部署（docker run）

通过以下命令启动容器，需挂载Nextcloud配置目录和备份目录，并链接数据库容器：

bash
docker container run -d \
  --link mysql \
  --volume /path/to/my/backup/folder:/backup \
  --volume /path/to/my/nextcloud/config:/nextcloud/config \
  waja/calcardbackup

Docker Compose配置

项目提供两种示例Compose配置文件：docker-compose-example.yml（基础配置）和docker-compose-complex-example.yml（复杂配置），可根据实际需求参考调整。

环境变量参数说明

配置示例

启用定时备份+初始备份：

bash
docker container run -d \
  --link mysql \
  -e CRON_TIME="0 3 * * *" \
  -e INIT_BACKUP=1 \
  --volume /my/backups:/backup \
  --volume /my/nextcloud/config:/nextcloud/config \
  waja/calcardbackup

此配置将每天凌晨3点执行备份，并在容器启动时立即生成首次备份。