wernight/duplicity

wernight/duplicity Docker镜像文档

支持的标签及对应的 Dockerfile 链接

• https://github.com/wernight/docker-duplicity/blob/master/latest/Dockerfile
• https://github.com/wernight/docker-duplicity/blob/master/python2/Dockerfile

什么是Duplicity？

duplicity 是一款备份工具。

本Docker镜像的特点：

• 小巧：基于 https://hub.docker.com/_/alpine/ 构建。
• 简单：下文说明了大多数常见用例，所需设置极少。
• 安全：默认以非root用户运行（使用随机选择的UID 1896），且支持以任意用户身份运行。

使用方法

基本命令语法

bash
$ docker run --rm wernight/duplicity duplicity --help

通用使用说明

使用时需注意：

• 必须挂载 要备份的目录或恢复备份的目标目录。
• 建议挂载 /home/duplicity/.cache/duplicity 到可写位置（若不缓存，duplicity将需要从远程仓库重新创建缓存，这可能需要解密备份内容）。注意该目录可能较大，且包含明文存储的已备份文件元数据。
• 建议挂载 /home/duplicity/.gnupg 到可写位置（该目录用于验证增量备份，若按以下步骤操作，恢复备份时可能无需此目录）。
• 建议指定 duplicity标志 --allow-source-mismatch，因为Docker容器的主机名是随机的。
• 可设置 环境变量 PASSPHRASE，除非希望在提示中手动输入（此时需添加 -it 参数）。
• 可能需要挂载 其他认证文件（见下文示例）。

定期备份示例

以下命令可定期执行以实现备份及清理/维护（不同存储选项见下文）：

bash
$ docker run --rm ... wernight/duplicity duplicity --full-if-older-than=6M source_directory target_url
$ docker run --rm ... wernight/duplicity duplicity remove-older-than 6M --force target_url
$ docker run --rm ... wernight/duplicity duplicity cleanup --force target_url

上述命令的作用：

1. 每6个月执行一次全量备份（加快恢复速度并确保清理功能正常），其他时间执行增量备份。
2. 删除超过6个月的备份（不会破坏增量备份链）。
3. 删除失败会话的文件（如有）。

备份到Google Cloud Storage示例

Google Cloud Storage 的 nearline 存储费用约为 $0.01/GB/月。

设置步骤：

1. 注册账号，创建空项目，启用 billing，创建存储桶。
2. 在 "存储" 部分 > "设置" > "互操作性" 标签页 > 点击 "启用互操作性访问"，然后点击 "创建新密钥" 按钮，记录 Access Key 和 Secret。同时记录项目编号（即项目ID，格式为数字，如 ***）。
3. 运行 gcloud 的 gsutil config -a 生成 ~/.boto 配置文件，并填入上述信息（也可尝试设置环境变量 GS_ACCESS_KEY_ID 和 GS_SECRET_ACCESS_KEY，但经测试可能无法设置项目ID）。
4. 生成的 ~/.boto 文件应类似：

ini
[Credentials]
gs_access_key_id = MYGOOGLEACCESSKEY
gs_secret_access_key = SomeVeryLongAccessKeyXXXXXXXX

[GSUtil]
default_project_id = 1233457890

执行备份：

bash
$ docker run --rm --user $UID \
      -e PASSPHRASE=P4ssw0rd \
      -v $PWD/.cache:/home/duplicity/.cache/duplicity \
      -v $PWD/.gnupg:/home/duplicity/.gnupg \
      -v ~/.boto:/home/duplicity/.boto:ro \
      -v /:/data:ro \
      wernight/duplicity \
      duplicity --full-if-older-than=6M --allow-source-mismatch /data gs://my-bucket-name/some_dir

执行恢复：

恢复需：

• 保留或重新生成 .boto 文件以访问Google Cloud Storage。
• 使用备份时的 PASSPHRASE。

bash
$ docker run --rm --user $UID \
      -e PASSPHRASE=P4ssw0rd \
      -v ~/.boto:/home/duplicity/.boto:ro \
      -v /:/data:ro \
      wernight/duplicity \
      duplicity restore gs://my-bucket-name/some_dir /data

另见 Google Cloud Storage 说明。

备份到Google Drive示例

Google Drive 提供15GB免费存储空间。

设置步骤：

1. 按照 Pydrive Backend 说明 生成P12凭证文件（命名为 pydriveprivatekey.p12），并记录关联的服务账号***（如 duplicity@developer.gserviceaccount.com）。
2. 将P12转换为PEM：

bash
$ docker run --rm -i --user $UID \
      -v $PWD/pydriveprivatekey.p12:/pydriveprivatekey.p12:ro \
      wernight/duplicity \
      openssl pkcs12 -in /pydriveprivatekey.p12 -nodes -nocerts >pydriveprivatekey.pem
Enter Import Password: notasecret

执行备份：

bash
$ docker run --rm --user $UID \
      -e PASSPHRASE=P4ssw0rd \
      -e GOOGLE_DRIVE_ACCOUNT_KEY=$(cat pydriveprivatekey.pem) \
      -v $PWD/.cache:/home/duplicity/.cache/duplicity \
      -v $PWD/.gnupg:/home/duplicity/.gnupg \
      -v /:/data:ro \
      wernight/duplicity \
      duplicity --full-if-older-than=6M --allow-source-mismatch /data pydrive://duplicity@developer.gserviceaccount.com/some_dir

执行恢复：

恢复需：

• 重新生成或保留PEM文件。
• 使用备份时的 PASSPHRASE。

通过rsync备份示例

若可通过SSH访问某台机器：

bash
$ docker run --rm -it --user root \
      -e PASSPHRASE=P4ssw0rd \
      -v $PWD/.cache:/home/duplicity/.cache/duplicity \
      -v $PWD/.gnupg:/home/duplicity/.gnupg \
      -v ~/.ssh/id_rsa:/id_rsa:ro \
      -v ~/.ssh/known_hosts:/etc/ssh/ssh_known_hosts:ro \
      -v /:/data:ro \
      wernight/duplicity \
      duplicity --full-if-older-than=6M --allow-source-mismatch \
      --rsync-options='-e "ssh -i /id_rsa"' \
      /data rsync://user@example.com/some_dir

注意：此处以 root 用户运行，以访问 ~/.ssh，且SSH不允许使用随机（本地不存在的）UID。为提高安全性，可复制 ~/.ssh 并执行 chown 1896（容器内duplicity用户的UID）。若有其他方法避免 "No user exists for uid" 检查，欢迎反馈。

别名设置

以下别名可适用于大多数场景：

bash
$ alias duplicity='docker run --rm --user=root -v ~/.ssh/id_rsa:/home/duplicity/.ssh/id_rsa:ro -v ~/.boto:/home/duplicity/.boto:ro -v ~/.gnupg:/home/duplicity/.gnupg -v /:/mnt:ro -e PASSPHRASE=$PASSPHRASE wernight/duplicity duplicity $@'

设置后，可像本地安装一样使用duplicity，例如：

bash
$ PASSPHRASE=123456 duplicity --progress /mnt rsync://user@example.com/some_dir

参见

• duplicity 手册
• duplicity 备份指南 - Ubuntu
• 如何在Ubuntu上使用Duplicity和GPG安全自动化备份 | DigitalOcean

反馈

问题/疑问/功能请求请在 https://github.com/wernight/docker-duplicity/issues 提交。