email-unlimit/server/README.md

Email Unlimited Server

Rust + Axum 实现的临时邮箱 HTTP API 与 SMTP 收信服务。

启动

开发环境默认使用 SQLite：

cargo run

指定配置与环境：

cargo run -- --env production --config config/production.toml

嵌套环境变量使用双下划线分隔：

$env:DATABASE__DATABASE_TYPE = "mysql"
$env:DATABASE__HOST = "localhost"
$env:DATABASE__PORT = "3306"
$env:DATABASE__USER = "root"
$env:DATABASE__PASSWORD = "your-password"
$env:DATABASE__DATABASE = "email_unlimit"
$env:AUTH__JWT_SECRET = "replace-with-at-least-32-random-characters"
$env:AUTH__INVITE_CODE = "replace-with-at-least-16-random-characters"
$env:AUTH__BOOTSTRAP_ADMIN_EMAIL = "admin@example.com"
$env:SMTP__BODY_ENCRYPTION_KEY = "0123456789abcdef0123456789abcdef"
cargo run -- --env production

核心接口

• GET /health
• POST /auth/register
• POST /auth/login
• POST /auth/refresh
• GET|POST /api/mailboxes
• GET /api/mailboxes/:id/emails
• GET /api/mailboxes/:id/ws
• GET /admin/stats
• GET|PATCH /admin/users

/api 路由使用用户或邮箱令牌，/admin 路由同时要求有效用户 JWT 与 admin 角色。

验证

cargo test
cargo check

更完整的资料位于 docs/。