谁还没几个不想暴露主邮箱的时刻？注册那些不知名的小众论坛、下载一份需要“验证”的电子书，或者是测试一个刚上线的SaaS服务。每次填入那个伴随你多年的主力邮箱，心里总会咯噔一下生怕第二天垃圾邮件就像决堤的洪水一样涌进来。以前我也习惯用那些公共的临时邮箱服务，但说实话，把这种隐私交给陌生人，总有点像是在玩俄罗斯轮盘赌——你永远不知道哪天服务会关停，或者你的验证码会被谁截胡。

所以当我在 GitHub 上发现 FlashInbox 这个项目时那种“自己动手丰衣足食”的DNA瞬间动了。这不仅仅是一个临时邮箱，geng是一个完全由我掌控、运行在 Cloudflare 边缘网络上的私人收件站。今天我就把这次折腾的全过程，连同那些踩过的坑和流过的汗，dou毫无保留地分享出来。

为什么选择 Cloudflare 和 FlashInbox？

在开始动手之前，我得先夸夸这套技术栈的选型。说实话，现在的开发者真的hen幸福。以前要搞个邮箱服务，你得自己折腾 Postfix，得跟 DNS 记录死磕，还得担心服务器 IP 被反垃圾邮件组织拉黑。那简直是噩梦。

但 FlashInbox 走的是一条完全不同的路子。它极其聪明地利用了 Cloudflare 的生态：

前端： 使用 Next.js 构建，界面现代，交互流畅。

运行环境： 直接部署在 Cloudflare Workers 上。这意味着没有服务器需要维护，全球节点加速，而且免费额度非常慷慨。

数据库： 使用 Cloudflare D1。这是一个基于 SQLite 的边缘数据库，虽然简单，但对于存储邮件元数据和临时内容来说绰绰有余。

收信核心： 依托于 Cloudflare Email Routing。这是 Cloudflare 提供的免费邮件转发功Neng，配合 Catch-all 规则，Neng接住发给域名的所有邮件。

这套组合拳打下来成本几乎为零，复杂度也降到了地板上。你不需要懂复杂的邮件协议，只需要懂一点 Node.js 和 Wrangler 的基本操作，就Neng在半小时内拥有一套属于自己的临时邮箱系统。

前期准备：磨刀不误砍柴工

别急着敲代码，先把环境理顺了。这套东西虽然不需要传统服务器，但本地开发环境还是得像模像样。

确保你手里有一个域名，并且Yi经托管在 Cloudflare 上。这是大前提。没有域名，这事儿就没法玩。然后你需要安装 Bun。为什么是 Bun 而不是 Npm？因为快啊！在这个时间就是金钱的年代，Neng省下一半的安装时间，何乐而不为？当然你用 Npm 或者 Pnpm 也完全没问题，只是我个人geng偏爱 Bun 的那种丝滑感。

Zui后自然是把项目代码拉下来：

git clone https://github.com/CtelSpecu/FlashInbox.git
cd FlashInbox
bun install

项目里其实Yi经内置了 wrangler，所以你不用全局安装，直接用 bunx wrangler 就Neng调用。这种细节上的处理，让我对作者的好感度瞬间拉满。

核心步骤一：D1 数据库的创建与同步

这是整个搭建过程中Zui容易让人掉以轻心，但也是Zui致命的一步。FlashInbox 的所有数据——用户信息、邮件内容、域名配置——dou存在 D1 里。Ru果这一步没配好，后面所有的部署dou将是空中楼阁。

先登录你的 Cloudflare 账号：

wrangler login

接着，创建生产环境的数据库。我们Ke以给它起个好听的名字，比如 flashinbox-db

wrangler d1 create flashinbox-db

执行完这条命令后Cloudflare 会返回一串长长的字符，这就是 database_id。请务必、一定、绝对要把它复制下来贴在显眼的地方。接下来你需要把这个 ID 填进三个配置文件里：wrangler.tomlwrangler.email.toml 和 wrangler.scheduled.toml。

这里有个巨大的坑，无数人dou在这里栽过跟头。

这三个配置文件里的 database_id 必须保持绝对一致！hen多人只改了主应用的 wrangler.toml，结果部署完发现网页Neng打开，后台也Neng进，就是死活收不到邮件。查了半天日志，Zui后才发现是 Email Worker 连错了数据库。那种感觉，就像是你明明把信投进了邮筒，结果邮递员却把信送到了邻居家。

配好 ID 后我们得把表结构建起来。项目里Yi经准备好了迁移文件，直接跑就行：

wrangler d1 execute flashinbox-db --remote --file=migrations/0001_init.sql
wrangler d1 execute flashinbox-db --remote --file=migrations/0002_mailboxes_banned.sql

这两条命令缺一不可。第一条是基础骨架，第二条是关于邮箱封禁状态的 表。别偷懒，也别想着“反正我不用封禁功Neng就不跑第二条”，系统逻辑是强依赖这些表结构的。Ru果你在迁移过程中kan到了 BEGIN TRANSACTION 或者 COMMIT 之类的报错，别慌，那通常是 D1 对 SQL 语法的一些特殊要求，不过项目作者Yi经处理过了照着跑一般没事。

核心步骤二：环境变量与密钥配置

数据库搞定了接下来就是给系统注入灵魂——环境变量。这部分主要涉及安全密钥和一些功Neng开关。

我们需要设置几个关键的 Secrets。打开终端，依次执行：

wrangler secret put ADMIN_TOKEN --env production
wrangler secret put KEY_PEPPER --env production
wrangler secret put SESSION_SECRET --env production
wrangler secret put TURNSTILE_SECRET_KEY --env production
wrangler secret put TURNSTILE_SITE_KEY --env production

这里面的每一个变量dou有它的使命：

ADMIN_TOKEN这是你管理后台的钥匙。设个复杂点的，不然被别人进了后台，你的邮箱就成公共厕所了。

KEY_PEPPER 和 SESSION_SECRET这两个是加密用的盐值。尤其是 KEY_PEPPER，它直接关系到用户 Key 的哈希算法和找回流程。千万别在部署后随便改这个值，一旦改了之前生成的所有 Key dou会失效，用户再也找不回他们的邮箱了。

TURNSTILE_*这是 Cloudflare 的验证码服务，用来防止机器人恶意注册。你需要去 Cloudflare Dashboard 里建一个 Turnstile 站点，把生成的 Key 填进去。

除了这些 Secrets，wrangler.toml 里还有一些显式配置需要关注。特别是 DEFAULT_DOMAIN

DEFAULT_DOMAIN = "example.com"

这里有个概念特别容易混淆：mail.example.com 和 example.com。

mail.example.com 是你访问网页的地址，是前台；而 example.com 才是真正用来收信的域名，是后台。Cloudflare 的 Email Routing 吃的是主域的 Catch-all 规则，不是子域。Ru果你把这两个搞混了比如把 DEFAULT_DOMAIN 写成了 mail.example.com，那你生成的临时邮箱地址就会变成 ，结果 Cloudflare 根本没配置这个子域的邮件路由，自然就收不到信了。

核心步骤三：部署三部曲

万事俱备，只欠东风。现在开始把代码推送到 Cloudflare 的边缘网络。注意，FlashInbox 不是单一的应用，它是由三个 Worker 协同工作的。

1. 部署主应用

这是用户kan到的界面也是 API 的入口。先构建，再部署：

bun run build:worker
wrangler deploy --env production

这一步跑完，你应该就Neng访问你的 https://mail.example.com 了。Ru果这时候页面打不开，先别急着往下走，检查一下 wrangler.toml 里的路由配置是否正确，自定义域名是否Yi经绑定在 Cloudflare 上。

2. 部署 Email Worker

这个 Worker 是个隐形英雄，它负责拦截 Cloudflare Email Routing 转发过来的邮件，解析内容，然后存入 D1。

wrangler deploy --config wrangler.email.toml

3. 部署 Scheduled Worker

这个 Worker 负责定时清理过期的邮件和垃圾数据，保持系统的轻盈。

wrangler deploy --config wrangler.scheduled.toml

这三个 Worker 必须指向同一个 D1 数据库，而且必须dou成功部署。hen多人漏了 Scheduled Worker，觉得不影响收信就不装。虽然短期内确实没事，但时间一长，你的数据库里全是过期垃圾，性Neng会直线下降。

核心步骤四：Cloudflare Email Routing 设置

代码dou上去了现在得把 Cloudflare 的“水管”接通。进入你的域名 Dashboard，找到 Email -> Email Routing。

Ru果你还没启用过先跟着向导走一遍，配置好 MX 记录等基础项。然后重点来了：

在 Routing rules 里确保 Catch-all address 是开启的。

编辑 Catch-all 规则，选择 Send to a Worker。

在 Worker 下拉列表里选择你刚才部署的那个 Email Worker。

这个逻辑非常简单粗暴：任何发往 的邮件，dou会被 Cloudflare 接住然后像传球一样扔给你的 Email Worker 处理。

初始化与测试：见证奇迹的时刻

现在所有技术环节douYi就位。但别急着庆祝，还有Zui后一步初始化。

访问你的管理后台：https://mail.example.com/admin。用之前设置的 ADMIN_TOKEN 登录。在 Domains 页面里你需要手动把你的域名加进去。

你Ke以直接在界面上操作，也Ke以用命令行插一条数据：

wrangler d1 execute flashinbox-db --remote --command "INSERT INTO domains  VALUES *1000, strftime*1000);"

注意kan那个 status 字段，必须是 enabled。Email Worker 在收到邮件时第一件事就是查这张表。Ru果域名不存在或者状态不是 enabled，它会直接把邮件丢弃。这就是为什么hen多人配置完一切正常，却收不到信的原因——Worker 以为你在搞非法操作。

好了现在打开前台页面创建一个临时邮箱。假设系统给你分配了 。赶紧找个别的邮箱，往这个地址发一封测试信。

Ru果一切顺利，几秒钟后你的页面上就会弹出那封新邮件。那一刻的成就感，真的比收到什么快递dou爽。

排错指南：当世界不按剧本走时

当然现实往往比剧本骨感。Ru果你没收到信，别急着砸键盘，按这个顺序排查：

1. 检查 Activity Log

去 Cloudflare Dashboard 的 Email Routing 页面kan Activity log。Ru果那里显示 Dropped，说明邮件在 Cloudflare 层面就被拒了。可Neng是你的 Catch-all 规则没配对，或者是触发了一些安全策略。

2. 检查 Email Worker 日志

Ru果 Activity log 显示Yi投递，但前端没收到，那就得kan Worker 日志了：

wrangler tail flashinbox-email

往那个地址发一封邮件，然后盯着终端kan。Ru果出现 Domain not found 或者 Domain is disabled，那就回去查你的 domains 表。Ru果出现数据库连接错误，那多半又是 database_id 没对齐。

3. 前端显示问题

Ru果日志里显示邮件Yi写入，但前端kan不到，那可Neng是缓存问题，或者是 DEFAULT_DOMAIN 配置导致前端查询的域名不对。

一些不得不提的限制

虽然 FlashInbox hen香，但我们得实事求是。它毕竟不是 Gmail 的替代品，也不适合用来处理工作邮件。

它不支持附件。或者说它不支持大附件。Cloudflare Email Routing 对邮件大小有限制，通常超过 25MB的邮件就会被直接丢弃。所以别指望用它传文件。它只适合收验证码、通知链接和纯文本信息。

它只Neng收，不Neng发。目前的架构主要是一个“收件站”。Ru果你想用这个域名发邮件，还得去折腾 Resend 之类的服务，或者配置 Cloudflare 的 Email Routing 的转发规则。不过对于临时邮箱这个场景来说“只收不发”反而是个安全特性，不是吗？

把隐私握在手里

折腾完这一圈，我kan着那个运行在 Cloudflare 边缘节点上的小图标，心里特别踏实。公共服务虽然方便，但那种“寄人篱下”的不安全感始终存在。现在不管是注册账号还是测试服务，我douKe以随手甩出一个 ，既霸气又安全。

而且，整个过程不仅是一次技术实践，geng是一次对现代 Serverless 架构的深度体验。没有繁重的服务器维护，没有复杂的网络配置，几个配置文件，几行命令，就Neng把一个全球可用的服务跑起来。这大概就是云原生时代的魅力吧。

Ru果你也厌倦了公共临时邮箱的不稳定性，或者单纯想体验一把 DIY 的乐趣，不妨试试 FlashInbox。相信我，当你kan到第一封测试邮件成功出现在自己搭建的收件箱里时你会发现，所有的折腾dou是值得的。

---