Documentation Service Mail - MachiganMC/Woodytoys GitHub Wiki

Aperçu :

Le service mail (containeur) est composé de 2 services :

  • Postfix, pour le protocole SMTP.
  • Dovecot, pour les protocoles POP et IMAP.

Organisation des fichiers :

  • SMTP :

    Le service SMTP tournant sous Postfix, la configuration de ce service se fera via le fichier main.cf se trouvant dans le répertoire /etc/postfix.

  • POP-IMAP :

    Le service POP-IMAP tournant sous Dovecot, la configuration de ce service fera via le fichier dovecot.conf et se trouvant dans le répertoire /etc/dovecot.

Configuration actuelle :

  • SMTP :

    Actuellement, le service SMTP utilise le système d'utilisateurs de Linux afin de gérer les comptes mails. Cette configuration étant la plus simple, il est prévu dans le futur de passer via le système d'utilisateurs virtuels.

    Pour le système de stockage de mails, encore une fois le système de base (Mailbox) est utilisé, c'est-à-dire via un fichier par utilisateur. Il est prévu de passer par un système de

  • POP-IMAP :

    Afin d'utiliser le même système de gestion des utilisateurs du serveur SMTP, le service POP-IMAP utilise aussi le système de d'utilisateurs de Linux.

Ajouter un nouveau compte mail :

Pour ajouter un nouveau compte la procédure est similaire pour les 2 services. Il suffit d'ajouter un utilisateur Linux en privilégiant la commande adduser en faisant attention d'utiliser le même nom d'utilisateur et mot de passe pour les 2 services. Un redémarrage des services est conseillé, via les commandes :

  • postfix reload, pour Postfix
  • dovecot reload, pour Dovecot

Sinon, il est toujours plus conseillé de redémarrer le conteneur via la commande docker restart <containeur> (le containeur est souvent nommé woodytoys_mail_1).

Mettre à jour les services :

  • SMTP :

    • Avant de mettre à jour le service, il est important de tester la configuration actuelle sur un serveur de test possédant la version de Postfix désirée.
    • Ensuite, il est important de faire une backup du fichier de configuration de Postfix main.cf se trouvant dans le répertoire/etc/postfix. Voir, de tout le répertoire pour plus de sécurité.
    • Désinstaller Postfix, puis réinstaller la version désirée.
    • Remettre la configuration de Postfix sauvegardée précédemment.
  • POP-IMAP :

    Les étapes pour la mise à jour sont assez similaires avec Dovecot, mais avec le fichier dovecot.conf se trouvant dans le répertoire /etc/dovecot.

Troubleshooter :

Pour les 2 services, la meilleure manière de trouver la raison d'un problème est via les logs. Les 2 services sont configurés pour logguer un maximum d'informations. Une première piste serait donc d'aller voir dans les dossiers de logs des 2 services /var/log/postfix.log pour Postfix et /var/log/dovecot.log pour Dovecot.

Erreurs fréquentes :

Encore une fois, les erreurs sont assez similaires pour les 2 services.

  • Le nom d'utilisateur ou le mot de passe n'est pas pareil pour les 2 services pour un compte mail.
  • Une erreur de permission, par exemple le serveur SMTP ne pouvant pas lire les dossiers de mails du serveur POP-IMAP.
⚠️ **GitHub.com Fallback** ⚠️