1. 项目概述一个基于 Cloudflare Workers 的邮件路由方案如果你手头有几个域名想用它们来收发邮件但又不想花钱租用专门的邮件服务器或者觉得像 Gmail、Outlook 这样的商业邮箱不够灵活那么今天聊的这个方案可能会让你眼前一亮。我最近在折腾一个个人项目需要为多个域名配置独立的邮件地址并且希望所有邮件都能统一转发到我的主力邮箱里。传统的方案要么太贵要么配置复杂直到我发现了利用 Cloudflare Workers 和其 Email Routing 服务来搭建一个轻量级、高可控性的邮件转发系统。这个方案的核心就是cloudflare-email-routing这个项目。它不是一个需要你下载安装的桌面软件而是一个基于 Web 技术栈从关键词看涉及 Blazor Server, React, TypeScript 等构建的配置管理工具。它的主要作用是帮你更直观、更批量地管理 Cloudflare 平台上的邮件路由规则尤其是当你需要处理大量自定义域名和邮件地址时通过一个友好的界面来操作远比在 Cloudflare 仪表盘里一个个手动点击要高效得多。简单来说它把你需要在 Cloudflare 上进行的多项 DNS 配置和邮件路由设置打包成了一个可自动化执行的流程。2. 核心需求与方案选型解析2.1 为什么选择 Cloudflare Email Routing在深入工具之前我们得先搞清楚底层依赖的 Cloudflare Email Routing 服务是什么以及它为什么是个人和小型项目的绝佳选择。Cloudflare Email Routing 是一项免费服务它允许你将发送到你域名下任意地址的邮件自动转发到你指定的一个或多个外部邮箱比如你的 Gmail、QQ 邮箱。它本身不提供邮箱存储只做“邮差”负责中转。我选择它的理由很直接零成本、高可靠、易集成。对于个人开发者、博主或是小型工作室自建邮件服务器如 Postfix的维护成本太高而购买企业邮箱又可能超出预算。Cloudflare 的解决方案完美折中利用 Cloudflare 全球化的网络和强大的反垃圾邮件能力确保邮件投递的可靠性和安全性完全免费没有发送数量限制但有合理的频率限制以防止滥用最重要的是它与 Cloudflare 的 DNS 服务无缝集成你本来可能就用它来管理域名的解析现在邮件路由也在同一个平台管理起来非常方便。2.2cloudflare-email-routing工具解决了什么痛点虽然 Cloudflare 官方控制台提供了 Email Routing 的配置界面但在处理一些复杂或批量场景时原生界面就显得有些力不从心。这正是cloudflare-email-routing这类第三方工具的价值所在。批量操作效率低下假设你需要为域名example.com设置一个“捕获所有”规则即*example.com都转发同时又要为adminexample.com,contactexample.com等特定地址设置独立转发或不同目的地在原生界面你需要多次点击、重复填写表单。而这个工具可以通过配置文件或更优的 UI实现批量导入和部署。配置的版本管理与复用当你拥有多个域名且希望应用相似的邮件路由规则时手动配置无法复用。这个工具很可能允许你将配置规则列表、目标地址等以代码或配置文件的形式保存下来便于版本控制Git和快速应用到新域名上。高级规则的便捷管理Cloudflare Workers 允许你在邮件路由过程中插入自定义逻辑比如根据发件人、邮件主题进行过滤或者将邮件内容进行简单处理后转发。在原生界面配置 Workers 并与 Email Routing 绑定步骤较为分散。而这个工具可能提供了一个集成的界面让你可以更方便地关联或编写简单的 Worker 脚本。状态可视化管理工具可能会提供一个仪表盘集中展示你所有域名下的邮件路由规则状态、近期的转发统计如成功/失败次数等这比登录 Cloudflare 不同域名的面板去查看要直观得多。从项目关键词包含blazor-server,react,typescript,github-config来看这个工具很可能是一个具有现代 Web 界面的应用程序它通过 Cloudflare API 与你账户下的资源进行交互实现了上述的便捷管理功能。laravel,php,mailable等关键词则暗示它可能也包含一个后端服务用于处理更复杂的逻辑或提供模板 (templates) 功能。3. 核心组件与工作原理深度拆解要玩转这个方案我们需要理解几个关键组件是如何协同工作的。这不仅仅是点几下按钮知道背后的原理出问题时你才能快速定位。3.1 Cloudflare Email Routing 的 DNS 魔法邮件路由的基石是 DNS 记录。当你启用 Cloudflare Email Routing 时它会自动为你管理的域名添加或修改两条关键的 MX 记录MX 记录将邮件交换服务器指向 Cloudflare 的邮件处理服务器如route1.mx.cloudflare.net,route2.mx.cloudflare.net。这告诉全世界的邮件服务器“发送给yourdomain.com的邮件请投递到 Cloudflare 的服务器。”TXT 记录 (SPF)会添加一条包含include:_spf.mx.cloudflare.net的 SPF 记录。SPF 是一种反垃圾邮件技术用于声明哪些服务器有权代表你的域名发送邮件。这里声明了 Cloudflare 的服务器是合法的发送者这能极大提高你转发邮件的送达率避免被收件方当作垃圾邮件。cloudflare-email-routing工具在初始设置时核心任务之一就是通过 Cloudflare API 自动配置或验证这些 DNS 记录是否正确。这是整个流程能跑通的第一步也是最重要的一步。如果 MX 记录设置错误或未生效所有邮件都会石沉大海。3.2 路由规则引擎与目标地址DNS 把邮件“接”到了 Cloudflare接下来就是“转”给谁。在 Cloudflare 控制台或通过此工具你需要创建“路由规则”。一条规则通常包含两个部分匹配条件可以是具体的邮箱地址如supportyourdomain.com也可以是通配符如*yourdomain.com或sales-*yourdomain.com。目标地址一个或多个你已经验证过的外部邮箱地址如your-personalgmail.com。Cloudflare 会先向这些目标地址发送一封验证邮件确认你拥有该邮箱的控制权之后转发才会生效。cloudflare-email-routing工具的亮点在于它可能允许你通过一个 CSV 文件或一个更友好的表格界面一次性创建数十条这样的规则并批量触发目标邮箱的验证流程这比手动操作节省了大量时间。3.3 Cloudflare Workers 的介入与高级处理这是让邮件路由从“简单转发”升级为“智能路由”的关键。Cloudflare Workers 是一个无服务器Serverless执行环境你可以在邮件被转发前用 JavaScript或兼容语言编写一段代码来处理这封邮件。常见的高级处理场景包括内容过滤与标记检查邮件主题或正文是否包含特定关键词如“投诉”、“紧急”并在转发时在主题前添加[URGENT]标签。路由决策根据发件人域名将邮件转发到不同的目标邮箱。例如来自partner.com的邮件转发到工作邮箱其他转发到个人邮箱。日志与通知将每封转发邮件的元信息发件人、时间、主题记录到外部数据库或发送到 Slack/Telegram 进行通知。附件处理检查附件大小、类型或对附件进行简单的重命名。cloudflare-email-routing工具如果集成了 Workers 管理功能它可能会提供一些预置的、常用的 Worker 脚本模板对应关键词templates并提供一个编辑器让你能够方便地修改、测试和部署这个 Worker并将其与特定的邮件路由规则绑定。关键词中的private-key-encryption可能涉及到在 Worker 中安全地处理一些敏感信息如调用第三方 API 的密钥工具或许提供了相应的加密存储和注入机制。3.4 工具本身的技术栈与架构猜想结合关键词我们可以推测这个工具可能是一个前后端分离的应用前端可能使用ReactTypeScript构建了一个单页面应用SPA提供动态、响应式的管理界面。blazor-server的出现则暗示可能还有基于 .NET 技术的 Blazor Server 版本提供了另一种全栈的解决方案。后端如果存在独立后端laravel(PHP) 是一个可能的选择用于处理用户认证、配置存储、与 Cloudflare API 的代理交互出于安全考虑前端通常不直接暴露 API 密钥等。mailable是 Laravel 中用于发送邮件的组件可能用于工具自身发送系统通知如配置完成通知。配置与扩展github-config提示工具可能支持从 GitHub 仓库读取配置文件实现“基础设施即代码”IaC让你的邮件路由配置像代码一样可版本化、可评审、可自动部署。cursor可能指代某个代码编辑器或 AI 编程助手暗示项目配置或 Worker 脚本的开发体验。浏览器扩展这是一个有趣的切入点。一个browser-extension可能用于快速捕获当前浏览器标签页中 Cloudflare 控制台的配置并导入到工具中或者提供一键快捷操作。注意以上是基于关键词的合理推测。实际使用中这个工具可能只实现了上述功能的一部分。它的核心价值在于将 Cloudflare 提供的、相对离散的 API 和功能通过一个更优的抽象层和用户界面整合起来降低复杂度和操作成本。4. 从零开始的完整实操部署指南现在我们抛开工具的细节先聚焦于最核心的目标如何利用 Cloudflare 的基础服务手动搭建一个可用的邮件转发系统。这是理解整个流程的基础即使后续使用工具你也会更清楚它在帮你做什么。4.1 前期准备与账户配置拥有一个域名这是前提。你可以在任何注册商购买域名。将域名接入 Cloudflare在 Cloudflare 官网添加你的站点并按照指引将其 DNS 名称服务器Name Server修改为 Cloudflare 提供的地址。这个过程通常需要几分钟到几小时生效。这是所有 Cloudflare 服务包括 CDN、DNS、Email Routing的基础。准备目标邮箱准备好你希望接收邮件的那个外部邮箱地址例如yournamegmail.com。确保你能正常登录并查看验证邮件。4.2 手动启用并配置 Cloudflare Email Routing登录 Cloudflare 仪表板选择你已接入的域名。在左侧菜单中找到“Email”-“Email Routing”。首次进入会看到一个“开始使用”的引导。添加目标邮箱地址点击“添加目标地址”输入你的外部邮箱如 Gmail。Cloudflare 会立即向该邮箱发送一封验证邮件。登录你的外部邮箱找到这封邮件可能在垃圾邮件夹点击其中的验证链接或输入验证码。验证成功后该地址状态会变为“有效”。创建自定义邮箱地址与路由规则在“Email Routing”页面找到“自定义地址”或“路由规则”选项卡。点击“创建地址”例如你想创建helloyourdomain.com。在“发送至”选项中选择你刚才验证过的目标邮箱地址。点击保存。至此一条最简单的路由规则就创建好了所有发送到helloyourdomain.com的邮件都会被转发到你的 Gmail。4.3 验证与测试配置完成后需要等待 DNS 的 MX 记录全球生效这个过程称为 DNS 传播可能需要几十分钟到几小时。测试方法用你另一个邮箱比如你的工作邮箱向新创建的自定义地址helloyourdomain.com发送一封测试邮件。检查你的目标邮箱Gmail是否收到了这封邮件。邮件的发件人显示会发生变化Cloudflare 默认会使用“通过 Cloudflare Email Routing 代发”的形式原始发件人信息会包含在邮件头中。Gmail 等客户端通常能很好地显示原始发件人。重要检查项在目标邮箱中查看这封测试邮件的原始邮件头在 Gmail 中点击邮件右上角“三个点” - “显示原始邮件”。检查是否有Received-SPF: pass以及Authentication-Results中包含dkimpass或dmarcpass等字样。这表示邮件通过了反垃圾邮件验证送达率有保障。4.4 引入cloudflare-email-routing工具进行高效管理假设工具是一个 Web 应用其典型使用流程可能如下获取 Cloudflare API 凭证在 Cloudflare 仪表板进入“我的个人资料” - “API 令牌”。点击“创建令牌”建议使用“编辑 Cloudflare Workers”模板因为它通常包含了管理 DNS、Workers 和 Email Routing 所需的权限。务必精细勾选所需权限Zone:Read, Zone:Edit, Worker:Edit 等并仅授权给需要管理的特定域名Zone遵循最小权限原则。安全地保存生成的 API 令牌只会显示一次。部署或启动管理工具如果工具是开源需要自部署的你可能需要按照其 README使用 Docker 或直接在服务器上部署其前后端。如果作者提供了在线服务则直接访问即可。在工具中授权并连接你的 Cloudflare 账户在工具界面找到添加账户或项目的入口。输入你的 Cloudflare 账户邮箱和刚才生成的 API 令牌。工具会拉取你账户下可管理的域名列表。批量配置与管理域名级配置选择一个域名工具可能会一键为你启用 Email Routing 服务并自动配置好 MX 和 SPF 记录。规则批量操作在一个清晰的表格或列表界面中你可以导入一个 CSV 文件文件列可能包含“自定义地址”、“目标邮箱”、“是否启用”等一次性创建上百条规则。对现有规则进行批量启用、禁用、编辑或删除。查看所有规则的状态如目标邮箱是否已验证。Workers 集成工具可能提供一个代码编辑器让你编写或粘贴处理邮件的 Worker 脚本。它可以帮助你绑定这个 Worker 到“在转发前”或“在转发后”的事件上并完成部署。实操心得手动配置是理解原理的最佳途径但在管理超过 5 个邮箱地址或 2 个域名后效率瓶颈就会非常明显。此时一个像cloudflare-email-routing这样的工具带来的效率提升是巨大的。它的核心价值在于将“配置”数据化、界面化、批量化把我们从重复的点击劳动中解放出来。5. 高级场景与自定义 Worker 脚本实战当你掌握了基础转发后Cloudflare Workers 能为你打开新世界的大门。下面我们通过两个实际例子来看看如何用几行 JavaScript 代码实现智能路由。5.1 示例一根据发件人自动加标签假设你希望所有来自important-client.com的邮件在转发到你的 Gmail 时都在主题前加上[VIP客户]的标签以便优先处理。// 这是一个 Cloudflare Email Worker 的基本骨架 export default { async email(message, env, ctx) { // 获取原始发件人邮箱 const from message.from; // 检查发件人域名 if (from.includes(important-client.com)) { // 修改邮件主题 const newSubject [VIP客户] ${message.headers.get(subject) || No Subject}; // 创建一个新的邮件对象修改主题其他部分保持不变 // 注意这里需要重新构造邮件这是一个简化的示例 // 实际应用中使用 message.forward() 或 message.reply() 等API更常见 // 但Email Routing Worker的API可能有所不同以下为概念性代码 // 假设我们可以直接设置新的headers并转发 message.setHeader(subject, newSubject); } // 继续转发给Email Routing设置的目标地址 // 实际API可能是 message.forwardTo(destination); // 这里示意继续流程 await message.forward(); } }关键点解析这个 Worker 会拦截每一封待转发的邮件检查message.from属性。如果匹配到关键域名它就修改邮件头的subject字段然后放行由 Cloudflare Email Routing 完成后续的转发。这让你在收件箱里能一眼识别出重要邮件。5.2 示例二邮件内容简单分析与日志记录你想记录下所有转发的邮件发送到了哪个自定义地址并将日志存储起来。// 假设我们使用 Workers 的 KV 命名空间一种键值存储来记录日志 // 或者在环境中配置了日志服务如 Discord Webhook export default { async email(message, env, ctx) { // 获取收件人即你的自定义地址和发件人 const to message.to; const from message.from; const subject message.headers.get(subject) || No Subject; const timestamp new Date().toISOString(); // 构造日志信息 const logEntry [${timestamp}] 邮件到达 ${to}来自 ${from}主题: ${subject}; // 方式1写入到控制台可在Workers仪表板的日志中查看 console.log(logEntry); // 方式2发送到外部Webhook例如Discord、Slack或自定义API // 这里以调用一个假设的环境变量中的WEBHOOK_URL为例 if (env.LOG_WEBHOOK_URL) { await fetch(env.LOG_WEBHOOK_URL, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ content: logEntry }), }); } // 方式3存储到 KV需要提前绑定 KV 命名空间 // const id mail-${Date.now()}; // await env.MAIL_LOG_KV.put(id, logEntry); // 邮件正常转发 await message.forward(); } }关键点解析这个示例展示了 Worker 的另一个强大功能——可观测性。你可以在邮件流转的关键节点插入日志用于监控、审计或调试。例如你可以知道哪个自定义地址最常用或者排查某封邮件为什么没有成功转发。env对象用于安全地访问你预先在 Worker 配置中设置的环境变量如 API 密钥、Webhook URL。注意事项编写 Email Worker 时务必注意执行时间和复杂度。Cloudflare Workers 有免费计划的限制每日请求数和 CPU 时间。邮件处理逻辑应尽量轻量、快速避免进行复杂的网络请求或大文件处理以免超时或产生额外费用。对于重要逻辑一定要添加充分的错误处理try-catch避免因为单封邮件处理失败而阻塞整个路由。6. 常见问题、故障排查与安全实践即使方案再优雅在实际运行中也可能遇到各种问题。下面是我在长期使用中总结的一些典型场景和解决方法。6.1 邮件收不到一步步排查这是最常见的问题。请按照以下顺序排查就像医生问诊一样由表及里问题环节检查点诊断方法与解决方案DNS 层面MX 记录是否生效使用dig或在线 DNS 查询工具如tool.chinaz.com/dns查询你的域名的 MX 记录。确认是否指向route1.mx.cloudflare.net等 Cloudflare 服务器。如果未生效检查 Cloudflare 域名状态并等待 DNS 传播最多 48 小时。Cloudflare 配置Email Routing 是否已启用目标邮箱是否已验证登录 Cloudflare 仪表板进入 Email Routing 页面确认服务状态为“已启用”。检查目标邮箱地址旁是否有绿色的“已验证”标记。如果没有重新发送验证邮件。路由规则规则是否创建且启用检查是否为你发送邮件的地址如testyourdomain.com创建了路由规则并且该规则是“启用”状态。规则的目标地址是否正确。发送方邮件是否被对方服务器拒收检查你发送测试邮件的邮箱如你的 Gmail的“已发送”文件夹。如果发送失败Gmail 通常会在几分钟后给你发送一封退信通知Bounce Mail里面会包含具体的错误原因如“收件人地址不存在”、“对方服务器拒绝”等。这是最直接的错误信息来源。Cloudflare 拦截邮件是否被 Cloudflare 视为垃圾邮件Cloudflare 有内置的垃圾邮件过滤。登录 Cloudflare 仪表板在 Email Routing 的“设置”中可以调整垃圾邮件过滤的严格程度或查看隔离邮件。接收方目标邮箱邮件是否在垃圾邮件夹务必检查你的目标邮箱如接收转发的 Gmail的“垃圾邮件”或“垃圾箱”文件夹。有时转发邮件可能因为 SPF/DKIM 配置未完全优化而被误判。6.2 邮件延迟或偶尔丢失DNS 缓存你或收件人邮件服务商的 DNS 缓存未更新。除了等待可以尝试刷新本地 DNS 缓存如 Windows 的ipconfig /flushdns。Cloudflare Workers 超时或错误如果你配置了自定义 Worker且 Worker 执行出错或超时默认超时时间较短可能导致邮件被丢弃。检查 Workers 的日志流查看是否有错误信息。发送频率限制Cloudflare 对免费账户的邮件转发有速率限制以防止滥用。如果你短时间内触发了大量转发例如被拉入一个活跃的邮件列表可能会被临时限制。这种情况通常会在稍后自动恢复。6.3 安全与隐私考量API 令牌安全这是最高级别的敏感信息。cloudflare-email-routing这类工具如果需要你的 API 令牌请务必只授予其最小必要权限仅限特定域名仅限所需操作并定期轮换。绝对不要将令牌提交到公开的代码仓库。目标邮箱安全你的所有邮件最终都汇聚到目标邮箱如 Gmail。务必为该邮箱开启双重身份验证2FA确保其安全性。谨慎使用通配符设置*yourdomain.com这样的“捕获所有”规则很方便但也意味着任何发往你域名的邮件都会被转发包括垃圾邮件和探测邮件。建议结合 Cloudflare 的垃圾邮件过滤或只为已知的、需要的地址创建规则。Worker 脚本审计如果你使用或编写了自定义 Worker请确保其代码是可信的。恶意的 Worker 脚本可能会窃取邮件内容。对于从第三方获取的脚本务必仔细审查其逻辑。6.4 关于发件人From地址的误解很多人会问“我可以用hellomybrand.com这个地址来发送邮件吗” 这是一个关键区分。Cloudflare Email Routing 目前主要是一个“入站”邮件转发服务并不直接提供“出站”SMTP 发信功能。接收入站任何人发送到hellomybrand.com的邮件会被 Cloudflare 接收并转发到你的个人邮箱。这是本方案的核心。发送出站当你想从你的个人邮箱如 Gmail以hellomybrand.com的名义给别人发邮件时你需要配置 Gmail 的“发送邮件为”功能这通常需要你域名下的 SMTP 服务器。Cloudflare Email Routing不提供这个 SMTP 服务器。解决方案如果你需要发送邮件可以考虑使用域名注册商或主机商提供的免费/付费企业邮箱服务通常带 SMTP。使用专门的邮件发送服务如 SendGrid, Mailgun 的免费额度。自建轻量级 SMTP 服务器如使用 Docker 部署postfix但这会显著增加维护复杂度。7. 进阶玩法与生态集成思路当你熟练掌握了基础转发和 Worker 脚本后可以尝试将这些能力融入更广的工作流中。1. 与自动化平台Zapier / Make / n8n集成虽然 Cloudflare Workers 本身可以处理逻辑但有时与现成的无代码/低代码平台集成更快。你可以创建一个简单的 Webhook在 Worker 中收到特定条件的邮件如主题包含“订单”时不仅转发还将邮件关键信息发件人、主题、正文摘要通过 HTTP POST 发送到 Zapier 的 Webhook。Zapier 接收到后可以自动在 Trello 创建卡片、在 Google Sheets 添加一行、或发送一条 Slack 通知。2. 构建简易的邮件工单系统为supportyourdomain.com设置转发规则并绑定一个 Worker。Worker 解析邮件提取客户的问题。将问题内容、客户邮箱存入一个简单的数据库如 Cloudflare D1 或 Supabase。同时自动回复一封“已收到您的问题工单号是 XXX”的确认邮件。你可以在一个自建的小型管理后台中查看和处理这些工单。3. 基于邮件的内容触发 GitHub Actions如果你是一个开发者可以用邮件来触发 CI/CD。为deployyourdomain.com设置转发并绑定 Worker。Worker 检查邮件如果发件人是特定的合作者且邮件包含特定指令如正文为“/deploy main”则 Worker 调用 GitHub Actions 的 API 触发某个仓库的部署工作流。这可以作为一种极简的、无需复杂界面的部署触发机制。我个人在实际使用 Cloudflare Email Routing 和尝试类似cloudflare-email-routing工具化方案的体会是它最大的魅力在于“化繁为简”和“激发创意”。它将一个传统上需要服务器、复杂软件和持续维护的基础设施邮件服务器变成了一个几乎零运维、按需编程的无服务组件。对于独立开发者、小微团队或是拥有多个域名的个人来说这不仅仅是省下了每年几十上百美元的邮箱费用更重要的是获得了一种轻盈、灵活且强大的通信控制能力。你可以像搭积木一样用几行代码就让邮件流与你数字世界里的其他部分互动起来。当然它并非万能出站发信的限制需要搭配其他方案解决但对于绝大多数以接收、分类、自动化处理为主的场景它已经是一个接近满分的答案。