Skip to content

Cloudflare Temp Email

TrendingActive
dreamhunter2333/cloudflare_temp_email

CloudFlare free temporary domain email service with attachment support, IMAP, SMTP, and Telegram Bot integration. Built with Vue 3 and Cloudflare Workers for global edge deployment.

View on GitHub
Stars
11.9k
Forks
8k
Watchers
11.9k
Open issues
23

Free temporary domain email service built on Cloudflare’s edge network with full-featured email management.

Overview

Cloudflare Temp Email is a comprehensive temporary email service that leverages Cloudflare’s global infrastructure to provide fast, reliable, and feature-rich temporary email functionality. Built with modern web technologies including Vue 3, TypeScript, and Rust WASM, this service offers everything from basic email receiving to advanced features like SMTP/IMAP support, attachment handling, and Telegram Bot integration.

The service is completely free to use and can be self-hosted on Cloudflare’s generous free tier, making it an excellent solution for developers, privacy-conscious users, and anyone needing temporary email addresses for testing or registration purposes.

Key Features

  • 📧 Advanced Email Processing: Rust WASM-powered email parsing for fast and reliable message handling
  • 📎 Attachment Support: View and download email attachments with image preview capabilities
  • 🔐 User Authentication: Complete user registration/login system with OAuth2 and Passkey support
  • 📱 Telegram Integration: Full Telegram Bot support with push notifications and mini-app
  • 🌐 Multi-language Support: Internationalization support for global users
  • 🛡️ Security Features: DKIM validation, spam detection, and blacklist/whitelist configuration
  • 📨 Email Sending: SMTP and Resend integration for outbound email capabilities
  • 🗄️ Storage Options: S3 and Cloudflare R2 support for attachment storage
  • ⚡ Real-time Updates: Live email notifications and updates
  • 🔧 Admin Console: Complete administrative interface for user and system management

Email Processing Features

Advanced Parsing & Handling

  • Rust WASM Parser: Lightning-fast email parsing that handles complex email formats
  • Attachment Management: Support for viewing, downloading, and storing email attachments
  • DKIM Validation: Built-in DKIM signature verification for email authenticity
  • Spam Detection: Intelligent spam filtering with customizable rules
  • Email Forwarding: Global and user-specific email forwarding capabilities

Multi-Protocol Support

  • SMTP Proxy Server: Full SMTP support for sending emails
  • IMAP Access: IMAP protocol support for email client integration
  • Resend Integration: Modern email sending via Resend API
  • Webhook Support: Real-time webhook notifications for email events

User Management System

Authentication & Security

  • Credential-based Login: Secure token-based authentication system
  • OAuth2 Integration: Support for GitHub, Authentik, and other OAuth providers
  • Passkey Support: Modern passwordless authentication
  • Role-based Access: Multi-role system with domain and prefix configuration
  • Access Control: Optional password protection for private instances

User Features

  • Email Binding: Link multiple email addresses to user accounts
  • Inbox Management: Advanced filtering by address and keywords
  • Credential Recovery: JWT token-based email access recovery
  • Custom Addresses: Admin-configurable custom email address creation

Administrative Features

Management Console

  • User Administration: Complete user management with address viewing
  • Blacklist Configuration: Customizable email address blacklists
  • Cleanup Automation: Scheduled cleanup with multiple retention strategies
  • Access Control: Site-wide password protection options
  • Analytics Integration: Google Ads and usage analytics support

System Configuration

  • Rate Limiting: Configurable rate limits to prevent abuse
  • Turnstile Integration: Cloudflare Turnstile CAPTCHA support
  • Multi-domain Support: Support for multiple domains and prefixes
  • Storage Management: Flexible storage backend configuration

Technical Architecture

Frontend Stack

  • Vue 3: Modern reactive frontend framework with Composition API
  • TypeScript: Full type safety throughout the application
  • Vite: Fast build tooling and development server
  • Shadow DOM: Style isolation to prevent CSS conflicts
  • Responsive Design: Mobile-first responsive interface

Backend Infrastructure

  • Cloudflare Workers: Serverless edge computing for global performance
  • Cloudflare D1: SQLite-compatible serverless database
  • Cloudflare KV: Key-value storage for sessions and caching
  • Cloudflare R2: Object storage for attachments and media
  • Email Routing: Cloudflare Email Routing for message delivery

Integration Services

  • Rust WASM: High-performance email parsing module
  • Python Proxy: SMTP/IMAP proxy server for email client support
  • Telegram Bot: Complete bot integration with mini-app support
  • Webhook System: Real-time event notifications

Quick Start

Prerequisites

  • Cloudflare account (free tier supported)
  • Domain name (optional, can use Cloudflare subdomains)
  • Basic knowledge of Cloudflare Workers and Pages

Deployment Steps

  1. Clone the Repository:

    git clone https://github.com/dreamhunter2333/cloudflare_temp_email.git
cd cloudflare_temp_email

  2. Configure Cloudflare Services:

    • Set up Cloudflare D1 database
    • Configure Email Routing for your domain
    • Create KV namespaces for storage

  3. Deploy Backend:

    # Deploy Workers
npm run deploy:worker

  4. Deploy Frontend:

    # Deploy to Cloudflare Pages
npm run deploy:frontend

  5. Configure Email Routing:

    • Set up catch-all email routing in Cloudflare dashboard
    • Point emails to your deployed Worker

Advanced Configuration

Email Routing Setup

# Configure email routing rules
wrangler email routing rules create \
  --name "temp-email-catch-all" \
  --pattern "*@yourdomain.com" \
  --action worker \
  --worker-name "temp-email-worker"

SMTP Proxy Configuration

# Configure SMTP proxy server
python smtp_proxy_server/main.py \
  --host 0.0.0.0 \
  --port 587 \
  --worker-url https://your-worker.your-subdomain.workers.dev

Telegram Bot Setup

# Set up Telegram Bot webhook
curl -X POST "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook" \
  -d "url=https://your-worker.your-subdomain.workers.dev/telegram"

Integration Examples

IMAP Client Configuration

Server: your-domain.com
Port: 993 (SSL) / 143 (STARTTLS)
Username: your-email@your-domain.com
Password: your-jwt-token

SMTP Client Configuration

Server: your-domain.com
Port: 587 (STARTTLS) / 465 (SSL)
Username: your-email@your-domain.com
Password: your-jwt-token

Webhook Integration

// Webhook payload example
{
  "type": "email_received",
  "email": {
    "from": "sender@example.com",
    "to": "recipient@your-domain.com",
    "subject": "Test Email",
    "timestamp": "2025-01-01T00:00:00Z"
  }
}

Performance & Scalability

Global Edge Deployment

  • Edge Locations: Deployed across Cloudflare’s 200+ edge locations
  • Low Latency: Sub-100ms response times globally
  • Auto-scaling: Automatic scaling based on demand
  • High Availability: 99.9%+ uptime with global redundancy

Resource Efficiency

  • Serverless Architecture: Pay-per-use pricing model
  • Efficient Parsing: Rust WASM for optimal performance
  • Smart Caching: KV-based caching for frequently accessed data
  • Optimized Storage: Intelligent attachment storage management

Security & Privacy

Data Protection

  • Encryption: End-to-end encryption for sensitive data
  • Automatic Cleanup: Configurable data retention policies
  • Access Control: Role-based permissions and authentication
  • Audit Logging: Comprehensive activity logging

Spam & Abuse Prevention

  • Rate Limiting: Configurable request rate limits
  • Blacklist Support: Domain and address blacklisting
  • CAPTCHA Integration: Turnstile human verification
  • Content Filtering: Intelligent spam detection

Monitoring & Analytics

Built-in Monitoring

  • Real-time Metrics: Live email processing statistics
  • Error Tracking: Comprehensive error logging and reporting
  • Performance Monitoring: Response time and throughput metrics
  • User Analytics: Usage patterns and engagement metrics

Integration Options

  • Google Analytics: Web analytics integration
  • Custom Webhooks: Real-time event notifications
  • Telegram Notifications: Admin alerts via Telegram
  • API Metrics: Detailed API usage statistics

Community & Support

Getting Help

  • Documentation: Comprehensive setup and usage guides
  • GitHub Issues: Bug reports and feature requests
  • Telegram Community: Active community support
  • Wiki: Community-maintained documentation

Contributing

  • Open Source: MIT licensed with active development
  • Pull Requests: Community contributions welcome
  • Feature Requests: User-driven feature development
  • Translations: Multi-language support contributions

Roadmap

Upcoming Features

  • Enhanced mobile app support
  • Advanced email filtering rules
  • Improved attachment handling
  • Extended OAuth provider support
  • Enhanced admin analytics dashboard

Performance Improvements

  • Optimized email parsing algorithms
  • Enhanced caching strategies
  • Improved mobile responsiveness
  • Better error handling and recovery

License

This project is licensed under the MIT License - see the LICENSE file for details.

Experience the power of edge-deployed temporary email! Try the live demo at mail.awsl.uk or deploy your own instance today.

Alternatives to Cloudflare Temp Email

Similar open-source projects, ranked by shared categories and tags.

All Tools projects →