Cloudflare Temp Email：功能、部署与替代方案

该介绍目前仅提供英文版本。

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

Clone the Repository:

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

Configure Cloudflare Services:
- Set up Cloudflare D1 database
- Configure Email Routing for your domain
- Create KV namespaces for storage
Deploy Backend:
```
# Deploy Workers
npm run deploy:worker
```

Deploy Frontend:

# Deploy to Cloudflare Pages
npm run deploy:frontend

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: [email protected]
Password: your-jwt-token

SMTP Client Configuration

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

Webhook Integration

// Webhook payload example
{
  "type": "email_received",
  "email": {
    "from": "[email protected]",
    "to": "[email protected]",
    "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.

Cloudflare Temp Email