xixu-me/gdrive-upload-robot

0 Fork 0

Files

T

xixu-me 9e74a49dc5 Add Chinese README for Google Drive upload bot

2025-12-04 17:18:32 +08:00

6.6 KiB

Raw Blame History

Google Drive 上传机器人

一个基于 Cloudflare Workers 构建的 Telegram 机器人，会自动把发送给它的文件和照片上传到 Google Drive。

功能特性

📁 自动文件上传：将发送给机器人的任意文档自动上传到 Google Drive
📷 支持照片：支持照片上传并自动命名
☁️ 无服务器架构：运行在 Cloudflare Workers 上，零服务器运维成本
🔒 安全：使用 Google 服务账号（Service Account）进行身份验证
📱 实时通知：向管理员发送上传成功的确认消息

工作原理

用户向 Telegram 机器人发送文件或照片
机器人从 Telegram 服务器下载该文件
使用服务账号凭据与 Google Drive 进行身份验证
将文件上传到指定的 Google Drive 文件夹
向管理员发送确认消息

快速开始

使用上面的 “Deploy to Cloudflare” 按钮可以获得最快的部署体验。

安装配置

前置条件

在开始之前，请确保你已经具备：

一个 Cloudflare 账号（提供免费套餐）
已安装 Node.js（版本 16 或更高）
本机已安装 Git

第 1 步：配置 Google Drive

创建 Google Cloud 项目
- 访问 Google Cloud Console
- 创建一个新项目或选择已有项目
- 记下你的项目 ID
启用 Google Drive API
- 在 Google Cloud Console 中，进入 “APIs & Services” > “Library”
- 搜索 “Google Drive API” 并点击 “Enable（启用）”
创建服务账号（Service Account）
- 进入 “APIs & Services” > “Credentials”
- 点击 “Create Credentials” > “Service Account”
- 填写服务账号信息并创建
- 点击刚创建的服务账号
- 前往 “Keys” 标签页 > “Add Key” > “Create New Key”
- 选择 JSON 格式并下载文件
- 务必妥善保存该 JSON 文件——其中包含敏感凭据
配置 Google Drive 文件夹
- 在你的 Google Drive 中创建一个用于保存上传文件的文件夹
- 右键该文件夹 > “共享（Share）”
- 将服务账号的邮箱（在 JSON 文件中可找到）添加为编辑者
- 从浏览器地址栏中复制该文件夹的 ID（例如：https://drive.google.com/drive/folders/FOLDER_ID_HERE 中的 FOLDER_ID_HERE）

第 2 步：配置 Telegram 机器人

创建 Telegram 机器人
- 在 Telegram 中私聊 @BotFather
- 发送 /newbot 命令
- 按提示设置机器人名称和用户名
- 保存 BotFather 提供的机器人 Token
获取你的 Chat ID
- 私聊 @userinfobot 来获取你的 Chat ID
- 或者给你的机器人发送一条消息，然后访问： https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
- 在返回的数据中查找 "chat":{"id":CHAT_ID}

第 3 步：环境变量

你需要配置以下环境变量。务必妥善保管这些变量！

变量名	描述	示例
`TELEGRAM_BOT_TOKEN`	来自 BotFather 的机器人 Token	`123456789:ABCdefGHIjklMNOpqrsTUVwxyz`
`GOOGLE_DRIVE_FOLDER_ID`	Google Drive 文件夹 ID	`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms`
`ADMIN_CHAT_ID`	你的 Telegram Chat ID	`123456789`
`GOOGLE_CREDENTIALS`	服务账号 JSON（转成字符串）	`{"type":"service_account",...}`

第 4 步：本地环境搭建

克隆仓库

git clone https://github.com/xixu-me/gdrive-upload-robot.git
cd gdrive-upload-robot

安装依赖
```
npm install
```
登录 Cloudflare
```
npx wrangler login
```

配置机密变量（用于生产环境）

# 添加机器人 Token
npx wrangler secret put TELEGRAM_BOT_TOKEN

# 添加 Google Drive 文件夹 ID
npx wrangler secret put GOOGLE_DRIVE_FOLDER_ID

# 添加你的 Chat ID
npx wrangler secret put ADMIN_CHAT_ID

# 添加 Google 凭据（粘贴整个 JSON 内容）
npx wrangler secret put GOOGLE_CREDENTIALS

第 5 步：部署

部署到 Cloudflare Workers
```
npx wrangler deploy
```

配置 Telegram Webhook

curl -X POST "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook" \
     -H "Content-Type: application/json" \
     -d '{"url": "https://your-worker.your-subdomain.workers.dev"}'

将 <YOUR_BOT_TOKEN> 替换为你的实际机器人 Token，并把 URL 换成你 Worker 的实际地址。

测试机器人
- 向你的 Telegram 机器人发送一个文件或照片
- 检查该文件是否出现在你的 Google Drive 文件夹中
- 你应当会收到一条确认消息

故障排查

机器人没有响应：检查 Webhook 是否配置正确
上传失败：确认 Google Drive 文件夹权限和服务账号访问权限是否正确
身份验证错误：检查所有环境变量是否已正确设置
本地开发调试：可以使用 npx wrangler dev 进行本地测试

API 接口

Worker 期望接收来自 Telegram Webhook 的 POST 请求，Payload 结构如下：

文档上传

{
  "message": {
    "document": {
      "file_id": "telegram_file_id",
      "file_name": "document.pdf"
    }
  }
}

照片上传

{
  "message": {
    "photo": [
      {
        "file_id": "telegram_file_id",
        "width": 1280,
        "height": 720
      }
    ]
  }
}

安全注意事项

包含敏感数据的环境变量会安全地存储在 Cloudflare Workers 中
Google 服务账号只应授予最小必要权限
机器人 Token 必须保密，不要提交到版本控制系统
在生产环境中建议实现访问频率限制（Rate Limiting）

许可证

本项目采用 GNU 通用公共许可证 v3.0（GNU General Public License v3.0）授权——详情见 LICENSE 文件。

6.6 KiB Raw Blame History Unescape Escape