Info:: apsi.net: RESOLUTION MYSQL
KEYWORDS: MAIL, SERVER, APSI.NET, OVH1, MAIL.APSI.NET, OVH2, BACKUP.APSI.NET
Le 04/01/2026:
Résolution du Problème MySQL avec Postfix
Date: 03 Janvier 2026 Serveur: ovh1 (mail.apsi.net) Statut: ✅ RÉSOLU
Symptôme Initial
postfix/cleanup: warning: mysql:/etc/postfix/mysql-virtual-alias-maps.cf lookup error postfix/cleanup: warning: virtual_alias_maps map lookup problem
Les lookups MySQL manuels (postmap -q) fonctionnaient, mais Postfix échouait lors de la livraison réelle.
Causes Identifiées
1. Permissions Insuffisantes sur les Fichiers MySQL
Problème: Les fichiers /etc/postfix/mysql-*.cf avaient des permissions 640 avec root:root, rendant impossible leur lecture par les processus Postfix non-privilégiés (qui s’exécutent sous l’utilisateur nobody).
Solution:
chmod 644 /etc/postfix/mysql-*.cf
chgrp postfix /etc/postfix/mysql-*.cf
2. Services Postfix en Chroot Sans Accès au Socket MySQL
Problème: Les services Postfix (cleanup, trivial-rewrite, etc.) s’exécutent dans un chroot à /var/spool/postfix et ne peuvent pas accéder au socket MySQL situé à /run/mysqld/mysqld.sock.
Solution: Utiliser le service proxymap de Postfix, qui n’est PAS en chroot et peut accéder au socket MySQL, puis proxyfie les requêtes pour les autres services.
Configuration:
postconf -e "virtual_alias_maps = proxy:mysql:/etc/postfix/mysql-virtual-alias-maps.cf, hash:/etc/postfix/virtual"
postconf -e "virtual_mailbox_maps = proxy:mysql:/etc/postfix/mysql-virtual-mailbox-maps.cf"
postconf -e "virtual_mailbox_domains = proxy:mysql:/etc/postfix/mysql-virtual-mailbox-domains.cf"
Note: Le préfixe proxy: est ESSENTIEL pour le fonctionnement avec services chroot.
3. Domaines Virtuels dans mydestination
Problème: Les domaines virtuels (apsi.net, voilou.nl, thabard.com) étaient listés dans mydestination, ce qui forçait Postfix à les traiter comme des domaines locaux au lieu de domaines virtuels gérés par MySQL.
Résultat: “unknown user” car Postfix cherchait des utilisateurs Unix locaux au lieu d’utiliser les mailboxes virtuelles.
Solution:
postconf -e "mydestination = \$myhostname, localhost"
Les domaines virtuels doivent être UNIQUEMENT dans virtual_mailbox_domains (géré par MySQL), PAS dans mydestination.
4. virtual_mailbox_base Non Configuré
Problème: Le paramètre virtual_mailbox_base était vide, causant:
postfix/virtual: fatal: bad string length 0 < 1: virtual_mailbox_base =
Solution:
postconf -e "virtual_mailbox_base = /home"
5. Absence de virtual_uid_maps/virtual_gid_maps
Problème: Le virtual delivery agent de Postfix nécessite virtual_uid_maps et virtual_gid_maps pour savoir sous quels UID/GID Unix livrer les emails.
Erreur:
postfix/virtual: warning: recipient contact@thabard.com: not found in virtual_uid_maps
Solution: Au lieu de configurer des mappings UID/GID complexes, utiliser Dovecot LMTP pour la livraison, qui gère automatiquement les permissions Unix.
Configuration Dovecot LMTP
Fichier: /etc/dovecot/conf.d/10-master.conf
service lmtp {
unix_listener /var/spool/postfix/private/dovecot-lmtp {
mode = 0600
user = postfix
group = postfix
}
}
Postfix:
postconf -e "virtual_transport = lmtp:unix:private/dovecot-lmtp"
Avantages: - Dovecot gère automatiquement les UIDs/GIDs via la base MySQL - Dovecot authentifie les utilisateurs et connaît leurs répertoires home - Pas besoin de virtual_uid_maps/virtual_gid_maps séparés - Meilleure intégration IMAP/POP3 puisque Dovecot gère à la fois la livraison et l’accès
Configuration Finale
/etc/postfix/main.cf
# Domaines virtuels via MySQL avec proxymap virtual_mailbox_domains = proxy:mysql:/etc/postfix/mysql-virtual-mailbox-domains.cf virtual_mailbox_maps = proxy:mysql:/etc/postfix/mysql-virtual-mailbox-maps.cf virtual_alias_maps = proxy:mysql:/etc/postfix/mysql-virtual-alias-maps.cf, hash:/etc/postfix/virtual # Livraison via Dovecot LMTP virtual_transport = lmtp:unix:private/dovecot-lmtp virtual_mailbox_base = /home # Domaines locaux uniquement (PAS de domaines virtuels) mydestination = $myhostname, localhost
/etc/postfix/mysql-virtual-alias-maps.cf
user = postfixadmin password = fromspace hosts = unix:/run/mysqld/mysqld.sock dbname = postfixadmin query = SELECT goto FROM alias WHERE address='%s' AND active='1'
Permissions: 644 root:postfix
/etc/dovecot/conf.d/10-master.conf
service lmtp {
unix_listener /var/spool/postfix/private/dovecot-lmtp {
mode = 0600
user = postfix
group = postfix
}
}
Tests de Validation
1. Test Lookup Domaine
postmap -q "thabard.com" proxy:mysql:/etc/postfix/mysql-virtual-mailbox-domains.cf
# Doit retourner: thabard.com
2. Test Lookup Mailbox
postmap -q "contact@thabard.com" proxy:mysql:/etc/postfix/mysql-virtual-mailbox-maps.cf
# Doit retourner: contact.thabard.com/
3. Test Lookup Alias
postmap -q "contact@thabard.com" proxy:mysql:/etc/postfix/mysql-virtual-alias-maps.cf
# Doit retourner: contact@thabard.com
4. Test Livraison Complète
echo "Test MySQL + LMTP" | mail -s "Test" contact@thabard.com
sleep 3
ls -l /home/contact.thabard.com/Maildir/new/
tail -20 /var/log/mail.log | grep "status=sent"
Résultat attendu:
postfix/lmtp[...]: to=<contact@thabard.com>, relay=mail.apsi.net[private/dovecot-lmtp], delay=X, dsn=2.0.0, status=sent (250 2.0.0 <contact@thabard.com> ... Saved) dovecot: lmtp(contact.thabard.com): msgid=...: saved mail to INBOX
5. Vérifier Queue Vide
mailq
# Doit retourner: Mail queue is empty
Résumé des Fichiers Modifiés
| Fichier | Modification | Raison |
|---|---|---|
/etc/postfix/main.cf
|
Ajout de proxy: aux lookups MySQL
|
Contourner le chroot |
/etc/postfix/main.cf
|
virtual_transport = lmtp:unix:private/dovecot-lmtp
|
Utiliser Dovecot pour livraison |
/etc/postfix/main.cf
|
virtual_mailbox_base = /home
|
Définir le répertoire de base |
/etc/postfix/main.cf
|
mydestination = $myhostname, localhost
|
Retirer domaines virtuels |
/etc/postfix/mysql-*.cf
|
chmod 644 et chgrp postfix
|
Permissions de lecture |
/etc/dovecot/conf.d/10-master.conf
|
Configuration socket LMTP | Accès depuis Postfix |
/root/scripts/couple-mysql.sh
|
Intégration de toutes les corrections | Automatisation |
Checklist de Diagnostic en Cas de Problème
Si les lookups MySQL échouent:
- ✓ Vérifier permissions:
ls -la /etc/postfix/mysql-*.cf→ doit être644 root:postfix - ✓ Vérifier préfixe proxy:
postconf virtual_mailbox_domains→ doit contenirproxy:mysql: - ✓ Vérifier socket LMTP:
ls -la /var/spool/postfix/private/dovecot-lmtp→ doit exister avec ownerpostfix:postfix - ✓ Vérifier mydestination:
postconf mydestination→ NE doit PAS contenir les domaines virtuels - ✓ Vérifier virtual_mailbox_base:
postconf virtual_mailbox_base→ doit être/home - ✓ Vérifier virtual_transport:
postconf virtual_transport→ doit êtrelmtp:unix:private/dovecot-lmtp - ✓ Test manuel:
postmap -q "domain" proxy:mysql:/etc/postfix/mysql-virtual-mailbox-domains.cf - ✓ Vérifier logs:
tail -f /var/log/mail.logpendant l’envoi de test
Avantages de MySQL vs Fichiers Plats
Avec MySQL (PostfixAdmin)
✅ Gestion Centralisée - Interface web pour créer/modifier comptes - Pas besoin de postmap après chaque modification - Changements instantanés
✅ Multi-Administrateurs - Plusieurs admins peuvent gérer différents domaines - Délégation de gestion par domaine
✅ Quotas et Statistiques - Gestion des quotas par mailbox - Statistiques d’utilisation - Logs d’activité
✅ Scalabilité - Gestion de centaines/milliers de domaines facilement - Pas de recompilation de maps
✅ Intégration - Dovecot utilise la même base - Synchronisation automatique IMAP/SMTP - Mots de passe uniques
Avec Fichiers Plats
✅ Simplicité - Pas de dépendance MySQL - Configuration visible directement
❌ Limitations - postmap requis après chaque modification - Pas d’interface graphique - Difficile à gérer avec beaucoup de domaines - Pas de quotas - Pas de statistiques
Conclusion
Le problème MySQL était dû à une combinaison de 5 problèmes de configuration qui se sont cumulés:
- Permissions fichiers (644 requis)
- Chroot (proxy: requis)
- mydestination pollué (nettoyage requis)
- virtual_mailbox_base manquant
- Livraison sans UID/GID maps (Dovecot LMTP requis)
Solution complète appliquée avec succès: ✅ Tous les emails sont maintenant livrés via MySQL → Dovecot LMTP ✅ Queue mail vide ✅ Logs propres, pas d’erreurs ✅ Scripts mis à jour pour éviter ces problèmes à l’avenir