Info:: apsi.net: GUIDE AJOUT 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 d’Ajout d’un Nouveau Domaine au Serveur Mail

Configuration multi-domaines sur ovh1 + ovh2

Date de création: 02 Janvier 2026 Serveurs: ovh1 (mail.apsi.net) + ovh2 (backup.apsi.net) Domaines existants: apsi.net, voilou.nl



Vue d’ensemble

Ce guide explique comment ajouter un nouveau domaine au serveur mail existant. Exemple utilisé dans ce guide: nouveau-domaine.com

Prérequis

  • Accès root au serveur ovh1 (51.83.2.131)
  • Accès root au serveur ovh2 (51.68.207.177)
  • Accès à la gestion DNS du domaine (PowerAdmin, Gandi, etc.)
  • Le domaine doit pointer vers les serveurs DNS appropriés

Temps estimé

  • Configuration serveur: 30-45 minutes
  • Propagation DNS: 1-24 heures



ÉTAPE 1: Configuration Postfix sur OVH1

1.1 Ajouter le domaine à mydestination

# Éditer la configuration Postfix
nano /etc/postfix/main.cf

Modifier la ligne mydestination pour ajouter le nouveau domaine:

mydestination = $myhostname, apsi.net, voilou.nl, nouveau-domaine.com, localhost

1.2 Créer les alias virtuels

# Éditer le fichier virtual
nano /etc/postfix/virtual

Ajouter les mappings email → utilisateur Unix:

# Domaine nouveau-domaine.com
contact@nouveau-domaine.com        contact-nouveaudomaine
pchevalier@nouveau-domaine.com     pchevalier-nouveaudomaine
info@nouveau-domaine.com           contact-nouveaudomaine
postmaster@nouveau-domaine.com     contact-nouveaudomaine

1.3 Compiler et recharger

# Compiler la table virtuelle
postmap /etc/postfix/virtual

# Tester la configuration
postfix check

# Recharger Postfix
systemctl reload postfix

# Vérifier que le mapping fonctionne
postmap -q "contact@nouveau-domaine.com" hash:/etc/postfix/virtual
# Doit retourner: contact-nouveaudomaine

ÉTAPE 2: Créer les Utilisateurs Unix

2.1 Créer les comptes utilisateurs

# Créer l'utilisateur principal
useradd -m -s /bin/bash pchevalier-nouveaudomaine
echo "pchevalier-nouveaudomaine:mot_de_passe_securise" | chpasswd

# Créer l'utilisateur contact
useradd -m -s /bin/bash contact-nouveaudomaine
echo "contact-nouveaudomaine:mot_de_passe_securise" | chpasswd

2.2 Créer les Maildir

# Se connecter en tant qu'utilisateur et créer le Maildir
su - pchevalier-nouveaudomaine
maildirmake ~/Maildir
exit

su - contact-nouveaudomaine
maildirmake ~/Maildir
exit

# Ou les créer directement (automatique à la réception du 1er email)

2.3 Vérifier les permissions

# Les Maildir doivent appartenir aux utilisateurs
ls -ld /home/pchevalier-nouveaudomaine/Maildir/
ls -ld /home/contact-nouveaudomaine/Maildir/

ÉTAPE 3: Configuration OpenDKIM

3.1 Générer les clés DKIM

# Créer le répertoire pour le domaine
mkdir -p /etc/opendkim/keys/nouveau-domaine.com
cd /etc/opendkim/keys/nouveau-domaine.com

# Générer la clé DKIM 1024 bits (compatible PowerAdmin)
opendkim-genkey -b 1024 -s mail -d nouveau-domaine.com

# Définir les permissions
chown opendkim:opendkim mail.private
chmod 600 mail.private
chmod 644 mail.txt

3.2 Récupérer la clé publique

# Afficher la clé publique pour la configuration DNS
cat /etc/opendkim/keys/nouveau-domaine.com/mail.txt

Exemple de sortie:

mail._domainkey IN  TXT ( "v=DKIM1; h=sha256; k=rsa; "
      "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQ..." )

Format sur une seule ligne (pour DNS):

# Extraire la clé sur une seule ligne
grep -o 'p=.*' /etc/opendkim/keys/nouveau-domaine.com/mail.txt | tr -d '"\t\n '

3.3 Ajouter le domaine dans KeyTable

nano /etc/opendkim/KeyTable

Ajouter:

mail._domainkey.nouveau-domaine.com nouveau-domaine.com:mail:/etc/opendkim/keys/nouveau-domaine.com/mail.private

3.4 Ajouter le domaine dans SigningTable

nano /etc/opendkim/SigningTable

Ajouter:

*@nouveau-domaine.com mail._domainkey.nouveau-domaine.com

3.5 Ajouter le domaine dans TrustedHosts

nano /etc/opendkim/TrustedHosts

Ajouter:

nouveau-domaine.com

3.6 Tester et redémarrer OpenDKIM

# Tester la configuration OpenDKIM
opendkim-testkey -d nouveau-domaine.com -s mail -vvv
# Attendu: "key OK" (ou "key not secure" si DNS pas encore configuré)

# Redémarrer OpenDKIM
systemctl restart opendkim

# Vérifier le statut
systemctl status opendkim

ÉTAPE 4: Configuration du Relay Backup (OVH2)

4.1 Ajouter le domaine aux relay_domains

# Se connecter à ovh2
ssh root@ovh2.pcstreet.org

# Éditer la configuration Postfix
nano /etc/postfix/main.cf

Modifier la ligne relay_domains:

relay_domains = apsi.net, voilou.nl, nouveau-domaine.com

4.2 Recharger Postfix sur ovh2

# Tester la configuration
postfix check

# Recharger
systemctl reload postfix

# Vérifier
postconf relay_domains
# Doit afficher: relay_domains = apsi.net, voilou.nl, nouveau-domaine.com

# Retourner sur ovh1
exit

ÉTAPE 5: Configuration DNS

5.1 Enregistrements MX (Prioritaire)

À ajouter dans votre interface DNS:

Type: MX
Nom: nouveau-domaine.com (ou @)
Priorité: 10
Valeur: mail.apsi.net

Type: MX
Nom: nouveau-domaine.com (ou @)
Priorité: 20
Valeur: backup.apsi.net

5.2 Enregistrement SPF

Type: TXT
Nom: nouveau-domaine.com (ou @)
Valeur: v=spf1 mx ip4:51.83.2.131 ip4:51.68.207.177 ~all

Explication: - v=spf1 : Version SPF - mx : Autorise les serveurs MX du domaine - ip4:51.83.2.131 : Autorise ovh1 - ip4:51.68.207.177 : Autorise ovh2 - ~all : SoftFail pour les autres (marquer comme suspect)

5.3 Enregistrement DKIM

Récupérer la clé publique:

cat /etc/opendkim/keys/nouveau-domaine.com/mail.txt

À ajouter dans DNS:

Type: TXT
Nom: mail._domainkey.nouveau-domaine.com
Valeur: v=DKIM1; h=sha256; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQ...

Note: La clé doit tenir sur une seule ligne. Si PowerAdmin tronque, vérifier que la clé fait moins de 255 caractères (d’où l’utilisation de 1024 bits).

5.4 Enregistrement DMARC

Type: TXT
Nom: _dmarc.nouveau-domaine.com
Valeur: v=DMARC1; p=quarantine; rua=mailto:postmaster@nouveau-domaine.com; ruf=mailto:postmaster@nouveau-domaine.com; fo=1; adkim=r; aspf=r; pct=100

Explication: - p=quarantine : Mettre en quarantaine les emails qui échouent - rua= : Adresse pour les rapports agrégés - ruf= : Adresse pour les rapports forensiques - adkim=r : DKIM en mode relaxed - aspf=r : SPF en mode relaxed

Alternative pour démarrer en mode surveillance:

v=DMARC1; p=none; rua=mailto:postmaster@nouveau-domaine.com; pct=100

5.5 Enregistrement A (si subdomain mail nécessaire)

Optionnel - si vous voulez mail.nouveau-domaine.com:

Type: A
Nom: mail.nouveau-domaine.com
Valeur: 51.83.2.131

Note: Pas strictement nécessaire si vous utilisez mail.apsi.net comme serveur mail principal.



ÉTAPE 6: Certificats SSL/TLS (Optionnel)

6.1 Ajouter le domaine au certificat Let’s Encrypt

Si vous voulez utiliser mail.nouveau-domaine.com:

# Arrêter Apache temporairement
systemctl stop apache2

# Étendre le certificat existant
certbot certonly --standalone \
  -d mail.apsi.net \
  -d mail.voilou.nl \
  -d mail.nouveau-domaine.com \
  --expand

# Redémarrer les services
systemctl start apache2
systemctl reload postfix dovecot

Note: Pas nécessaire si vous continuez à utiliser mail.apsi.net comme serveur SMTP/IMAP pour tous les domaines.



ÉTAPE 7: Vérification et Tests

7.1 Vérifier la configuration Postfix

# Vérifier mydestination
postconf mydestination

# Vérifier les alias virtuels
postmap -q "contact@nouveau-domaine.com" hash:/etc/postfix/virtual

# Vérifier qu'il n'y a pas d'erreurs
postfix check

# Voir les logs en temps réel
tail -f /var/log/mail.log

7.2 Vérifier OpenDKIM

# Tester la clé DKIM (après propagation DNS)
opendkim-testkey -d nouveau-domaine.com -s mail -vvv

# Vérifier les logs
journalctl -u opendkim -n 50

7.3 Test d’envoi local

# Envoyer un email de test
echo "Test depuis ovh1" | sendmail contact@nouveau-domaine.com

# Vérifier la réception
ls -lth /home/contact-nouveaudomaine/Maildir/new/

# Lire le dernier email reçu
cat $(ls -t /home/contact-nouveaudomaine/Maildir/new/ | head -1 | xargs -I {} echo /home/contact-nouveaudomaine/Maildir/new/{})

# Vérifier la signature DKIM dans les logs
grep "DKIM-Signature" /var/log/mail.log | grep "nouveau-domaine.com"

7.4 Test du relay depuis ovh2

# Envoyer depuis ovh2
ssh root@ovh2.pcstreet.org 'echo "Test relay" | sendmail contact@nouveau-domaine.com'

# Vérifier sur ovh1
tail -20 /var/log/mail.log | grep "nouveau-domaine.com"

ÉTAPE 8: Vérification DNS (Après propagation)

8.1 Vérifier les enregistrements

Attendre 1-24h pour la propagation DNS, puis:

# Vérifier MX
dig +short MX nouveau-domaine.com
# Attendu:
# 10 mail.apsi.net.
# 20 backup.apsi.net.

# Vérifier SPF
dig +short TXT nouveau-domaine.com
# Attendu: "v=spf1 mx ip4:51.83.2.131 ip4:51.68.207.177 ~all"

# Vérifier DKIM
dig +short TXT mail._domainkey.nouveau-domaine.com
# Attendu: "v=DKIM1; h=sha256; k=rsa; p=MIGfMA0GCSq..."

# Vérifier DMARC
dig +short TXT _dmarc.nouveau-domaine.com
# Attendu: "v=DMARC1; p=quarantine; rua=mailto:..."

8.2 Tests externes

Envoyer un email de test depuis le nouveau domaine à: - check-auth@verifier.port25.com - postmaster@dkimvalidator.com

Vérifier en ligne: - https://mxtoolbox.com/SuperTool.aspx - https://www.mail-tester.com/



ÉTAPE 9: Configuration Thunderbird

9.1 Ajouter un compte dans Thunderbird

Paramètres IMAP: - Nom d’utilisateur: pchevalier-nouveaudomaine (PAS l’adresse email!) - Serveur IMAP: mail.apsi.net - Port: 143 - Sécurité: STARTTLS - Authentification: Mot de passe normal

Paramètres SMTP: - Nom d’utilisateur: pchevalier-nouveaudomaine - Serveur SMTP: mail.apsi.net - Port: 587 - Sécurité: STARTTLS - Authentification: Mot de passe normal

Identité: - Nom: Votre nom - Adresse email: pchevalier@nouveau-domaine.com - Adresse de réponse: (vide ou identique)

IMPORTANT: Le nom d’utilisateur pour la connexion est le nom Unix (pchevalier-nouveaudomaine), pas l’adresse email!



ÉTAPE 10: Configuration Roundcube (Optionnel)

Aucune modification nécessaire!

Roundcube fonctionne automatiquement avec le nouveau domaine car: - Il utilise %u (nom d’utilisateur fourni) pour IMAP/SMTP - Les utilisateurs se connectent avec leur nom Unix: pchevalier-nouveaudomaine



CHECKLIST DE VALIDATION

Configuration Serveur (OVH1)

  • ☐ Postfix: domaine ajouté à mydestination
  • ☐ Postfix: alias virtuels créés dans /etc/postfix/virtual
  • ☐ Postfix: postmap /etc/postfix/virtual exécuté
  • ☐ Postfix: systemctl reload postfix exécuté
  • ☐ Utilisateurs Unix créés avec mot de passe
  • ☐ Maildir créés pour chaque utilisateur
  • ☐ OpenDKIM: clés générées (1024 bits)
  • ☐ OpenDKIM: domaine ajouté dans KeyTable
  • ☐ OpenDKIM: domaine ajouté dans SigningTable
  • ☐ OpenDKIM: domaine ajouté dans TrustedHosts
  • ☐ OpenDKIM: systemctl restart opendkim exécuté
  • ☐ Test local: email envoyé et reçu
  • ☐ Logs: signature DKIM confirmée

Configuration Relay (OVH2)

  • ☐ Postfix: domaine ajouté à relay_domains
  • ☐ Postfix: systemctl reload postfix exécuté
  • ☐ Test relay: email envoyé depuis ovh2 vers nouveau domaine

Configuration DNS

  • ☐ MX 10: mail.apsi.net
  • ☐ MX 20: backup.apsi.net
  • ☐ TXT: SPF configuré
  • ☐ TXT: DKIM configuré (mail._domainkey)
  • ☐ TXT: DMARC configuré (_dmarc)
  • ☐ Propagation DNS: vérifiée avec dig
  • ☐ Validation externe: mail-tester.com (score > 8/10)
  • ☐ Validation externe: MXToolbox (pas d’erreurs)

Tests Finaux

  • ☐ Envoi email DEPUIS nouveau domaine: OK
  • ☐ Réception email VERS nouveau domaine: OK
  • ☐ Signature DKIM présente: OK
  • ☐ SPF validé: OK
  • ☐ DMARC configuré: OK
  • ☐ Thunderbird: connexion IMAP/SMTP OK
  • ☐ Roundcube: connexion OK (si utilisé)
  • ☐ Relay backup: testé et fonctionnel



DÉPANNAGE

Email non reçu

  1. Vérifier les logs:

    grep "nouveau-domaine.com" /var/log/mail.log | tail -20
    
  2. Vérifier que le domaine est dans mydestination:

    postconf mydestination
    
  3. Vérifier le mapping virtual:

    postmap -q "contact@nouveau-domaine.com" hash:/etc/postfix/virtual
    
  4. Vérifier que l’utilisateur existe:

    id contact-nouveaudomaine
    

DKIM non valide

  1. Vérifier que la clé DNS est correcte:

    dig +short TXT mail._domainkey.nouveau-domaine.com
    
  2. Comparer avec la clé générée:

    cat /etc/opendkim/keys/nouveau-domaine.com/mail.txt
    
  3. Tester la clé:

    opendkim-testkey -d nouveau-domaine.com -s mail -vvv
    
  4. Si la clé est tronquée dans DNS:

    • Régénérer en 1024 bits (au lieu de 2048)
    • La clé doit faire moins de 255 caractères

Erreur “Relay access denied”

  1. Vérifier que le domaine est dans mydestination OU relay_domains:

    postconf mydestination relay_domains
    
  2. Recharger Postfix après modification:

    systemctl reload postfix
    

Thunderbird ne se connecte pas

  1. Vérifier que vous utilisez le nom Unix (pas l’email):

    • ❌ Mauvais: pchevalier@nouveau-domaine.com
    • ✅ Bon: pchevalier-nouveaudomaine
  2. Tester la connexion IMAP manuellement:

    doveadm auth test pchevalier-nouveaudomaine mot_de_passe
    



RÉCAPITULATIF DES FICHIERS MODIFIÉS

Fichier Serveur Modification Commande après
/etc/postfix/main.cf ovh1 Ajouter domaine à mydestination systemctl reload postfix
/etc/postfix/virtual ovh1 Ajouter mappings email→utilisateur postmap virtual && systemctl reload postfix
/etc/opendkim/KeyTable ovh1 Ajouter référence clé DKIM systemctl restart opendkim
/etc/opendkim/SigningTable ovh1 Ajouter mapping domaine→clé systemctl restart opendkim
/etc/opendkim/TrustedHosts ovh1 Ajouter domaine systemctl restart opendkim
/etc/postfix/main.cf ovh2 Ajouter domaine à relay_domains systemctl reload postfix



NOTES IMPORTANTES

  1. Nommage des utilisateurs Unix:
    • Convention: utilisateur-nomdomaine
    • Exemples: pchevalier-nouveaudomaine, contact-nouveaudomaine
    • Permet de différencier les boîtes mail entre domaines
  2. Clés DKIM:
    • Toujours utiliser 1024 bits pour compatibilité PowerAdmin
    • Les clés 2048 bits sont plus sécurisées mais trop longues pour certains DNS
    • Les clés sont stockées dans /etc/opendkim/keys/domaine/
  3. Certificats SSL:
    • Pas obligatoire si vous utilisez mail.apsi.net pour tous les domaines
    • Nécessaire seulement si vous voulez mail.nouveau-domaine.com
  4. Relay backup:
    • Ne pas oublier d’ajouter le domaine sur ovh2
    • Sinon les emails seront rejetés si ovh1 est down
  5. Propagation DNS:
    • Compter 1 à 24 heures
    • Vérifier régulièrement avec dig
    • Les tests externes ne fonctionneront qu’après propagation complète



EXEMPLE COMPLET: Ajout de example.org

# === SUR OVH1 ===

# 1. Postfix
nano /etc/postfix/main.cf
# Ajouter "example.org" à mydestination

echo "contact@example.org    contact-example" >> /etc/postfix/virtual
echo "admin@example.org      admin-example" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix

# 2. Utilisateurs
useradd -m -s /bin/bash contact-example
echo "contact-example:SecurePass123!" | chpasswd
useradd -m -s /bin/bash admin-example
echo "admin-example:SecurePass456!" | chpasswd

# 3. OpenDKIM
mkdir -p /etc/opendkim/keys/example.org
cd /etc/opendkim/keys/example.org
opendkim-genkey -b 1024 -s mail -d example.org
chown opendkim:opendkim mail.private
chmod 600 mail.private

echo "mail._domainkey.example.org example.org:mail:/etc/opendkim/keys/example.org/mail.private" >> /etc/opendkim/KeyTable
echo "*@example.org mail._domainkey.example.org" >> /etc/opendkim/SigningTable
echo "example.org" >> /etc/opendkim/TrustedHosts
systemctl restart opendkim

# 4. Récupérer la clé publique pour DNS
cat /etc/opendkim/keys/example.org/mail.txt

# === SUR OVH2 ===
ssh root@ovh2.pcstreet.org
nano /etc/postfix/main.cf
# Ajouter "example.org" à relay_domains
systemctl reload postfix
exit

# === DANS LE DNS ===
# Ajouter MX, SPF, DKIM, DMARC (voir ÉTAPE 5)

# === TEST ===
echo "Test" | sendmail contact@example.org
ls -lth /home/contact-example/Maildir/new/
tail -f /var/log/mail.log

Guide créé le: 02 Janvier 2026 Auteur: Configuration Claude + PC Serveurs: ovh1 (mail.apsi.net) + ovh2 (backup.apsi.net)