rfgamaral/gphotos-uploader

rfgamaral/gphotos-uploader

!https://github.com/rfgamaral/docker-gphotos-uploader/workflows/Docker%20Images%20CI/badge.svg !image size !layers !docker pulls !docker Stars

本仓库包含创建和运行容器所需的Dockerfile及其他文件，通过后台任务定期批量上传媒体文件夹到你的Google Photos账户。任务按预定义计划周期性运行，由https://github.com/nmrshll/gphotos-uploader-cli%E9%A9%B1%E5%8A%A8%E3%80%82

支持的架构

该镜像支持多种架构，如x86-64、arm64和armhf。直接拉取rfgamaral/gphotos-uploader会自动获取适合你架构的镜像，也可通过标签拉取特定架构的镜像。

支持的架构如下：

使用方法

创建并启动容器

确保Docker守护进程正在运行，然后通过以下命令启动容器：

docker run -d \
    --name=gphotos-uploader \
    -e GPU_SCHEDULE="<SCHEDULE_EXPRESSION>" \
    -p <EXTERNAL_PORT>:29070 \
    -v <PATH_TO_CONFIGURATION>:/config \
    -v <PATH_TO_PHOTOS_LIBRARY>:/photos \
    --restart unless-stopped \
    rfgamaral/gphotos-uploader

容器运行后，在gphotos-uploader-cli正常工作前，需先编辑/config/config.json并根据下方认证部分设置APIAppCredentials。其他配置选项请参考官方https://github.com/nmrshll/gphotos-uploader-cli/blob/master/.docs/configuration.md%E3%80%82

容器配置参数

以下是运行时可传递给容器的配置参数：

认证

由于gphotos-uploader-cli使用OAuth 2访问Google API，认证过程需要几个手动步骤。请仔细遵循以下指南，授予工具访问Google Photos账户的权限。

API凭证

使用gphotos-uploader-cli前，需启用Photos Library API并申请OAuth 2.0客户端ID：

1. 确保登录到你要上传照片的Google账户。
2. 在Google Cloud Platform中创建新项目，命名（如“Google Photos Uploader”）。
3. 启用Google Photos Library API，点击ENABLE按钮。
4. 配置OAuth consent screen，设置应用名称（如“docker-gphotos-uploader”），然后点击底部的Save按钮。
5. 创建凭证：点击“Create credentials → OAuth client ID”，选择“Other”作为应用类型，命名（如“gphotos-uploader-cli”）。
6. 复制Client ID和Client Secret，以备后续使用。

CLI认证

生成OAuth 2.0客户端ID后，需认证gphotos-uploader-cli以访问Google Photos账户：

以下步骤假设容器已创建并运行。若未运行，请先参考创建并启动容器部分。

1. 打开/config/config.json文件，设置ClientID和ClientSecret为上一步生成的值，并将jobs[0].account设置为你要上传照片的Google账户***。

2. 打开终端，运行以下命令启动认证流程：

   docker exec -it gphotos-uploader run
   

3. 你会看到类似以下输出：

   2019/10/04 16:58:50 Token has not been retrieved from token store: failed retrieving token from keyring
   2019/10/04 16:58:50 Openning browser to complete authorization.
   2019/10/04 16:58:50 Browser was not detected. Complete the authorization browsing to: http://localhost:29070
   

   在主浏览器中打开授权URL，允许“docker-gphotos-uploader”访问你的Google账户以“查看和管理你的Google Photos库”。若从本地网络的其他机器访问，需将localhost替换为Docker主机的IP地址。

4. 认证完成后，你会看到一个绿色的“Success!”提示，终端会输出类似以下内容：

   2019/10/04 17:00:22 Token expiration: 2019-10-04 18:00:22.9833634 +0000 UTC m=+3692.306522601
   2019/10/04 17:00:23 all uploads done
   2019/10/04 17:00:23 all deletions done
   2019/10/04 17:00:23 leveldb: closed
   

认证过程完成，gphotos-uploader-cli将在后台自动上传照片。

支持信息

强制运行上传任务：

docker exec -it gphotos-uploader run

容器运行时的Shell访问：

docker exec -it gphotos-uploader /bin/sh

实时监控容器日志：

docker logs -f gphotos-uploader

许可证

本源代码的使用受MIT风格许可证约束，详见LICENSE文件。