gilesknap/gphotos-sync

gphotos-sync Docker镜像文档

镜像概述

本Docker镜像基于https://github.com/gilesknap/gphotos-sync%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BA%86%E4%B8%80%E4%B8%AA%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E7%94%A8%E4%BA%8E%E9%80%9A%E8%BF%87Google Photos API同步和备份Google Photos中的照片与相册。该镜像简化了gphotos-sync工具的部署和使用流程，适用于需要本地备份Google照片数据的场景。

核心功能与特性

• 完整数据备份：支持备份Google Photos中的所有照片、视频及相册
• 官方API集成：通过Google Photos官方API进行数据同步，确保兼容性和安全性
• 增量同步：仅同步新增或修改的媒体文件，提高同步效率
• 元数据保留：保留照片的EXIF信息、创建时间等元数据
• 容器化部署：简化依赖管理，可在任何支持Docker的环境中运行

使用场景与适用范围

• 个人用户Google Photos数据的本地备份与归档
• 照片数据的异地容灾备份
• 需要将Google Photos数据迁移至本地存储的场景
• 定期自动备份Google Photos内容的自动化任务

使用方法与配置说明

前置准备

1. 获取Google API凭证：
   • 访问https://console.cloud.google.com/
   • 创建新项目并启用"Google Photos Library API"
   • 创建OAuth 2.0客户端ID，下载凭证文件（credentials.json）

基本使用（Docker Run）

bash
docker run -d \
  --name gphotos-sync \
  -v /path/to/local/backup:/backup \
  -v /path/to/credentials.json:/app/credentials.json \
  docker.xuanyuan.run/gilesknap/gphotos-sync \
  gphotos-sync /backup --credentials /app/credentials.json

参数说明：

• -v /path/to/local/backup:/backup：挂载本地目录用于存储备份数据
• -v /path/to/credentials.json:/app/credentials.json：挂载Google API凭证文件
• gphotos-sync /backup：指定备份目录为容器内的/backup
• --credentials /app/credentials.json：指定凭证文件路径

首次运行说明

首次运行时，容器会生成授权链接，需通过以下步骤完成授权：

1. 查看容器日志获取授权链接：docker logs gphotos-sync
2. 在浏览器中打开链接并完成Google账号授权
3. 将授权后获取的代码输入容器提示中
4. 授权完成后，同步过程将自动开始

常用配置参数

Docker Compose示例

yaml
version: '3'
services:
  gphotos-sync:
    image: docker.xuanyuan.run/gilesknap/gphotos-sync
    container_name: gphotos-sync
    volumes:
      - /path/to/local/backup:/backup
      - /path/to/credentials.json:/app/credentials.json
    command: gphotos-sync /backup --credentials /app/credentials.json --new-only
    restart: unless-stopped

注意事项

• 确保本地备份目录有足够的存储空间
• 网络连接不稳定可能导致同步失败，建议在网络稳定环境下运行
• 定期检查同步日志，确保备份任务正常执行
• 凭证文件包含敏感信息，需妥善保管，避免泄露