Info:: apsi.net: README SCRIPTS
KEYWORDS: MAIL, SERVER, APSI.NET, OVH1, MAIL.APSI.NET, OVH2, BACKUP.APSI.NET
Le 04/01/2026:
Index des Scripts - Serveur Mail
Serveur: ovh1 (mail.apsi.net) Architecture: Postfix + Dovecot + rspamd + ClamAV Dernière mise à jour: 2026-01-03
Ce document liste tous les scripts disponibles pour la gestion du serveur mail, organisés par catégorie.
Table des matières
- Scripts de Configuration
- Scripts de Test
- Scripts de Diagnostic
- Scripts de Maintenance
- Guides de Documentation
Scripts de Configuration
add-domain.sh
Description: Ajoute un nouveau domaine au serveur mail.
Utilisation:
/root/scripts/add-domain.sh
Ce que fait le script: - Ajoute le domaine dans PostfixAdmin (MySQL) - Génère les clés DKIM pour rspamd - Configure la signature DKIM dans rspamd - Affiche les enregistrements DNS à configurer - Fournit les instructions de vérification
Requis: - Accès root au serveur - MySQL accessible
Voir aussi: /root/scripts/GUIDE_CREATION_DOMAINE.md
add-account.sh
Description: Crée un nouveau compte email sur un domaine existant.
Utilisation:
# Mode interactif
/root/scripts/add-account.sh
# Mode direct
/root/scripts/add-account.sh contact@exemple.com "MotDePasse123!"
Ce que fait le script: - Crée le compte dans PostfixAdmin (MySQL) - Crée la structure Maildir - Configure les permissions (vmail 5000:5000) - Teste la livraison des emails - Affiche les paramètres de connexion IMAP/SMTP
Requis: - Le domaine doit exister dans MySQL - Accès root au serveur
Voir aussi: /root/scripts/GUIDE_CREATION_COMPTE.md
couple-mysql.sh
Description: Active l’utilisation de MySQL pour la résolution des domaines et mailboxes.
Utilisation:
/root/scripts/couple-mysql.sh
Ce que fait le script: - Modifie /etc/postfix/main.cf pour utiliser les lookups MySQL - Configure virtual_mailbox_domains, virtual_mailbox_maps, virtual_alias_maps - Recharge Postfix - Teste la configuration
Requis: - Fichiers de configuration MySQL présents dans /etc/postfix/ - MySQL accessible
Inverse: decouple-mysql.sh
decouple-mysql.sh
Description: Désactive l’utilisation de MySQL et revient aux fichiers statiques.
Utilisation:
/root/scripts/decouple-mysql.sh
Ce que fait le script: - Modifie /etc/postfix/main.cf pour utiliser les fichiers statiques - Sauvegarde la configuration MySQL - Recharge Postfix - Vérifie le fonctionnement
Requis: - Fichiers statiques présents (/etc/postfix/virtual, etc.)
Inverse: couple-mysql.sh
Scripts de Test
test-mail-accounts.sh
Description: Teste l’envoi d’emails depuis tous les comptes configurés.
Utilisation:
/root/scripts/test-mail-accounts.sh
Ce que fait le script: - Lit tous les comptes depuis MySQL (PostfixAdmin) - Envoie un email de test depuis chaque compte - Vérifie la livraison - Affiche un rapport de réussite/échec
Requis: - MySQL accessible - Comptes existants dans PostfixAdmin
Sortie: Rapport des tests pour chaque compte
test-certificates.sh
Description: Vérifie tous les certificats SSL/TLS du serveur.
Utilisation:
/root/scripts/test-certificates.sh
Ce que fait le script: - Teste les certificats pour IMAP (993), POP3 (995), SMTP (587, 465) - Vérifie la date d’expiration - Affiche les domaines couverts - Signale les certificats expirés ou proches de l’expiration
Requis: - Certificats Let’s Encrypt configurés - Ports SSL/TLS accessibles
Sortie: État des certificats avec dates d’expiration
checkOvh1.sh
Description: Vérifie l’état complet du serveur ovh1.
Utilisation:
/root/scripts/checkOvh1.sh
Ce que fait le script: - Vérifie l’état des services (Postfix, Dovecot, rspamd, ClamAV, Redis, Apache, MySQL, Fail2ban) - Teste la connectivité réseau - Vérifie les certificats SSL - Teste l’envoi et la réception d’emails - Affiche un rapport d’état complet
Requis: - Accès root au serveur
Sortie: Rapport d’état complet du serveur
Scripts de Diagnostic
mail-diagnostic.sh
Description: Génère un rapport de diagnostic complet du serveur mail.
Utilisation:
/root/scripts/mail-diagnostic.sh
Ce que fait le script: - Vérifie l’état de tous les services (postfix, dovecot, rspamd, redis, apache, fail2ban, clamav-daemon) - Affiche l’état de la queue mail - Liste la configuration Postfix - Affiche les utilisateurs mail et leur utilisation - Vérifie les clés DKIM (rspamd) - Contrôle les certificats SSL - Teste les enregistrements DNS (MX, SPF, DKIM, DMARC) - Vérifie Fail2ban - Affiche l’espace disque - Liste les erreurs récentes dans les logs - Calcule un score de santé global - Fournit des recommandations
Requis: - Accès root au serveur
Sortie: Rapport complet avec score de santé et recommandations
Architecture: Mis à jour pour rspamd + ClamAV (version 2.0)
import-postfixadmin.sh
Description: Importe les données de PostfixAdmin dans les fichiers Postfix statiques.
Utilisation:
/root/scripts/import-postfixadmin.sh
Ce que fait le script: - Lit les domaines depuis MySQL - Lit les mailboxes depuis MySQL - Lit les alias depuis MySQL - Génère /etc/postfix/virtual_domains - Génère /etc/postfix/virtual_mailboxes - Génère /etc/postfix/virtual_aliases - Exécute postmap sur les fichiers générés
Requis: - MySQL accessible - PostfixAdmin configuré
Usage: Pour migration de MySQL vers fichiers statiques
Scripts de Maintenance
renew-certificates.sh
Description: Renouvelle les certificats SSL/TLS Let’s Encrypt.
Utilisation:
/root/scripts/renew-certificates.sh
Ce que fait le script: - Arrête Apache temporairement - Exécute certbot renew - Redémarre Apache - Recharge Dovecot et Postfix - Vérifie que les certificats sont bien renouvelés
Requis: - Certbot installé - Ports 80/443 accessibles
Note: Peut aussi être exécuté automatiquement via cron
mail-diagnostic.sh (mode maintenance)
Description: Même script que le diagnostic, mais peut être utilisé pour la maintenance.
Usage typique en maintenance:
# Avant maintenance
/root/scripts/mail-diagnostic.sh > /root/logs/diagnostic-avant-$(date +%Y%m%d).log
# Après maintenance
/root/scripts/mail-diagnostic.sh > /root/logs/diagnostic-apres-$(date +%Y%m%d).log
# Comparer
diff /root/logs/diagnostic-avant-*.log /root/logs/diagnostic-apres-*.log
Guides de Documentation
GUIDE_CREATION_DOMAINE.md
Description: Guide complet pour créer un nouveau domaine mail.
Contenu: - Prérequis et vérifications - Création du domaine dans MySQL - Génération des clés DKIM pour rspamd - Configuration des enregistrements DNS (MX, SPF, DKIM, DMARC) - Tests de vérification - Configuration SSL (optionnel) - Troubleshooting
Ordre: Du plus urgent au moins urgent
Lire: /root/scripts/GUIDE_CREATION_DOMAINE.md
GUIDE_CREATION_COMPTE.md
Description: Guide complet pour créer un nouveau compte email.
Contenu: - Prérequis (domaine doit exister) - Création du compte dans MySQL - Création de la structure Maildir - Tests de réception et d’envoi - Configuration IMAP/SMTP - Vérification DKIM - Configuration avancée (quota, alias, Sieve, etc.) - Troubleshooting
Ordre: Du plus urgent au moins urgent
Lire: /root/scripts/GUIDE_CREATION_COMPTE.md
RESOLUTION_MYSQL.md (si existant)
Description: Guide pour résoudre les problèmes liés à MySQL et PostfixAdmin.
Contenu (typique): - Connexion à MySQL - Vérification des tables PostfixAdmin - Dépannage des lookups Postfix - Réparation de la base de données
Scripts par Usage
Pour ajouter un nouveau domaine
/root/scripts/add-domain.sh- Lire
/root/scripts/GUIDE_CREATION_DOMAINE.md - Configurer le DNS
- Vérifier avec
/root/scripts/mail-diagnostic.sh
Pour ajouter un nouveau compte
/root/scripts/add-account.sh- Lire
/root/scripts/GUIDE_CREATION_COMPTE.md - Tester avec
/root/scripts/test-mail-accounts.sh - Vérifier avec
/root/scripts/mail-diagnostic.sh
Pour diagnostiquer un problème
/root/scripts/mail-diagnostic.sh(vue d’ensemble)/root/scripts/checkOvh1.sh(état des services)/root/scripts/test-certificates.sh(si problème SSL)- Consulter
/var/log/mail.logpour les détails
Pour migrer de MySQL vers fichiers statiques
/root/scripts/import-postfixadmin.sh(exporter de MySQL)/root/scripts/decouple-mysql.sh(basculer sur fichiers)- Tester l’envoi/réception
- Si problème:
/root/scripts/couple-mysql.sh(revenir à MySQL)
Pour migrer de fichiers statiques vers MySQL
- Créer les domaines avec
/root/scripts/add-domain.sh - Créer les comptes avec
/root/scripts/add-account.sh /root/scripts/couple-mysql.sh(basculer sur MySQL)- Tester avec
/root/scripts/test-mail-accounts.sh
Scripts qui Utilisent MySQL
Les scripts suivants interrogent directement la base de données MySQL (PostfixAdmin):
- add-domain.sh - Ajoute des domaines dans MySQL
- add-account.sh - Ajoute des mailboxes dans MySQL
- test-mail-accounts.sh - Lit les comptes depuis MySQL pour les tester
- import-postfixadmin.sh - Lit MySQL pour exporter vers fichiers statiques
- mail-diagnostic.sh - Peut interroger MySQL pour afficher des stats (si couplé)
Configuration MySQL:
# Fichiers de configuration
/etc/postfix/mysql-virtual-mailbox-domains.cf
/etc/postfix/mysql-virtual-mailbox-maps.cf
/etc/postfix/mysql-virtual-alias-maps.cf
# Credentials
user = postfixadmin
password = fromspace
dbname = postfixadmin
hosts = 127.0.0.1
Scripts qui Modifient la Configuration
Les scripts suivants modifient des fichiers de configuration système:
- add-domain.sh - Modifie
/etc/rspamd/local.d/dkim_signing.conf - add-account.sh - Crée des répertoires Maildir
- couple-mysql.sh - Modifie
/etc/postfix/main.cf - decouple-mysql.sh - Modifie
/etc/postfix/main.cf - import-postfixadmin.sh - Génère
/etc/postfix/virtual*files
Sauvegarde recommandée avant modifications:
# Sauvegarder configuration Postfix
cp -a /etc/postfix /etc/postfix.backup-$(date +%Y%m%d)
# Sauvegarder configuration rspamd
cp -a /etc/rspamd /etc/rspamd.backup-$(date +%Y%m%d)
# Sauvegarder MySQL
mysqldump -u postfixadmin -p postfixadmin > /root/backups/postfixadmin-$(date +%Y%m%d).sql
Services Concernés
Les scripts interagissent avec les services suivants:
Postfix (MTA)
- Scripts: add-domain.sh, add-account.sh, couple-mysql.sh, decouple-mysql.sh, test-mail-accounts.sh, mail-diagnostic.sh
- Ports: 25 (SMTP), 587 (Submission), 465 (SMTPS)
Dovecot (IMAP/POP3)
- Scripts: add-account.sh, test-mail-accounts.sh, mail-diagnostic.sh, test-certificates.sh
- Ports: 993 (IMAPS), 995 (POP3S), 143 (IMAP), 110 (POP3)
rspamd (Spam + DKIM)
- Scripts: add-domain.sh, mail-diagnostic.sh
- Ports: 11334 (Web interface), 11332 (Controller)
- Configuration:
/etc/rspamd/local.d/dkim_signing.conf
ClamAV (Antivirus)
- Scripts: mail-diagnostic.sh, checkOvh1.sh
- Socket:
/var/run/clamav/clamd.ctl
Redis (Cache rspamd)
- Scripts: mail-diagnostic.sh, checkOvh1.sh
- Port: 6379
MySQL/MariaDB (PostfixAdmin)
- Scripts: add-domain.sh, add-account.sh, test-mail-accounts.sh, couple-mysql.sh, import-postfixadmin.sh
- Port: 3306
- Database: postfixadmin
Apache (Webmail si installé)
- Scripts: test-certificates.sh, renew-certificates.sh, checkOvh1.sh
- Ports: 80 (HTTP), 443 (HTTPS)
Fail2ban (Protection)
- Scripts: mail-diagnostic.sh, checkOvh1.sh
- Configuration:
/etc/fail2ban/jail.conf
Ordre d’Exécution Typique
Première Installation
- Configuration réseau et DNS
- Installation des services (Postfix, Dovecot, rspamd, ClamAV, MySQL, Apache)
- Configuration PostfixAdmin
/root/scripts/couple-mysql.sh(activer MySQL)/root/scripts/add-domain.sh(ajouter premier domaine)- Configuration DNS (MX, SPF, DKIM, DMARC)
/root/scripts/add-account.sh(ajouter premier compte)/root/scripts/test-mail-accounts.sh(tester)/root/scripts/mail-diagnostic.sh(vérifier santé)
Ajout d’un Nouveau Domaine
/root/scripts/add-domain.sh(créer domaine)- Configurer DNS
- Attendre propagation DNS (15-30 minutes)
/root/scripts/test-certificates.sh(vérifier SSL si nouveau sous-domaine)/root/scripts/add-account.sh(créer au moins un compte)/root/scripts/test-mail-accounts.sh(tester envoi)- Envoyer un test vers Gmail/Outlook
/root/scripts/mail-diagnostic.sh(vérifier tout)
Ajout d’un Nouveau Compte
- Vérifier que le domaine existe
/root/scripts/add-account.sh(créer compte)- Configurer client mail (Thunderbird, Outlook, etc.)
- Tester envoi et réception
/root/scripts/mail-diagnostic.sh(optionnel)
Diagnostic d’un Problème
/root/scripts/mail-diagnostic.sh(vue d’ensemble)/root/scripts/checkOvh1.sh(état des services)- Consulter
/var/log/mail.logpour détails - Si problème DKIM: vérifier
/etc/rspamd/local.d/dkim_signing.conf - Si problème DNS:
dig MX domaine.com,dig TXT mail._domainkey.domaine.com - Si problème SSL:
/root/scripts/test-certificates.sh
Logs Importants
Postfix
/var/log/mail.log # Tous les logs mail
grep postfix /var/log/mail.log # Logs Postfix uniquement
tail -f /var/log/mail.log # Suivi en temps réel
Dovecot
journalctl -u dovecot # Logs Dovecot
journalctl -u dovecot -f # Suivi en temps réel
rspamd
journalctl -u rspamd # Logs rspamd
journalctl -u rspamd | grep -i dkim # Logs DKIM
ClamAV
journalctl -u clamav-daemon # Logs ClamAV
MySQL
journalctl -u mysql # Logs MySQL
/var/log/mysql/error.log # Erreurs MySQL
Commandes Utiles
Postfix
postqueue -p # Afficher la queue
postqueue -f # Forcer l'envoi de la queue
postsuper -d ALL # Vider la queue (prudence!)
postconf virtual_mailbox_domains # Afficher configuration
postmap -q "domaine.com" proxy:mysql:/etc/postfix/mysql-virtual-mailbox-domains.cf # Test lookup MySQL
Dovecot
doveadm auth test user@domain.com password # Tester authentification
doveadm quota get -u user@domain.com # Afficher quota
doveadm mailbox list -u user@domain.com # Lister boîtes mail
rspamd
rspamadm configtest # Tester configuration
rspamadm configdump dkim_signing # Afficher config DKIM
rspamc stat # Statistiques rspamd
MySQL
mysql -u postfixadmin -p postfixadmin # Se connecter
mysql -u postfixadmin -p postfixadmin -e "SELECT * FROM domain;" # Lister domaines
mysql -u postfixadmin -p postfixadmin -e "SELECT username, active FROM mailbox;" # Lister comptes
DNS
dig MX domaine.com +short # Vérifier MX
dig TXT domaine.com +short # Vérifier SPF
dig TXT mail._domainkey.domaine.com +short # Vérifier DKIM
dig TXT _dmarc.domaine.com +short # Vérifier DMARC
Maintenance Régulière
Quotidien (Automatique via Cron)
- Renouvellement certificats SSL (certbot renew)
- Nettoyage logs anciens
- Mise à jour définitions ClamAV
Hebdomadaire (Recommandé)
/root/scripts/mail-diagnostic.sh > /root/logs/diagnostic-$(date +%Y%m%d).log
/root/scripts/test-certificates.sh
Mensuel (Recommandé)
# Vérifier espace disque Maildir
du -sh /home/*/Maildir | sort -h
# Vérifier comptes inactifs
mysql -u postfixadmin -p postfixadmin -e "SELECT username, modified FROM mailbox ORDER BY modified ASC LIMIT 10;"
# Backup MySQL
mysqldump -u postfixadmin -p postfixadmin > /root/backups/postfixadmin-$(date +%Y%m%d).sql
Support et Contact
Documentation complète: - /root/scripts/GUIDE_CREATION_DOMAINE.md - /root/scripts/GUIDE_CREATION_COMPTE.md - /root/scripts/README_SCRIPTS.md (ce fichier)
Logs et Diagnostic:
/root/scripts/mail-diagnostic.sh # Script principal de diagnostic
/var/log/mail.log # Logs mail
journalctl -u dovecot # Logs Dovecot
journalctl -u rspamd # Logs rspamd
Sites utiles: - https://mail-tester.com - Tester réputation email - https://mxtoolbox.com - Vérifier DNS et blacklists - https://dkimvalidator.com - Vérifier signature DKIM
Version: 2.0 (architecture rspamd + ClamAV) Dernière mise à jour: 2026-01-03