Info:: apsi.net: RESOLUTION MYSQL

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:

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:

  1. ✓ Vérifier permissions: ls -la /etc/postfix/mysql-*.cf → doit être 644 root:postfix
  2. ✓ Vérifier préfixe proxy: postconf virtual_mailbox_domains → doit contenir proxy:mysql:
  3. ✓ Vérifier socket LMTP: ls -la /var/spool/postfix/private/dovecot-lmtp → doit exister avec owner postfix:postfix
  4. ✓ Vérifier mydestination: postconf mydestination → NE doit PAS contenir les domaines virtuels
  5. ✓ Vérifier virtual_mailbox_base: postconf virtual_mailbox_base → doit être /home
  6. ✓ Vérifier virtual_transport: postconf virtual_transport → doit être lmtp:unix:private/dovecot-lmtp
  7. ✓ Test manuel: postmap -q "domain" proxy:mysql:/etc/postfix/mysql-virtual-mailbox-domains.cf
  8. ✓ Vérifier logs: tail -f /var/log/mail.log pendant 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:

  1. Permissions fichiers (644 requis)
  2. Chroot (proxy: requis)
  3. mydestination pollué (nettoyage requis)
  4. virtual_mailbox_base manquant
  5. 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