dove

Self-hosted email relay service
Webhook 触发 · 模板管理 · 配额控制 · 完整日志

---

这是什么

Dove 是一个自托管的邮件中继服务，运行在 Cloudflare Workers 上。个人项目通过 Webhook 发送邮件，Dove 负责管理邮件模板、收件人白名单、发送配额和完整日志，通过可配置的邮件服务商（Resend / Cloudflare Email Routing）投递。

┌──────────────────────────────────────────────────────┐
│  Your Projects                                        │
│  SaaS App · CLI Tool · Cron Job · ...                 │
└───────────────┬──────────────────────────────────────┘
                │  POST /api/webhook/send (Bearer token)
                ▼
┌──────────────────────────────────────────────────────┐
│  Dove (Cloudflare Workers)                            │
│  Auth → Quota Check → Template Render → Send Log      │
└───────────────┬──────────────────────────────────────┘
                │  Resend API / Cloudflare Email Routing
                ▼
┌──────────────────────────────────────────────────────┐
│  Recipient Inbox                                      │
└──────────────────────────────────────────────────────┘

技术栈

层	技术
运行时	Cloudflare Workers
API 框架	Hono
语言	TypeScript (strict mode)
数据库	Cloudflare D1 (native binding)
会话存储	Cloudflare KV
认证	Google OAuth + KV sessions + email whitelist
前端	React 19 SPA (Vite + React Router)
UI	Tailwind CSS v4 + shadcn/ui
图表	Recharts
校验	Zod v4
邮件	Resend API / Cloudflare Email Routing
部署	wrangler deploy (single command)

开发

环境要求：Bun ≥ 1.3

git clone https://github.com/nocoo/dove.git
cd dove
bun install
bun dev  # http://localhost:7034

命令	说明
bun dev	启动开发服务器 (port 7034)
bun run build	生产构建
bun test	运行单元测试
bun run test:coverage	单元测试 + 90% 覆盖率门控
bun run typecheck	TypeScript 类型检查
bun run lint	ESLint (strict, 0 warnings)
bun run test:e2e:api	L2 API E2E 测试 (port 17034)
bun run test:e2e:bdd	L3 Playwright BDD E2E (port 27034)
bun run gate:security	安全扫描 (osv-scanner + gitleaks)
bun run release	发版 (SemVer bump + CHANGELOG + tag + GH release)

测试

层	内容	触发时机
L1 Unit	≥90% coverage (bun test)	pre-commit
G1 Static	tsc strict + ESLint strict + max-warnings=0	pre-commit
L2 API E2E	REST endpoint coverage (port 17034)	pre-push
G2 Security	osv-scanner + gitleaks	pre-push
L3 BDD E2E	Playwright 核心流程 (port 27034)	on-demand

MIT © 2026