注册小网站时,填邮箱这一步很烦。给主邮箱,后面全是垃圾邮件;不给,很多服务又不让过。
更省事的办法是用自己的域名做一个“无限邮箱”:任意前缀都能收信,不用提前创建地址;邮件到了直接推到 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:
- 按提示启用 Email Routing,Cloudflare 会自动写好 MX 记录
- 打开 Catch-all
- 动作选择 Send to a Worker
- 目标选择
cloudflare-temp-email
MX 保持 Cloudflare 默认的 route1/2/3.mx.cloudflare.net,不要手动改。
这一步完成后,任意前缀@你的域名.com 的邮件都会进 Worker。没创建过的地址也不会丢,会出现在后台的「未知邮件」里;之后再创建同名地址,还能看到之前的历史邮件。
不要开启“拒绝未知地址”之类的选项,否则未创建的地址就收不到信了。
三、加 KV 绑定和 Telegram Token
我第一次失败就卡在这里。
推送代码运行前会检查两个东西:
TELEGRAM_BOT_TOKEN:机器人 tokenKV:保存配置和推送列表
少任何一个,推送函数会直接返回,不报错,也不推送。
先创建 KV:
wrangler kv namespace create temp-mail-tg
把返回的 id 写进 wrangler.toml:
[[kv_namespaces]]
binding = "KV"
id = "<KV 的 id>"
注意 binding 必须叫 KV,不能改成别的名字。然后重新部署:
wrangler deploy
接着在 Telegram 里找 @BotFather:
- 发送
/newbot - 填一个显示名称,比如“邮件通知”
- 填用户名
用户名有两个硬性要求:必须以字母开头,并以 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,输入站点密码和管理员密码,找到 电报机器人 页面:
- 点 初始化,注册 webhook
- 勾选 启用全局邮件推送
- 在推送列表里填入你的数字 User ID
- 建议同时把 User ID 加入 Telegram 白名单
- 保存
初始化成功后,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 收到推送,内容包含发件人、收件地址、主题和邮件正文
- 后台「未知邮件」能看到这封信
- 之后再创建同名地址,能看到这封信的历史记录
如果没收到推送,按这个顺序排查:
- Worker 有没有
KV绑定,binding 名字是不是KV TELEGRAM_BOT_TOKEN有没有设置成功- webhook 是不是指向
https://mail.你的域名.com/telegram/webhook - 你有没有先给 bot 发过消息
globalMailPushList里是不是数字 User ID- 后台有没有开启全局推送
全局推送和“每用户绑定推送”是两套逻辑。同一个地址如果既在全局列表里,又绑定到了你的 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