1. Fork 并克隆项目#

首先访问 OmniMail 的 GitHub 仓库，点击 Fork 将项目复制到自己的账号下，然后部署到cf：

fork完毕后再cf

Workers & Pages -> “Create application”

在你连接github账户后，就可以选择你的仓库进行自动部署

3. 设置环境变量#

在 Cloudflare Dashboard 中，进入你的 Worker → 设置 → 变量，在 Variables & Secrets 中添加以下变量：

坑点：SETUP_TOKEN 必须设为 Secret 类型，否则初始化页面会提示“初始化令牌未检测到”。添加变量后，必须点击“保存并部署”，否则变量不会生效。

4. 执行数据库迁移#

这是整个部署过程中最容易出错的环节，需要特别注意。

如果迁移报错，以下是常见错误及解决方案：

如果迁移反复失败，最省事的办法是：

1. 在 Cloudflare Dashboard → D1 SQL 数据库中，删除现有的 omnimail-db
2. 重新创建一个同名的 D1 数据库
3. 需要注意要在Bindings 界面删除DB并重新添加新的D1

我最终就是通过“删除重建 D1”一次性成功完成了所有迁移。这是最简单粗暴但最有效的方法。

5. 部署 Worker#

部署成功后，你会获得一个 *.workers.dev 的默认域名，例如 omnimail.你的用户名.workers.dev。

你可以进行访问 它但是如果你在中国大陆 它大概率失败 你可以使用 1.1.1.1 进行访问 本章的第七步：国内访问优化 章节讲述了如何进行国内访问

2.1 启用 Email Routing#

1. 进入 Cloudflare Dashboard → 你的域名 → 电子邮件 → 电子邮件路由。
2. 点击 开始使用，它会自动添加 MX、SPF、DKIM 记录。
3. 确认 DNS 记录状态显示为 “已锁定”。

2.2 配置 Catch-all 规则#

这是关键步骤，确保所有发送到你的域名的邮件都能被 Worker 处理。

1. 在 Email Routing 页面，找到 Catch-all 规则，点击 编辑。
2. Action 选择 “发送到 Worker”。
3. 在下拉菜单中选择你的 Worker（omnimail）。
4. 保存。

坑点：如果后续收信失败，检查 Worker 的 触发器 中是否配置了路由 email.bg4jts.cn/*。注意这里用的是 路由 而不是 自定义域，因为我们后面要用优选 IP，自定义域会强制走 CDN 代理，导致优选 IP 失效。

3.1 注册并验证域名#

1. 注册 Resend，在 Domains 中添加你的域名 bg4jts.cn。
2. Resend 会提供几条 DNS 记录（DKIM、SPF 等），在 Cloudflare DNS 中添加对应的 TXT 记录。
3. 等待验证通过（状态变为 “已验证”）。

[截图建议：Resend 域名验证成功页面，显示 “Domain verified”]

3.2 获取并配置 API Key#

1. 在 Resend 控制台 → API Keys 中创建新的 API Key，复制保存。
2. 在 Worker 中添加 Secret：变量名 RESEND_DOMAIN_CONFIGS，值为 JSON 格式：

   1
   {"bg4jts.cn": {"apiKey": "re_你的API密钥"}}
   

3. 保存并重新部署 Worker。

说明：如果不需要追踪邮件打开/点击状态，可以不配置 Webhook。如果需要，在 Resend 的 Webhooks 中添加端点 https://你的域名/api/webhooks/resend，并在 Worker 中添加 RESEND_WEBHOOK_SECRET。

QQ 邮箱#

前置准备：

1. 在 QQ 邮箱网页版的 设置 → 账户 中开启 IMAP/SMTP 服务。
2. 按提示发送短信验证，获取 16 位授权码（不是 QQ 密码）。

配置步骤：

1. 在 Worker 中添加 Secret：QQ_MAIL_CREDENTIALS_KEY（至少 32 位随机字符串）。
2. 重新部署 Worker。
3. 在 OmniMail 左侧边栏点击 添加账户 → 选择 QQ 邮箱。
4. 填写邮箱地址和 16 位授权码。

坑点：QQ 邮箱的密码字段需要填的是 授权码 而不是 QQ 密码。如果填错了会报认证失败。

Outlook / Microsoft 邮箱#

前置准备：

1. 在 Azure AD 中注册应用，获取 Client ID 和 Refresh Token。
2. 应用注册时，受支持的帐户类型 要选 “任何组织目录中的帐户和个人 Microsoft 帐户”。

配置步骤：

1. 在 Worker 中添加 Secret：MICROSOFT_CREDENTIALS_KEY（至少 32 位随机字符串）。
2. 重新部署 Worker。
3. 在 OmniMail 中添加 Microsoft 账户，填写：
   • 邮箱地址
   • Refresh Token
   • Client ID
   • Authority：consumers（个人账户）

坑点：如果 Azure 应用注册时只选了“仅组织目录中的帐户”，会报错 AADSTS50020。解决方法是在应用的 清单 中，将 signInAudience 改为 AzureADandPersonalMicrosoftAccount。

7.1 测试优选 IP#

1. 下载 CloudflareSpeedTest（建议从 Releases 页面下载）。
2. 解压后运行 CloudflareST.exe（Windows），它会自动测试并输出延迟最低的 IP。
3. 记录测试结果中延迟最低、丢包率为 0% 的 IP 地址。

7.2 修改 DNS 记录#

1. 在 Cloudflare DNS 中，找到你的邮件子域名（如 我的就是email.bg4jts.cn）。
2. 将记录类型从 CNAME 改为 A 记录。
3. 记录值填入测出的最优 IP。
4. 代理状态必须关闭（灰色云朵，仅 DNS），不能开启橙色云。

坑点：如果开启代理（橙色云），请求会强制走 Cloudflare CDN，优选 IP 就失效了。

7.3 配置 Worker 路由#

1. 进入 omnimail Worker → 设置 → 触发器。
2. 在 路由 部分，添加或确认存在：email.bg4jts.cn/* 指向 omnimail。
3. 不要在自定义域中添加 email.bg4jts.cn，否则会与路由冲突。

注意：路由格式是 email.bg4jts.cn/*（带 /*），不是 *email.bg4jts.cn/*。