MailShield

E-Mail Protection Service. Secure your inbox. Protect your identity.

---

MailShield is a minimalist, resource-efficient PHP application designed to hide email addresses behind encrypted links and a Cloudflare Turnstile check. It’s the perfect solution for sharing email addresses on public websites without being targeted by scraper bots.

✨ Features

• Zero-Tracking: No cookies, no analytics.
• Secure: AES-256-GCM encryption for all stored data.
• Bot Protection: Integrated Cloudflare Turnstile (Captcha alternative).
• Lightweight: Optimized for small home labs (minimal RAM usage).
• Modern UI: Built with Tailwind CSS, including Dark Mode support.
• Multilingual: Automatically detects German and English.
• Badge: Use a badge to promote your protection

Database Support

MailShield supports:

• SQLite (default, zero config)
• PostgreSQL (recommended for production)

Switch via environment variables.

🚀 Deployment (Docker/Portainer)

Use this stack configuration for Portainer.

services:
  mailshield:
    image: ghcr.io/rondevhub/mailshield:latest
    container_name: mailshield
    restart: unless-stopped
    environment:
      # Generate a secure key (e.g., openssl rand -base64 32)
      - APP_KEY=base64:GeneriereMichBitteNeu12345678901234567=
      - https://mailshield.deine-domain.de
      # Admin Access
      - ADMIN_SITE=false
      - ADMIN_USER=admin
      - ADMIN_PASS=admin123
      # Cloudflare Turnstile
      - CF_SITE_KEY=1x00000000000000000000AA
      - CF_SECRET_KEY=1x0000000000000000000000000000000AA
      - DB_PATH=/var/www/html/data/mailshield.sqlite
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/html/data

Created with ❤️ by RonDevHub