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:

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:

  1. État des services
    • postfix, dovecot, opendkim, apache2, fail2ban
    • Statut: ✓ OK / ✗ ERREUR
  2. Queue Mail
    • Nombre d’emails en attente
    • ✓ < 10 emails / ⚠ 10-100 / ✗ > 100
  3. Configuration Postfix
    • Domaines gérés (mydestination)
    • Liste complète des alias virtuels
    • Total d’alias configurés
  4. Utilisateurs Mail
    • Liste tous les comptes avec Maildir
    • Taille de chaque boîte
    • Nombre d’emails par compte
  5. DKIM (OpenDKIM)
    • Statut de chaque domaine
    • Affiche les clés publiques DKIM complètes
    • Test avec opendkim-testkey
  6. Certificats SSL
    • Date d’expiration
    • Jours restants
    • Alerte à 3 niveaux:
      • ✓ > 30 jours (OK)
      • ⚠ 7-30 jours (ATTENTION)
      • ✗ < 7 jours (URGENT)
    • Liste des domaines couverts
  7. Enregistrements DNS
    • Pour chaque domaine: MX, SPF, DKIM, DMARC
    • Vérification avec dig
  8. Fail2ban
    • Statut de chaque jail
    • Nombre d’IP bannies
  9. Espace Disque
    • Utilisation partition racine
    • Alertes si > 80%
  10. 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:

  1. Expiration
    • Date d’expiration
    • Jours restants
    • Statut: ✓ > 30j / ⚠ 7-30j / ✗ < 7j
  2. Domaines Couverts
    • Liste tous les SAN du certificat
    • Vérifie mail.apsi.net et mail.voilou.nl
  3. Émetteur
    • Vérifie que c’est Let’s Encrypt
  4. Test SMTP (port 587 - STARTTLS)
    • Test sur mail.apsi.net
    • Test sur mail.voilou.nl
    • Vérification du certificat présenté
  5. Test IMAPS (port 993)
    • Test sur mail.apsi.net
    • Test sur mail.voilou.nl
    • Vérification SSL/TLS
  6. Test HTTPS (port 443)
    • Test sur apsi.net (Roundcube)
    • Vérification du certificat web
  7. Services Utilisant le Certificat
    • postfix: ✓ Actif
    • dovecot: ✓ Actif
    • apache2: ✓ Actif
  8. 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)