cloudflare_temp_email

应用程序

dreamhunter2333/cloudflare_temp_email

基于Cloudflare的免费临时邮箱服务,支持IMAP/SMTP和Telegram Bot。

项目简介

基于Cloudflare免费层构建的全功能临时邮箱系统。采用Rust WASM快速解析邮件,支持附件、AI邮件识别、SMTP/IMAP代理以及Telegram Bot通知。适用于个人或小规模部署。

README 预览

\n# Cloudflare 临时邮箱 - 免费搭建临时邮件服务\n\n\n  \n    \n  \n  \n    \n  \n  \n    \n  \n  \n   \n  \n  \n    \n  \n  \n    \n  \n\n\n\n  \n    \n  \n\n\n\n  中文文档 |\n  English Document\n\n\n> 本项目仅供学习和个人用途,请勿将其用于任何违法行为,否则后果自负。\n\n**一个功能完整的临时邮箱服务!**\n\n- **完全免费** - 基于 Cloudflare 免费服务构建,零成本运行\n- **高性能** - Rust WASM 邮件解析,响应速度极快\n- **现代化界面** - 响应式设计,支持多语言,操作简便\n- **地址密码** - 支持为邮箱地址设置独立密码,增强安全性\n- **Agent 友好** - 内置邮箱 [`skill`](skills/cf-temp-mail-agent-mail/SKILL.md),方便 AI agent 使用邮箱\n- **移动端管理** - 社区客户端 [CloudMail](https://github.com/Lur1N77777/CloudMail),支持 Android 管理后台和邮箱管理\n\n## 部署文档 - 快速开始\n\n[部署文档](https://temp-mail-docs.awsl.uk) | [Github Action 部署文档](https://temp-mail-docs.awsl.uk/zh/guide/actions/github-action.html)\n\n\n  \n\n\n## 更新日志\n\n查看 [CHANGELOG](CHANGELOG.md) 了解最新更新内容。\n\n## 在线体验\n\n立即体验 → [https://mail.awsl.uk/](https://mail.awsl.uk/)\n\n\n服务状态监控(点击收缩/展开)\n\n|                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

常见问题 (3)

故障排除
为什么管理员邮箱的 created_at 和 updated_at 时间戳显示为 UTC 而不是本地时区?

此问题已在 PR #1146 中修复。请将前端更新到包含该 PR 的版本,并重新构建/重新部署。frontend/src/views/admin/Account.vue 中的原始 D1 时间戳列现在使用 utcToLocalDate(row.created_at, useUTCDate.value) 和 utcToLocalDate(row.updated_at, useUTCDate.value)。frontend/src/views/admin/UserManagement.vue 和 frontend/src/views/admin/SenderAccess.vue 中的 created_at 也应用了相同的修复。如需手动修补,请将这些模板中直接渲染时间戳的代码替换为 utcToLocalDate(...),确保已导入该辅助函数和 useUTCDate 设置,然后运行前端构建并重新部署。

来源 Issue #1145
故障排除
如何在启用 JUNK_MAIL_CHECK_LIST 的情况下,解决 DMARC/DKIM/SPF 结果为 none 或 neutral 导致的垃圾邮件误判拒收问题?

此误拒是由垃圾邮件检查逻辑的一个缺陷引起的:Cloudflare Email Worker 错误地将 SPF/DKIM/DMARC 的 none/neutral 状态视为明确的失败。根据电子邮件认证标准,这些状态表示未发布 SPF 记录、邮件未签名或没有适用的 DMARC 策略,不应触发拒绝。有缺陷的代码仅检查认证标头是否存在(例如 dmarc=),并拒绝所有非 pass 的结果,这与文档中 JUNK_MAIL_CHECK_LIST 的规则不一致:只有当某个已启用的检查存在且明确失败时才应拒绝。

临时解决方案:
1. 打开你的 worker/wrangler.toml 配置文件。
2. 从 JUNK_MAIL_CHECK_LIST 数组中移除返回 none/neutral 状态的检查项(例如 dkim、dmarc),仅保留你需要的、会返回明确通过/失败结果的检查项。
3. 通过 Wrangler CLI 重新部署 Worker。

可用的配置示例:

ENABLE_CHECK_JUNK_MAIL = true
JUNK_MAIL_CHECK_LIST = ["spf"]
JUNK_MAIL_FORCE_PASS_LIST = ["spf"]

官方修复后,该逻辑将遵循标准:none/neutral 状态不会触发拒绝,只有明确的认证失败才会被标记为垃圾邮件,且 JUNK_MAIL_FORCE_PASS_LIST 仅接受明确的 pass 结果。

来源 Issue #1084
故障排除
如何修复 Cloudflare 临时邮箱随机邮箱收不到邮件、而管理员地址正常,且 Email Routing 显示该邮件已被删除的问题?

管理员地址很可能匹配了一条明确的 Email Routing 规则,而随机地址则依赖于 catch-all 规则。如果 catch-all 被禁用或设置为 Delete/Drop,Cloudflare 会在邮件到达你的 Worker 之前将其删除。

在 Cloudflare 中修复:
1. 前往 **Cloudflare Dashboard → 选择你的域名 → Email → Email Routing → Routing Rules**。
2. 编辑 **Catch-all address** 规则。
3. 启用该规则,并将操作设置为 **Send to a Worker**。
4. 选择你已部署的临时邮箱 Worker 并保存。
5. 如果你使用多个域名,请对每个分配给随机邮箱的域名重复此操作,并确保该域名也已在 Worker 中配置。
6. 确认 Email Routing 的 MX/SPF DNS 记录显示为已激活,然后发送一封新的测试邮件。

不要使用 **Delete**、**Drop**,也不要将 catch-all 地址转发到管理员邮箱;它必须直接路由到 Worker。

来源 Issue #1044