👋 欢迎
Mailbox 是一个基于 Cloudflare Workers 的开源邮件管理系统。 在继续之前，您需要：
- 配置 Cloudflare KV 命名空间（基础配置）
- 配置 Cloudflare KV 命名空间（主邮箱数据）
- 配置 Cloudflare R2 对象存储
- 配置 Cloudflare Queues
- 配置 Email Routing 收件路由
Cloudflare Native Mailbox
系统初始化
让我们设置您的邮件系统。首先检查环境，然后完成一键初始化。
1
基础环境
2
收件路由
3
完成初始化
1
基础环境检测
自动检测 KV 基础配置、主邮箱存储、R2 对象存储和消息队列是否配置完成。
2
收件路由配置
先填写 Cloudflare API Token 和邮箱后缀域名，再点击检测。系统会精确验证收件所需的 Email Routing 是否启用、Catch-all 是否指向当前 Worker。
外发所需的 Email Sending 发信域会在「一键初始化」阶段自动接入，并自动写入 Cloudflare 官方 DNS 建议记录。
配置建议：Catch-all 请设置为“发送到 Worker”，不要设置为“转发到邮箱/目标地址”。
📘 API Token
创建教程（安装与收发）
1. 打开 https://dash.cloudflare.com/profile/api-tokens
2. 点击「创建自定义令牌」
3. Token 名称建议：mailbox-install-check
4. 添加权限：Zone -> Zone -> Read
5. 添加权限：Zone -> Email Routing -> Read（如果控制台只有 Edit，也可用 Edit）
6. 添加权限：Zone -> DNS -> Read
7. 添加权限：Zone -> Zone Settings -> Read（用于直接拉取官方 DKIM 建议值）
8. 如需使用 SPF / DMARC 的「一键设置」，再添加权限：Zone -> DNS -> Edit（DKIM 由 Email Routing 托管，不能直接覆盖）
9. 额外添加 Email Sending 的读写权限（用于自动接入发信域名）
10. 资源范围建议选 Specific zone，并选择你的邮箱域名所在 Zone
11. 点击 Continue to summary -> Create Token
12. 复制令牌（仅显示一次），粘贴到下方输入框
13. 返回此页面，填写域名后点击「检测收件路由」，通过后再执行「一键初始化」
该授权码仅用于首次初始化与环境检测，防止公开安装入口被未授权用户抢先接管。
仅用于当前安装流程请求，不会显示在页面中。建议使用覆盖安装所需权限的最小令牌。
填写你用于收发邮件的域名，例如 example.com
3
完成初始化
所有环境检测已通过。点击下方按钮完成系统初始化，并自动接入 Email Sending 发信域。
📋 安全提醒
⚠️
初始化完成后，请立即修改管理员密码并妥善保管访问凭据！
Cloudflare Mailbox
管理后台
管理员登录
请输入管理员账号和密码
登录用户:
邮箱列表
邮箱地址
创建时间
操作
正在读取邮箱列表...
账号安全
初始配置
可在此查看和编辑初始化阶段写入的系统配置。API 授权信息不会明文展示。
API Token 状态：读取中...
API 接入
-
AccessKey
尚未创建
请先创建 AccessKey，再让第三方服务使用它请求 API。
当前 AccessKey 需配合邮箱地址使用。调用 API 时请在请求头传入 X-Mailbox-Address。
GET
/mailbox/mails?limit=20
请求内容
-
响应内容
-
GET
/mailbox/mails/:id
请求内容
-
响应内容
-
POST
/mailbox/send
请求内容
-
响应内容
-
域名验证
独立检测当前安装域名的 SPF / DKIM / DMARC 配置状态。
将自动接入 Cloudflare Email
Sending，让当前域名可向外部邮箱发信。
将自动检测当前域名的 SPF / DKIM / DMARC 配置。