简体中文 · English
给收件箱，加一些隐私。
一个可自部署的临时邮箱聚合服务，通过网页和统一 API 管理多个供应商的邮箱。
- 统一收件：创建临时邮箱、复制地址、查看邮件与操作记录。
- 数据看板：查看邮箱统计、收件趋势和最近活动。
- 在线配置：管理供应商与系统参数，支持配置热更新。
- 简洁界面：支持深色模式、中英文和移动端。
- 保留历史：邮箱到期后停止收发，历史邮件保留至手动清除。
| 平台 | 网站 | 支持能力 | 接入文档 |
|---|---|---|---|
| temp-mail.org | temp-mail.org | 创建、收件 | 接入说明 |
| TempMail.lol | tempmail.lol | 创建、收件 | 接入说明 |
目前暂不支持发件和附件下载。
首次部署，在项目根目录执行：
mkdir -p temp-mail
cd temp-mail
curl -fsSL https://raw.githubusercontent.com/ThinkerWen/temp-mail/main/compose.yaml -o compose.yaml
mkdir -p config data
docker pull designerwang/temp-mail:latest
docker compose run --rm --user "$(id -u):$(id -g)" init
docker compose up -d打开 http://127.0.0.1:8000/，使用 config/config.yaml 中的 app.api_token 登录。
需要 Python 3.12+、uv、Node.js 22.13+ 和 pnpm 11。
uv sync --dev
uv run python scripts/init_config.py
pnpm --dir frontend install --frozen-lockfile
pnpm --dir frontend build
uv run python run.py| 文档 | 内容 |
|---|---|
| 部署指南 | Docker、持久化、日志与备份 |
| 配置说明 | YAML 参数、供应商配置与热更新 |
| 使用与前端开发 | 页面功能、本地开发与构建 |
| API 使用 | 鉴权、创建邮箱、收件与接口索引 |
| 架构设计 | 数据模型、任务调度与供应商扩展 |
配置模板见 config.example.yaml，请求示例见 test_main.http。服务启动后可访问 /docs 查看交互 API 文档。
Windows、远程访问、已有配置迁移与备份见 部署指南。已有数据库请跳过初始化，保留原配置及加密密钥。
uv run pytest
pnpm --dir frontend build
pnpm --dir frontend exec playwright install chromium
pnpm --dir frontend test后端使用 FastAPI、SQLite 和 Loguru；前端使用 React、TypeScript 和 HeroUI。测试使用本地模拟供应商，无需创建真实邮箱。