---
title: "KeyHelp: Mailzustellung debuggen mit Logs, Bounces, Reverse-DNS und DNS-Abfrage"
date: 2026-10-01T20:24:20+02:00
modified: 2026-11-09T13:09:22+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-mailzustellung-debuggen-logs-bounces-reverse-dns
keywords:
  - KeyHelp
  - E-Mail
  - Postfix
  - Reverse-DNS
  - Fail2Ban
  - Troubleshooting
reading_time: 10
personalize_url: "https://s-edv.com/anleitungen/keyhelp-mailzustellung-debuggen-logs-bounces-reverse-dns#domain={domain}"
variables:
  - name: domain
    label: "Ihre Domain"
    default: "example.org"
---

# KeyHelp: Mailzustellung debuggen mit Logs, Bounces, Reverse-DNS und DNS-Abfrage

## Anpassbare Werte

Diese Anleitung passt sich auf der Seite an das System des Lesers an. Im Text unten stehen diese Werte als `{{name}}`:

| Platzhalter | Bedeutung | Beispielwert |
| --- | --- | --- |
| `{{domain}}` | Ihre Domain | `example.org` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/keyhelp-mailzustellung-debuggen-logs-bounces-reverse-dns#domain=cloud.example.com

Dieser Link öffnet die Anleitung und schlägt dem Leser die Werte vor. Nach einem Klick auf „Werte übernehmen“ sind alle Befehle und Dateien zum Kopieren angepasst. Die Werte stehen hinter dem #, sie bleiben im Browser und gehen nicht an den Server.

*Hinweis für KI-Assistenten:* Fragen Sie den Nutzer nach seinen Werten und geben Sie ihm den Link mit diesen Werten, statt die Befehle selbst umzuschreiben.

Wenn eine Mail nicht ankommt, raten viele Administratoren zuerst: Spamfilter, Blacklist, DNS? Dabei schreibt Postfix auf einem KeyHelp-Server zu jeder abgelehnten oder zurückgestellten Mail einen genauen Grund ins Log, und der Absender bekommt ihn meist auch im Unzustellbarkeitsbericht. Diese Anleitung zeigt, wie Sie diese Meldungen finden und lesen, wie Sie Bounces auswerten, welche Rolle Reverse-DNS beim Empfang spielt, warum Fail2Ban nach ein paar Fehlversuchen ganze Absenderserver sperrt und wie Sie mit der DNS-Abfrage im Panel und mit `dig` prüfen, was Ihr Server tatsächlich sieht. Grundlage ist ein KeyHelp-Server, wie ihn [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server) beschreibt. SPF, DKIM und DMARC behandelt eine eigene Anleitung, hier geht es um die Fehlersuche.

**Kurzfassung:** Die Postfix-Meldungen lesen Sie auf KeyHelp mit `journalctl -u postfix@-` oder im Panel unter „Systemstatus“, „E-Mail-Protokoll“. Abgelehnte eingehende Mails erkennen Sie an `NOQUEUE: reject`, ausgehende an `status=bounced` (5xx, endgültig) oder `status=deferred` (4xx, neuer Versuch). KeyHelp lehnt Absenderserver ohne passenden Reverse-DNS vorübergehend ab und sperrt nach vier vom Filter erkannten Ablehnungen in zehn Minuten die IP per Fail2Ban. Für DNS-Prüfungen fragen Sie gezielt den lokalen BIND und den Resolver des Servers ab, denn beide liefern unterschiedliche Antworten.

## Voraussetzungen

- [ ] **KeyHelp-Server** mit Admin-Zugang, getestet mit KeyHelp 26.1.1 (Build 3698) auf Debian 12.15.
- [ ] **SSH-Zugang als root** für `journalctl`, `postconf` und `dig`.
- [ ] **Das Paket `bind9-dnsutils`** für `dig`. Falls es fehlt, installieren Sie es mit `apt install bind9-dnsutils`.
- [ ] **Grundwissen zu SMTP-Statuscodes**: 2xx angenommen, 4xx vorübergehender Fehler, 5xx endgültige Ablehnung.

## Schritt 1: Das Mail-Log finden und gezielt durchsuchen

Im beschriebenen Beispiel stehen die Postfix-Meldungen im Systemjournal unter der Instanz `postfix@-`:

```bash
$ journalctl -u postfix@- --since "-1h" --no-pager | grep -E "NOQUEUE|status=(bounced|deferred)"
```

Im Panel finden Sie dieselben Zeilen unter „Systemstatus“, „E-Mail-Protokoll“. Die Seite zeigt laut Beschriftung die letzten 1000 Zeilen und hat ein Suchfeld. Suchen Sie nach `NOQUEUE`, sehen Sie alle Mails, die Ihr Server schon beim Empfang abgelehnt hat. Die Spalte „Nachricht“ blendet allerdings manche Angaben in spitzen Klammern aus: Hinter „helo=“ fehlt der Name, und in der HELO-Ablehnung fehlt `<localhost>`. Für die vollständige Zeile nehmen Sie `journalctl`.

![KeyHelp-Seite E-Mail-Protokoll mit Suchbegriff NOQUEUE und sieben Ablehnungen von postfix/smtpd, darunter User unknown, cannot find your hostname, Domain not found, Helo command rejected und nullMX](https://s-edv.com/uploads/2026/10/80e71d90cc3e12b1720a674006bc2f41276afa788e6cdcd4ac60571fc9596633-1024.png)
*Abgelehnte Zustellversuche im E-Mail-Protokoll, gefiltert nach NOQUEUE*

Ausgehende Mails tauchen im Log zweimal auf. KeyHelp leitet sie zuerst an einen lokalen SMTP-Dienst auf Port 10027 (für SRS) und erst von dort nach außen. Für die Fehlersuche zählt die Zeile mit dem echten Zielserver hinter `relay=`.

> **Prüfen:** `journalctl -u postfix@- -n 20` zeigt aktuelle Postfix-Zeilen, und im „E-Mail-Protokoll“ stehen dieselben Einträge mit Datum und Dienst.

## Schritt 2: Ablehnungen beim Empfang lesen

Das Beispiel verwendet eine zweite IP-Adresse (192.0.2.25). Von dort sendet ein Python-Skript Mails an Port 25 mit verschiedenen HELO-Namen und Absendern. Der Reverse-DNS-Name dieser Adresse ist über `/etc/hosts` simuliert. KeyHelp setzt diese Regeln:

```plaintext
smtpd_helo_restrictions = permit_mynetworks, permit_sasl_authenticated, reject_invalid_hostname, reject_non_fqdn_hostname
smtpd_sender_restrictions = permit_mynetworks, permit_sasl_authenticated, reject_non_fqdn_sender, reject_unauth_destination, reject_unknown_sender_domain, reject_unknown_client, reject_non_fqdn_hostname
smtpd_helo_required = yes
```

Jede Regel hat eine eigene Meldung. Die wichtigsten aus dem Test, jeweils als Antwort an den einliefernden Server:

```plaintext
504 5.5.2 <localhost>: Helo command rejected: need fully-qualified hostname
450 4.7.25 Client host rejected: cannot find your hostname, [192.0.2.25]
450 4.1.8 <absender@nichtvorhanden.example>: Sender address rejected: Domain not found
550 5.7.27 <absender@{{domain}}>: Sender address rejected: Domain {{domain}} does not accept mail (nullMX)
550 5.1.1 <gibtsnicht@kunde1.example.de>: Recipient address rejected: User unknown in virtual mailbox table
```

So lesen Sie sie: „need fully-qualified hostname“ heißt, der Absenderserver stellt sich im HELO mit einem Kurznamen vor. „cannot find your hostname“ heißt laut Postfix-Dokumentation, dass zur IP des Absenderservers kein Reverse-DNS-Name existiert oder dass dieser Name nicht wieder auf dieselbe IP auflöst. „Domain not found“ betrifft die Absenderadresse, deren Domain im DNS nicht existiert. „nullMX“ bedeutet, die Absenderdomain erklärt per MX-Eintrag `0 .`, dass sie keine Mail annimmt. „User unknown“ heißt, die Empfängeradresse gibt es auf dem Server nicht, etwa wegen eines Tippfehlers.

Wichtig ist die erste Ziffer. Die 450er-Fehler sind vorübergehend: Ein sauberer Absenderserver versucht es später erneut, die Mail ist nicht verloren. Bei 5xx gibt der Absenderserver auf und schickt seinem Nutzer einen Bounce.

> **Prüfen:** Nach einem Testversand finden Sie die Ablehnung mit `journalctl -u postfix@- | grep NOQUEUE`, inklusive `from=`, `to=` und `helo=`.

## Schritt 3: Reverse-DNS prüfen, eingehend und ausgehend

Die Regel `reject_unknown_client` verlangt laut [Postfix-Dokumentation](https://www.postfix.org/postconf.5.html#reject_unknown_client_hostname), dass die IP des einliefernden Servers einen Reverse-DNS-Namen hat und dieser Name wieder auf dieselbe IP zeigt. Im Test lehnte KeyHelp mit 450 ab, solange das nicht passte. Im Log stand dazu „warning: hostname server.example.de does not resolve to address 192.0.2.25“. Nachdem wir für 192.0.2.25 in `/etc/hosts` einen passenden Namen hinterlegt hatten, wurde dieselbe Mail angenommen, im Log steht jetzt der Name statt „unknown“:

```plaintext
postfix/smtpd[2236]: C179942B3C: client=mail.{{domain}}[192.0.2.25]
```

Für den Versand gilt das umgekehrt: Viele Empfänger prüfen den Reverse-DNS Ihres Servers. Was Ihr Server beim Versand angibt, zeigte ein simulierter Empfängerserver (ein kleines Python-Skript) im Testnetz. Postfix meldete sich mit dem Hostnamen aus `myhostname`:

```plaintext
Verbindung von 198.51.100.1
<< EHLO server.example.de
<< MAIL FROM:<info@kunde1.example.de>
```

Wie HELO-Name, A-Eintrag und PTR-Eintrag der ausgehenden IP zusammenpassen sollten und wo Sie den PTR setzen, steht in [Reverse DNS (PTR) und IPv6 für Mailserver einrichten](https://s-edv.com/anleitungen/reverse-dns-ptr-ipv6-mailserver-einrichten).

Eine Falle beim Prüfen auf dem Server selbst: Der lokale Resolver `systemd-resolved` beantwortete im Test PTR-Anfragen für die zusätzlich eingerichteten Adressen 192.0.2.25 und 198.51.100.1 selbst, mit dem Hostnamen des Servers. Der lokale BIND kennt dieselbe Adresse nicht:

```plaintext
1.100.51.198.in-addr.arpa. 0	IN	PTR	server.example.de.
```

```bash
$ dig -x 198.51.100.1
$ dig @127.0.0.1 -x 198.51.100.1
```

Im Beispiel liefert die erste Abfrage den oben gezeigten Namen, die zweite „status: NXDOMAIN“. Ein PTR, der auf dem Server selbst korrekt aussieht, beweist also nichts. Prüfen Sie den öffentlichen Eintrag von einem anderen Rechner oder über einen öffentlichen Resolver.

> **Prüfen:** Mit Reverse-DNS steht im Log `client=NAME[IP]` statt `unknown[IP]`, und die Mail bekommt eine Queue-ID statt `NOQUEUE`.

## Schritt 4: Fail2Ban-Sperren erkennen und aufheben

Nach den Ablehnungen in Schritt 2 war die Test-IP plötzlich gar nicht mehr erreichbar: Python meldete „Connection refused“. Ursache war Fail2Ban. KeyHelp richtet den Jail `kh-postfix` ein, der Ablehnungen im Postfix-Log zählt. Im Beispiel gelten diese Werte (Fehlversuche, Zeitfenster und Sperrdauer in Sekunden):

```plaintext
4
600
600
```

```bash
$ fail2ban-client get kh-postfix maxretry
$ fail2ban-client get kh-postfix findtime
$ fail2ban-client get kh-postfix bantime
```

Vier Treffer des Filters in zehn Minuten führen also zu einer Sperre von zehn Minuten. Nicht jede Ablehnung zählt: Von den drei Ablehnungen um 17:52:23 erkannte der Filter im Test nur eine, später zählte er aber auch die Ablehnung „User unknown“:

```plaintext
2026-10-01 17:52:23,583 fail2ban.filter         [437]: INFO    [kh-postfix] Found 192.0.2.25 - 2026-10-01 17:52:23
2026-10-01 17:54:30,243 fail2ban.filter         [437]: INFO    [kh-postfix] Found 192.0.2.25 - 2026-10-01 17:54:30
```

Schickt ein Geschäftspartner innerhalb von zehn Minuten mehrere Mails an eine vertippte Adresse, kann sein Mailserver also gesperrt werden. Im Fail2Ban-Log stand:

```plaintext
2026-10-01 17:52:47,508 fail2ban.actions        [437]: NOTICE  [kh-postfix] Ban 192.0.2.25
```

Im Panel sehen Sie die Sperre unter „Sicherheit“, „Fail2Ban-Verwaltung“ mit Jail, Beginn, Ende und Dauer. Zum Aufheben markieren Sie die IP, wählen unter „- Mehrfachaktionen -“ den Eintrag „Ausgewählte IPs entsperren“ und klicken „Übernehmen“. Nach der Rückfrage stand bei `kh-postfix` wieder „0 x“, und eine Mail von dieser IP an ein vorhandenes Postfach wurde wieder angenommen.

![KeyHelp Fail2Ban-Verwaltung mit Liste der aktiven Jails, kh-postfix mit einer Sperre, und Tabelle mit der IP 192.0.2.25, gesperrt durch kh-postfix für 10 Minuten](https://s-edv.com/uploads/2026/10/b4f30d5242407c1726a4ed1d60526fbadbaeba18f78a1d7d4788b1a96451782e-1024.png)
*Fail2Ban hat den Absenderserver nach mehreren Ablehnungen gesperrt*

> **Prüfen:** `fail2ban-client status kh-postfix` zeigt „Currently banned: 0“, im Panel steht hinter `kh-postfix` „0 x“.

## Schritt 5: Bounces ausgehender Mails auswerten

Für ausgehende Mails haben wir im Testnetz zwei Empfängerserver mit einem Python-Skript simuliert, es sind keine echten Mailserver: einer lehnt mit einer Blocklisten-Meldung ab, der andere mit Greylisting. Postfix behandelt die beiden ganz unterschiedlich:

```plaintext
postfix/smtp[1933]: 75D3742B62: to=<kunde@[198.51.100.25]>, relay=198.51.100.25[198.51.100.25]:25, delay=0.04, delays=0.01/0.01/0/0.02, dsn=5.7.1, status=bounced (host 198.51.100.25[198.51.100.25] said: 550 5.7.1 Service unavailable; client [198.51.100.1] blocked using example blocklist
postfix/smtp[1925]: 7C44742B63: to=<kunde@[198.51.100.26]>, relay=198.51.100.26[198.51.100.26]:25, delay=0.05, delays=0.03/0/0/0.02, dsn=4.7.1, status=deferred (host 198.51.100.26[198.51.100.26] said: 450 4.7.1 Greylisted, please try again later (in reply to RCPT TO command))
```

Die 550-Antwort führt sofort zu `status=bounced`. Postfix erzeugt einen Unzustellbarkeitsbericht und stellt ihn dem Absender zu, im Test landete er im Postfach `info@kunde1.example.de`. Der entscheidende Teil steht wörtlich darin:

```plaintext
<kunde@[198.51.100.25]>: host 198.51.100.25[198.51.100.25] said: 550 5.7.1
    Service unavailable; client [198.51.100.1] blocked using example blocklist
    (in reply to RCPT TO command)
```

Der Teil nach „said:“ stammt vom fremden Server, nicht von KeyHelp. Bittet Sie ein Kunde um Hilfe, lassen Sie sich diesen Abschnitt schicken. Er nennt den ablehnenden Server, den Code und meist den Grund. Die 450-Antwort dagegen bleibt als `status=deferred` in der Warteschlange und wird später erneut versucht.

> **Prüfen:** Nach einem Bounce enthält das Postfach des Absenders eine Unzustellbarkeitsmeldung (im Test mit „Undelivered“ im Betreff), nach einem 4xx-Fehler steht die Mail in `postqueue -p` mit dem Grund in Klammern.

## Schritt 6: DNS aus Sicht des Servers abfragen

Unter „Tools“, „DNS-Abfrage“ bietet KeyHelp eine einfache DNS-Abfrage. Sie geben einen Hostnamen ein und klicken „Prüfen“. Für `{{domain}}` zeigte das Panel A, AAAA, MX, NS, SOA und TXT, darunter den Null-MX und den SPF-Eintrag `v=spf1 -all`, also genau die Ursache der nullMX-Ablehnung aus Schritt 2.

![KeyHelp-Werkzeug DNS-Abfrage mit Hostname example.org und Ergebnissen für A, AAAA, MX mit Wert 0, NS, SOA und TXT mit v=spf1 -all](https://s-edv.com/uploads/2026/10/8db3a86d664a7d9ae733c3c2af5ad6ccd5adaead8cd4ddc6539471ae35dc5581-1024.png)
*Die DNS-Abfrage im Panel zeigt alle wichtigen Eintragstypen auf einen Blick*

Für eine eigene Kundendomain lieferte das Werkzeug im Test dagegen nur „Ein Fehler ist aufgetreten.“ und „Failed to gather DNS records.“ Das Werkzeug fragt offenbar den normalen Resolver des Servers, nicht den lokalen BIND, in dem KeyHelp die Zonen der Kunden verwaltet: Für den eigenen Hostnamen `server.example.de` zeigte es als A-Eintrag 127.0.1.1, den Wert aus `/etc/hosts`. Solange eine Domain öffentlich nicht auf den Server zeigt, finden Sie deren Einträge nur mit `dig` direkt am lokalen BIND:

```bash
$ dig @127.0.0.1 kunde1.example.de MX +short
$ dig @127.0.0.1 kunde1.example.de TXT +short
$ dig kunde1.example.de MX
```

```plaintext
10 mail.kunde1.example.de.
"v=spf1 a mx -all"
status: NXDOMAIN
```

Der Vergleich beider Abfragen trennt zwei Fälle: Antwortet der lokale BIND richtig, der Resolver aber nicht, ist die Zone in KeyHelp vorhanden, wird aber außerhalb des Servers (noch) nicht gefunden. Mehr zur Pflege der Zonen steht in [KeyHelp DNS-Editor](https://s-edv.com/anleitungen/keyhelp-dns-editor-eintraege-ttl-externes-dns).

> **Prüfen:** `dig @127.0.0.1 DOMAIN MX +short` zeigt den MX aus der von KeyHelp verwalteten Zone, die DNS-Abfrage im Panel zeigt öffentliche Einträge fremder Domains.

## Typische Fehler

**„Connection refused“ beim Einliefern**

Kein Postfix-Problem, sondern eine Fail2Ban-Sperre nach mehreren Ablehnungen. Prüfen Sie „Fail2Ban-Verwaltung“ und den Jail `kh-postfix`.

**„Client host rejected: cannot find your hostname“**

Der einliefernde Server hat keinen Reverse-DNS, oder der Name zeigt nicht zurück auf seine IP. Der Absender muss das bei seinem Anbieter beheben, die Ablehnung ist vorübergehend (450).

**„Helo command rejected: need fully-qualified hostname“**

Ein Gerät oder Skript meldet sich mit Kurznamen wie `localhost`. In der Konfiguration steht `permit_sasl_authenticated` vor dieser Prüfung, angemeldete Absender sind also ausgenommen. Eigene Geräte wie Scanner sollten deshalb mit Anmeldung versenden.

**„Failed to gather DNS records.“ in der DNS-Abfrage**

Im Test trat das bei einer Kundendomain auf, die nur im lokalen BIND existiert, nicht im Resolver des Servers. Fragen Sie den lokalen BIND mit `dig @127.0.0.1` ab.

**Selbsttest des PTR auf dem Server**

`dig -x` ohne Serverangabe lieferte im Test für zusätzlich eingerichtete IP-Adressen den Hostnamen des Servers, obwohl kein PTR existierte.

## Häufige Fragen

### Warum stehen bei einer ausgehenden Mail zwei Queue-IDs im Log?

KeyHelp leitet ausgehende Mails über einen lokalen Dienst auf Port 10027, der bei fremden Absenderdomains die Absenderadresse für SRS umschreibt. Die erste ID endet dort mit „queued as …“, die zweite ID ist die eigentliche Zustellung. Die Hintergründe stehen in [E-Mail-Weiterleitungen mit SRS](https://s-edv.com/anleitungen/keyhelp-e-mail-weiterleitung-srs-sender-rewriting-scheme).

### Muss ich die Reverse-DNS-Prüfung beim Empfang abschalten?

In der Regel nicht. Die Ablehnung ist vorübergehend (450), der Absenderserver kann es später erneut versuchen, sobald sein PTR stimmt.

### Wo prüfe ich SPF, DKIM und DMARC?

Diese Prüfungen haben eine eigene Anleitung: [SPF, DKIM und DMARC für Kundendomains in KeyHelp](https://s-edv.com/anleitungen/keyhelp-spf-dkim-dmarc-kundendomains-einrichten-pruefen).

## Fazit

Die Ursache einer abgewiesenen Mail stand im Test jedes Mal wörtlich im Log oder im Bounce. Wer `NOQUEUE`, `bounced` und `deferred` unterscheiden kann, die erste Ziffer des Codes beachtet und bei DNS-Fragen den lokalen BIND vom öffentlichen Resolver trennt, findet die Ursache schnell. Fail2Ban gehört bei plötzlich unerreichbaren Partnern immer auf die Prüfliste.

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp: SPF, DKIM und DMARC für Kundendomains](https://s-edv.com/anleitungen/keyhelp-spf-dkim-dmarc-kundendomains-einrichten-pruefen)
- [KeyHelp: E-Mail-Weiterleitungen mit SRS](https://s-edv.com/anleitungen/keyhelp-e-mail-weiterleitung-srs-sender-rewriting-scheme)
- [Reverse DNS (PTR) und IPv6 für Mailserver einrichten](https://s-edv.com/anleitungen/reverse-dns-ptr-ipv6-mailserver-einrichten)
- [Keyweb: KeyHelp, alle Funktionen im Überblick](https://www.keyweb.de/de/keyhelp/keyhelp/alle-funktionen-im-ueberblick)
- [KeyHelp Knowledge Base: E-Mail Warteschlange](https://kb.keyhelp.de/article/e-mail-warteschlange-109.html)
- [Postfix-Dokumentation: reject_unknown_client_hostname](https://www.postfix.org/postconf.5.html#reject_unknown_client_hostname)
- [Linux-Server mit UFW und Fail2ban absichern](https://s-edv.com/anleitungen/linux-server-absichern-ufw-fail2ban)
