VMail Manager Tool

Ein interaktives CLI-Tool zur Verwaltung von virtuellen Mail-Benutzern, Aliasen und Domains für Postfix/Dovecot-Mailserver.
Das Tool nutzt modernes Argon2id-Passwort-Hashing und zeigt dynamisch den Hostnamen des Systems an.

✨ Features

Domain-Verwaltung
- Anzeigen vorhandener Domains
- Hinzufügen neuer Domains
- Löschen bestehender Domains
Account-Verwaltung
- Erstellen von Mail-Usern mit automatischem Argon2id-Hashing
- Standard-Quota: 1024 MB
- Aktivieren / Deaktivieren von Accounts (Toggle)
- Passwortänderung für bestehende Benutzer
Alias-Verwaltung
- Anlegen von E-Mail-Aliasen
- Löschen von Aliasen anhand der ID
Sicherheit
- Verdeckte Passworteingabe
- Datenbank-Zugangsdaten in separater Konfigurationsdatei

🧩 Voraussetzungen

Beispiel für Debian / Ubuntu:

apt update
apt install python3-venv python3-full

🚀 Installation

1. Repository klonen

git clone https://git.bouquet24.de/paase/vmailtool.git
cd vmailtool

2. Virtuelle Python-Umgebung erstellen

python3 -m venv vmail-env
source vmail-env/bin/activate
pip install mysql-connector-python argon2-cffi

⚙️ Konfiguration

Das Tool benötigt eine config.ini.

cp config.ini.example config.ini
nano config.ini

🌍 Globale Einrichtung (empfohlen)

Damit das Tool systemweit verfügbar ist, kannst du ein Wrapper-Skript anlegen.

Wrapper anlegen

nano /usr/local/bin/vmailtool

Inhalt (Pfade ggf. anpassen)

#!/bin/bash
/root/sql/vmail-env/bin/python3 /root/sql/vmailtool.py

Ausführbar machen

chmod +x /usr/local/bin/vmailtool

Danach kannst du das Tool einfach starten mit:

vmailtool

📌 Hinweis

Dieses Tool ist für den Einsatz auf Servern mit Postfix + Dovecot + MariaDB/MySQL konzipiert und richtet sich an Administratoren, die Mailkonten komfortabel per CLI verwalten möchten.

2.0 KiB Raw Blame History