Info:: apsi.net: GUIDE CREATION DOMAINE
KEYWORDS: MAIL, SERVER, APSI.NET, OVH1, MAIL.APSI.NET, OVH2, BACKUP.APSI.NET
Le 04/01/2026:
Guide de Création d’un Nouveau Domaine
Serveur: ovh1 (mail.apsi.net) Architecture: Postfix + Dovecot + rspamd + ClamAV Ordre: Du plus urgent au moins urgent
Ce guide détaille toutes les étapes pour ajouter un nouveau domaine au serveur mail, organisées par ordre de priorité.
Table des matières
- Étapes URGENTES - À faire immédiatement
- Étapes IMPORTANTES - À faire dans les 24h
- Étapes OPTIONNELLES - Configuration avancée
Étapes URGENTES
Ces étapes sont nécessaires pour que le domaine fonctionne. À effectuer immédiatement.
1. Ajouter le domaine dans PostfixAdmin (MySQL)
Pourquoi: C’est la source de vérité pour Postfix et Dovecot. Sans cela, le serveur ne reconnaît pas le domaine.
Commande:
/root/scripts/add-domain.sh exemple.com
Ce que fait le script: - Ajoute le domaine dans la table domain de MySQL - Configure les quotas et limites par défaut - Prépare la structure pour les comptes email
Vérification:
mysql -u postfixadmin -p postfixadmin -e "SELECT domain, active FROM domain WHERE domain='exemple.com';"
Vous devriez voir:
+-------------+--------+ | domain | active | +-------------+--------+ | exemple.com | 1 | +-------------+--------+
Dépannage: - Si le domaine existe déjà: “Domain already exists” - Si erreur MySQL: vérifier les credentials dans /etc/postfix/mysql-virtual-mailbox-domains.cf
2. Générer les clés DKIM pour rspamd
Pourquoi: DKIM signe cryptographiquement vos emails pour prouver qu’ils viennent bien de votre domaine. Sans cela, vos emails risquent d’être marqués comme spam.
Commandes:
Look @ apsi.net::/root/IA/MAIL.APSI.NET/.pcmakeDKIM-generate
# Créer le répertoire pour les clés rspamd si nécessaire
mkdir -p /etc/rspamd/dkim
# Générer la clé privée DKIM (RSA 1024 bits)
openssl genrsa -out /etc/rspamd/dkim/exemple.com.key 1024
# Ajuster les permissions (lecture seule pour _rspamd)
chmod 640 /etc/rspamd/dkim/exemple.com.key
chown root:_rspamd /etc/rspamd/dkim/exemple.com.key
Vérification:
ls -la /etc/rspamd/dkim/exemple.com.key
Devrait afficher:
-rw-r----- 1 root _rspamd 887 Jan 3 16:00 /etc/rspamd/dkim/exemple.com.key
Générer la clé publique (pour le DNS):
# Extraire la clé publique
openssl rsa -in /etc/rspamd/dkim/exemple.com.key -pubout -outform PEM 2>/dev/null | \
grep -v "PUBLIC KEY" | tr -d '\n'
Notez cette valeur, vous en aurez besoin pour le DNS (étape 4).
Dépannage: - Si erreur de permission: vérifier que le groupe _rspamd existe - Si rspamd ne démarre plus: vérifier les permissions avec ls -la
3. Configurer DKIM dans rspamd
Pourquoi: Indique à rspamd comment signer les emails pour ce domaine.
Éditer le fichier:
nano /etc/rspamd/local.d/dkim_signing.conf
Ajouter dans la section domain {:
exemple.com {
path = "/etc/rspamd/dkim/exemple.com.key";
selector = "mail";
}
Exemple complet:
# Configuration DKIM signing pour rspamd
enabled = true;
use_domain = "header";
use_envelope = true;
allow_username_mismatch = true;
selector = "mail";
path = "/etc/rspamd/dkim/$domain.key";
domain {
apsi.net {
path = "/etc/rspamd/dkim/apsi.net.key";
selector = "mail";
}
exemple.com {
path = "/etc/rspamd/dkim/exemple.com.key";
selector = "mail";
}
}
sign_alg = "rsa-sha256";
sign_headers = "from:to:cc:subject:date:message-id:references:in-reply-to:reply-to";
Redémarrer rspamd:
systemctl restart rspamd
systemctl status rspamd
Vérification:
# Vérifier que rspamd a bien chargé la configuration
rspamadm configdump dkim_signing | grep -A 5 exemple.com
Dépannage: - Si rspamd ne démarre pas: journalctl -u rspamd -n 50 - Vérifier la syntaxe: rspamadm configtest
4. Configurer les enregistrements DNS
Pourquoi: Les serveurs mail distants ont besoin de ces enregistrements pour savoir où envoyer les emails et comment vérifier leur authenticité.
IP du serveur: 51.83.2.131
A. Enregistrement MX (OBLIGATOIRE)
Type: MX Nom: @ (ou exemple.com) Valeur: 10 mail.apsi.net. Priorité: 10 TTL: 3600
Explication: Indique que les emails pour @exemple.com doivent être livrés à mail.apsi.net.
B. Enregistrement A (si mail.exemple.com)
Si vous voulez utiliser mail.exemple.com au lieu de mail.apsi.net:
Type: A Nom: mail Valeur: 51.83.2.131 TTL: 3600
C. Enregistrement SPF (OBLIGATOIRE)
Type: TXT Nom: @ (ou exemple.com) Valeur: v=spf1 mx a:mail.apsi.net ~all TTL: 3600
Explication: - v=spf1 = version SPF - mx = autorise les serveurs listés dans les enregistrements MX - a:mail.apsi.net = autorise l’IP de mail.apsi.net - ~all = soft-fail pour les autres (marquer comme suspect mais accepter)
D. Enregistrement DKIM (OBLIGATOIRE)
Type: TXT Nom: mail._domainkey Valeur: v=DKIM1; k=rsa; p=VOTRE_CLE_PUBLIQUE TTL: 3600
Pour obtenir la clé publique:
openssl rsa -in /etc/rspamd/dkim/exemple.com.key -pubout -outform PEM 2>/dev/null | \
grep -v "PUBLIC KEY" | tr -d '\n'
Exemple de valeur complète:
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDMidBAoMcRQ+RxAWvRTF5qqnDS0Xamb82IQi88EztMKYtlQn2273K+IE70yuufaEON01KADFY1YjPNE8iWl8KtGdR2o46n415+2KqwE/TamDxtANDGAD4icZKC9BiEZ3oEMXrLEDyV/t42RUQMas9+c1EtIkxbMm95OnNUiMjB/QIDAQAB
Attention: La clé publique doit être sur UNE SEULE ligne, sans retours à la ligne.
E. Enregistrement DMARC (OBLIGATOIRE)
Look @ apsi.net::/root/IA/MAIL.APSI.NET/.pcmakeDMARC.check
Type: TXT Nom: _dmarc Valeur: v=DMARC1; p=quarantine; rua=mailto:postmaster@exemple.com; ruf=mailto:postmaster@exemple.com; fo=1 TTL: 60
Explication: - v=DMARC1 = version DMARC - p=quarantine = mettre en quarantaine les emails qui échouent (ou p=reject pour rejeter) - rua= = adresse pour recevoir les rapports agrégés - ruf= = adresse pour recevoir les rapports détaillés - fo=1 = générer des rapports pour tous les échecs
Vérification DNS (attendre 5-10 minutes après configuration):
# MX
dig +short MX exemple.com
# SPF
dig +short TXT exemple.com | grep spf1
# DKIM
dig +short TXT mail._domainkey.exemple.com
# DMARC
dig +short TXT _dmarc.exemple.com
Dépannage: - Si dig ne retourne rien: le DNS n’a pas encore propagé (attendre 15-30 minutes) - Si erreur de syntaxe DKIM: vérifier qu’il n’y a pas de retours à la ligne dans la clé publique - Tester avec des outils en ligne: https://mxtoolbox.com/
Étapes IMPORTANTES
Ces étapes doivent être faites dans les 24 heures pour une configuration complète et sécurisée.
5. Créer un compte email de test
Pourquoi: Pour tester que le domaine fonctionne correctement.
Commande:
/root/scripts/add-account.sh postmaster@exemple.com "MotDePasse123!"
Vérification:
mysql -u postfixadmin -p postfixadmin -e "SELECT username, domain FROM mailbox WHERE username='postmaster@exemple.com';"
6. Tester l’envoi et la réception d’emails
A. Test de réception (depuis un autre serveur):
Envoyez un email depuis Gmail/Outlook vers postmaster@exemple.com
Vérifier la réception:
ls -la /home/postmaster.exemple.com/Maildir/new/
B. Test d’envoi (depuis le serveur):
/root/scripts/test-mail-accounts.sh
Ou manuellement:
echo "Test email" | mail -s "Test depuis exemple.com" -r postmaster@exemple.com destination@gmail.com
Vérifier les logs:
tail -f /var/log/mail.log | grep exemple.com
Dépannage: - Si “Relay access denied”: le domaine n’est pas dans MySQL - Si “User unknown”: le compte n’existe pas dans MySQL - Si email refusé par destinataire: vérifier SPF/DKIM/DMARC avec https://mail-tester.com
7. Vérifier les signatures DKIM
Test simple:
Envoyez un email depuis postmaster@exemple.com vers votre compte Gmail/Outlook, puis:
Dans Gmail: 1. Ouvrir l’email 2. Cliquer sur “…” → “Afficher l’original” 3. Chercher “DKIM: ‘PASS’”
Depuis le serveur:
Envoyez un email à vous-même sur le serveur:
{
sleep 1
echo "EHLO localhost"
sleep 1
echo "MAIL FROM:<postmaster@exemple.com>"
sleep 1
echo "RCPT TO:<postmaster@exemple.com>"
sleep 1
echo "DATA"
sleep 1
echo "Subject: Test DKIM exemple.com"
echo "From: postmaster@exemple.com"
echo "To: postmaster@exemple.com"
echo ""
echo "Test de signature DKIM pour le domaine exemple.com"
echo ""
echo "."
sleep 1
echo "QUIT"
} | nc localhost 25
Vérifier l’email reçu:
grep -r "DKIM-Signature.*d=exemple.com" /home/postmaster.exemple.com/Maildir/
Devrait afficher une ligne avec DKIM-Signature: v=1; ... d=exemple.com; s=mail;
Dépannage: - Si pas de signature DKIM: vérifier les logs rspamd: journalctl -u rspamd | grep -i dkim - Si “cannot load private key”: vérifier les permissions de /etc/rspamd/dkim/exemple.com.key - Tester la configuration: rspamadm configdump dkim_signing | grep -A 5 exemple.com
8. Configurer les certificats SSL (si mail.exemple.com)
Pourquoi: Pour que les clients mail (Outlook, Thunderbird) puissent se connecter en HTTPS/IMAPS/SMTPS sans avertissement.
Uniquement si vous utilisez mail.exemple.com au lieu de mail.apsi.net:
# Arrêter Apache temporairement
systemctl stop apache2
# Obtenir le certificat
certbot certonly --standalone -d mail.exemple.com -d exemple.com -d www.exemple.com
# Redémarrer Apache
systemctl start apache2
Configurer Postfix pour utiliser le nouveau certificat:
Si vous voulez que Postfix utilise le certificat de mail.exemple.com:
postconf -e "smtpd_tls_cert_file=/etc/letsencrypt/live/mail.exemple.com/fullchain.pem"
postconf -e "smtpd_tls_key_file=/etc/letsencrypt/live/mail.exemple.com/privkey.pem"
systemctl reload postfix
Configurer Dovecot:
nano /etc/dovecot/conf.d/10-ssl.conf
Modifier:
ssl_cert = </etc/letsencrypt/live/mail.exemple.com/fullchain.pem ssl_key = </etc/letsencrypt/live/mail.exemple.com/privkey.pem
systemctl reload dovecot
Vérification:
openssl s_client -connect mail.exemple.com:993 -servername mail.exemple.com | grep "Verify return code"
Devrait afficher: Verify return code: 0 (ok)
Note: Si vous continuez à utiliser mail.apsi.net, cette étape n’est pas nécessaire.
9. Tester avec des outils externes
A. Mail-tester.com
Aller sur https://mail-tester.com
Noter l’adresse email fournie (ex:
test-xyz@mail-tester.com)Envoyer un email depuis votre nouveau domaine:
echo "Test de configuration" | mail -s "Test exemple.com" -r postmaster@exemple.com test-xyz@mail-tester.com
Rafraîchir la page mail-tester.com
Objectif: Score de 10/10
Points vérifiés: - SPF: PASS - DKIM: PASS - DMARC: PASS - Reverse DNS - IP non blacklistée - Contenu de l’email
B. MXToolbox.com
Vérifier tous les enregistrements:
https://mxtoolbox.com/SuperTool.aspx?action=mx:exemple.com https://mxtoolbox.com/SuperTool.aspx?action=spf:exemple.com https://mxtoolbox.com/SuperTool.aspx?action=dkim:mail:exemple.com https://mxtoolbox.com/SuperTool.aspx?action=dmarc:exemple.com
Dépannage: - Score < 10/10: lire les détails pour voir ce qui manque - SPF fail: vérifier l’enregistrement DNS - DKIM fail: vérifier que la clé DNS correspond à la clé privée
Étapes OPTIONNELLES
Configuration avancée et optimisations.
10. Configurer un alias catchall (optionnel)
Pourquoi: Recevoir tous les emails envoyés à des adresses inexistantes sur le domaine.
Ajouter dans PostfixAdmin (MySQL):
mysql -u postfixadmin -p postfixadmin
INSERT INTO alias (address, goto, domain, created, modified, active)
VALUES ('@exemple.com', 'postmaster@exemple.com', 'exemple.com', NOW(), NOW(), 1);
Vérification:
# Tester avec une adresse inexistante
echo "Test catchall" | mail -s "Test" -r externe@gmail.com nexistepas@exemple.com
L’email devrait arriver dans la boîte postmaster@exemple.com.
Attention: Le catchall peut augmenter le spam reçu.
11. Configurer des alias personnalisés
Pourquoi: Rediriger certaines adresses vers d’autres comptes.
Exemples courants: - contact@exemple.com → postmaster@exemple.com - info@exemple.com → postmaster@exemple.com - support@exemple.com → support@autre-domaine.com
Ajouter un alias:
mysql -u postfixadmin -p postfixadmin
INSERT INTO alias (address, goto, domain, created, modified, active)
VALUES ('contact@exemple.com', 'postmaster@exemple.com', 'exemple.com', NOW(), NOW(), 1);
Alias vers plusieurs adresses:
INSERT INTO alias (address, goto, domain, created, modified, active)
VALUES ('support@exemple.com', 'admin1@exemple.com,admin2@exemple.com', 'exemple.com', NOW(), NOW(), 1);
Vérification:
echo "Test alias" | mail -s "Test" -r externe@gmail.com contact@exemple.com
12. Configurer le filtrage Sieve (optionnel)
Pourquoi: Permettre aux utilisateurs de créer des règles de filtrage automatique (déplacer spam vers Junk, trier par expéditeur, etc.)
Vérifier que Sieve est activé:
grep -r "sieve" /etc/dovecot/conf.d/
Devrait afficher des configurations dans 90-sieve.conf.
Configuration par défaut (déjà faite normalement):
Créer /var/lib/dovecot/sieve/default.sieve:
require ["fileinto"];
# Déplacer les spams détectés par rspamd vers Junk
if header :contains "X-Spam" "Yes" {
fileinto "Junk";
stop;
}
Compiler:
sievec /var/lib/dovecot/sieve/default.sieve
chown vmail:vmail /var/lib/dovecot/sieve/default.sieve*
Test:
Envoyer un email avec GTUBE (test spam):
echo "XJS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X" | \
mail -s "Test Spam" -r externe@gmail.com postmaster@exemple.com
L’email devrait arriver dans /home/postmaster.exemple.com/Maildir/.Junk/
13. Documenter la configuration
Créer un fichier de référence:
nano /root/docs/exemple.com-config.txt
Contenu suggéré:
Domaine: exemple.com Date de création: 2026-01-03 Serveur MX: mail.apsi.net === Comptes email === - postmaster@exemple.com (compte principal) - contact@exemple.com (alias vers postmaster) === DNS === MX: 10 mail.apsi.net. SPF: v=spf1 mx a:mail.apsi.net ~all DKIM: mail._domainkey (sélecteur: mail) DMARC: v=DMARC1; p=quarantine === DKIM === Clé privée: /etc/rspamd/dkim/exemple.com.key Sélecteur: mail Algorithme: RSA-SHA256 === Certificats SSL === Utilise: mail.apsi.net (certificat partagé) Ou: mail.exemple.com (certificat dédié) === Tests === Mail-tester.com: 10/10 (date: 2026-01-03) Test DKIM: PASS Test SPF: PASS Test DMARC: PASS === Notes === - Pas de catchall configuré - Filtrage Sieve activé par défaut - Antivirus ClamAV actif via rspamd - Filtrage spam via rspamd
Scripts utiles
Script de diagnostic complet
/root/scripts/mail-diagnostic.sh
Ce script vérifie: - État des services (postfix, dovecot, rspamd, clamav, redis) - Queue mail - Configuration Postfix - Utilisateurs et Maildir - Clés DKIM rspamd - Certificats SSL - Enregistrements DNS - Fail2ban - Espace disque - Erreurs récentes
Test des comptes email
/root/scripts/test-mail-accounts.sh
Teste l’envoi d’emails depuis tous les comptes configurés.
Checklist finale
Avant de considérer le domaine comme “en production”:
- ☐ Domaine ajouté dans MySQL (PostfixAdmin)
- ☐ Clés DKIM générées et configurées dans rspamd
- ☐ Enregistrements DNS configurés (MX, SPF, DKIM, DMARC)
- ☐ DNS propagés et vérifiés avec
dig - ☐ Au moins un compte email créé
- ☐ Test d’envoi réussi (vers Gmail/Outlook)
- ☐ Test de réception réussi (depuis Gmail/Outlook)
- ☐ Signature DKIM vérifiée dans les emails envoyés
- ☐ Score mail-tester.com ≥ 9/10
- ☐ Tests MXToolbox tous verts
- ☐ Certificats SSL configurés (si domaine dédié)
- ☐ Logs vérifiés sans erreurs critiques
Dépannage général
Emails n’arrivent pas
Vérifier que le domaine est dans MySQL:
mysql -u postfixadmin -p postfixadmin -e "SELECT * FROM domain WHERE domain='exemple.com';"
Vérifier les logs Postfix:
tail -100 /var/log/mail.log | grep exemple.com
Vérifier le DNS:
dig +short MX exemple.com
Emails marqués comme spam
Vérifier SPF/DKIM/DMARC avec mail-tester.com
Vérifier que l’IP n’est pas blacklistée: https://mxtoolbox.com/blacklists.aspx
Vérifier les signatures DKIM:
journalctl -u rspamd | grep -i "dkim.*exemple.com"
DKIM ne signe pas
Vérifier que la clé existe et est lisible:
ls -la /etc/rspamd/dkim/exemple.com.key
Vérifier la configuration rspamd:
rspamadm configdump dkim_signing | grep -A 5 exemple.com
Vérifier les logs:
journalctl -u rspamd | grep -i dkim | tail -20
Tester la syntaxe de configuration:
rspamadm configtest
Ressources
- Documentation Postfix: http://www.postfix.org/documentation.html
- Documentation Dovecot: https://doc.dovecot.org/
- Documentation rspamd: https://rspamd.com/doc/
- Test SPF/DKIM/DMARC: https://mail-tester.com
- Test DNS: https://mxtoolbox.com
- Vérification blacklist: https://multirbl.valli.org/
Dernière mise à jour: 2026-01-03 Version: 2.0 (architecture rspamd + ClamAV)