什么是 MoeMail
想象一下这个场景：你正想注册某个网站的试用账号，或者下载一份资料、加入一个论坛、订阅一份电子报——但网站硬性要求填一个邮箱地址。你犹豫了，因为你知道交出真实邮箱意味着什么：从此以后，垃圾邮件、无休止的营销推广、各种"您可能感兴趣的推荐"会接踵而至，你的收件箱将不再干净。
这正是 MoeMail 要解决的问题。MoeMail 是一款可爱、开源、完全免费的临时邮箱服务，让你在需要"一次性地址"的场合，随手就能生成一个临时邮箱，用完即弃，绝不牵连你的主邮箱。
简单、可爱，但功能一点都不含糊
MoeMail 采用了 Next.js + Cloudflare Pages + D1 数据库的现代技术栈，构建在 Cloudflare 的边缘网络上，这意味着它响应飞快、稳定可靠，而且对隐私保护极其友好——没有用户追踪，不会分析你的邮件内容。
最打动人的一点是：MoeMail 的代码完全开源在 GitHub（github.com/beilunyang/moemail）上。你能查看它的每一行代码，确认数据是怎么处理的，甚至可以自己在 Cloudflare 上免费部署一份。这种透明感，在如今"数据越来越值钱"的时代里，显得尤为珍贵。
而对于开发者来说，MoeMail 还提供了一整套完整的 OpenAPI 接口（REST API），方便你把它集成到自己的工作流中——无论是测试邮箱注册流程，还是做自动化数据处理，都能轻松搞定。
隐私优先保护：不追踪用户，不读取邮件内容，保护真实邮箱不受垃圾邮件骚扰
即时生成邮箱：瞬间创建自定义或随机临时邮箱地址
开源免费：代码在 GitHub 开源，可在 Cloudflare 上免费自行部署
完整 OpenAPI REST API：面向开发者的标准化集成接口
Webhook 实时通知：新邮件到达时可实时推送到你的服务器
MoeMail 的核心功能
与其堆砌功能列表，不如直接聊聊 MoeMail 能帮你做些什么。
即时创建你的临时邮箱
你可以用它来在几秒钟内生成一个临时邮箱地址，支持自定义前缀（比如 [email protected]）或完全随机生成。更贴心的是，你可以灵活设置有效期——1 小时、1 天、7 天，甚至永久有效。对于不同场景，选择不同的期限，用完自动过期销毁，省心又安全。
实时邮件管理
你可以用它来在个人仪表盘中实时接收和查看新邮件。MoeMail 基于 Cloudflare 边缘网络实时轮询，邮件一到就能看到，不需要频繁刷新页面。界面设计走的是可爱路线，操作起来却非常直观，一眼就能看清每封邮件的发件人、主题和到达时间。
邮件与邮箱分享
你可以用它来通过带过期时间的分享链接，安全地与其他团队成员共享单封邮件或整个邮箱。比如客服团队需要演示某封验证邮件的格式，或者测试团队需要让同事查看某个邮箱里的邮件——生成一个分享链接发过去就能搞定，不需要暴露账号密码，链接过期后自动失效。
Webhook 实时通知
你可以用它来让 MoeMail 在新邮件到达时，向你自己配置的服务器发送实时 POST 通知。请求头携带 X-Webhook-Event: new_message 标识，请求体内包含发件人、主题、正文、HTML 内容等完整信息。这意味着你可以把临时邮箱和自定义的业务逻辑无缝衔接起来——比如自动解析验证码、自动归档邮件等。
完整的 OpenAPI REST 接口
你可以用它来通过标准化的 REST API 把 MoeMail 集成到自己的应用中。全套共 12 个文档化的接口端点，覆盖系统配置查询、邮箱生成、邮件列表获取、邮件内容读取、删除，以及各种分享链接的管理。只要在请求头中加上 X-API-Key，就能以编程方式完成几乎所有操作。
单账号多邮箱管理
你可以用它来用一个账号创建和管理多个临时邮箱地址。对于需要反复测试不同注册流程、或者给不同项目分配独立邮箱的人来说，这简直是效率神器。所有邮箱都在你的账号下完全隔离，各自的邮件互不影响。
谁在使用 MoeMail
MoeMail 的适用人群其实比想象中更广。我们来看看几个典型场景。
开发者：测试邮箱注册流程
假如你是开发者，正在开发新应用的注册功能，需要一个临时邮箱来完成整个注册流程的测试。MoeMail 的 REST API 让你可以用 curl 或任意语言轻松创建邮箱地址，并与自动化测试无缝集成。对于那些需要反复验证不同邮箱格式、不同域名支持的测试场景，MoeMail 的多邮箱管理功能会帮你节省大量时间。
注重隐私的用户：不把真实邮箱交给陌生网站
生活中总有些场合，你不得不注册某个一次性服务——下载一份文档、试用一个工具、参与一次抽奖。这些场景里，你其实不想交出真实邮箱，但又没有别的选择。有了 MoeMail，你可以随手生成一个临时地址，用完就扔，主邮箱永远保持干净。
测试工程师：多个隔离的邮箱进行测试
当你的团队需要验证多种邮件通知场景（比如注册确认、密码重置、订单通知），往往需要同时使用多个不同的邮箱地址。MoeMail 允许你在一个账号下创建多个完全隔离的临时邮箱，每个邮箱的邮件互不干扰，测试逻辑清晰可控。
团队协作：通过分享链接共享临时邮箱
比如客服团队在做产品演示时，需要向客户展示一封典型的欢迎邮件或验证邮件。与其把账号密码交给新人，不如直接生成一个带过期时间的分享链接发过去——安全、可控、即时生效，链接到期自动失效，无需手动清理。
普通用户：告别垃圾邮件
如果你已经厌倦了论坛注册后收到的各种推广邮件，或者订阅电子报后不得不每天清理收件箱，MoeMail 可以帮你把"一次性"的邮箱需求从主邮箱中剥离出来，让主邮箱回归清爽。
如果需要接收银行或支付服务发来的邮件（比如验证码、账单通知），请务必使用真实地址，而不是 MoeMail。部分银行和支付服务会屏蔽一次性域名，这种情况下临时邮箱可能收不到这些关键邮件。
快速开始
上手 MoeMail 比你想象的还要简单，三步走就能搞定。
第一步：注册账号
打开 MoeMail 官网，注册一个账号以便安全访问你的个人仪表盘。注册信息非常简单（只需要一个用户名），MoeMail 不追踪用户、不收集不必要的数据。
第二步：创建邮箱
登录后，在个人中心点击创建邮箱，即可瞬间生成一个自定义或随机生成的临时邮箱地址。你可以选择有效期——1 小时、1 天、7 天，或者永久。
第三步：使用地址
把生成的临时地址用于注册任何服务、下载资料、加入论坛或订阅电子报。邮件会实时出现在你的仪表盘中，无需暴露真实邮箱。
第四步（开发者可选）：调用 REST API
对于开发者，MoeMail 提供了完整的 REST API。首先在个人中心获取你的 API Key（需要 DUKE 或 EMPEROR 角色），然后在请求头中加入 X-API-Key 即可调用。
举个例子，用 curl 创建临时邮箱：
curl -X POST https://your-domain.com/api/emails/generate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "test",
"expiryTime": 3600000,
"domain": "moemail.app"
}'
expiryTime 参数的单位是毫秒，可选值包括：3600000（1 小时）、86400000（1 天）、604800000（7 天）、0（永久）。
设置有效期时，建议根据使用场景来权衡。如果你要接收的是一封需要等待较长时间的验证邮件（比如某些平台的审核流程），选择 1 天或 7 天更稳妥；如果只是做一次性注册、收个验证码，1 小时就绰绰有余了。选太短可能导致邮件还没到就过期了，把有效期留一点余量总是更安心。
生态与集成
MoeMail 不只是面向普通用户的临时邮箱服务，对开发者而言，它更像是一个可以深度集成的工具。
完整的 OpenAPI 接口
MoeMail 提供了标准化的 OpenAPI 接口文档，地址在 https://docs.moemail.app/api.html#openapi。所有接口都通过请求头中的 X-API-Key 进行认证，API Key 可以在个人中心页面创建（需要 DUKE 或 EMPEROR 角色）。
12 个 REST 端点，覆盖全部核心操作
MoeMail 的 API 设计非常完整，12 个端点覆盖了多种典型操作：
系统配置：GET /api/config，查看默认角色、支持域名等基础信息
邮箱管理：创建临时邮箱（POST /api/emails/generate）、获取邮箱列表（GET /api/emails）、删除邮箱（DELETE /api/emails/{emailId}）
邮件管理：获取某邮箱的邮件列表（GET /api/emails/{emailId}）、读取单封邮件详情（GET /api/emails/{emailId}/{messageId}）
分享链接管理：创建和删除邮箱分享链接、创建和删除单封邮件的分享链接
每个端点都提供了明确清晰的请求和响应格式，配合 OpenAPI 文档，集成起来相当顺畅。
Webhook 实时通知
除了主动轮询，MoeMail 还支持 Webhook 推送。在个人中心启用 Webhook 功能、设置好通知 URL 后，每当新邮件到达，系统就会向你的服务器发送 POST 请求。Webhook 端点需要在 10 秒内响应，如果返回非 2xx 状态码，系统会自动重试，确保通知不丢失。
测试服务器与本地调试
项目附带了测试用的 Webhook 服务器，只需运行 pnpm webhook-test-server，就会在本地 3001 端口启动一个 HTTP 服务器（http://localhost:3001），打印收到的 Webhook 消息详情。需要外部测试时，还可以通过 pnpx cloudflared tunnel --url http://localhost:3001 用 Cloudflare Tunnel 将本地服务暴露到公网。
开源社区与免费自部署
MoeMail 的代码完全开源在 GitHub 上，构建在 Cloudflare 生态之上，意味着你可以在 Cloudflare 上免费自行部署，完全掌控自己的数据。项目还有活跃的 Telegram 社区（@moecloudflare），遇到问题可以随时交流求助。
常见问题
需要。注册账号是使用 MoeMail 的前提条件，因为只有注册后，系统才能为你提供安全的个人仪表盘来管理临时邮箱。好消息是注册非常简单，只需要一个用户名，MoeMail 不会收集多余的个人信息。
MoeMail 中的邮件是临时存储的，到有效期后会自动永久删除。当你创建邮箱时选定的有效期（比如 1 小时、1 天、7 天）决定了邮件保留的时间。请记得在过期前下载或转发你需要保留的内容。
不会。每个邮箱都在你的账号下完全隔离，除了你自己，任何人都无法读取你的邮件内容。MoeMail 本身也不会阅读或分析你的邮件。只有当你自己主动生成分享链接并分享出去时，接收者才能看到对应内容。
邮箱及其中的所有邮件会被永久删除，无法恢复。因此，如果你希望保留某些重要邮件，请务必在过期前转移或保存它们；或者干脆在创建邮箱时选择一个更长的有效期。这个逻辑虽然严格，但也保证了你的数据不会残留在服务器上。
建议不要使用。部分银行和支付服务会屏蔽一次性域名，这意味着你可能收不到关键的验证码或账单通知。对于这类需要长期可靠接收邮件的重要服务，还是使用你的真实邮箱更稳妥。
真的。创建邮箱、接收邮件、生成分享链接全部免费。付费角色（如 DUKE、EMPEROR）只是提供更高的配额——更多的邮箱数量、更多的 API 调用次数、以及发送邮件等功能。如果你只是偶尔需要临时邮箱，免费角色完全够用。
当然可以。MoeMail 提供完整的 OpenAPI REST 接口，你只需要在个人中心获取 API Key（需要 DUKE 或 EMPEROR 角色），然后在请求头中加上 X-API-Key 就能以编程方式调用。全套 12 个端点覆盖了邮箱生成、邮件管理、分享链接等所有核心功能。
在个人中心的 Webhook 设置中启用该功能，然后配置你的通知 URL。新邮件到达时，MoeMail 会向该 URL 发送 POST 请求（包含发件人、主题、正文等完整信息）。配置完成后可以先用测试按钮验证，确保一切正常再保存使用。
评论