如何无需第三方服务与轮询，从Dropbox触发GitHub Webhook？

1. 生成GitHub权限令牌（PAT） #

• 创建一个拥有 repo 权限的Personal Access Token，务必妥善保存，后续会用到。

2. 配置Dropbox Webhook #

• 在Dropbox开发者平台创建应用，开启Webhook功能，把后续搭建的中间服务地址设为Webhook的接收地址。
• Dropbox会发送验证请求到你的服务地址，服务需要处理：当请求参数里带challenge时，直接返回该参数值，完成验证流程。

3. 搭建中间服务（以Vercel无服务器函数为例） #

创建一个无服务器函数文件（比如api/dropbox-webhook.js），代码逻辑如下：

export default async function handler(req, res) {
  // 处理Dropbox的Webhook验证
  if (req.method === 'GET') {
    const challenge = req.query.challenge;
    if (challenge) {
      res.status(200).send(challenge);
      return;
    }
  }

  // 处理Dropbox的文件变更通知
  if (req.method === 'POST') {
    // 调用GitHub API触发Actions工作流
    const githubToken = process.env.GITHUB_PAT;
    const repoOwner = '你的GitHub用户名';
    const repoName = '目标仓库名称';
    const workflowId = '你的工作流文件名（比如ci.yml）';

    const response = await fetch(`https://api.github.com/repos/${repoOwner}/${repoName}/actions/workflows/${workflowId}/dispatches`, {
      method: 'POST',
      headers: {
        'Authorization': `token ${githubToken}`,
        'Accept': 'application/vnd.github.v3+json',
      },
      body: JSON.stringify({
        ref: 'main' // 指定触发工作流的分支
      })
    });

    if (response.ok) {
      res.status(200).send('工作流触发成功');
    } else {
      res.status(500).send('工作流触发失败');
    }
    return;
  }

  res.status(405).send('不支持该请求方法');
}

• 把之前生成的GitHub PAT添加到服务的环境变量中（比如Vercel里设GITHUB_PAT变量）。
• 部署这个无服务器服务，拿到公开访问URL，配置到Dropbox的Webhook设置里。

4. 配置GitHub Actions工作流 #

确保仓库里有对应的工作流文件（比如.github/workflows/ci.yml），并且开启手动/API触发权限，示例开头配置：

name: CI
on:
  push:
    branches: [main]
  workflow_dispatch: # 允许通过API触发该工作流
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # 这里写你的CI任务步骤

安全提示 #

• 校验Dropbox请求签名：用Dropbox提供的签名密钥，核对请求头里的签名，确保请求来自官方。
• 最小化GitHub令牌权限：只给必要的repo权限，避免权限过大带来风险。

内容的提问来源于stack exchange，提问作者Ruggero Turra