vanhoavn/vh-mail-hook repository overview

⁠VHMailHook - Secure Email Handling System

VHMailHook is a secure email handling system that provides temporary mailboxes with encryption capabilities. It's built with Rust and offers a modern web interface for managing email services.

⁠Features

• Secure Email Processing: Built-in encryption and automatic email expiration
• Multiple Authentication Methods: Supports GitHub, Telegram, Google OAuth, and password-based authentication
• Modern Web Interface: Clean and responsive UI for mailbox management
• RESTful API: Comprehensive API for system integration
• Multi-Protocol Support: Handles both plain SMTP (port 2525) and TLS SMTP (port 465)

⁠Quick Start

docker run -d \
  -p 2525:2525 \
  -p 465:465 \
  -p 8080:8080 \
  -e JWT_SECRET=your-256-bit-secret \
  -e APP_URL=http://your-domain \
  [optional auth environment variables] \
  vhnvn/vh-mail-hook

⁠Required Environment Variables

• JWT_SECRET: Secret key for JWT token generation
• APP_URL: Your application's public URL

⁠Optional Authentication Environment Variables

For OAuth/Social Login support:

# GitHub OAuth
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret

# Google OAuth
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret

# Telegram Login Widget
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_BOT_NAME=your-telegram-bot-name

⁠Ports

• 2525: Plain SMTP
• 465: TLS SMTP
• 8080: Web interface

⁠Security Notes

• Make sure to use strong secrets for the JWT configuration
• When deploying in production, always use HTTPS for the web interface
• Configure authentication providers according to your needs

⁠Support

For issues and feature requests, please visit the GitHub repository⁠.

⁠License

MIT License