← zur Übersicht

Server 02 — Mailserver, Aufbau von null


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]


02 · Mailserver — Aufbau von null

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

1. Was am Ende laufen muss

DienstPortZweck
Postfix25, 465, 587SMTP-Versand und -Empfang
Dovecot143, 993IMAP
rspamd11332, 11333, 11334Spamfilter, DKIM-Signatur
MariaDB3306 (lokal)virtuelle Postfächer (vmail)
nginx80, 443ACME-Challenge, rspamd-Weboberfläche
unbound53 (lokal)DNSSEC-fähiger Resolver
SSH2121Verwaltungszugang (nicht 22!)

Besonderheit: SSH läuft auf Port 2121, Benutzer anna2, nicht root auf 22.


2. Die Domains — und warum das der schwierige Teil ist

Der Mailserver bedient fünf Domains, jede mit anderer DNS-Lage:

#DomainDNS liegt beiAutomatisierbar?
1ki-rechtsdialog.siteNamecheapja — über die API
2unsere-ki-runde.xyzNamecheapja
3kiagent2.siteNamecheapja
4ichselbstreal.siteNamecheapja, eigene Rolle domain4add
5kiagent1.siteCloudflarenein — 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.


3. Die 27 Rollen in Reihenfolge

Der Aufbau ist in vier Blöcke geteilt: Bootstrap (Server erreichbar machen), Vault (Geheimnisse), Basis (Betriebssystem), Mail (die eigentliche Anwendung).

Block A — Bootstrap: aus einem leeren Server einen erreichbaren machen

#RolleWas sie tutWarum an dieser Stelle
1deletehetznerserver1löscht einen benannten Server über die Hetzner-APIAufräumen vor dem Aufbau; verhindert Namenskollisionen
2namecheapdnsresetsetzt die DNS-Zone auf einen Grundzustandvor dem Server, weil die API nur von der Mailserver-IP darf — bei Erstaufbau über eine Übergangs-IP
3apt_upgradeSystemaktualisierungerster Schritt nach dem Boot
4hostnamesHostname und /etc/hostsmuss vor allem stehen, was den Namen benutzt
5usersBenutzer anna2 anlegenVoraussetzung für SSH und alle späteren Läufe
6sshbesser1SSH-Härtung (Port, Schlüssel, Root-Sperre)nach users, sonst sperrt man sich aus
7sshbesser1ubu24dasselbe für Ubuntu 24.04eigene Rolle, weil sich Konfigurationspfade unterscheiden
8createbilligsterserver1ubu24besser1Server-Neuanlage über die Hetzner-API mit fester Konfigurationder eigentliche „Server entsteht"-Schritt
9vaultinroot2legt das Ansible-Vault im Root-Verzeichnis abVoraussetzung für alle Geheimnis-Rollen
10annaundsecret2Schlüssel und Zugangsdaten für anna2nach dem Vault, weil die Werte daraus kommen
11namecheapdns1setzt die A- und MX-Recordszuletzt im Bootstrap — ab hier zeigt DNS auf den neuen Server

Block B — Basis: Zertifikate und Grunddienste

#RolleWas sie tut
12nginxcrtinstallatonallgmeinnginx mit ACME-Challenge für die Zertifikatsausstellung
13nginxneudomain1die neue Domain in nginx bekannt machen
14certbotLet's-Encrypt-Zertifikat ausstellen
15generalBenutzer vmail, Basispakete
16general2testubuntu24systemd-resolved für DNSSEC (Ubuntu 24)
17general3testubuntu24DNS-Werkzeuge für die Prüfungen
18unbound22lokaler DNS-Resolver mit DNSSEC

Block C — Mail: die eigentliche Anwendung

#RolleWas sie tutReihenfolge-Grund
19mariadbDatenbank vmail für virtuelle Postfächervor Dovecot und Postfix, beide brauchen sie
20dovecotIMAP, liest Postfächer aus vmailnach MariaDB
21postfixSMTP, alle SQL-Maps auf 127.0.0.1nach Dovecot und MariaDB
22rspamdubu24Spamfilter und DKIM-Signaturnach Postfix, hängt sich in die Zustellung
23dkimberechtigungensetzenDateirechte für die DKIM-Schlüsselnach rspamd — der Dienst muss die Schlüssel lesen können
24nginxneurspamd-Weboberfläche über nginxzuletzt, braucht laufendes rspamd

Block D — DNS-Abschluss

#RolleWas sie tut
25namecheapdkimupdateträgt den DKIM-Public-Key als TXT-Record in ki-rechtsdialog.site ein
26namecheapdkimupdatedomain2dasselbe für unsere-ki-runde.xyz
27mailserverreset1Rü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).


4. Was der Generator noch enthält

Neben den Rollen liegen im Skript von 97,7 KB:

Diese 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.

5. DNS-Records, die nach dem Aufbau stimmen müssen

Für jede der fünf Domains:

TypNameZiel
MX@mail.ki-rechtsdialog.site. Priorität 10
AmailIP des Mailservers
TXT@v=spf1 a:mail.ki-rechtsdialog.site ip4:<IP> ~all
TXT_dmarcv=DMARC1; p=quarantine; rua=mailto:postmaster@<domain>
TXTselector7._domainkeyv=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.


6. Abnahme nach dem Aufbau

Ein Playbook-Lauf ist kein Beweis. Zu prüfen:


7. Fallen

FalleWirkungGegenmittel
SSH auf 22 statt 2121man kommt nicht wie erwartet hineinZugang ist anna2@2121
sshbesser1 vor usersman sperrt sich selbst ausReihenfolge im Playbook zwingend
DKIM-Key im falschen Format ins DNSDNS-Eintrag ungültig, DKIM schlägt fehlnur die Anführungszeichen-Inhalte zusammenkleben
kiagent1.site automatisieren wollenAPI-Fehler, Zone liegt bei Cloudflarevon Hand pflegen
Postfix nur enabled-runtimenach Neustart kein Mailversand, ohne Fehlermeldungsystemctl enable postfix@-.service
Mails kommen nicht anmeist SPF/DMARC/PTRalle drei prüfen, nicht nur MX

8. Was für den Ansible-Umzug zu tun ist

SchrittInhalt
127 Rollen als Verzeichnisse unter roles\mail\ anlegen
2Die Aufgaben aus setup_mailserver2c.sh in tasks/main.yml je Rolle überführen
3Werte aus dem Skript nach inventory\group_vars\mail.yml ziehen (Domains, Selektoren, Pfade)
4Geheimnisse nach vault.yml — nicht in group_vars
5playbooks\02-mail.yml mit den vier Blöcken und Tags je Block
6Abnahme als eigene Rolle mail_abnahme mit den Prüfungen aus Abschnitt 6
7Gegen einen Wegwerfserver laufen lassen und das Ergebnis protokollieren

Kein Skript löschen, bevor dieser Lauf einmal erfolgreich war.