告别网页版！手把手教你用 Telegram 实时接收 Gmail 邮件（全异步、零成本）

type

Post

status

Published

date

May 2, 2026

slug

gmailtegegram

summary

利用 Cloudflare Workers + Email Routing，配合开源项目 mail2telegram，可以将 Gmail 邮件实时转发到 Telegram 机器人，实现像收微信消息一样收邮件。本文提供从 Worker 部署、Telegram 机器人配置、KV 绑定到 Gmail 转发的完整教程，零成本、全异步。

📌 一、核心原理

本项目基于 Cloudflare Email Routing + Worker。

当邮件发送到你的自定义域名邮箱时，Cloudflare 会触发 Worker 脚本，将邮件内容解析并调用 Telegram Bot API，直接推送到你的手机上。

整个过程：全异步、零服务器、完全免费。

🛠️ 二、准备工作

项目	说明
Cloudflare 账号	需有自己的一个域名
Telegram 账号	用于接收消息
GitHub 项目	mail2telegram

📝 三、部署 Cloudflare Workers

1. 创建 Worker

点击 [创建应用程序] → [从Hello World！开始]

命名为 mail2telegram，点击 [部署]

2. 写入核心代码

点击 [Edit Code] 编辑代码

前往 GitHub 复制项目中的 index.ts 代码（项目地址：点击跳转）

回到编辑页面，删掉原有代码，粘贴新代码并保存部署

🤖 四、配置 Telegram 机器人

我们需要两个关键参数：TELEGRAM_TOKEN 和 TELEGRAM_ID。

1. 获取 Token

在 Telegram 搜索 @BotFather，发送 /newbot

按提示输入机器人名称和用户名

复制生成的 API TOKEN

2. 获取你的个人 ID

搜索 @userinfobot，点击 Start

它会返回一串数字，这就是你的 Chat ID，复制备用

3. 设置环境变量

回到 Cloudflare Worker 页面：

点击 [设置] → [变量和机密] → [添加]

添加以下三个变量：

变量名	值
`TELEGRAM_TOKEN`	你的机器人 Token
`TELEGRAM_ID`	你的个人 ID
`DOMAIN`	Worker 的默认域名（在上面的域和路由界面可以找到）

⚠️ 记得点击部署保存！

📦 五、绑定存储与域名路由

1. 绑定 KV 空间（关键步骤）

Worker 需要一个 KV 命名空间来存储邮件状态。

在 Cloudflare 左侧菜单找到 [存储和数据库] → [Workers KV]

创建一个名为 mail2tg_db 的命名空间

回到 Worker 的设置页面，找到 [绑定] → [添加绑定] → [KV命名空间]

变量名必须大写输入：DB，空间选择刚才创建的 mail2tg_db

⚠️ 村长提醒：这个绑定非常关键，很多人卡在这一步！变量名必须是 DB，大写！

2. 设置邮件转发规则

进入你的域名管理页面，点击 [你的域名] → [电子邮件] → [电子邮件路由]

开启服务后，点击 [路由规则]

在 Catch-all 后面点击编辑：

设置项	值
Action（操作）	发送到 Worker
Destination（目标）	选择 `mail2telegram`

📧 六、配置 Gmail 自动转发

最后一步，我们要让 Gmail 收到信后，自动“踢”给我们的机器人。

打开 Gmail 设置 → [管理标签] → [转发和 POP/IMAP]

点击 [添加转发地址]，输入你的自定义域名邮箱（如 gmail@你的域名.com）

验证环节：

此时你的 Telegram 机器人会收到一封确认邮件

点击机器人发来的消息中的 [Text] 或 [HTML]

复制验证链接并在浏览器打开，确认转发

回到 Gmail 刷新页面，勾选“将收到的邮件转发至...”，点击保存更改

✅ 七、测试与总结

现在，你可以尝试给自己的 Gmail 发一封邮件。

实测延迟仅约 2 秒！

Telegram 机器人会立刻弹出提醒，你可以选择以纯文本或 HTML 网页形式查看邮件内容。

💡 村长的小贴士

贴士	说明
安全提示	请勿将此用于接收极其敏感的金融验证码。虽然 Cloudflare 很安全，但多一层转发多一份风险。
域名建议	用于转发的域名，尽量不要和你部署 Cloud Mail 等其他邮件服务的域名混用，避免路由冲突。
Bot 激活	配置完成后，记得先去 Telegram 给机器人发一条消息（比如 `/start`），否则它没权限给你推送。