Skip to content

Latest commit

 

History

History
67 lines (56 loc) · 3.91 KB

File metadata and controls

67 lines (56 loc) · 3.91 KB


MailShield

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

Created GitHub Repo stars GitHub Repo stars GitHub Repo stars GitHub Repo language GitHub Repo license GitHub Repo release GitHub Repo release GitHub Repo downlods GitHub Repo stars Docker Publish

Buy me a coffee Buy me a coffee Sponsor me Pizza Power Bitcoin Power


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