---
title: "KeyHelp: E-Mail-Weiterleitungen mit SRS zuverlässig zustellen"
date: 2026-10-01T11:13:14+02:00
modified: 2026-11-08T22:37:01+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-e-mail-weiterleitung-srs-sender-rewriting-scheme
keywords:
  - KeyHelp
  - SRS
  - SPF
  - E-Mail-Weiterleitung
  - Postfix
  - Mailserver
reading_time: 8
personalize_url: "https://s-edv.com/anleitungen/keyhelp-e-mail-weiterleitung-srs-sender-rewriting-scheme#domain={domain}&server_ip={server_ip}"
variables:
  - name: domain
    label: "Ihre Domain"
    default: "example.com"
  - name: server_ip
    label: "Server ip"
    default: "SERVER-IP"
---

# KeyHelp: E-Mail-Weiterleitungen mit SRS zuverlässig zustellen

## 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.com` |
| `{{server_ip}}` | Server ip | `SERVER-IP` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/keyhelp-e-mail-weiterleitung-srs-sender-rewriting-scheme#domain=cloud.example.com&server_ip=SERVER-IP

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.

Weiterleitungen gehören zu den häufigsten Wünschen in kleinen Firmen: Die Adresse info@ der Firmendomain soll im privaten Postfach des Chefs landen, die Bewerbungsadresse bei einem externen Dienstleister. Genau diese Mails kommen beim Ziel aber oft nicht an oder landen im Spam. Der Grund ist SPF: Der Zielserver sieht eine Mail mit dem Absender einer fremden Domain, die von Ihrem Server kommt, und Ihr Server steht nicht im SPF-Eintrag dieser Domain. Seit Version 24.1 vom Juni 2024 löst KeyHelp das mit dem Sender Rewriting Scheme (SRS). Diese Anleitung erklärt, was SRS auf einem KeyHelp-Server technisch macht, wie Sie Weiterleitungen einrichten und wie Sie die Umschreibung selbst nachweisen. Grundlage ist ein Server nach unserer Anleitung [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).

**Kurzfassung:** SRS ersetzt bei weitergeleiteten Mails den Umschlag-Absender durch eine Adresse Ihres Servers, zum Beispiel `SRS0=BW/V=HX=fremd.example=absender@kh.{{domain}}`. Der Zielserver prüft SPF dann gegen Ihren Hostnamen statt gegen die fremde Domain. Bei Neuinstallationen ist SRS aktiv, nach Updates von älteren Versionen schalten Sie es unter „Konfiguration“ → „E-Mail-Server“ ein. Prüfen Sie, dass Ihr Hostname einen SPF-Eintrag hat, der die Server-IP erlaubt. Weiterleitungen werden umgeschrieben, Rückläufer korrekt an den Absender zurückgeführt und gefälschte SRS-Adressen abgewiesen.

## Voraussetzungen

- [ ] **KeyHelp ab 24.1:** Laut Keyweb ist SRS bei Neuinstallationen ab dieser Version aktiv, bei aktualisierten Servern muss es eingeschaltet werden. Wir haben KeyHelp 26.1.1 auf Debian 12 getestet.
- [ ] **Admin-Zugang** zum Panel für den Schalter und Root per SSH für die Prüfbefehle.
- [ ] **DNS-Zugriff auf den Hostnamen des Servers.** SRS-Adressen enden auf den Hostnamen, nicht auf die Kundendomain. Der Hostname braucht deshalb einen eigenen SPF-Eintrag.
- [ ] **Ein externes Testpostfach**, an das Sie weiterleiten, um den Header beim Empfänger zu prüfen.
- [ ] Optional das Werkzeug `swaks` für Testmails (`apt install swaks`).

## Schritt 1: Verstehen, was SRS umschreibt

Eine Mail hat zwei Absender: den sichtbaren im Header `From:` und den Umschlag-Absender aus dem SMTP-Befehl `MAIL FROM`, der später als `Return-Path` im Header steht. SPF prüft nur den Umschlag-Absender. Leitet Ihr Server eine Mail von `absender@fremd.example` weiter, steht dort weiterhin `fremd.example`, obwohl Ihre Server-IP sendet. Hat `fremd.example` ein striktes SPF mit `-all`, schlägt die Prüfung fehl.

SRS ersetzt nur diesen Umschlag-Absender. Der sichtbare Absender bleibt unverändert, der Empfänger sieht wie gewohnt `absender@fremd.example`. Die neue Adresse enthält einen Prüfwert (Hash), einen Zeitstempel, die Originaldomain und den Originalnamen. Dadurch kann Ihr Server einen Rückläufer später wieder der ursprünglichen Adresse zuordnen, und fremde Server können keine gültigen SRS-Adressen erfinden.

SRS behebt SPF, nicht DMARC: Weil die Umschlag-Domain danach nicht mehr zur `From:`-Domain passt, hängt ein DMARC-Ergebnis beim Empfänger von der DKIM-Signatur des Absenders ab. Bleibt die Mail beim Weiterleiten unverändert, bleibt diese Signatur gültig.

> **Prüfen:** Die weitergeleitete Mail kommt beim Zielserver so an (gekürzt):
>
> ```powershell
> X-Mail-Args: <SRS0=BW/V=HX=fremd.example=absender@kh.{{domain}}>
> X-Rcpt-Args: <extern@ziel.example> ORCPT=rfc822;info@testkunde.example
> From: absender@fremd.example
> To: info@testkunde.example
> ```

> **Prüfen:** Vergleichen Sie den umgeschriebenen Umschlag-Absender mit dem unveränderten From-Header.

## Schritt 2: SRS im Panel einschalten

Öffnen Sie im Admin-Bereich „Konfiguration“ → „E-Mail-Server“. Weiter unten steht der Eintrag „Sender Rewriting Scheme (SRS)“ mit der Beschreibung „Durch Aktivieren dieser Einstellung wird das Sender Rewriting Scheme (SRS) aktiviert, eine Methode zum Umschreiben des Absender-Envelopes einer E-Mail, damit das Sender Policy Framework (SPF) auch für E-Mail-Weiterleitungen funktioniert.“ Setzen Sie den Haken bei „Aktiviert“ und klicken Sie auf „Speichern“.

Das Panel meldet „Die Einstellungen wurden aktualisiert. Die Änderungen werden in wenigen Augenblicken wirksam.“ Die Konfiguration schreibt der KeyHelp-Cronjob, der jede Minute läuft. Die Änderung ist nach etwa einer Minute aktiv.

> Prüfen Sie die Postfix-Werte, die KeyHelp setzt:
>
> ```bash
> postconf default_transport recipient_canonical_maps
> systemctl is-active postsrsd
> ```
>
> ```plaintext
> default_transport = smtp:127.0.0.1:10027
> recipient_canonical_maps = tcp:127.0.0.1:10002
> active
> ```

Ist SRS aus, steht dort `default_transport = smtp` und `recipient_canonical_maps` ist leer.

> **Prüfen:** Die Postfix-Werte müssen den gezeigten Sollwerten entsprechen; postsrsd muss aktiv sein.

## Schritt 3: Was KeyHelp intern einrichtet

KeyHelp nutzt das Debian-Paket `postsrsd` (zum Beispiel Version 1.10). Es läuft als eigener Dienst und bietet zwei Nachschlagetabellen an: Port 10001 schreibt Absender um, Port 10002 macht das rückgängig. Die Einstellungen stehen in `/etc/default/postsrsd`:

```plaintext
SRS_DOMAIN=kh.{{domain}}
SRS_SEPARATOR==
SRS_SECRET=/etc/postsrsd.secret
SRS_HASHLENGTH=4
SRS_FORWARD_PORT=10001
SRS_REVERSE_PORT=10002
```

In Postfix leitet KeyHelp jede ausgehende Mail über einen zweiten, internen SMTP-Dienst auf `127.0.0.1:10027`. Dieser nutzt einen eigenen Cleanup-Dienst `cleanup-srs` mit zwei Tabellen für den Umschlag-Absender. Die erste fragt in der KeyHelp-Datenbank nach, ob die Absenderdomain auf dem Server angelegt ist. Wenn ja, bleibt der Absender unverändert. Nur fremde Domains gehen an postsrsd. Ein Kommentar in `/etc/postfix/mysql-virtual-srs-local-domains.cf` begründet die Prüfung auf Domainebene: Kunden können aus PHP auch mit nicht existierenden Absenderadressen ihrer Domain senden.

Auf dem internen Dienst sind die Milter abgeschaltet (`-o smtpd_milters=`), Rspamd prüft die Mail also nicht ein zweites Mal. Die Datei `/etc/postsrsd.secret` enthält den Schlüssel für den Hash. Sichern Sie sie mit, wenn Sie den Server umziehen: Ein neuer Schlüssel macht alle noch laufenden Rückläufer ungültig.

> **Prüfen:** Eine Mail mit Absender Ihrer eigenen Domain bleibt unverändert, eine fremde wird umgeschrieben. Beispiel:
>
> ```plaintext
> from chef@testkunde.example   -> MAIL FROM:<chef@testkunde.example>
> from absender@fremd.example   -> MAIL FROM:<SRS0=BW/V=HX=fremd.example=absender@kh.{{domain}}>
> ```

> **Prüfen:** Nur die Mail mit fremder Absenderdomain darf umgeschrieben werden.

## Schritt 4: SPF-Eintrag für den Hostnamen prüfen

Nach der Umschreibung prüft der Zielserver SPF gegen den Hostnamen, im Beispiel `kh.{{domain}}`. Verwaltet KeyHelp die DNS-Zone des Hostnamens, legt es `v=spf1 a mx -all` an. Liegt die Zone beim Domain-Anbieter, müssen Sie den Eintrag dort selbst setzen, sonst bringt SRS nichts.

```bash
$ dig +short TXT kh.{{domain}}
```

Die SPF-Prüfung lässt sich mit dem Python-Paket `python3-spf` nachstellen: einmal für den Originalabsender, einmal für die SRS-Adresse, jeweils mit der IP-Adresse des weiterleitenden Servers. Als Originaldomain diente `{{domain}}`, die öffentlich `v=spf1 -all` veröffentlicht.

```bash
$ python3 -c 'import spf; print(spf.check2(i="{{server_ip}}", s="absender@{{domain}}", h="kh.{{domain}}"))'
```

> **Prüfen:** Ohne SRS fiel die Prüfung durch, mit SRS bestand sie (die SRS-Adresse über den Nameserver des Testservers, der die Zone des Hostnamens hält):
>
> ```plaintext
> absender@{{domain}}                              ('fail', 'SPF fail - not authorized')
> SRS0=7cRs=HX={{domain}}=absender@kh.{{domain}}  ('pass', 'sender SPF authorized')
> ```

> **Prüfen:** Die SPF-Prüfung mit Ihrer Server-IP und SRS-Adresse muss pass ergeben.

## Schritt 5: Weiterleitung für ein Postfach einrichten

Weiterleitungen legen Sie pro Postfach an, als Kunde unter „E-Mail-Adressen“ beim jeweiligen Konto, Reiter „Weiterleitungen“. Dort gibt es zwei Einstellungen:

- **„Weitergeleitete E-Mails auch im Postfach speichern“:** Ohne Haken landet die Mail nur beim Ziel. Dann liegt sie nicht im Postfach.
- **„Weiterleitungen“:** eine oder mehrere Zieladressen, getrennt durch Leerzeichen, Komma, Semikolon oder Zeilenumbruch.

Unter dem Feld steht der Hinweis „Wenn Sie eine externe E-Mail-Adresse verwenden, die nicht von diesem Server verwaltet wird, müssen Sie diesen Server möglicherweise in den SPF-Einstellungen (SPF = Sender Policy Framework) des externen Servers auf die Whitelist setzen.“ Mit aktivem SRS ist das in der Regel nicht nötig. Weiterleitungen lassen sich auch per API setzen (Feld `forwardings`), wie unsere Anleitung zur [KeyHelp-REST-API](https://s-edv.com/anleitungen/keyhelp-rest-api-kunden-domains-postfaecher-automatisieren) zeigt.

> **Prüfen:** Senden Sie eine Mail von einer fremden Adresse an das Postfach und prüfen Sie das Mail-Log:
>
> ```bash
> $ journalctl -u postfix@- --since "-5min" | grep -E "SRS0|orig_to"
> ```
>
> ```plaintext
> postfix/smtp: B28BD42663: to=<extern@ziel.example>, orig_to=<info@testkunde.example>, relay=127.0.0.1[127.0.0.1]:10027, status=sent
> postfix/qmgr: 1F4F7428CD: from=<SRS0=BW/V=HX=fremd.example=absender@kh.{{domain}}>, nrcpt=1 (queue active)
> ```

Beim Empfänger steht die SRS-Adresse im Header `Return-Path`.

> **Prüfen:** Return-Path muss beim Empfänger eine SRS-Adresse Ihres Servers enthalten.

## Schritt 6: Rückläufer und Missbrauchsschutz prüfen

Kann das Ziel die Mail nicht zustellen, schickt es den Rückläufer an die SRS-Adresse. postsrsd prüft den Hash und setzt die Originaladresse wieder ein. Ein Rückläufer wird korrekt an `absender@fremd.example` weitergereicht:

```plaintext
postsrsd: srs_reverse: <SRS0=BW/V=HX=fremd.example=absender@kh.{{domain}}> rewritten as <absender@fremd.example>
postfix/smtp: to=<absender@fremd.example>, orig_to=<SRS0=BW/V=HX=fremd.example=absender@kh.{{domain}}>
```

Eine erfundene SRS-Adresse mit falschem Hash weist der Server ab. So kann niemand Ihren Server als offenes Relay für Rückläufer missbrauchen.

> **Prüfen:** Mit dem Hash `XXXX` von außen:
>
> ```plaintext
> postsrsd: srs_reverse: <srs0=xxxx=hx=fremd.example=absender@kh.{{domain}}> not rewritten: Hash invalid in SRS address.
> NOQUEUE: reject: RCPT from ziel.example[198.51.100.20]: 550 5.1.1 <SRS0=XXXX=...@kh.{{domain}}>: Recipient address rejected: User unknown in local recipient table
> ```

> **Prüfen:** Ein gültiger Rückläufer muss den ursprünglichen Absender erreichen; ein ungültiger Hash muss abgewiesen werden.

## Typische Fehler

### Weiterleitungen landen trotz SRS im Spam

Prüfen Sie den SPF-Eintrag des Hostnamens (Schritt 4). Fehlt er, bekommt die SRS-Adresse kein SPF-Ergebnis. Bei uns lieferte die Prüfung über einen Resolver, der die Zone des Testhostnamens nicht kannte, nur `none`.

### Rückläufer kommen beim Server an und werden verzögert

Ein gültiger Rückläufer von außen kann zunächst „4.7.1 Try again later“ bekommen. Das ist das Greylisting von Rspamd, nicht SRS. Der sendende Server stellt später erneut zu. Wie Sie Greylisting steuern, steht in unserer Anleitung zum [Rspamd-Spamfilter in KeyHelp](https://s-edv.com/anleitungen/keyhelp-rspamd-spamfilter-einrichten-einstellen).

### SRS ausgeschaltet, Dienst läuft trotzdem

Nach dem Abschalten im Panel lief `postsrsd` weiter, Postfix nutzte ihn aber nicht mehr. Maßgeblich ist die Ausgabe von `postconf default_transport`.

### Weiterleitung an eine fremde Domain wird abgewiesen

Postfix prüft eingehende Absender mit `reject_unknown_sender_domain`. Existiert die Absenderdomain nicht im DNS, wird die Mail schon beim Eingang mit „450 4.1.8 Sender address rejected: Domain not found“ abgelehnt und gar nicht erst weitergeleitet.

## Häufige Fragen

### Ändert SRS den Absender, den der Empfänger sieht?

Nein. Nur der Umschlag-Absender ändert sich. `From:` bleibt unverändert.

### Werden auch normale Mails meiner Kunden umgeschrieben?

Nein, solange die Absenderdomain auf dem Server angelegt ist. Umgeschrieben werden nur Mails mit fremder Absenderdomain, also vor allem Weiterleitungen.

### Sollte ich SRS abschalten?

Nur mit gutem Grund. Ohne SRS fiel die nachgestellte SPF-Prüfung durch, weil die Originaldomain SPF mit `-all` nutzt. Mit abgeschaltetem SRS ging die weitergeleitete Mail mit dem unveränderten Absender `absender@fremd.example` hinaus.

## Fazit

SRS ist in KeyHelp mit einem Haken erledigt und arbeitet im Hintergrund zuverlässig: Weiterleitungen bestehen die SPF-Prüfung, Rückläufer finden zurück, gefälschte Rückläufer werden abgewiesen. Die wichtigste Nacharbeit liegt außerhalb des Panels: Der Hostname braucht einen SPF-Eintrag, der die Server-IP erlaubt. Wer SPF, DKIM und DMARC für seine Domains insgesamt sauber aufstellen will, findet Hinweise in unserer Anleitung zum [Domainumzug mit DNS, MX, SPF und DKIM](https://s-edv.com/anleitungen/domain-umziehen-ohne-ausfall-dns-email-webseite).

## 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: Rspamd-Spamfilter einrichten und einstellen](https://s-edv.com/anleitungen/keyhelp-rspamd-spamfilter-einrichten-einstellen)
- [Keyweb: KeyHelp 24.1 mit Sender Rewriting Scheme](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-24.1)
- [PostSRSd, Projektseite](https://github.com/roehling/postsrsd)
- [RFC 7208: Sender Policy Framework](https://www.rfc-editor.org/rfc/rfc7208)
