HUB
Sign inSign up

stygarctuss/rusted-truemail-server

By stygarctuss

•Updated 2 days ago

Serveur API léger en Rust pour valider des adresses e-mail via syntaxe, DNS et SMTP.

Image
0

147

stygarctuss/rusted-truemail-server repository overview

⁠Rusted Truemail Server

API HTTP asynchrone de validation d’adresses e-mail, développée en Rust avec Axum et Tokio. Compatible avec les clients truemail-rack, elle fonctionne sans base de données.

⁠Fonctionnalités

  • Vérification de la syntaxe, du domaine via DNS et par dialogue SMTP, sans envoyer d’e-mail.
  • Authentification par jeton et configuration par variables d’environnement.
  • Listes blanches et noires d’adresses, de domaines et d’IP MX.
  • Image minimale basée sur scratch, exécutée sans privilèges root.

⁠Démarrage rapide

docker run -d \
  --name rusted-truemail-server \
  -p 9292:9292 \
  -e [email protected] \
  -e ACCESS_TOKENS=votre_token_secret \
  stygarctuss/rusted-truemail-server:latest

⁠Utilisation

curl "http://localhost:9292/[email protected]" \
  -H "Authorization: votre_token_secret"

L’état du serveur est accessible sans authentification sur GET /healthcheck.

⁠Options de validation

Configurez DEFAULT_VALIDATION_TYPE selon vos besoins :

ValeurVérificationPort 25 sortant
regexSyntaxe de l’adresseNon
mxSyntaxe et résolution DNS du domaineNon
smtpSyntaxe, DNS et dialogue avec le serveur mail ; valeur par défautOui

Le mode mx ne vérifie pas l’existence de la boîte. Par défaut, si aucun enregistrement MX n’est trouvé, la résolution peut se replier sur les enregistrements A/AAAA du domaine.

⁠Variables d’environnement

VariableDescriptionValeur par défaut
VERIFIER_EMAILAdresse utilisée comme expéditeur SMTPnoreply@localhost
ACCESS_TOKENSJetons autorisés, séparés par des virgulesAucun
VERIFIER_DOMAINDomaine utilisé pour EHLO/HELODomaine de VERIFIER_EMAIL, sinon localhost
DEFAULT_VALIDATION_TYPEMode de validation : regex, mx ou smtpsmtp
VALIDATION_TYPE_FORMode par domaine, par exemple example.com:mxAucun
DNSServeurs DNS séparés par des virgules, par exemple 8.8.8.8,8.8.4.4:53DNS système
CONNECTION_TIMEOUTDélai de connexion SMTP, en secondes2
RESPONSE_TIMEOUTDélai de lecture SMTP, en secondes2
SMTP_PORTPort du serveur SMTP distant25
SMTP_FAIL_FASTArrête la validation au premier rejet SMTP permanentfalse
SMTP_SAFE_CHECKLu et affiché, mais sans effet sur la validation SMTPfalse
WHITELISTED_EMAILS / BLACKLISTED_EMAILSListes d’adresses séparées par des virgulesAucune
WHITELISTED_DOMAINS / BLACKLISTED_DOMAINSListes de domaines séparés par des virgulesAucune
BLACKLISTED_MX_IP_ADDRESSESIP MX interdites, séparées par des virgulesAucune
EMAIL_PATTERNExpression régulière personnalisée pour la syntaxe^.+@.+$
PORT / HOSTPort et adresse d’écoute HTTP9292 / 0.0.0.0

Sécurité : configurez toujours ACCESS_TOKENS en production. Sans jeton configuré, l’API accepte les requêtes sans authentification.

⁠Docker Compose / Coolify avec validation MX

services:
  truemail:
    image: stygarctuss/rusted-truemail-server:latest
    restart: unless-stopped
    ports:
      - "9292:9292"
    environment:
      ACCESS_TOKENS: '${ACCESS_TOKENS}'
      VERIFIER_EMAIL: '${VERIFIER_EMAIL}'
      DEFAULT_VALIDATION_TYPE: 'mx'
      DNS: '8.8.8.8,8.8.4.4:53'

Définissez ACCESS_TOKENS et VERIFIER_EMAIL dans votre environnement ou dans Coolify avant le déploiement. Cet exemple utilise mx lorsque le port 25 sortant est bloqué.

⁠Docker Compose / Coolify avec validation SMTP

services:
  truemail:
    image: stygarctuss/rusted-truemail-server:latest
    restart: unless-stopped
    ports:
      - "9292:9292"
    environment:
      ACCESS_TOKENS: '${ACCESS_TOKENS}'
      VERIFIER_EMAIL: '${VERIFIER_EMAIL}'
      DEFAULT_VALIDATION_TYPE: 'smtp'
      SMTP_PORT: '25'
      CONNECTION_TIMEOUT: '10'
      RESPONSE_TIMEOUT: '10'
      DNS: '8.8.8.8,8.8.4.4:53'

Définissez ACCESS_TOKENS et VERIFIER_EMAIL dans Coolify. Le mode smtp est déjà celui par défaut, mais l’indiquer explicitement rend la configuration plus claire.

⁠Limites SMTP

La validation SMTP nécessite une connexion sortante au port 25. Si elle expire, success: false ne prouve pas que l’adresse est invalide : la boîte n’a pas pu être vérifiée. Augmenter CONNECTION_TIMEOUT ne débloque pas le port. Une réponse SMTP positive ne garantit pas non plus la délivrabilité d’un message.

Tag summary

Content type

Image

Digest

sha256:44d3b3a25…

Size

2.5 MB

Last updated

2 days ago

docker pull stygarctuss/rusted-truemail-server