MailEdge 文档 · 快速开始

使用说明

从部署、收件路由、发信渠道到更新与卸载,按顺序完成 MailEdge 的首次配置。

适用于 v0.2.0 及以上约 5 分钟阅读
幂等部署:重复执行会复用已有的 D1 与 R2/KV 资源并更新 Worker;已有机密不会被覆盖。执行更新前,请确认目标账户和资源属于同一套 MailEdge 部署。
01
开始使用

一键部署

部署向导优先使用 Cloudflare OAuth;如果不使用 OAuth,也可以提供一个临时 API Token。OAuth 会话和 Token 都不会写入数据库,Token 完成部署后建议立即删除。

  1. 授权或创建受限 Token。 在部署页连接 Cloudflare OAuth,或按指引创建 Token,并补充 D1、R2 或 KV 与 Workers Scripts 的账户级权限。
  2. 验证权限。 完成账户和资源权限检查,再选择目标 Cloudflare 账户。
  3. 运行部署。 向导会创建或复用 Worker、D1,以及可用的 R2 或 KV,并在终端中显示实时进度和管理地址。
02
接收邮件

配置收件路由

  1. 在 Cloudflare 控制台启用目标域名的 Email Routing。
  2. 在 Routing Rules 中创建精确地址或 Catch-all 规则,操作选择 Send to a Worker,目标选择 mailedge。
  3. 在 MailEdge「设置 → 收件地址」中添加与路由规则完全一致的地址。地址不一致时,Worker 会拒收并返回未知收件人。
建议:先用一个精确地址测试收信,确认邮件进入收件箱后,再按需要启用 Catch-all。
03
初始化

首次使用

打开部署完成后的 MailEdge 管理地址,按照初始化页面创建管理员账号。随后在「设置 → 收件地址」中登记地址,并在「设置 → 发信服务」中配置至少一个发信渠道。

收件地址必须与 Email Routing 规则一致
发信渠道至少配置一个并完成测试
04
日常使用

收信与发信

收件地址必须与 Email Routing 规则一致,否则可能退信。使用 Cloudflare Email Service 发往外部邮箱需要 Workers Paid;使用 Resend、Sendflare 或 SMTP 时,请按对应服务商的验证、配额与计费规则配置。

收信Cloudflare Email Routing
发信Email Service、Resend、Sendflare 或 SMTP
05
保持最新

更新与升级

部署页的「一键升级」会先读取 Worker 版本,再与当前可部署版本比对。升级只更新 Worker,复用现有 D1、R2/KV、ENCRYPTION_KEY 和 SESSION_SECRET,不执行卸载或清空数据。

安全边界:升级前请确认显示的 Cloudflare 账户和资源属于你的 MailEdge 部署;如果资源不完整,向导会停止升级。
06
资源管理

卸载

不可逆操作:卸载会永久删除 MailEdge 的 Worker、D1、R2/KV 及已选的路由资源,邮件与附件数据不可恢复。请先扫描资源并逐项确认。

卸载向导会先清理 R2/KV 对象,再处理 Worker 和 D1;如果对象存储无法清空,会停止后续删除并保留资源供重试。