--- 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 | 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. --- ## 2. Die Domains — und warum das der schwierige Teil ist 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. --- ## 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 | # | 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 | ### Block B — Basis: Zertifikate und Grunddienste | # | 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 | ### Block C — Mail: die eigentliche Anwendung | # | 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 | ### Block D — DNS-Abschluss | # | 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). --- ## 4. Was der Generator noch enthält Neben den Rollen liegen im Skript von 97,7 KB: - **Die Playbooks**, die die Rollen in dieser Reihenfolge aufrufen - **Die Konfigurationsdateien** (Postfix-Maps, Dovecot-Konfiguration, rspamd-Lua) - **Host-Variablen** für `mailserver2`: Mail-Server, Mail-User, MySQL, SSH-Keys, Domain 2–5 - **Die Addons** `domain3add` (kiagent2.site) und `domain4add` (ichselbstreal.site) — beide **idempotent**, laufen also auch auf dem laufenden Server - **Eine DNS-Update-Routine für `unsere-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 → `setHosts` > **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: | 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: ~all` | | TXT | `_dmarc` | `v=DMARC1; p=quarantine; rua=mailto:postmaster@` | | TXT | `selector7._domainkey` | `v=DKIM1; k=rsa; p=` | **Der DKIM-Public-Key steht auf dem Server** unter `/var/lib/rspamd/dkim//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: 1. **Ports:** 25, 143, 465, 587, 993, 2121, 3306, 11332–11334 offen 2. **`systemctl --failed`** leer — **Ausnahme:** `postfix@-.service` steht auf `enabled-runtime` und nach einem Neustart nicht mehr an 3. **`cloud-init status`** = `done` 4. **Postfach-Test:** Mail von außen an `postmaster@ki-rechtsdialog.site`, Empfang im IMAP prüfen 5. **Versand-Test:** Mail hinaus, DKIM-Signatur prüfen (`rspamd`-Log oder Header `DKIM-Signature`) 6. **MX-Auflösung:** `dig MX +short` zeigt auf `mail.ki-rechtsdialog.site` 7. **DKIM im DNS:** TXT-Abfrage auf `selector7._domainkey.` liefert einen Wert, der mit `v=DKIM1` beginnt 8. **Zertifikat:** `certbot renew --dry-run` --- ## 7. Fallen | 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 | --- ## 8. Was für den Ansible-Umzug zu tun ist | 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.**