Skip to content

Repository files navigation


MailShield

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

CreatedGitHub Repo starsGitHub Repo starsGitHub Repo starsGitHub Repo languageGitHub Repo licenseGitHub Repo releaseGitHub Repo releaseGitHub Repo downlodsGitHub Repo starsstatus-badge

Buy me a coffeeBuy me a coffeePizza PowerBitcoin 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/rondev/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

About

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.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages