Info:: apsi.net: GUIDE CREATION DOMAINE

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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

  1. Étapes URGENTES - À faire immédiatement
  2. Étapes IMPORTANTES - À faire dans les 24h
  3. É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

  1. Aller sur https://mail-tester.com

  2. Noter l’adresse email fournie (ex: test-xyz@mail-tester.com)

  3. 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
    
  4. Rafraîchir la page mail-tester.com

  5. 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

  1. Vérifier que le domaine est dans MySQL:

    mysql -u postfixadmin -p postfixadmin -e "SELECT * FROM domain WHERE domain='exemple.com';"
    
  2. Vérifier les logs Postfix:

    tail -100 /var/log/mail.log | grep exemple.com
    
  3. Vérifier le DNS:

    dig +short MX exemple.com
    

Emails marqués comme spam

  1. Vérifier SPF/DKIM/DMARC avec mail-tester.com

  2. Vérifier que l’IP n’est pas blacklistée: https://mxtoolbox.com/blacklists.aspx

  3. Vérifier les signatures DKIM:

    journalctl -u rspamd | grep -i "dkim.*exemple.com"
    

DKIM ne signe pas

  1. Vérifier que la clé existe et est lisible:

    ls -la /etc/rspamd/dkim/exemple.com.key
    
  2. Vérifier la configuration rspamd:

    rspamadm configdump dkim_signing | grep -A 5 exemple.com
    
  3. Vérifier les logs:

    journalctl -u rspamd | grep -i dkim | tail -20
    
  4. Tester la syntaxe de configuration:

    rspamadm configtest
    



Ressources



Dernière mise à jour: 2026-01-03 Version: 2.0 (architecture rspamd + ClamAV)