免费无限邮箱:Cloudflare 收信 + Telegram 秒推送

注册小网站时,填邮箱这一步很烦。给主邮箱,后面全是垃圾邮件;不给,很多服务又不让过。

更省事的办法是用自己的域名做一个“无限邮箱”:任意前缀都能收信,不用提前创建地址;邮件到了直接推到 Telegram,手机上马上收到通知。

这套流程可以跑在 Cloudflare 免费额度里,成本只有一个域名。域名本来就有的话,等于零成本。

我最近把 guoshunfa.com 接上了这套流程,从部署到收到第一条 Telegram 推送不到一小时。下面是完整过程,以及几个容易出错的地方。

它是怎么工作的

发件人
  ↓
Cloudflare Email Routing(Catch-all)
  ↓
Worker:cloudflare_temp_email
  ├─ D1:保存邮件
  ├─ KV:保存 Telegram 配置和绑定关系
  └─ Telegram Bot API → 你的手机

收信、网页和 API 都由同一个 Worker 处理。网页挂在 mail.你的域名.com,Email Routing 把所有收件地址交给它。

Catch-all 打开后,任意前缀@你的域名.com 都会进来,不需要先创建地址。

准备

  • 一个已经托管到 Cloudflare 的域名,NS 已生效
  • Cloudflare 免费账号
  • Telegram 账号
  • 本地能跑 wrangler(只在部署和改配置时用)

项目用开源方案 cloudflare_temp_email,本文基于 v1.13.0,MIT 协议。

一、部署 cloudflare_temp_email

从项目的 Release 下载 worker.js 和前端产物,放到同一个工作目录。目录大概是这样:

cloudflare-temp-email/
├── worker.js
├── frontend-dist/
├── wrangler.toml
└── schema.sql

创建 D1 数据库并初始化表结构:

wrangler d1 create cloudflare_temp_email
wrangler d1 execute cloudflare_temp_email --remote --file schema.sql

wrangler.toml 里这几项不要漏:

name = "cloudflare-temp-email"
main = "worker.js"
compatibility_flags = ["nodejs_compat"]

routes = [
  { pattern = "mail.你的域名.com", custom_domain = true },
]

[assets]
directory = "./frontend-dist"
binding = "ASSETS"
not_found_handling = "single-page-application"
run_worker_first = true

[[d1_databases]]
binding = "DB"
database_name = "cloudflare_temp_email"
database_id = "<D1 的 id>"

[vars]
DOMAINS = ["你的域名.com"]
DEFAULT_DOMAINS = ["你的域名.com"]
PASSWORDS = ["站点访问密码"]
ADMIN_PASSWORDS = ["管理员密码"]
ENABLE_USER_CREATE_EMAIL = true

然后:

wrangler deploy

部署完成后,https://mail.你的域名.com 应该能打开。

前端 index.html 里的 app-config 要保留 API_BASE: ""。改成别的地址,网页会出现 Network Error。

<script id="app-config">{ "API_BASE": "", "DEFAULT_LANG": "zh" }</script>

同源部署时留空就行。

二、让 Email Routing 接住所有来信

在 Cloudflare 后台进入域名的 Email Routing:

  1. 按提示启用 Email Routing,Cloudflare 会自动写好 MX 记录
  2. 打开 Catch-all
  3. 动作选择 Send to a Worker
  4. 目标选择 cloudflare-temp-email

MX 保持 Cloudflare 默认的 route1/2/3.mx.cloudflare.net,不要手动改。

这一步完成后,任意前缀@你的域名.com 的邮件都会进 Worker。没创建过的地址也不会丢,会出现在后台的「未知邮件」里;之后再创建同名地址,还能看到之前的历史邮件。

不要开启“拒绝未知地址”之类的选项,否则未创建的地址就收不到信了。

三、加 KV 绑定和 Telegram Token

我第一次失败就卡在这里。

推送代码运行前会检查两个东西:

  • TELEGRAM_BOT_TOKEN:机器人 token
  • KV:保存配置和推送列表

少任何一个,推送函数会直接返回,不报错,也不推送。

先创建 KV:

wrangler kv namespace create temp-mail-tg

把返回的 id 写进 wrangler.toml:

[[kv_namespaces]]
binding = "KV"
id = "<KV 的 id>"

注意 binding 必须叫 KV,不能改成别的名字。然后重新部署:

wrangler deploy

接着在 Telegram 里找 @BotFather:

  1. 发送 /newbot
  2. 填一个显示名称,比如“邮件通知”
  3. 填用户名

用户名有两个硬性要求:必须以字母开头,并以 bot 结尾。我一开始填 168mailbot,被 BotFather 直接拒绝,因为数字开头不合法。改成 guoshunfa_mail_bot 就通过了。

创建成功后 BotFather 会返回一段 token,形如:

1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

把它写进 Worker 的 secret:

wrangler secret put TELEGRAM_BOT_TOKEN

粘贴 token 回车即可。不要把它写进 wrangler.toml,也不要提交到 Git。

四、拿到你的数字 User ID

推送列表里要填的是 Telegram 的数字 User ID,不是用户名。

最简单的方法:找 @userinfobot,发送 /start,它会回复:

Id: 8172423869

这个数字就是你的 User ID。

也可以让机器人自己“记”下来:先给刚创建的 bot 发送一条 /new。/new 会创建一个临时邮箱,同时把用户 ID 写进 KV:

wrangler kv key list --remote --namespace-id <KV id> --prefix temp-mail-telegram

返回里会出现:

temp-mail-telegram:8172423869

冒号后面的数字就是 User ID。

前提是用户先给 bot 发过消息。Telegram 不允许机器人主动给没开聊的用户发消息,第一次得由你先点 Start 或发一条指令。

五、初始化 Webhook,开启全局推送

进入后台 https://mail.你的域名.com/admin,输入站点密码和管理员密码,找到 电报机器人 页面:

  1. 点 初始化,注册 webhook
  2. 勾选 启用全局邮件推送
  3. 在推送列表里填入你的数字 User ID
  4. 建议同时把 User ID 加入 Telegram 白名单
  5. 保存

初始化成功后,webhook 地址应该是:

https://mail.你的域名.com/telegram/webhook

如果不想点页面,也可以直接用接口:

curl -X POST \
  -H "x-custom-auth: 站点访问密码" \
  -H "x-admin-auth: 管理员密码" \
  https://mail.你的域名.com/admin/telegram/init

写入推送配置:

curl -X POST \
  -H "content-type: application/json" \
  -H "x-custom-auth: 站点访问密码" \
  -H "x-admin-auth: 管理员密码" \
  --data '{
    "enableAllowList": true,
    "allowList": ["你的 User ID"],
    "miniAppUrl": "",
    "enableGlobalMailPush": true,
    "globalMailPushList": [你的 User ID]
  }' \
  https://mail.你的域名.com/admin/telegram/settings

再读一次确认:

curl -H "x-custom-auth: 站点访问密码" \
  -H "x-admin-auth: 管理员密码" \
  https://mail.你的域名.com/admin/telegram/settings

看到 enableGlobalMailPush: true,并且列表里有你的 ID,就说明配置生效了。

六、验证

不用先创建地址,直接用任意邮箱发一封到:

随便什么前缀@你的域名.com

比如 tgtest-1118@你的域名.com。

正常情况下:

  • Telegram 收到推送,内容包含发件人、收件地址、主题和邮件正文
  • 后台「未知邮件」能看到这封信
  • 之后再创建同名地址,能看到这封信的历史记录

如果没收到推送,按这个顺序排查:

  1. Worker 有没有 KV 绑定,binding 名字是不是 KV
  2. TELEGRAM_BOT_TOKEN 有没有设置成功
  3. webhook 是不是指向 https://mail.你的域名.com/telegram/webhook
  4. 你有没有先给 bot 发过消息
  5. globalMailPushList 里是不是数字 User ID
  6. 后台有没有开启全局推送

全局推送和“每用户绑定推送”是两套逻辑。同一个地址如果既在全局列表里,又绑定到了你的 Telegram,会收到两条。嫌重复就只留一种。

成本和边界

这套方案只收不发,用的是 Cloudflare 免费额度和 Telegram 免费 Bot。个人日常注册、收验证码完全够用,具体额度以 Cloudflare 官网当前政策为准。

几个边界要记住:

  • 不要开 Email Sending,这套方案不需要发信
  • 不要动 MX 记录,Catch-all 保持指向 Worker
  • 邮件会经过 Cloudflare 和你的 Worker,不适合银行、支付这类重要账号
  • 站点密码、管理员密码、JWT_SECRET、Bot Token 都不要公开
  • 未知邮件和临时地址会越积越多,记得定期清理
  • 域名信誉会影响送达率,只收不发风险更低

部署本身不复杂,麻烦主要出在三个地方:KV 没绑、bot 用户名数字开头、用户没先给 bot 发消息。处理好这三件事,收信和推送就能稳定运行。


本文基于开源项目 cloudflare_temp_email v1.13.0(MIT)实践:
https://github.com/dreamhunter2333/cloudflare_temp_email