Installieren Sie Mailpit auf CasaOS mit dem offiziellen axllent/mailpit-Docker-Image, Port 8025 für den Web-Posteingang und Port 1025 für SMTP. Binden Sie /data nur dann dauerhaft ein, wenn Nachrichten und Einstellungen eine Neuerstellung des Containers überstehen sollen.
Das alte BigBearCasaOS-Tutorial ist weiterhin als Beispiel für eine Ein-Klick-Installation nützlich. Die aktuelle Mailpit-Dokumentation des Upstream-Projekts enthält jedoch nun das genaue Docker-Image, die Option für eine persistente Datenbank, Authentifizierungsoptionen sowie TLS-/Relay-Einstellungen. Diese sollten den Leitfaden für 2026 bestimmen.
Wofür Mailpit gedacht ist
Mailpit ist ein lokaler SMTP-Testserver für Entwickler. Anwendungen senden Test-E-Mails an Mailpit statt an einen echten Mailanbieter, und Sie prüfen die Nachrichten über einen Browser.
Es ist weder ein gewöhnliches produktives Postfach noch ein aus dem Internet erreichbarer Mailserver.
Das offizielle Docker-Image verwenden
Der aktuelle Mailpit-Docker-Leitfaden dokumentiert:
axllent/mailpitPortzuordnung in CasaOS
- 8025/TCP: Mailpit-Weboberfläche
- 1025/TCP: SMTP-Empfänger
Wenn ein anderer Dienst bereits einen der beiden Host-Ports verwendet, ändern Sie den Port auf der Host-Seite, während der Container-Port unverändert bleibt.
Grundlegende Einstellungen für eine benutzerdefinierte CasaOS-App
image: axllent/mailpit
restart: unless-stopped
ports:
- "8025:8025"
- "1025:1025"Öffnen Sie nach dem Start http://CASAOS-IP:8025.
Die Anwendung auf Mailpit verweisen
Verwenden Sie für einen anderen Container im selben Docker-Netzwerk den Namen des Mailpit-Dienstes bzw. -Containers und Port 1025. Verwenden Sie für eine Anwendung im LAN die Host-IP-Adresse von CasaOS und den veröffentlichten SMTP-Host-Port.
Nachrichten nur bei Bedarf dauerhaft speichern
Die aktuelle Mailpit-Dokumentation unterstützt eine SQLite-Datenbank unter /data mit:
MP_DATABASE=/data/mailpit.dbBinden Sie einen CasaOS-AppData-Ordner an /data, wenn der Nachrichtenverlauf den Austausch des Containers überstehen soll.
Mailpit privat halten
Ein Test-Posteingang kann Links zum Zurücksetzen von Passwörtern, API-Benachrichtigungen und Anwendungsdaten enthalten. Veröffentlichen Sie die Weboberfläche oder den nicht authentifizierten SMTP-Listener nicht direkt im Internet.
Der aktuelle Mailpit-Konfigurationsleitfaden dokumentiert HTTP-, SMTP- und POP3-Authentifizierung sowie TLS-Optionen.
Wann Sie Port 1025 nicht veröffentlichen müssen
Wenn nur Container im selben Compose-Netzwerk E-Mails an Mailpit senden, können Sie die Veröffentlichung des SMTP-Ports auf dem Host weglassen und ihn intern in Docker belassen.
Der Docker-Netzwerkleitfaden erklärt dasselbe Isolationsmodell.
Testen Sie den SMTP-Pfad, bevor Sie ihn mit Ihrer Anwendung verbinden
Nachdem Mailpit gestartet ist, überprüfen Sie, ob sich die Weboberfläche öffnen lässt, und senden Sie anschließend eine Testnachricht von einem einfachen SMTP-Client oder Ihrer Anwendung. Wenn die Nachricht sofort im Mailpit-Posteingang erscheint, funktionieren sowohl der Netzwerkpfad als auch der SMTP-Listener.
Wenn die Anwendung „Verbindung abgelehnt“ meldet, überprüfen Sie, ob sie aus ihrem eigenen Netzwerkkontext den richtigen Hostnamen verwendet. Ein Container sollte normalerweise den Namen des Mailpit-Dienstes verwenden; ein Laptop im LAN sollte die Host-IP-Adresse von CasaOS verwenden.
Authentifizierung nur aktivieren, wenn Ihr Test sie erfordert
Mailpit kann für eine einfache lokale Entwicklung nicht authentifizierten SMTP-Verkehr akzeptieren. Die aktuellen Konfigurationsoptionen unterstützen jedoch auch SMTP- und UI-Authentifizierung. Aktivieren Sie diese, wenn mehrere Benutzer das Labor gemeinsam verwenden oder der Dienst über ein einzelnes vertrauenswürdiges Docker-Netzwerk hinaus erreichbar ist.
Test-E-Mails von produktiven E-Mails getrennt halten
Mailpit ist dafür ausgelegt, Nachrichten abzufangen, damit sie nicht versehentlich echte Benutzer erreichen. Verweisen Sie Entwicklungs- und Staging-Anwendungen ausdrücklich auf Mailpit und bewahren Sie produktive SMTP-Zugangsdaten in einer separaten Konfiguration auf. So verhindern Sie, dass eine Test-E-Mail zum Zurücksetzen eines Passworts oder eine Flut von Benachrichtigungen Kunden erreicht.
Ein Nachrichtenlimit für dauerhaft laufende Labore festlegen
Mailpit kann Tausende von Nachrichten speichern. Legen Sie in einer kontinuierlich laufenden CI- oder Homelab-Umgebung ein sinnvolles Maximum fest und speichern Sie dauerhaft nur, was Sie tatsächlich benötigen. Andernfalls kann ein kleines Testwerkzeug allmählich zu einer weiteren Datenbank werden, die Sie verwalten müssen.
FAQ
Welche Standardports verwendet Mailpit?
8025 für die Weboberfläche und 1025 für SMTP.
Versendet Mailpit echte E-Mails?
Die Hauptaufgabe besteht darin, Test-E-Mails lokal abzufangen. Mailpit kann für die Weiterleitung bzw. das Relay konfiguriert werden, dies erfordert jedoch eine separate, ausdrückliche Einrichtung.
Benötige ich eine Datenbank?
Nein, nicht für vorübergehende Tests. Verwenden Sie die SQLite-Datenbankoption, wenn Sie einen dauerhaft gespeicherten Nachrichtenverlauf wünschen.
Sollte ich Mailpit öffentlich erreichbar machen?
Nein. Betreiben Sie es in einem vertrauenswürdigen Netzwerk oder schützen Sie es mit Authentifizierung und TLS.
