---
title: "KeyHelp: Rspamd-Spamfilter einrichten, einstellen und mit Testmails prüfen"
date: 2026-10-01T10:07:27+02:00
modified: 2026-11-08T21:14:50+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-rspamd-spamfilter-einrichten-einstellen
keywords:
  - KeyHelp
  - Rspamd
  - Spamfilter
  - E-Mail
  - Mailserver
  - Hosting-Panel
reading_time: 9
personalize_url: "https://s-edv.com/anleitungen/keyhelp-rspamd-spamfilter-einrichten-einstellen#ihr_hostname={ihr_hostname}&ihre_server_ip={ihre_server_ip}&domain={domain}"
variables:
  - name: ihr_hostname
    label: "Ihr hostname"
    default: "IHR-HOSTNAME"
  - name: ihr_rspamd_passwort
    label: "Ihr rspamd passwort"
    default: "IHR-RSPAMD-PASSWORT"
  - name: ihre_server_ip
    label: "Ihre server ip"
    default: "IHRE-SERVER-IP"
  - name: domain
    label: "Ihre Domain"
    default: "example.org"
---

# KeyHelp: Rspamd-Spamfilter einrichten, einstellen und mit Testmails prüfen

## 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 |
| --- | --- | --- |
| `{{ihr_hostname}}` | Ihr hostname | `IHR-HOSTNAME` |
| `{{ihr_rspamd_passwort}}` | Ihr rspamd passwort | `IHR-RSPAMD-PASSWORT` |
| `{{ihre_server_ip}}` | Ihre server ip | `IHRE-SERVER-IP` |
| `{{domain}}` | Ihre Domain | `example.org` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/keyhelp-rspamd-spamfilter-einrichten-einstellen#ihr_hostname=IHR-HOSTNAME&ihre_server_ip=IHRE-SERVER-IP&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.

Seit KeyHelp auf Debian 12 und Ubuntu 24.04 Rspamd als Spamfilter einsetzt, hat Keyweb die Spamabwehr mit jeder Version ausgebaut: SPF-Prüfung und eigene Schwellenwerte pro Postfach mit 25.0, automatisches Lernen mit 25.3, Greylisting-Schalter, DKIM-Zurückweisung und Black-/Whitelists pro Postfach mit 26.1 vom 14. August 2026. Die Einstellungen liegen verteilt auf drei Seiten im Admin- und Kundenbereich, und nicht jede Option wirkt so, wie die Beschriftung vermuten lässt. Diese Anleitung richtet sich an Administratoren kleiner Hosting-Server, Agenturen und KMU, die KeyHelp nach unserer Anleitung [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server) betreiben. Sie zeigt jede Einstellung mit ihrem echten Namen in der Oberfläche, was KeyHelp daraus in der Rspamd-Konfiguration macht und wie Sie die Wirkung mit Testmails selbst nachweisen.

**Kurzfassung:** Rspamd ist auf aktuellen KeyHelp-Servern mit Debian 12 oder Ubuntu 24.04 ab Werk aktiv: Greylisting, SPF-Zurückweisung, Virenprüfung mit ClamAV und automatisches Lernen sind eingeschaltet. Setzen Sie zuerst ein Passwort für die Rspamd-Weboberfläche, prüfen Sie dann unter „Konfiguration“ → „E-Mail-Spam- & Virenschutz“ die serverweiten Regeln und passen Sie bei Bedarf pro Postfach die Schwellenwerte an. Eine Mail ab 6 Punkten landet im Junk-Ordner, eine SPF-Fälschung und eine Blacklist-Adresse werden mit 554 abgewiesen. Ab 200 gelernten Spam- und Ham-Mails nutzt der Filter seine Trainingsdaten.

## Voraussetzungen

- [ ] **KeyHelp mit Rspamd:** Laut Keyweb nutzen Systeme mit Debian 12 oder neuer und Ubuntu 24.04 Rspamd; ältere Systeme (Debian 11, Ubuntu 20.04 und 22.04) arbeiten noch mit SpamAssassin und Amavis, für sie gilt diese Anleitung nicht. Wer noch auf Ubuntu 22.04 sitzt, wechselt vorher mit unserer Anleitung zum [Upgrade von Ubuntu 22.04 auf 24.04](https://s-edv.com/anleitungen/keyhelp-ubuntu-22-04-auf-24-04-upgrade-skript-pruefliste).
- [ ] **KeyHelp-Version:** Die Seite „E-Mail-Spam- & Virenschutz“ gibt es seit 25.3, Greylisting-Schalter, DKIM-Zurückweisung und Listen pro Postfach seit 26.1. Beschrieben ist Version 26.1.1 (Build 3698).
- [ ] **Arbeitsspeicher:** KeyHelp verlangt für die Virenprüfung mindestens 2 GiB. In der Regel belegt allein der ClamAV-Dienst rund 1 GB RAM.
- [ ] **Admin-Zugang** zum Panel und Root per SSH für die Prüfbefehle. Zum Testen eignet sich das Werkzeug `swaks` (`apt install swaks`).
- [ ] **Ein eigener DNS-Resolver:** KeyHelp weist darauf hin, dass DNS-Blacklists über öffentliche Resolver wie Google DNS oder Cloudflare oft nicht antworten.

## Schritt 1: Ausgangslage prüfen

Prüfen Sie zuerst, ob Rspamd läuft und Postfix die Mails an ihn übergibt. KeyHelp bindet Rspamd als Milter auf Port 11332 ein; Port 11334 ist die Weboberfläche, die das Panel unter `/rspamd/` durchreicht.

```bash
systemctl is-active rspamd redis-server clamav-daemon
postconf smtpd_milters milter_default_action
rspamadm configdump actions
rspamc stat | head -9
```

Die Grenzwerte liegen ab Werk bei 6 Punkten für „add header“ (Spam markieren) und 15 Punkten für „reject“. Greylisting setzt bei 4 Punkten ein. Wichtig ist `milter_default_action = accept`: Fällt Rspamd aus, stellt Postfix weiter zu, aber ungefiltert.

> **Prüfen:** Die Befehle liefern:
>
> ```plaintext
> active
> active
> active
> smtpd_milters = inet:localhost:11332
> milter_default_action = accept
> reject = 15;
> add_header = 6;
> greylist = 4;
> ```

## Schritt 2: Passwort für die Rspamd-Weboberfläche setzen

Die Weboberfläche zeigt Verlauf, Bewertungen und Statistiken. Öffnen Sie „Systemstatus“ → „Rspamd-Weboberfläche“. Bei der ersten Nutzung steht dort: „Um auf die Rspamd-Webschnittstelle zugreifen zu können, müssen Sie zunächst ein Zugangspasswort festlegen.“ Tragen Sie unter „Zugangspasswort aktualisieren“ ein eigenes Passwort ein (mindestens 12 Zeichen mit Groß- und Kleinbuchstaben, Ziffer und Sonderzeichen) und speichern Sie.

Verwenden Sie hier nicht Ihr Admin-Passwort. KeyHelp warnt selbst, dass ein Co-Administrator es lesen könnte. In der Datei `/etc/rspamd/local.d/worker-controller.inc` steht allerdings in der Regel ein Hash, kein Klartext. Die Oberfläche erreichen Sie anschließend unter `https://{{ihr_hostname}}/rspamd/`.

> **Prüfen:** Die Anmeldung mit dem Passwort klappt auch per Kommandozeile:
>
> ```bash
> $ curl -s -H "Password: {{ihr_rspamd_passwort}}" https://{{ihr_hostname}}/rspamd/auth
> ```
>
> ```plaintext
> {"version":"4.2.0","auth":"ok","uptime":172,"clean":3, ...}
> ```

## Schritt 3: Serverweite Regeln einstellen

Die zentrale Seite liegt unter „Konfiguration“ → „E-Mail-Spam- & Virenschutz“. Die Optionen und ihre Werkseinstellung:

| Option in der Oberfläche | Ab Werk | Wirkung in Rspamd |
| --- | --- | --- |
| Greylisting | aktiviert | `local.d/greylist.conf` und Aktion `greylist` |
| Zurückweisen von E-Mails, die SPF-Prüfungen nicht bestehen | aktiviert | Regel `REJECT_SPF_FAIL` in `force_actions.conf` |
| Whitelist \| IP-Adressen (SPF) | leer | `/var/lib/rspamd/keyhelp/spf_whitelist.map` |
| Zurückweisen von E-Mails, die DKIM-Prüfungen nicht bestehen | aus | Schalter in der Oberfläche |
| Zurückweisen von E-Mails aus Google-Groups-Mailinglisten | aus | Schalter in der Oberfläche |
| Blacklist/Whitelist \| E-Mail-Adressen | leer | Multimap mit +10 bzw. −50 Punkten |
| DNS-Blacklists/-Whitelists | leer | eigene DNSBL-Anbieter |
| Automatisches Spam- und Ham-Training | aktiviert, 10 und −2 | `classifier-bayes.conf` (autolearn) |
| E-Mail-Virenprüfung | aktiviert | ClamAV über `antivirus.conf` |

Nach dem Speichern meldet KeyHelp „Die Änderungen werden in wenigen Augenblicken wirksam.“ Die Dateien schreibt der minütliche KeyHelp-Cronjob; das dauert in der Regel unter einer Minute. Bearbeiten Sie die Dateien unter `/etc/rspamd/local.d/` nicht von Hand: Jede trägt den Kopf „DO NOT CHANGE ANYTHING IN THIS FILE, CHANGES WILL BE LOST ON NEXT UPDATE!“.

**Greylisting:** Es greift nur bei Mails ab 4 Punkten und hält sie fünf Minuten zurück. Unsere erste Testmail mit 4,9 Punkten bekam `451 4.7.1 Try again later`, derselbe Absender kam beim nächsten Versuch nach mehr als fünf Minuten durch. Wer Bestellbestätigungen oder Einmalcodes sofort braucht, kann es abschalten. KeyHelp setzt dann zusätzlich `greylist = null` in `actions.conf`, denn laut Kommentar in der Datei reicht das Abschalten des Moduls allein nicht.

**SPF-Whitelist:** Tragen Sie hier Server ein, die legitim im Namen fremder Domains senden, etwa ein Weiterleitungsdienst oder ein Scanner, der Mails verschickt.

> **Prüfen:** Nach einer Minute stehen Ihre Einträge in den Map-Dateien und Rspamd übernimmt sie:
>
> ```bash
> $ cat /var/lib/rspamd/keyhelp/*.map
> $ grep -v '^#' /etc/rspamd/local.d/greylist.conf
> ```
>
> ```plaintext
> /^.*@spam\.example$/iu
> 198.51.100.10
> freund@partner.example
> enabled = true
> ```

## Schritt 4: Regeln mit Testmails nachweisen

Nur eine echte Mail zeigt, ob eine Regel greift. Wichtig dabei: Mails aus privaten Netzen (Rspamd zählt 10.0.0.0/8, 172.16.0.0/12 und 192.168.0.0/16 als lokal) und von angemeldeten Benutzern bekommen keine Spam-Header (`skip_local` und `skip_authenticated` in `milter_headers.conf`). Testen Sie deshalb von einem externen Rechner mit öffentlicher IP-Adresse, etwa einem zweiten Server, mit `swaks`:

```bash
swaks --to info@ihre-domain.de --from test@microsoft.com \
  --server {{ihre_server_ip}} --header "Subject: Test SPF"
```

Die Ergebnisse unserer Testreihe an das Postfach `info@testkunde.example`:

| Testmail | Antwort des Servers |
| --- | --- |
| Absender `test@microsoft.com` von fremder IP | `554 5.7.1 SPF validation failed: Your email was rejected ...` |
| dieselbe Mail, IP in der SPF-Whitelist | zugestellt, 2,4 Punkte |
| Absender auf der globalen Blacklist mit „E-Mails zurückweisen“ | `554 5.7.1 Matched map: KH_GLOBAL_BLACKLIST_ADDRESS` |
| Absender auf der globalen Whitelist | zugestellt, −44,8 Punkte |
| GTUBE-Testmuster im Text | `554 5.7.1 Gtube pattern` |
| EICAR-Testvirus als Anhang | zugestellt, Betreff `***VIRUS*** Test EICAR` |

Beachten Sie die Virenmail: KeyHelp weist sie nicht ab, sondern markiert nur den Betreff. Die Regel `VIRUS` in `force_actions.conf` setzt die Aktion „rewrite subject“. Wer Viren gar nicht zustellen will, braucht derzeit eine eigene Lösung.

> **Prüfen:** Im Mail-Header der zugestellten Testmail steht die Bewertung samt Einzelregeln:
>
> ```powershell
> X-Spam-Status: Yes, score=6.20
> X-Spamd-Result: default: False [6.20 / 15.00];
> 	RBL_SPAMHAUS_PBL(2.00)[198.51.100.10:from];
> 	HFILTER_FROMHOST_NORES_A_OR_MX(1.50)[testkunde.example];
> X-Spam: Yes
> ```

Diese Mail lag wegen `X-Spam: Yes` im Ordner `.Junk`.

## Schritt 5: Schwellenwerte und Listen pro Postfach

Kunden (und Sie als Admin per Kundenlogin) stellen pro Postfach eigene Werte ein: „E-Mail-Adressen“ → Postfach bearbeiten → Reiter „Erweiterte Einstellungen“. Die Optionen dort:

- „Aktiviere E-Mail-Schutzmaßnahmen“ und „Eingehende E-Mails auf Viren prüfen“ (beide ab Werk an),
- „Verwende benutzerdefinierte Spam-Bewertungen“ mit „Spam-Markierungs-Punktzahl“, „Betreff umschreiben“ und „Spam-Zurückweisungs-Punktzahl“ (muss größer sein als die Markierungs-Punktzahl),
- „Spam in Junk-/Spam-Ordner verschieben“ (ab Werk an),
- „Blacklist | E-Mail-Adressen“ und „Whitelist | E-Mail-Adressen“,
- automatisches Löschen im Junk-Ordner und Papierkorb nach einer Zahl von Tagen.

Als Beispiel sind Markierung 8, Zurückweisung 12 und „Betreff umschreiben“ gesetzt. KeyHelp schreibt daraus einen Eintrag in `/var/lib/rspamd/keyhelp/account_settings.conf`:

Datei: `/var/lib/rspamd/keyhelp/account_settings.conf`

```plaintext
account_3b3137fc... {
    priority = medium;
    rcpt = "info@testkunde.example";
    apply {
        actions {
            "add header" = 8;
            "rewrite subject" = 8.001;
            reject = 12;
        }
    }
}
```

Eine Mail mit 4,9 Punkten kam danach ohne Spam-Kennzeichnung im Posteingang an, der Header zeigte `[4.90 / 12.00]`.

**Achtung bei der Blacklist pro Postfach:** KeyHelp schreibt den Eintrag mit zwei Bedingungen, `from` (Umschlag-Absender) und `from_mime` (sichtbarer Absender). Die Regel greift nur, wenn beide passen; dann weist der Server die Mail mit `554 5.7.1 Spam message rejected` ab (99,9 Punkte). Stimmt nur der sichtbare Absender, wird die Mail normal zugestellt. Die globale Blacklist reagiert dagegen schon auf einen der beiden Absender.

> **Prüfen:** Nach einer Minute steht der Eintrag in der Datei:
>
> ```bash
> $ grep -A3 'rcpt = "info@ihre-domain.de"' /var/lib/rspamd/keyhelp/account_settings.conf
> ```

## Schritt 6: Den Filter trainieren

Rspamd lernt mit einem Bayes-Filter, was auf Ihrem Server Spam ist. Laut KeyHelp-Oberfläche braucht er mindestens 200 gelernte Spam- und 200 Ham-Nachrichten, bevor die Daten in die Bewertung eingehen. Drei Wege füllen ihn:

- **Junk-Ordner:** Die Datei `/etc/cron.d/keyhelp-rspamd-learn` lernt jede Nacht um 0:30 Uhr alle Mails in den Ordnern `.Junk/cur` aller Postfächer als Spam. Bitten Sie Ihre Nutzer, Spam in den Junk-Ordner zu verschieben statt zu löschen.
- **Automatisch:** Eingehende Mails ab 10 Punkten lernt Rspamd als Spam, unter −2 Punkten als Ham (Felder „Automatisches Spam-Training“ und „Automatisches Ham-Training“).
- **Von Hand:** KeyHelp nennt in der Oberfläche die Befehle dafür:

```bash
rspamc learn_spam /var/mail/vhosts/ihre-domain.de/info/.Junk/cur/
rspamc learn_ham /var/mail/vhosts/ihre-domain.de/info/cur/
```

Sehr kurze Mails lehnt der Klassifikator ab. Bei einer Zweizeiler-Mail meldet `rspamc`: `contains less tokens than required for bayes classifier: 8 < 11`. Das ist kein Fehler; solche Mails zählen einfach nicht.

> **Prüfen:** Die Zähler steigen nach jedem Lernlauf:
>
> ```bash
> rspamc stat | grep BAYES
> ```
>
> ```plaintext
> Statfile: BAYES_SPAM type: redis; ... learned: 1; users: 1; languages: 0
> Statfile: BAYES_HAM type: redis; ... learned: 1; users: 1; languages: 0
> ```

## Typische Fehler

### Testmail hat keinen X-Spam-Header

Mails aus privaten Netzen oder von angemeldeten Benutzern erhalten bewusst keine Header (siehe Schritt 4). Unsere erste Testmail aus dem internen Netz der VM kam ohne jede Bewertung an. Testen Sie von einer öffentlichen Adresse aus.

### Testmail scheitert schon vor Rspamd

Postfix prüft vorher selbst. Typische Antworten sind `450 4.7.25 Client host rejected: cannot find your hostname` (sendende IP ohne Reverse-DNS) und `550 5.7.27 ... Domain {{domain}} does not accept mail (nullMX)`. Beides sind Postfix-Regeln aus `smtpd_sender_restrictions`, nicht Rspamd.

### Viele Spam-Treffer bei sauberen Mails

Beispiel: Eine simulierte Absender-IP bekam 2 Punkte von `RBL_SPAMHAUS_PBL` (Spamhaus-Liste für Einwahl- und Endkundenadressen), zusammen mit fehlenden DNS-Einträgen reichte das für 6,2 Punkte. Mailserver an Endkundenanschlüssen trifft das ebenso. Prüfen Sie in der Weboberfläche unter „History“, welche Regeln anschlagen, bevor Sie Grenzwerte ändern.

### Änderung wirkt nicht sofort

Die Dateien schreibt der KeyHelp-Cronjob einmal pro Minute. Warten Sie eine Minute, dann prüfen Sie die Datei.

## Häufige Fragen

### Kann ich eigene Rspamd-Regeln ergänzen?

Die Dateien unter `local.d`, die KeyHelp anlegt, überschreibt es bei Updates. Legen Sie eigene Regeln in Dateien an, die KeyHelp nicht verwaltet; Rspamd kennt dafür `local.d` und `override.d`.

### Wird Spam abgewiesen oder zugestellt?

Ab Werk wird ab 6 Punkten markiert und in den Junk-Ordner verschoben, ab 15 Punkten abgewiesen. Pro Postfach lassen sich beide Werte ändern.

### Lohnt sich die Virenprüfung auf kleinen Servern?

ClamAV belegt in der Regel rund 1 GB RAM. Auf Servern mit 2 GB wird es eng; KeyHelp rät dann selbst zum Abschalten, weil sonst Mails in der Warteschlange hängen können.

## Fazit

KeyHelp liefert Rspamd sinnvoll vorkonfiguriert aus. Zu tun bleibt wenig: Passwort für die Weboberfläche setzen, Greylisting bewusst behalten oder abschalten, SPF-Ausnahmen pflegen und die Nutzer zum Junk-Ordner erziehen, damit der Filter lernt. Prüfen Sie jede Änderung mit einer Testmail und einem Blick in den Header. Wer verstehen will, wie Postfix, Dovecot und Rspamd ohne Panel zusammenspielen, findet das in unserer Anleitung zum [nativen Mailserver mit Postfix, Dovecot und Rspamd](https://s-edv.com/anleitungen/mailserver-nativ-postfix-dovecot-rspamd-ubuntu-systemd).

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern: das kostenlose Hosting-Panel für eigene Server](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp-Server von Ubuntu 22.04 auf 24.04 upgraden](https://s-edv.com/anleitungen/keyhelp-ubuntu-22-04-auf-24-04-upgrade-skript-pruefliste)
- [Keyweb: KeyHelp 25.0 mit SPF-Prüfung und Spam-Schwellen pro Postfach](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-25.0)
- [Keyweb: KeyHelp 25.3 mit Spam-Training](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-25.3)
- [Keyweb: KeyHelp 26.1 mit Greylisting-Schalter und Listen pro Postfach](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-26.1)
- [Rspamd-Dokumentation](https://rspamd.com/doc/)
