当前位置：首页 > 文章列表 > 文章 > 前端 > 使用 Cloudflare Workers 实施 Gmail 发送 - 设置指南

使用 Cloudflare Workers 实施 Gmail 发送 - 设置指南

来源：dev.to 2024-12-05 11:28:05 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《使用 Cloudflare Workers 实施 Gmail 发送 - 设置指南》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

这是使用 Cloudflare Workers 实施 Gmail 发送系列的第 1 部分：

第 1 部分：设置（当前）
第 2 部分：开发环境（即将推出）
第 3 部分：实施（即将推出）

介绍

在 Cloudflare Pages 托管的静态网站上实施联系表单时，电子邮件发送功能需要无服务器解决方案。本指南演示了如何使用 Cloudflare Workers 设置 Gmail API 来处理表单提交。

Cloudflare Workers 限制

使用 Cloudflare Workers 时，需要考虑两个主要限制：

Google API 包不可用：
- Cloudflare Workers 不是 Node.js 环境
- 必须使用对 Google API REST 端点的直接 HTTP 请求，而不是 Node.js 客户端库
Nodemailer 软件包不可用:
- Nodemailer 依赖 Node.js 环境
- 不能在 Cloudflare Workers 中使用

设置过程

1. 创建服务帐号

访问 Google Cloud Console
创建一个新项目或选择现有项目
导航到“IAM 和管理” > “服务帐户”
点击“创建服务帐户”
输入服务帐户名称和描述
跳过可选设置并单击“完成”
记下 OAuth2 客户端 ID 供以后使用

2. 分配所需的角色

导航到“IAM 和管理” >“IAM”
选择相关主体
点击“授予访问权限”
将服务帐户添加为新主体
分配以下角色：
- 服务帐户管理员
- 服务帐户密钥管理员
- 服务帐户令牌创建者
- IAP 政策管理员
保存更改

3.启用Gmail API

导航至“API 和服务”>“库”
搜索“gmail”
选择“Gmail API”
点击“启用”

4. 添加组织策略管理员角色

导航到“IAM 和管理” >“IAM”
编辑组织管理员
添加“组织政策管理员”角色
保存更改

5.禁用服务帐户密钥创建策略

导航至“IAM 和管理” > “组织政策”
过滤“iam.disableServiceAccountKeyCreation”
点击政策链接
点击“管理政策”
选择“覆盖家长政策”
添加规则并设置为“强制”
点击“完成”

6. 生成服务帐户密钥

导航到“IAM 和管理” > “服务帐户”
选择创建的服务帐户
转到“按键”选项卡
点击“添加密钥” > “创建新密钥”
选择 JSON 格式
创建并安全存储下载的 JSON 文件

7. 配置域范围委派

访问 Google Workspace 管理控制台
导航至安全 > 访问和数据控制 > API 控件
点击“管理域范围委托”
添加新的客户端 ID：
- 输入服务帐户的客户端 ID
- 添加范围：https://www.googleapis.com/auth/gmail.send
点击“授权”

注意：由于安全隐患，应在较大的组织中仔细考虑域范围的委派。

附加配置

使用 Gmail 别名发送电子邮件时，请记得添加别名地址：

转到 Gmail 设置 > 帐户
通过“添加其他电子邮件地址”添加别名电子邮件地址

关于免费电子邮件服务的重要说明

此前，MailChannels Send API 被广泛推荐为 Cloudflare Workers 的免费电子邮件发送解决方案。但是，自 2024 年 6 月 30 日起，MailChannels 和 Cloudflare 之间的集成已停止。这影响了许多依赖此服务来满足电子邮件发送需求的开发人员。

许多 AI 语言模型仍然建议使用 MailChannels 作为解决方案，因为它们的训练数据早于该服务终止。这种情况凸显了验证当前服务可用性的重要性，尤其是在使用第三方集成时。

本指南中描述的 Gmail API 实现是一个可靠的替代方案，尽管与之前的 MailChannels 解决方案相比，它需要更多的初始设置。