この紹介文は現在英語版のみです。
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.