
Freemail接入Resend发件渠道从创建API Key到第一封邮件发出的完整教程【免费下载链接】freemailCloudflare 域名邮箱系统 临时邮箱系统 支持API 调用 支持多渠道发件 支持用户管理 domain mail tempmail项目地址: https://gitcode.com/gh_mirrors/free/freemailFreemail 是一款基于 Cloudflare Workers D1 的开源临时邮箱系统支持 API 调用、邮件转发与多渠道发件。本文手把手带你完成Freemail 接入 Resend 发件渠道的全流程绑定并验证发信域名 → 创建 Resend API Key → 配置到 Cloudflare Workers → 发出第一封邮件全程不到 15 分钟 为什么用 Resend 给临时邮箱发件Freemail 本身负责收Cloudflare Email Routing 负责收件路由而发则由第三方发件渠道完成。目前项目内置三大发件渠道Resend、SendFlare、Cyberpersons三者的配置格式完全一致可以同时启用、按发件人域名自动路由。Resend 作为最常用的发件渠道优势在于纯 API 发件无需 SMTPWorker 里一个fetch就能发出邮件密钥简单一个 API Key 即可支持按域名精细授权多域名同一个变量里可配置多个域名的独立密钥代码读取密钥的环境变量优先级为RESEND_API_KEYRESEND_TOKENRESEND推荐统一使用RESEND_API_KEY。开始前的准备工作准备项说明Cloudflare 账号已部署 Freemail可用一键部署按钮快速完成一个自有域名如yourdomain.com需在 Cloudflare 托管或可编辑其 DNSResend 账号免费注册即可获得发件额度发件权限严格管理员默认可发件普通用户需在管理后台开启can_send第一步在 Resend 绑定并验证发信域名发件的前提是域名在 Resend 侧完成验证否则所有发件请求都会被拒绝。登录 Resend 后台左侧菜单进入Domains点击右上角Add Domain按向导输入你的发件域名如yourdomain.comResend 会生成需要添加的 DNS 记录前往域名的 DNS 管理Cloudflare 控制台即可添加 Resend 提示的记录SPF / MX 等记录添加完成后回到 Resend 点击验证等待状态变为Verified验证通过后即可使用该域名下的任意地址发件例如no-replyyourdomain.com⚠️注意发件地址必须使用该已验证域名。Freemail 首页邮箱后端里配置的域名需要与 Resend 已验证域名保持一致。第二步创建 Resend API Key进入 Resend →API Keys点击Create API Key为密钥起个名字如mailfree权限建议选择包含 Emails 读写发送的完整权限创建成功后复制生成的 Key以re_开头。Key 只显示一次请妥善保存第三步把 API Key 配置到 Cloudflare Workers本项目运行在 Cloudflare Workers密钥需要以Secret形式配置域名作为普通变量配置。两种任选其一方式一命令行Wrangler# 设置 Resend 密钥Secret wrangler secret put RESEND_API_KEY方式二DashboardGit 集成部署必用进入 Cloudflare Dashboard → Workers → 选中你的 Worker → Settings → Variables在Secrets添加RESEND_API_KEY值为你刚创建的 Key在Variables确认MAIL_DOMAIN值为收发件域名列表多个用逗号分隔如iding.asia,example.com 使用 Git 集成自动部署时环境变量不会被提交到代码仓库请务必在 Dashboard 手动配置。第四步部署并发出第一封邮件部署Git 集成部署会自动触发命令行部署则执行wrangler deploy本地调试可用wrangler dev打开 Freemail 首页确认当前邮箱已生成如xxxx你的域名点击发邮件填写收件人、主题与内容点击发送后端会调用 Resend API 发出邮件并在数据库中记录该封邮件。稍后切换到收件箱的发件箱标签即可看到这封已发送的记录与详情 ✅后端实现位于src/api/send.js与src/email/providers/resend/index.js发送成功后会写入sent_emails表含provider字段标记渠道前端发件箱读取的就是这份记录。多域名发信如何配置如果你有多个域名且希望各自使用独立的 Resend 密钥独立计费/限额RESEND_API_KEY支持三种格式# 单密钥通配所有发件域名 RESEND_API_KEYre_xxxxxxxxxxxxxxxxxxxxxxxx # 键值对推荐多域名独立配置 RESEND_API_KEYdomain1.comre_key1,domain2.comre_key2 # JSON 格式 RESEND_API_KEY{domain1.com:re_key1,domain2.com:re_key2}配置多个渠道时路由规则为键值对/JSON 命中优先 → 单密钥兜底SendFlare → Resend → Cyberpersons 依次匹配均未命中则报错未找到域名对应的发件 API Key。路由逻辑在src/email/providers/index.js与src/email/providers/shared.js中实现。常见问题排查现象原因与解决提示未配置 Resend API Key未设置RESEND_API_KEY或未以 Secret 形式写入检查 Workers → Settings → Secrets403 / Unauthorized发件域名未在 Resend 完成验证或 From 地址与已验证域名不一致429 限流短时间内请求过密稍后重试或改用批量接口POST /api/send/batch普通用户发送报 403用户未开启发件权限需在管理后台打开can_send中文/HTML 显示异常项目已自动为 HTML 生成纯文本版本确认收件客户端支持相关文件速查 官方 Resend 配置教程docs/resend.md 多渠道适配说明docs/provider-adapter.md Resend 渠道实现src/email/providers/resend/index.js 渠道路由分发器src/email/providers/index.js 发件记录接口src/api/send.js 本地变量示例wrangler.toml到这里你的 Freemail 就已经拥有 Resend 发件能力了。如果还想接入 SendFlare 或 Cyberpersons只要按照同样的格式配置对应的SENDFLARE_API_KEY/CYBERPERSONS_API_KEY环境变量即可无需改动任何代码 【免费下载链接】freemailCloudflare 域名邮箱系统 临时邮箱系统 支持API 调用 支持多渠道发件 支持用户管理 domain mail tempmail项目地址: https://gitcode.com/gh_mirrors/free/freemail创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考