Info:: apsi.net: README SCRIPTS

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:

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

  1. Scripts de Configuration
  2. Scripts de Test
  3. Scripts de Diagnostic
  4. Scripts de Maintenance
  5. 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

  1. /root/scripts/add-domain.sh
  2. Lire /root/scripts/GUIDE_CREATION_DOMAINE.md
  3. Configurer le DNS
  4. Vérifier avec /root/scripts/mail-diagnostic.sh

Pour ajouter un nouveau compte

  1. /root/scripts/add-account.sh
  2. Lire /root/scripts/GUIDE_CREATION_COMPTE.md
  3. Tester avec /root/scripts/test-mail-accounts.sh
  4. Vérifier avec /root/scripts/mail-diagnostic.sh

Pour diagnostiquer un problème

  1. /root/scripts/mail-diagnostic.sh (vue d’ensemble)
  2. /root/scripts/checkOvh1.sh (état des services)
  3. /root/scripts/test-certificates.sh (si problème SSL)
  4. Consulter /var/log/mail.log pour les détails

Pour migrer de MySQL vers fichiers statiques

  1. /root/scripts/import-postfixadmin.sh (exporter de MySQL)
  2. /root/scripts/decouple-mysql.sh (basculer sur fichiers)
  3. Tester l’envoi/réception
  4. Si problème: /root/scripts/couple-mysql.sh (revenir à MySQL)

Pour migrer de fichiers statiques vers MySQL

  1. Créer les domaines avec /root/scripts/add-domain.sh
  2. Créer les comptes avec /root/scripts/add-account.sh
  3. /root/scripts/couple-mysql.sh (basculer sur MySQL)
  4. 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

  1. Configuration réseau et DNS
  2. Installation des services (Postfix, Dovecot, rspamd, ClamAV, MySQL, Apache)
  3. Configuration PostfixAdmin
  4. /root/scripts/couple-mysql.sh (activer MySQL)
  5. /root/scripts/add-domain.sh (ajouter premier domaine)
  6. Configuration DNS (MX, SPF, DKIM, DMARC)
  7. /root/scripts/add-account.sh (ajouter premier compte)
  8. /root/scripts/test-mail-accounts.sh (tester)
  9. /root/scripts/mail-diagnostic.sh (vérifier santé)

Ajout d’un Nouveau Domaine

  1. /root/scripts/add-domain.sh (créer domaine)
  2. Configurer DNS
  3. Attendre propagation DNS (15-30 minutes)
  4. /root/scripts/test-certificates.sh (vérifier SSL si nouveau sous-domaine)
  5. /root/scripts/add-account.sh (créer au moins un compte)
  6. /root/scripts/test-mail-accounts.sh (tester envoi)
  7. Envoyer un test vers Gmail/Outlook
  8. /root/scripts/mail-diagnostic.sh (vérifier tout)

Ajout d’un Nouveau Compte

  1. Vérifier que le domaine existe
  2. /root/scripts/add-account.sh (créer compte)
  3. Configurer client mail (Thunderbird, Outlook, etc.)
  4. Tester envoi et réception
  5. /root/scripts/mail-diagnostic.sh (optionnel)

Diagnostic d’un Problème

  1. /root/scripts/mail-diagnostic.sh (vue d’ensemble)
  2. /root/scripts/checkOvh1.sh (état des services)
  3. Consulter /var/log/mail.log pour détails
  4. Si problème DKIM: vérifier /etc/rspamd/local.d/dkim_signing.conf
  5. Si problème DNS: dig MX domaine.com, dig TXT mail._domainkey.domaine.com
  6. 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