titel: Server 02 — Mailserver, Aufbau von null
erstellt: 2026-10-28
grundlage: 01-Wissen\setup_mailserver2c.sh (97,7 KB, 16.07.2026) — 27 Rollen
status: dokumentiert, Rollen noch nicht als Ansible-Projekt übernommen
tags: [ansible, serveraufbau, mail, postfix, dovecot, rspamd]
Server: 02-mailserver, Hostname mail, heute 46.224.157.119
Rolle im Betrieb: MX-Ziel für drei Domains, PTR-Träger (mail.ki-rechtsdialog.site), Absender aller Bestätigungs- und Systemmails
Schwierigkeit: mittel — aber die DNS-Automatik aller Server hängt an seiner IP
Der wichtigste Satz zuerst: Der Mailserver muss bei einem echten Wiederaufbau zuerst gebaut werden. Alle DNS-Schritte laufen über die Namecheap-API, und die funktioniert nur von der gewhitelisteten IP dieses Servers. Ist er weg, ist die DNS-Automatik blockiert.
Fundstelle: 01-Wissen\notfall-wiederaufbau-server.md
| Dienst | Port | Zweck |
|---|---|---|
| Postfix | 25, 465, 587 | SMTP-Versand und -Empfang |
| Dovecot | 143, 993 | IMAP |
| rspamd | 11332, 11333, 11334 | Spamfilter, DKIM-Signatur |
| MariaDB | 3306 (lokal) | virtuelle Postfächer (vmail) |
| nginx | 80, 443 | ACME-Challenge, rspamd-Weboberfläche |
| unbound | 53 (lokal) | DNSSEC-fähiger Resolver |
| SSH | 2121 | Verwaltungszugang (nicht 22!) |
Besonderheit: SSH läuft auf Port 2121, Benutzer anna2, nicht root auf 22.
Der Mailserver bedient fünf Domains, jede mit anderer DNS-Lage:
| # | Domain | DNS liegt bei | Automatisierbar? |
|---|---|---|---|
| 1 | ki-rechtsdialog.site | Namecheap | ja — über die API |
| 2 | unsere-ki-runde.xyz | Namecheap | ja |
| 3 | kiagent2.site | Namecheap | ja |
| 4 | ichselbstreal.site | Namecheap | ja, eigene Rolle domain4add |
| 5 | kiagent1.site | Cloudflare | nein — Handarbeit |
Domain 5 ist die Falle. Für kiagent1.site kann das Playbook die DNS-Einträge nicht setzen: Die Zone wird bei Cloudflare verwaltet (harlee/tosana.ns.cloudflare.com), und dafür gibt es in diesem Playbook keinen Zugang. Steht so im Generator: *„Domain5 (kiagent1.site — Postfach info@kiagent1.site, DNS auf CLOUDFLARE → manuell)"*.
Wichtig für die Einordnung: Bei kiagent1.site bedeutet Cloudflare nur, *wer die Zone verwaltet* — nicht, dass der Verkehr durch Cloudflare läuft. Gemessen am 28.10.2026 zeigen nextcloud.kiagent1.site und termine.kiagent1.site direkt auf Server 06 (178.105.232.19). Nur www und buzz-g3 laufen über den Cloudflare-Proxy. Für den Mailserver heißt das: MX und SPF für kiagent1.site müssen von Hand bei Cloudflare gepflegt werden.
Der Aufbau ist in vier Blöcke geteilt: Bootstrap (Server erreichbar machen), Vault (Geheimnisse), Basis (Betriebssystem), Mail (die eigentliche Anwendung).
| # | Rolle | Was sie tut | Warum an dieser Stelle |
|---|---|---|---|
| 1 | deletehetznerserver1 | löscht einen benannten Server über die Hetzner-API | Aufräumen vor dem Aufbau; verhindert Namenskollisionen |
| 2 | namecheapdnsreset | setzt die DNS-Zone auf einen Grundzustand | vor dem Server, weil die API nur von der Mailserver-IP darf — bei Erstaufbau über eine Übergangs-IP |
| 3 | apt_upgrade | Systemaktualisierung | erster Schritt nach dem Boot |
| 4 | hostnames | Hostname und /etc/hosts | muss vor allem stehen, was den Namen benutzt |
| 5 | users | Benutzer anna2 anlegen | Voraussetzung für SSH und alle späteren Läufe |
| 6 | sshbesser1 | SSH-Härtung (Port, Schlüssel, Root-Sperre) | nach users, sonst sperrt man sich aus |
| 7 | sshbesser1ubu24 | dasselbe für Ubuntu 24.04 | eigene Rolle, weil sich Konfigurationspfade unterscheiden |
| 8 | createbilligsterserver1ubu24besser1 | Server-Neuanlage über die Hetzner-API mit fester Konfiguration | der eigentliche „Server entsteht"-Schritt |
| 9 | vaultinroot2 | legt das Ansible-Vault im Root-Verzeichnis ab | Voraussetzung für alle Geheimnis-Rollen |
| 10 | annaundsecret2 | Schlüssel und Zugangsdaten für anna2 | nach dem Vault, weil die Werte daraus kommen |
| 11 | namecheapdns1 | setzt die A- und MX-Records | zuletzt im Bootstrap — ab hier zeigt DNS auf den neuen Server |
| # | Rolle | Was sie tut |
|---|---|---|
| 12 | nginxcrtinstallatonallgmein | nginx mit ACME-Challenge für die Zertifikatsausstellung |
| 13 | nginxneudomain1 | die neue Domain in nginx bekannt machen |
| 14 | certbot | Let's-Encrypt-Zertifikat ausstellen |
| 15 | general | Benutzer vmail, Basispakete |
| 16 | general2testubuntu24 | systemd-resolved für DNSSEC (Ubuntu 24) |
| 17 | general3testubuntu24 | DNS-Werkzeuge für die Prüfungen |
| 18 | unbound22 | lokaler DNS-Resolver mit DNSSEC |
| # | Rolle | Was sie tut | Reihenfolge-Grund |
|---|---|---|---|
| 19 | mariadb | Datenbank vmail für virtuelle Postfächer | vor Dovecot und Postfix, beide brauchen sie |
| 20 | dovecot | IMAP, liest Postfächer aus vmail | nach MariaDB |
| 21 | postfix | SMTP, alle SQL-Maps auf 127.0.0.1 | nach Dovecot und MariaDB |
| 22 | rspamdubu24 | Spamfilter und DKIM-Signatur | nach Postfix, hängt sich in die Zustellung |
| 23 | dkimberechtigungensetzen | Dateirechte für die DKIM-Schlüssel | nach rspamd — der Dienst muss die Schlüssel lesen können |
| 24 | nginxneu | rspamd-Weboberfläche über nginx | zuletzt, braucht laufendes rspamd |
| # | Rolle | Was sie tut |
|---|---|---|
| 25 | namecheapdkimupdate | trägt den DKIM-Public-Key als TXT-Record in ki-rechtsdialog.site ein |
| 26 | namecheapdkimupdatedomain2 | dasselbe für unsere-ki-runde.xyz |
| 27 | mailserverreset1 | Rücksetz-Rolle für Wiederholungsläufe |
Warum DKIM bei Namecheap und nicht lokal: Der private Schlüssel liegt auf dem Server, der öffentliche muss ins DNS — sonst können Empfänger die Signatur nicht prüfen. Die Reihenfolge ist zwingend: Schlüssel erzeugen (22) → Rechte setzen (23) → Public Key ins DNS (25/26).
Neben den Rollen liegen im Skript von 97,7 KB:
mailserver2: Mail-Server, Mail-User, MySQL, SSH-Keys, Domain 2–5domain3add (kiagent2.site) und domain4add (ichselbstreal.site) — beide idempotent, laufen also auch auf dem laufenden Serverunsere-ki-runde.xyz, die ausdrücklich *„alle bestehenden A-Records behält und nur die Mail-Records ersetzt"* — in vier Schritten: Records laden → Mail-Records herausfiltern → neue hinzufügen → setHostsDiese DNS-Routine ist die Vorlage für jede künftige DNS-Änderung. Sie zeigt das Muster, das am 28.10. gefehlt hat: erst lesen, filtern, dann schreiben — und dabei nichts anderes anfassen.
Für jede der fünf Domains:
| Typ | Name | Ziel |
|---|---|---|
| MX | @ | mail.ki-rechtsdialog.site. Priorität 10 |
| A | mail | IP des Mailservers |
| TXT | @ | v=spf1 a:mail.ki-rechtsdialog.site ip4:<IP> ~all |
| TXT | _dmarc | v=DMARC1; p=quarantine; rua=mailto:postmaster@<domain> |
| TXT | selector7._domainkey | v=DKIM1; k=rsa; p=<Public Key> |
Der DKIM-Public-Key steht auf dem Server unter /var/lib/rspamd/dkim/<domain>/selector7.txt — im Zonenzeilen-Format selector7._domainkey IN TXT ( "v=DKIM1; k=rsa; " "p=MIIB…" ). Für den DNS-Eintrag müssen die Anführungszeichen-Teile zu einem Wert zusammengeklebt werden — die ganze Zeile einzutragen ist falsch (dieser Fehler ist am 28.10. passiert und wurde korrigiert).
PTR: mail.ki-rechtsdialog.site — wird bei Hetzner an der Primary IP gesetzt und bleibt beim Restore erhalten.
Ein Playbook-Lauf ist kein Beweis. Zu prüfen:
systemctl --failed leer — Ausnahme: postfix@-.service steht auf enabled-runtime und nach einem Neustart nicht mehr ancloud-init status = donepostmaster@ki-rechtsdialog.site, Empfang im IMAP prüfenrspamd-Log oder Header DKIM-Signature)dig MX <domain> +short zeigt auf mail.ki-rechtsdialog.siteselector7._domainkey.<domain> liefert einen Wert, der mit v=DKIM1 beginntcertbot renew --dry-run| Falle | Wirkung | Gegenmittel |
|---|---|---|
| SSH auf 22 statt 2121 | man kommt nicht wie erwartet hinein | Zugang ist anna2@2121 |
sshbesser1 vor users | man sperrt sich selbst aus | Reihenfolge im Playbook zwingend |
| DKIM-Key im falschen Format ins DNS | DNS-Eintrag ungültig, DKIM schlägt fehl | nur die Anführungszeichen-Inhalte zusammenkleben |
kiagent1.site automatisieren wollen | API-Fehler, Zone liegt bei Cloudflare | von Hand pflegen |
Postfix nur enabled-runtime | nach Neustart kein Mailversand, ohne Fehlermeldung | systemctl enable postfix@-.service |
| Mails kommen nicht an | meist SPF/DMARC/PTR | alle drei prüfen, nicht nur MX |
| Schritt | Inhalt |
|---|---|
| 1 | 27 Rollen als Verzeichnisse unter roles\mail\ anlegen |
| 2 | Die Aufgaben aus setup_mailserver2c.sh in tasks/main.yml je Rolle überführen |
| 3 | Werte aus dem Skript nach inventory\group_vars\mail.yml ziehen (Domains, Selektoren, Pfade) |
| 4 | Geheimnisse nach vault.yml — nicht in group_vars |
| 5 | playbooks\02-mail.yml mit den vier Blöcken und Tags je Block |
| 6 | Abnahme als eigene Rolle mail_abnahme mit den Prüfungen aus Abschnitt 6 |
| 7 | Gegen einen Wegwerfserver laufen lassen und das Ergebnis protokollieren |
Kein Skript löschen, bevor dieser Lauf einmal erfolgreich war.