• 🔗 多服务商聚合: 集成 MinMail、TempMail Plus、Mail.tm、EtempMail、VanishPost 等多个临时邮箱服务
• 🌍 多平台部署: 支持 Cloudflare Workers、Deno、Vercel、Node.js 等多种部署平台
• 🔐 双层认证: TempMailHub API Key + Provider AccessToken 保障安全
• 🔄 智能重试: 内置重试机制和错误处理
• 📊 健康监控: 实时监控各渠道状态和统计信息
• 🛡️ 类型安全: 完整的 TypeScript 类型定义
• 🐳 容器化: 支持 Docker 部署和 GitHub Actions 自动构建

# 克隆项目
git clone https://github.com/hzruo/tempmailhub.git
cd tempmailhub

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 访问服务
open http://localhost:8787

点击上方任意部署按钮，即可一键部署到对应平台。

curl -X POST http://localhost:8787/api/mail/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"provider": "mailtm"}'

curl -X POST http://localhost:8787/api/mail/list \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "address": "user@somoj.com",
    "accessToken": "provider_token"
  }'

💡 详细使用说明: 请查看 API_DOCUMENTATION.md
🚀 部署指南: 请查看 DEPLOYMENT.md

TempMailHub/
├── src/
│   ├── providers/         # 邮件服务商适配器
│   ├── services/          # 业务逻辑层
│   ├── middleware/        # 认证中间件
│   ├── types/             # TypeScript 类型定义
│   └── index.ts           # 应用入口
├── API_DOCUMENTATION.md   # 完整API文档
├── API_SECURITY.md        # 安全配置文档
├── DEPLOYMENT.md          # 部署指南
└── README.md              # 项目说明

1. 在 src/providers/ 创建适配器文件
2. 实现 IMailProvider 接口
3. 在 src/providers/index.ts 注册服务商

# 构建
npm run build

# 测试
npm test

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

本项目 TempMailHub 仅供学习、研究和测试目的使用。请用户遵守以下条款：

• ❌ 禁止用于任何非法、违规或恶意活动
• ❌ 禁止用于垃圾邮件发送或网络攻击
• ❌ 禁止用于绕过任何服务的正当验证机制
• ❌ 禁止用于任何可能损害第三方利益的行为

• 🔸 本项目不存储任何用户邮件内容或个人信息
• 🔸 本项目仅作为API聚合器，不对第三方服务的可用性负责
• 🔸 使用本服务造成的任何后果由用户自行承担
• 🔸 开发者不承担因使用本项目而产生的任何法律责任

本项目基于 MIT 许可证 开源。

• Hono - 轻量级 Web 框架

本项目感谢以下优秀的临时邮箱服务提供商：

• MinMail - 自动过期、高可用的临时邮箱服务
• TempMail Plus - 支持多域名选择的临时邮箱服务
• Mail.tm - 稳定可靠的临时邮箱API服务
• EtempMail - 提供教育域名的临时邮箱服务
• VanishPost - 15分钟自动过期的临时邮箱服务

⚠️ 重要说明:

本项目 TempMailHub 仅提供 API 聚合服务，不提供 Web UI 界面。

如需图形界面体验，请直接访问上述各临时邮箱提供方的官方网站～