Custom Mail

01. 项目概述

用 Rust（workers-rs）实现的自托管网页发信工作台：会话登录、Markdown 撰写与邮件安全预览、附件、KV 发送记录，以及可丢入的 ESP / 主题 / 布局插件——不必自建邮件服务器。

02. 问题

为什么做？

团队需要可品牌化、跑在自己 Cloudflare 账号上的私有撰写界面——不是共享 SaaS 邮箱，也不是要运维一整套 VPS 邮件栈。

03. 方案

怎么解决？

把 Custom Mail 做成 Workers + KV 产品：JSON 驱动品牌、可插拔提供商（Brevo、Resend、SendGrid …）、Docker / GHCR 镜像、文档站，以及可供 Agent 安装的 ClawHub 技能。

04. 架构

系统架构

05. 关键特性

核心功能

• Cloudflare Workers 上带密码保护的撰写控制台
• CommonMark + GFM 正文与邮件安全 HTML 预览
• 多附件上限与 KV 中最近 N 条发送记录
• 可品牌化配置：名称、域名、配色、Logo、页脚与文案
• 可插拔 ESP / 主题 / 布局 / Logo 目录
• Docker Hub + GHCR 镜像与 ClawHub 技能安装路径

06. 我的角色

我具体做了什么？

• 从 Workers 运行时到 ESP 插件，主导产品架构。
• 实现 Rust/wasm 邮件控制台、Markdown 预览与 KV 历史。
• 发布 Docker / GHCR 镜像、文档站与 ClawHub 打包。

07. 技术栈

使用什么技术？

• Rust (workers-rs)
• Cloudflare Workers
• KV
• Brevo / Resend / SendGrid
• Docker
• OpenClaw / ClawHub

08. 成果指标

取得什么成果？

09. 部署

如何运行？

在 Cloudflare Workers 上绑定密钥与 KV 部署，或用 Docker / wrangler 本地运行；在 config/mail.json 配置品牌与 ESP。

1. 克隆 InnoNestX/Custom-Mail，并复制 .dev.vars.example。
2. 设置 ADMIN_PASSWORD 与提供商 API Key，然后 npm run dev 或 docker run。
3. 将 wrangler 路由与 mail.json 的 host 指向你的域名并部署。
4. 可选：clawhub install custom-mail，走 OpenClaw 技能路径。

10. GitHub

11. 在线体验

12. 取舍

• 自托管 Workers + KV，而不是 SaaS 网页邮箱——凭据与品牌留在你的账号。
• 专注出站撰写控制台，而不是完整 IMAP 收件箱——对齐团队真实发信流程。
• 可插拔 ESP，而不是锁死单一提供商——通过配置切换 Brevo / Resend / SendGrid。

13. 交付物

• Cloudflare Workers 上带会话登录的私有撰写 UI
• Markdown 预览 + 附件 + KV 发送历史
• 安装面：Workers 部署、Docker / GHCR、ClawHub

14. 可检查的证据

15. 链接