d0whc3r/gdrive

Node gdrive镜像概述

该镜像基于Node.js和TypeScript构建，旨在简化Google Drive API的操作，提供便捷的文件管理与备份功能，支持上传、压缩、清理等多种操作，可作为Google Drive备份服务工具使用。

核心功能

• 文件列表：列出Google Drive中的文件和文件夹
• 文件备份：上传单个或多个文件到指定文件夹
• 压缩备份：将多个文件压缩为ZIP包后上传
• 替换文件：上传时替换已存在的文件
• 文件夹创建：自动创建目标上传文件夹
• 旧文件清理：按时间清理指定文件夹中的旧文件
• MySQL备份：通过环境变量连接MySQL服务器并生成备份文件上传

使用场景

• 个人文件定期备份到Google Drive
• 团队共享文件夹的文件管理与备份
• MySQL数据库定时备份到Google Drive
• 自动清理Google Drive中过期的临时文件

配置说明

获取credentials.json

1. 访问Google Drive API快速启动页面
2. 点击“ENABLE THE DRIVE API”按钮
3. 下载客户端配置文件（credentials.json），保存到secrets文件夹

生成token.json

通过执行列表命令触发token生成流程：

Docker方式

确保credentials.json在$PWD/secrets路径下：

bash
docker run --rm -it -v $PWD/secrets:/app/secrets/ d0whc3r/gdrive -l

执行后会显示授权URL，完成授权后将token粘贴到终端即可生成token.json

环境变量配置

• CREDENTIALS_FILE：指定credentials.json文件路径
• TOKEN_FILE：指定token.json文件路径

Docker部署示例

查看帮助

bash
docker run --rm d0whc3r/gdrive --help

列出Google Drive文件

bash
docker run --rm -v $PWD/secrets:/app/secrets:ro d0whc3r/gdrive -l

备份文件到指定文件夹

bash
docker run --rm -v $PWD/secrets:/app/secrets:ro -v $PWD/files:/app/files d0whc3r/gdrive -b files/doc.pdf -f backupFolder

MySQL备份并压缩上传

bash
docker run --rm -v $PWD/secrets:/app/secrets:ro -e MYSQL_USER=root -e MYSQL_PASSWORD=123456 -e MYSQL_DATABASE=mydb -e MYSQL_HOST=host.docker.internal d0whc3r/gdrive -f mysql-backup -m -z

许可证

该项目遵循开源许可证，详情见https://github.com/d0whc3r/node-gdrive%E3%80%82