Serveur API léger en Rust pour valider des adresses e-mail via syntaxe, DNS et SMTP.
147
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.
scratch, exécutée sans privilèges root.docker run -d \
--name rusted-truemail-server \
-p 9292:9292 \
-e [email protected] \
-e ACCESS_TOKENS=votre_token_secret \
stygarctuss/rusted-truemail-server:latest
curl "http://localhost:9292/[email protected]" \
-H "Authorization: votre_token_secret"
L’état du serveur est accessible sans authentification sur GET /healthcheck.
Configurez DEFAULT_VALIDATION_TYPE selon vos besoins :
| Valeur | Vérification | Port 25 sortant |
|---|---|---|
regex | Syntaxe de l’adresse | Non |
mx | Syntaxe et résolution DNS du domaine | Non |
smtp | Syntaxe, DNS et dialogue avec le serveur mail ; valeur par défaut | Oui |
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.
| Variable | Description | Valeur par défaut |
|---|---|---|
VERIFIER_EMAIL | Adresse utilisée comme expéditeur SMTP | noreply@localhost |
ACCESS_TOKENS | Jetons autorisés, séparés par des virgules | Aucun |
VERIFIER_DOMAIN | Domaine utilisé pour EHLO/HELO | Domaine de VERIFIER_EMAIL, sinon localhost |
DEFAULT_VALIDATION_TYPE | Mode de validation : regex, mx ou smtp | smtp |
VALIDATION_TYPE_FOR | Mode par domaine, par exemple example.com:mx | Aucun |
DNS | Serveurs DNS séparés par des virgules, par exemple 8.8.8.8,8.8.4.4:53 | DNS système |
CONNECTION_TIMEOUT | Délai de connexion SMTP, en secondes | 2 |
RESPONSE_TIMEOUT | Délai de lecture SMTP, en secondes | 2 |
SMTP_PORT | Port du serveur SMTP distant | 25 |
SMTP_FAIL_FAST | Arrête la validation au premier rejet SMTP permanent | false |
SMTP_SAFE_CHECK | Lu et affiché, mais sans effet sur la validation SMTP | false |
WHITELISTED_EMAILS / BLACKLISTED_EMAILS | Listes d’adresses séparées par des virgules | Aucune |
WHITELISTED_DOMAINS / BLACKLISTED_DOMAINS | Listes de domaines séparés par des virgules | Aucune |
BLACKLISTED_MX_IP_ADDRESSES | IP MX interdites, séparées par des virgules | Aucune |
EMAIL_PATTERN | Expression régulière personnalisée pour la syntaxe | ^.+@.+$ |
PORT / HOST | Port et adresse d’écoute HTTP | 9292 / 0.0.0.0 |
Sécurité : configurez toujours ACCESS_TOKENS en production. Sans jeton configuré, l’API accepte les requêtes sans authentification.
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é.
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.
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.
Content type
Image
Digest
sha256:44d3b3a25…
Size
2.5 MB
Last updated
2 days ago
docker pull stygarctuss/rusted-truemail-server