dreamhunter2333/cloudflare_temp_email
Cloudflare Temp Email
This project is a disposable email inbox service built to run entirely on Cloudflare's edge network. It creates temporary email addresses that automatically receive and store incoming messages and attachments, all without managing any traditional server infrastructure. The service uses Cloudflare Workers for serverless processing, Durable Objects for persistent inbox state, and Workers KV for storing email data, with attachments handled through R2 object storage.
The service distinguishes itself through a comprehensive set of access and management features. Users can authenticate through multiple methods including stored credentials, OAuth2 providers like GitHub and Authentik, or passwordless passkeys. An admin console provides centralized control for creating email addresses, managing users, configuring blacklists, and setting access passwords. The system also supports role-based permissions, CAPTCHA verification via Cloudflare Turnstile, and configurable rate limiting to prevent abuse.
Beyond basic email reception, the platform offers advanced email processing capabilities. Incoming emails are parsed using a Rust WebAssembly module for reliable content extraction, and an AI-powered feature can automatically identify verification codes and authentication links. Users can filter their inbox by address or keyword, forward emails to other addresses, and even send emails with DKIM signing support. The service also integrates with Telegram for notifications and a mini app interface, and can fire webhook events for external system integration.
The entire application is deployed through automated GitHub Actions workflows, with the frontend hosted as a static site on Cloudflare Pages and backend logic running on Workers. The repository includes configuration for automatic upstream synchronization, allowing forked instances to stay current with the latest changes.
Features
- Disposable Email Services - Sets up disposable email inboxes on Cloudflare Workers with automatic message and attachment handling.
- Rust WASM Parsers - Provides a Rust WebAssembly module for fast and reliable parsing of incoming email messages.
- Registration and Login Flows - Provides user registration and login with JWT credentials for switching between mailboxes.
- Cloudflare Workers KV Stores - Stores email messages and metadata in Cloudflare Workers KV for low-latency access.
- Email Attachments - Includes file attachments in received messages, making the inbox usable for document delivery.
- Cloudflare R2 Attachment Storages - Stores email attachments in Cloudflare R2 object storage for retrieval and management.
- Password-Protected Inboxes - Secures temporary email inboxes with password login and private site mode.
- Edge Function Runtimes - Runs serverless functions on Cloudflare's global edge network for email and HTTP processing.
- Edge Network Deployment - Deploys serverless applications to Cloudflare's global edge network using automated CI/CD pipelines.
- Cloudflare R2 Integrations - Stores email attachments in Cloudflare R2 object storage with retrieval and management capabilities.
- Cloudflare R2 Object Storages - Stores email attachments in Cloudflare R2 object storage for retrieval and management.
- Cloudflare Workers Deployments - Automates deployment of Workers and Pages applications using GitHub Actions and repository secrets.
- Key-Value Data Stores - Stores email messages and metadata using Cloudflare Workers KV for low-latency access.
- Incoming Email Processors - Provides an email receiving system built on Cloudflare Workers that handles messages without traditional servers.
- Cloudflare Email Routing Integrations - Leverages Cloudflare's Email Routing API to forward incoming emails to Workers for processing.
- Password Access Restrictions - Secures temporary email inboxes with password authentication and private site mode.
- Password-Protected Static Sites - Protects the email inbox by requiring a password for access with user registration support.
- Multi-Provider Authentication - Supports logging in with credentials, OAuth2 providers, or passkeys for flexible access control.
- Temporary Account Registrations - Creates separate user accounts so each person gets a unique temporary mailbox.
- Deployment Automation - Uses GitHub Actions workflows to automate deployment of backend and frontend code to Cloudflare's edge network.
- Deployment Workflows - Automates backend and frontend deployment using pre-configured GitHub Actions workflows.
- Distributed Inbox State Managers - Uses Cloudflare Durable Objects to maintain persistent inbox state across distributed edge locations.
- Distributed State Managers - Manages persistent inbox state across distributed edge locations using Cloudflare Durable Objects.
- Email Inbox Admin Consoles - Provides an admin console for creating email addresses, managing users, and configuring blacklists.
- Scheduled Data Cleanups - Runs periodic cleanup tasks with configurable strategies to remove old data automatically.
- Telegram Bots - Integrates a Telegram bot for push notifications and a mini app interface.
- Email Verification Code Extractors - Identifies and extracts verification codes and authentication links from incoming emails using AI.
- Upstream Synchronization - Keeps the deployed service up to date by pulling changes from the original repository.
- Remote Fork Synchronization - Keeps forked repositories updated by automatically pulling changes from the upstream source.
- JWT Credential Mailbox Bindings - Registers user accounts with bound email addresses and issues JWT credentials for mailbox switching.
- Email Content Parsing - Parses incoming emails using a Rust WASM module for fast and reliable content extraction.
- AI-Powered Content Extraction - Extracts verification codes and authentication links from incoming emails using Cloudflare Workers AI.
- WebAssembly Email Parsers - Parses incoming emails using a Rust WebAssembly module for fast and reliable content extraction.
- Subdomain Address Generators - Generates random subdomain email addresses under a configured base domain for message isolation.
- Email Forwarding Rules - Forwards received emails to a global forwarding address or per-user forwarding rules.
- Notification Bots - Receives email notifications and allows interaction with the service through a Telegram bot interface.
- Credential Authentication - Logs users back into previously used email addresses using stored credentials for persistent access.
- Email Signing - Sends emails via SMTP or Resend with DKIM signing to improve deliverability and authenticity.
- AI-Powered Code Extractors - Uses Cloudflare Workers AI to automatically extract verification codes and authentication links from emails.
- Email Spam Filtering - Implements spam filtering using configurable allow and block lists for incoming emails.
- OAuth2 Providers - Supports login via third-party OAuth2 providers such as GitHub and Authentik.
- Multi-Provider Authentication Flows - Supports login via email credentials, OAuth2 providers, and passkeys for flexible access control.
- Multi-Provider Login Flows - Supports login via stored credentials, OAuth2 providers, and passkeys for passwordless access.
- Passkey Authentication - Supports passwordless authentication using passkeys for secure and convenient login.
- Password Authentication - Authenticates users with a shared password to turn the service into a private inbox.
- Static Site Hosting - Hosts the frontend inbox interface as a static site on Cloudflare Pages for global delivery.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
