Info:: apsi.net: GUIDE AJOUT DOMAINE
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/virtualexécuté - ☐ Postfix:
systemctl reload postfixexé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 opendkimexécuté - ☐ Test local: email envoyé et reçu
- ☐ Logs: signature DKIM confirmée
Configuration Relay (OVH2)
- ☐ Postfix: domaine ajouté à
relay_domains - ☐ Postfix:
systemctl reload postfixexé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
Vérifier les logs:
grep "nouveau-domaine.com" /var/log/mail.log | tail -20
Vérifier que le domaine est dans mydestination:
postconf mydestinationVérifier le mapping virtual:
postmap -q "contact@nouveau-domaine.com" hash:/etc/postfix/virtual
Vérifier que l’utilisateur existe:
id contact-nouveaudomaine
DKIM non valide
Vérifier que la clé DNS est correcte:
dig +short TXT mail._domainkey.nouveau-domaine.com
Comparer avec la clé générée:
cat /etc/opendkim/keys/nouveau-domaine.com/mail.txtTester la clé:
opendkim-testkey -d nouveau-domaine.com -s mail -vvv
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”
Vérifier que le domaine est dans mydestination OU relay_domains:
postconf mydestination relay_domains
Recharger Postfix après modification:
systemctl reload postfix
Thunderbird ne se connecte pas
Vérifier que vous utilisez le nom Unix (pas l’email):
- ❌ Mauvais:
pchevalier@nouveau-domaine.com - ✅ Bon:
pchevalier-nouveaudomaine
- ❌ Mauvais:
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
- Nommage des utilisateurs Unix:
- Convention:
utilisateur-nomdomaine - Exemples:
pchevalier-nouveaudomaine,contact-nouveaudomaine - Permet de différencier les boîtes mail entre domaines
- Convention:
- 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/
- Certificats SSL:
- Pas obligatoire si vous utilisez mail.apsi.net pour tous les domaines
- Nécessaire seulement si vous voulez mail.nouveau-domaine.com
- Relay backup:
- Ne pas oublier d’ajouter le domaine sur ovh2
- Sinon les emails seront rejetés si ovh1 est down
- 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)