Info:: apsi.net: README-SCRIPTS
KEYWORDS: MAIL, SERVER, APSI.NET, OVH1, MAIL.APSI.NET, OVH2, BACKUP.APSI.NET
Le 04/01/2026:
Documentation des Scripts - Serveur Mail
Répertoire: /root/scripts/ Serveurs: ovh1 (mail.apsi.net) + ovh2 (backup.apsi.net) Dernière mise à jour: 02 Janvier 2026
Vue d’Ensemble
Ce répertoire contient tous les scripts d’administration, de diagnostic et de maintenance du serveur mail.
Scripts par Catégorie
| Catégorie | Scripts | Usage |
|---|---|---|
| Diagnostic | checkOvh1.sh, checkOvh2.sh, mail-diagnostic.sh, test-certificates.sh | Quotidien |
| Maintenance | renew-certificates.sh, rename-accounts.sh | Périodique |
Scripts de Diagnostic
checkOvh1.sh ⭐
Serveur: ovh1 (mail.apsi.net) Fréquence: Quotidien (automatique via cron) Fonction: Diagnostic complet du serveur mail principal avec envoi par email
Ce qu’il fait: - Exécute mail-diagnostic.sh (état des services, queue, configuration, utilisateurs, DKIM, SSL, DNS, fail2ban, disque, erreurs) - Exécute test-certificates.sh (expiration, domaines couverts, tests SMTP/IMAPS/HTTPS) - Supprime les codes couleur ANSI pour l’email - Génère un rapport unifié - Envoie le rapport à pchevalier@pcstreet.fr - Sauvegarde dans /var/log/check-ovh1/ - Nettoie les rapports > 30 jours
Utilisation:
# Exécution manuelle
/root/scripts/checkOvh1.sh
# Cron (quotidien à 7h)
0 7 * * * /root/scripts/checkOvh1.sh
Rapports générés: - /var/log/check-ovh1/check-ovh1-YYYYMMDD-HHMMSS.txt
Score de santé typique: - Mail: 80-90/90 (88-100%) - SSL: 100/100 (100%)
Actions si score < 80%: 1. Consulter le rapport email 2. Vérifier la section “RECOMMANDATIONS” 3. Consulter /var/log/mail.log pour détails
checkOvh2.sh ⭐
Serveur: ovh2 (backup.apsi.net) Fréquence: Quotidien (automatique via cron) Fonction: Diagnostic du serveur relay backup avec envoi par email
Ce qu’il fait: - Vérifie l’état des services (postfix, fail2ban) - Surveille la queue relay - Teste la configuration relay (relay_domains, relay_transport) - Vérifie la connectivité vers ovh1 (DNS, SMTP port 25, ping) - Statistiques de relay depuis les logs - Supprime les codes couleur pour l’email - Génère un rapport unifié - Envoie le rapport à pchevalier@pcstreet.fr - Sauvegarde dans /var/log/check-ovh2/
Utilisation:
# Exécution manuelle sur ovh2
ssh root@ovh2.pcstreet.org "/root/scripts/checkOvh2.sh"
# Ou directement sur ovh2
/root/scripts/checkOvh2.sh
# Cron sur ovh2 (quotidien à 7h)
0 7 * * * /root/scripts/checkOvh2.sh
Rapports générés: - /var/log/check-ovh2/check-ovh2-YYYYMMDD-HHMMSS.txt
Score de santé typique: - Relay: 90-100/100 (90-100%)
Alertes critiques: - ✗ Impossible de joindre ovh1 sur le port 25 - ✗ Queue > 10 emails - ✗ Domaines relay non configurés
mail-diagnostic.sh
Serveur: ovh1 Fonction: Diagnostic détaillé du serveur mail (utilisé par checkOvh1.sh)
10 sections de diagnostic:
- État des services
- postfix, dovecot, opendkim, apache2, fail2ban
- Statut: ✓ OK / ✗ ERREUR
- Queue Mail
- Nombre d’emails en attente
- ✓ < 10 emails / ⚠ 10-100 / ✗ > 100
- Configuration Postfix
- Domaines gérés (mydestination)
- Liste complète des alias virtuels
- Total d’alias configurés
- Utilisateurs Mail
- Liste tous les comptes avec Maildir
- Taille de chaque boîte
- Nombre d’emails par compte
- DKIM (OpenDKIM)
- Statut de chaque domaine
- Affiche les clés publiques DKIM complètes
- Test avec
opendkim-testkey
- Certificats SSL
- Date d’expiration
- Jours restants
- Alerte à 3 niveaux:
- ✓ > 30 jours (OK)
- ⚠ 7-30 jours (ATTENTION)
- ✗ < 7 jours (URGENT)
- Liste des domaines couverts
- Enregistrements DNS
- Pour chaque domaine: MX, SPF, DKIM, DMARC
- Vérification avec
dig
- Fail2ban
- Statut de chaque jail
- Nombre d’IP bannies
- Espace Disque
- Utilisation partition racine
- Alertes si > 80%
- Erreurs Récentes
- Dernières 100 lignes de /var/log/mail.log
- Filtrage des erreurs/warnings
Scoring: - Services: 5 points × 5 = 25 points - Queue: 10 points - Certificat: 15 points - DNS: 20 points (10 par domaine) - Disque: 10 points - Erreurs: 10 points - Total: 90 points
Utilisation:
# Diagnostic complet
/root/scripts/mail-diagnostic.sh
# Avec couleurs pour terminal
/root/scripts/mail-diagnostic.sh
# Sans couleurs (pour logs)
/root/scripts/mail-diagnostic.sh | sed 's/\x1b\[[0-9;]*m//g'
test-certificates.sh
Serveur: ovh1 Fonction: Tests complets des certificats SSL/TLS (utilisé par checkOvh1.sh)
8 sections de test:
- Expiration
- Date d’expiration
- Jours restants
- Statut: ✓ > 30j / ⚠ 7-30j / ✗ < 7j
- Domaines Couverts
- Liste tous les SAN du certificat
- Vérifie mail.apsi.net et mail.voilou.nl
- Émetteur
- Vérifie que c’est Let’s Encrypt
- Test SMTP (port 587 - STARTTLS)
- Test sur mail.apsi.net
- Test sur mail.voilou.nl
- Vérification du certificat présenté
- Test IMAPS (port 993)
- Test sur mail.apsi.net
- Test sur mail.voilou.nl
- Vérification SSL/TLS
- Test HTTPS (port 443)
- Test sur apsi.net (Roundcube)
- Vérification du certificat web
- Services Utilisant le Certificat
- postfix: ✓ Actif
- dovecot: ✓ Actif
- apache2: ✓ Actif
- Renouvellement Automatique
- Statut du timer certbot
- Prochaine vérification programmée
Scoring: - Expiration: 30 points - Tests SMTP: 20 points - Tests IMAPS: 20 points - Tests HTTPS: 10 points - Services actifs: 15 points - Timer certbot: 5 points - Total: 100 points
Utilisation:
# Test complet
/root/scripts/test-certificates.sh
# Sans couleurs
/root/scripts/test-certificates.sh | sed 's/\x1b\[[0-9;]*m//g'
Scripts de Maintenance
renew-certificates.sh
Serveur: ovh1 Fréquence: Automatique via timer certbot Fonction: Renouvellement des certificats Let’s Encrypt
Ce qu’il fait: 1. Stop les services (apache2) 2. Exécute certbot renew 3. Redémarre les services (apache2, postfix, dovecot) 4. Vérifie que les certificats sont valides 5. Affiche la nouvelle date d’expiration
Utilisation:
# Renouvellement manuel (si < 30 jours)
/root/scripts/renew-certificates.sh
# Forcer le renouvellement (test)
certbot renew --force-renewal
# Vérifier le timer automatique
systemctl status certbot.timer
systemctl list-timers certbot.timer
Certificat actuel: - Fichier: /etc/letsencrypt/live/mail.apsi.net/fullchain.pem - Domaines: mail.apsi.net, mail.voilou.nl - Expiration: ~90 jours après émission - Renouvellement auto: 30 jours avant expiration
Troubleshooting:
# Vérifier la configuration
certbot certificates
# Logs certbot
journalctl -u certbot.timer
tail -100 /var/log/letsencrypt/letsencrypt.log
# Test de renouvellement (dry-run)
certbot renew --dry-run
rename-accounts.sh
Serveur: ovh1 Fréquence: Ponctuel (migration) Fonction: Migration vers nouvelle convention de nommage avec points
Convention de nommage: - Ancienne: pchevalier, pchevalier-voilou (tiret) - Nouvelle: pchevalier.apsi.net, pchevalier.voilou.nl (point + domaine complet)
Ce qu’il fait: 1. Arrête dovecot et postfix 2. Pour chaque compte: - Renomme l’utilisateur Unix (usermod -l) - Renomme le groupe (groupmod -n) - Déplace le home directory (usermod -d -m) - Corrige les permissions du Maildir - Met à jour /etc/postfix/virtual 3. Recompile la table virtuelle (postmap) 4. Redémarre les services 5. Affiche un résumé des migrations 6. Teste tous les mappings
Configuration des migrations:
# Éditer la liste dans le script
MIGRATIONS=(
"pchevalier:pchevalier.apsi.net:pchevalier@apsi.net"
"pchevalier-voilou:pchevalier.voilou.nl:pchevalier@voilou.nl"
"contact:contact.apsi.net:contact@apsi.net"
"contact-voilou:contact.voilou.nl:contact@voilou.nl"
)
Utilisation:
# 1. IMPORTANT: Backup d'abord!
tar -czf /backup/mail-accounts-$(date +%Y%m%d).tar.gz /home/*/Maildir/ /etc/postfix/virtual
# 2. Adapter les migrations
nano /root/scripts/rename-accounts.sh
# 3. Exécuter
/root/scripts/rename-accounts.sh
# 4. Vérifier
cat /etc/postfix/virtual | grep -v "^#" | grep "@"
ls -ld /home/*.*/
Post-migration: - Les utilisateurs doivent mettre à jour leurs clients email - Thunderbird: Modifier le “Nom d’utilisateur” dans les paramètres - Roundcube: Se connecter avec le nouveau nom d’utilisateur - Les emails existants sont préservés dans le Maildir
Voir aussi: /root/IA/MAIL.APSI.NET/GUIDE_AJOUT_COMPTE.md section “Renommer un Compte Existant”
Alias et Liens Symboliques
# Lien vers checkOvh1.sh
ln -s /root/scripts/checkOvh1.sh /root/scripts/pcCheckMailOvh1.sh
Configuration Cron Recommandée
Sur ovh1
# Editer crontab
crontab -e
# Diagnostic quotidien à 7h00
0 7 * * * /root/scripts/checkOvh1.sh
# Vérification certbot (automatique via systemd timer, mais backup cron)
0 0,12 * * * /usr/bin/certbot renew --quiet
Sur ovh2
# Editer crontab
crontab -e
# Diagnostic quotidien à 7h00
0 7 * * * /root/scripts/checkOvh2.sh
Logs des Scripts
Emplacements des rapports
# ovh1 - Rapports de diagnostic
/var/log/check-ovh1/check-ovh1-YYYYMMDD-HHMMSS.txt
# ovh2 - Rapports de relay
/var/log/check-ovh2/check-ovh2-YYYYMMDD-HHMMSS.txt
# Nettoyage automatique (> 30 jours)
# Les scripts suppriment automatiquement les anciens rapports
Consulter les rapports
# Dernier rapport ovh1
ls -t /var/log/check-ovh1/*.txt | head -1 | xargs cat
# Dernier rapport ovh2
ls -t /var/log/check-ovh2/*.txt | head -1 | xargs cat
# Tous les rapports d'aujourd'hui
ls -lh /var/log/check-ovh1/*$(date +%Y%m%d)*.txt
Emails de Diagnostic
Destinataire: pchevalier@pcstreet.fr
Format des sujets: - [checkOvh1.sh] Rapport Diagnostic OVH1 - DD/MM/YYYY HH:MM - [checkOvh2.sh] Rapport Diagnostic OVH2 (Relay) - DD/MM/YYYY HH:MM
Contenu: - Rapport complet sans codes couleur ANSI - Formatage préservé pour lecture facile - Scores de santé en fin de rapport - Recommandations d’actions si nécessaire
Troubleshooting Scripts
Script ne s’exécute pas
# Vérifier les permissions
ls -l /root/scripts/*.sh
# Rendre exécutable
chmod +x /root/scripts/*.sh
# Vérifier l'interpréteur
head -1 /root/scripts/checkOvh1.sh
# Doit être: #!/bin/bash
Email non reçu
# Vérifier que mail est installé
which mail
apt install mailutils
# Test d'envoi manuel
echo "Test" | mail -s "Test" pchevalier@pcstreet.fr
# Vérifier les logs
grep "pchevalier@pcstreet.fr" /var/log/mail.log | tail -20
Script bloqué
# Voir les processus
ps aux | grep -E "checkOvh|mail-diagnostic|test-certificates"
# Tuer un script bloqué
pkill -f checkOvh1.sh
# Vérifier les services
systemctl status postfix dovecot
Scripts Archivés (dans /root/IA/MAIL.APSI.NET/)
Ces scripts ont été utilisés pour l’installation initiale mais ne sont plus utilisés quotidiennement:
| Script | Fonction |
|---|---|
| install-mailserver.sh | Installation initiale de Postfix, Dovecot, OpenDKIM |
| install-roundcube.sh | Installation de Roundcube webmail |
| setup-ovh2-relay.sh | Configuration initiale du serveur relay ovh2 |
| create-ovh2-firewall.sh | Configuration firewall ovh2 |
| fix-roundcube-db.sh | Correction base de données Roundcube |
Note: Ces scripts sont conservés pour référence historique mais ne doivent pas être ré-exécutés sur un système en production.
Résumé des Scripts Actifs
| Script | Serveur | Fréquence | Automatique |
|---|---|---|---|
| checkOvh1.sh | ovh1 | Quotidien | ✓ (cron) |
| checkOvh2.sh | ovh2 | Quotidien | ✓ (cron) |
| mail-diagnostic.sh | ovh1 | Quotidien | ✓ (via checkOvh1) |
| test-certificates.sh | ovh1 | Quotidien | ✓ (via checkOvh1) |
| renew-certificates.sh | ovh1 | 30j avant expiration | ✓ (timer) |
| rename-accounts.sh | ovh1 | Ponctuel | ✗ (manuel) |
Créé le: 02 Janvier 2026 Auteur: Configuration automatisée Version: 2.0 Serveurs: ovh1 (mail.apsi.net) + ovh2 (backup.apsi.net)