gitmyhub

cloudflare_temp_email

TypeScript ★ 10k updated 1d ago

CloudFlare free temp domain email 免费收发 临时域名邮箱 支持附件 IMAP SMTP TelegramBot

Run your own free disposable email service on Cloudflare's free tier, visitors get temporary inboxes, you keep full control over the data, and the whole thing costs nothing to operate.

TypeScriptVue 3Cloudflare WorkersCloudflare D1RustWebAssemblysetup: moderatecomplexity 4/5

This project lets you build and run your own temporary email service entirely on Cloudflare's free infrastructure, which means it costs nothing to operate once deployed. Visitors get a disposable inbox address they can use to receive messages without revealing a real email account. The service is self-hosted, so the person who deploys it controls the data and configuration.

The feature list goes well beyond a basic inbox. You can send email out (not just receive it), attach files, store attachments in S3-compatible storage, and configure spam filtering with blacklists. Users can log in with a password, with OAuth2 providers like GitHub, or with a passkey (no password at all). There is a Telegram bot for notifications and a mobile client built by the community for Android. An admin control panel handles user management, scheduled cleanup of old messages, and access control.

Under the hood, the backend runs as a Cloudflare Worker (a serverless function that runs at Cloudflare's edge), and the frontend is a Vue 3 app deployed to Cloudflare Pages. Email is routed through Cloudflare Email Routing. What makes parsing unusually fast is a module written in Rust and compiled to WebAssembly, which handles decoding incoming messages more reliably than most JavaScript-based parsers. The database is Cloudflare D1, a SQLite-compatible service, and key-value storage handles session and cache data.

Deployment is documented and can be done through a GitHub Action workflow. There is also an SMTP and IMAP proxy so that standard email clients can connect to the service if needed. Rate limiting and a Cloudflare Turnstile challenge (a bot-detection widget) are available to prevent abuse.

The project is primarily documented in Chinese, though an English README is included. It is intended for learning and personal use, and the author notes that using it for anything illegal is the user's own responsibility.

Where it fits