DevOps / CI/CD

Next.js 16 Server Actions wegen Cross-Origin-Anfragen abgelehnt? Reverse-Proxy prüfen (2026)

Im Browser wird eine Server Action abgelehnt, obwohl dieselbe Funktion lokal funktioniert.

Schnellste Lösung: Vergleichen Sie zuerst den Browser-Origin, den nach der Proxy-Weiterleitung bei Next.js eintreffenden Host und die tatsächlich empfangene Anfrage. Ergänzen Sie serverActions.allowedOrigins nur, wenn ein legitimer Cross-Origin-Aufruf nachgewiesen ist und die Weiterleitung korrekt eingerichtet wurde.

Dieser Leitfaden richtet sich an Frontend-Teams, die Next.js 16 mit App Router hinter einem Reverse Proxy, Gateway oder mehreren Domains betreiben.
Plattformteams können damit die Weitergabe von Host-Informationen entlang der Proxy-Kette überprüfen.
Verantwortliche für Anwendungssicherheit erhalten Kriterien, um zusätzliche Ursprünge eng zu begrenzen.

Zuerst feststellen, an welcher Stelle die Anfrage scheitert

Eine Meldung über eine nicht erlaubte Quelle kann verschiedene Ursachen haben. Die Anfrage kann vor Next.js am Gateway abgewiesen, bei der Quellenprüfung im Anwendungsprozess abgelehnt oder erst innerhalb der Action durch Anwendungslogik beendet werden. Diese Fälle verlangen unterschiedliche Korrekturen. Ein Fehlertext im Browser reicht nicht aus, um sie auseinanderzuhalten.

Server Actions werden über eine HTTP-Anfrage aufgerufen; die Next.js-Dokumentation beschreibt den Aufruf- und Änderungsablauf. Prüfen Sie deshalb in den Browser-Entwicklerwerkzeugen unter „Netzwerk“, ob der zugehörige Request tatsächlich gesendet wurde und welche Antwort zurückkam. Die Next.js-Dokumentation zum Ändern von Daten und Aufrufen von Server Actions erläutert den Ablauf. Für eine erste Einordnung gilt: Ein Statuscode ist ein Hinweis, aber kein Beweis für eine bestimmte Fehlerursache.

Beobachtung Wahrscheinliche Prüfstrecke Nächster sinnvoller Schritt
Kein passender Request im Anwendungsprotokoll Browser, Gateway, WAF oder Proxy vor Next.js Anfrage anhand von Zeitpunkt, Pfad und Korrelationskennung in vorgelagerten Protokollen suchen
Request erreicht Next.js, Origin und Host weichen unerwartet voneinander ab Quellenprüfung oder Host-Umschreibung Weiterleitungsregeln und empfangene Header je Proxy-Stufe vergleichen
Request erreicht die Action und die Anwendung protokolliert einen Fehler Action-Logik, Authentifizierung oder Berechtigung Anwendungsfehler und Autorisierungsentscheidungen untersuchen
Antwort stammt erkennbar vom Gateway statt von Next.js Proxy-Regel, Gateway-Richtlinie oder WAF Gateway-Protokolle und Antwortheader prüfen

Ein HTTP-Statuscode wie 403 bedeutet laut HTTP-Semantik, dass der Server die Anfrage verstanden hat, ihre Ausführung aber verweigert. Er identifiziert nicht allein, welcher Server in einer mehrstufigen Bereitstellung sie abgelehnt hat. Die HTTP-Spezifikation zu 403 Forbidden hilft bei der Bedeutung des Status, nicht bei der Zuordnung zu einer konkreten Proxy-Stufe.

Für Browser-Aufrufende: Origin und Ziel-Host gegenüberstellen

Der Browser sendet im Origin-Header den Ursprung der Seite, von der eine Anfrage ausgeht. Dazu gehören Schema, Hostname und gegebenenfalls der Port; der Header ist nicht einfach die vollständige Seitenadresse mit Pfad. Die MDN-Referenz zum Origin-Header beschreibt seinen Aufbau und seine Verwendung.

Vergleichen Sie diese Werte für einen fehlgeschlagenen Action-Aufruf:

  • die Adresse der Seite, auf der das Formular oder die aufrufende Komponente geöffnet ist;
  • die Zieladresse des Action-Requests in den Browserwerkzeugen;
  • den Origin-Header des Requests;
  • den Hostnamen, den der Anwendungsserver laut Protokoll tatsächlich erhalten hat.

Ein Wechsel zwischen http und https, zwischen zwei Subdomains oder zwischen unterschiedlichen Ports kann einen anderen Ursprung ergeben. Auch ein Wechsel von einer Preview-Adresse auf die Produktionsdomain kann den Befund verändern. Der passende Vergleich ist daher nicht „lokal gegen Produktion“ im Allgemeinen, sondern dieselbe Action über die tatsächlich verwendeten Einstiegsadressen.

Sichern Sie die Anfrage als Nachweis, aber veröffentlichen Sie keine vollständigen Request-Header ohne vorherige Bereinigung. Entfernen Sie Cookies, Sitzungskennungen, Autorisierungswerte, personenbezogene Daten und interne Hostnamen, sofern diese nicht für eine geschützte Betriebsanalyse erforderlich sind. Bei der Aufbewahrung von Protokollen sind Zweck, Zugriff und Löschfristen im Rahmen der geltenden Datenschutzvorgaben festzulegen. KuzCloud beschreibt seine Datenschutzinformationen unter Datenschutz und Umgang mit Daten.

Hinweis: Ein Browserfehler mit dem Wort „Cross-Origin“ beweist nicht automatisch, dass die allgemeine CORS-Konfiguration die Ursache ist. Die Quellenprüfung von Server Actions, eine Gateway-Regel und eine tatsächliche CORS-Blockade sind getrennte Prüfpfade.

Für Plattformteams: die Weiterleitung bis zu Next.js rekonstruieren

Next.js dokumentiert für Server Actions einen Vergleich zwischen dem Origin der Anfrage und dem Host; zusätzliche erlaubte Ursprünge lassen sich über allowedOrigins konfigurieren. Das ist eine Quellenprüfung. Es ersetzt weder eine korrekte Host-Weitergabe noch die Analyse der Proxy-Kette. Die offizielle Konfigurationsreferenz für Server Actions sollte für die konkret eingesetzte Next.js-Version maßgeblich sein.

Bei einer Proxy-Bereitstellung ist zu klären, welche Komponente den öffentlichen TLS-Endpunkt annimmt, welche den Request weiterleitet und ob nachgelagerte Komponenten den öffentlichen Host oder einen internen Dienstnamen sehen. X-Forwarded-Host kann einen ursprünglichen Hostnamen entlang einer Proxy-Kette vermitteln; seine Bedeutung hängt jedoch davon ab, welche Komponente den Header setzt und welcher Komponente die Anwendung vertraut. Die MDN-Referenz zu X-Forwarded-Host beschreibt den Header. Die Next.js-Anleitung zum selbst gehosteten Betrieb behandelt außerdem den Einsatz eines Reverse Proxys vor einer selbst gehosteten Anwendung.

Gehen Sie für jede Proxy-Stufe dieselben Fragen durch:

  • Wird der eingehende öffentliche Host unverändert weitergereicht oder durch einen internen Namen ersetzt?
  • Wird X-Forwarded-Host vom vertrauenswürdigen Proxy gesetzt, oder kann ein nicht vertrauenswürdiger Client einen gleichnamigen Wert einschleusen?
  • Löscht oder überschreibt eine weitere Stufe Header, die eine vorherige Stufe gesetzt hat?
  • Erhält Next.js die Werte, die im Browser sichtbar sind, oder nur die Werte eines internen Netzwerks?
  • Weist das Gateway den Request ab, bevor er den Next.js-Prozess erreicht?

Die HTTP-Spezifikation definiert Gateways als Vermittler zwischen Protokollen oder Verbindungen. Sie legt damit aber nicht automatisch fest, welche konkrete Header-Umschreibung ein bestimmtes Produkt vornimmt. Die HTTP-Spezifikation zu Gateways und Vermittlern ist eine Protokollgrundlage, kein Ersatz für die Konfiguration und Protokolle der eingesetzten Proxy-Schicht.

Im mittleren Prüfpunkt die passende Fehlerklasse auswählen

Die folgende Gegenüberstellung hilft, eine Änderung an der richtigen Stelle vorzunehmen. Sie verhindert insbesondere, dass eine Änderung an allowedOrigins einen falschen Host oder eine vorgelagerte Blockade verdeckt.

Fehlerbild Beleg, den das Team sichern sollte Geeignete Korrekturrichtung Nicht vorschnell tun
Next.js erhält Anfrage, Origin und Host passen nicht zur vorgesehenen Domain Bereinigte Browser-Header und Header am Next.js-Eingang Öffentlichen Host und vertrauenswürdige Weiterleitung korrigieren; anschließend Quellenprüfung erneut testen Alle Domains in eine breite Freigabeliste aufnehmen
Gateway protokolliert eine Ablehnung, Next.js kennt den Request nicht Gateway-Ereignis, Antwortheader und Zeitbezug Gateway-Regel, WAF oder Routing prüfen React-Zustand oder Next.js-Cache als Ursache annehmen
Die Action startet und scheitert in ihrer eigenen Logik Anwendungsprotokoll mit Fehlerursache, ohne Geheimnisse Authentifizierung, Autorisierung, Eingabeprüfung oder Geschäftslogik untersuchen Eine Quellenfreigabe als Reparatur einsetzen
Nur Preview oder nur Produktion ist betroffen Getrennte Host- und Origin-Werte der jeweiligen Einstiegsdomain Unterschiede in DNS, TLS-Terminierung und Proxyregeln beseitigen oder gezielt berücksichtigen Eine Preview-Domain pauschal als Produktionsquelle behandeln

CORS und die Server-Actions-Quellenprüfung dürfen nicht gleichgesetzt werden. CORS steuert, ob Browser Skripten den Zugriff auf bestimmte Antworten erlauben; die in der Next.js-Dokumentation beschriebene Prüfung vergleicht Request-Ursprung und Host auf Serverseite. Ein Browser kann daher einen Request senden, den die Anwendung später ablehnt. Umgekehrt kann ein Gateway den Request blockieren, bevor die Anwendungsprüfung überhaupt stattfindet.

Ein Cache-Fehler ist ebenfalls nicht die Standarderklärung für einen nicht erlaubten Ursprung. Die aktuelle Aufgabe lautet zunächst, die Empfangskette und die Werte der Anfrage zu belegen. Erst wenn der Request die Quelleprüfung passiert und eine Action ausgeführt wird, sind Anwendungszustand, Aktualisierung von Daten oder Cache-Verhalten passende Folgethemen.

Für Sicherheitsverantwortliche: serverActions.allowedOrigins eng begrenzen

serverActions.allowedOrigins ist für zusätzliche Ursprünge vorgesehen, die Server Actions aufrufen dürfen. Die Option sollte deshalb nicht als allgemeiner CORS-Schalter und auch nicht als Ersatz für eine korrekt konfigurierte Proxy-Kette behandelt werden. Die Next.js-Konfigurationsreferenz zu allowedOrigins ist die maßgebliche Quelle für Syntax und Verhalten der verwendeten Version.

Prüfen Sie vor einer Änderung, ob tatsächlich eine legitime Konstellation vorliegt, in der der Browser-Origin vom Host abweicht, den Next.js erhält. Ist die Abweichung nur Folge einer falschen Umschreibung auf einen internen Namen, sollte zuerst die Weiterleitung korrigiert werden. Ist der abweichende öffentliche Ursprung Teil der vorgesehenen Architektur, können Sie die zusätzliche Freigabe anhand der dokumentierten Konfiguration prüfen. Die freigegebenen Werte müssen zur tatsächlichen Bereitstellung passen und dürfen nicht weiter reichen als für die legitimen Einstiege erforderlich.

Ein Beispiel für das Schema einer eng gefassten Konfiguration:

/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    serverActions: {
      allowedOrigins: ['app.example.de'],
    },
  },
};

module.exports = nextConfig;

Dieses Beispiel ist kein universeller Reparaturvorschlag. Prüfen Sie zuerst die Dokumentation Ihrer installierten Next.js-Version und übernehmen Sie nur die dort bestätigte Option und Schreibweise. Ersetzen Sie den Beispielhost durch einen tatsächlich benötigten Ursprung, nicht durch einen geratenen Proxy-Namen. Falls die eingesetzte Version oder Bereitstellung eine andere Konfigurationsform erfordert, gilt die offizielle Versionsdokumentation.

Sicherheit endet außerdem nicht an der Herkunftsprüfung: Ein erlaubter Ursprung beweist nicht, dass ein Benutzer eine bestimmte Aktion ausführen darf. Authentifizierung und Autorisierung müssen weiterhin in der Anwendung geprüft werden. Die Next.js-Anleitung zu Authentifizierung und Autorisierung empfiehlt, Zugriff auf geschützte Funktionen serverseitig zu kontrollieren. Eine Herkunftsfreigabe ist keine Benutzerberechtigung.

Für Release-Teams: eine reproduzierbare Prüfung durchführen

Führen Sie die Diagnose in einer kontrollierten Umgebung durch und ändern Sie jeweils nur eine Stelle der Request-Kette. So bleibt nachvollziehbar, welche Korrektur den Befund verändert hat.

  1. Fehlerfall dokumentieren. Notieren Sie die verwendete Einstiegsdomain, die betroffene Action, den Zeitpunkt und den sichtbaren Antwortstatus. Sichern Sie im Browserwerkzeug die relevanten Request-Header, nachdem Sie Cookies und andere Geheimnisse entfernt haben.
  2. Ankunft bei Next.js nachweisen. Suchen Sie denselben Request in Anwendungsprotokollen. Fehlt er dort, prüfen Sie zuerst Gateway, WAF, Routing und Proxyprotokolle, statt die Next.js-Anwendung zu verändern.
  3. Header vor und nach der Proxy-Kette vergleichen. Erfassen Sie Origin, Host und, soweit verwendet, X-Forwarded-Host an geeigneten, geschützten Messpunkten. Dokumentieren Sie, welche Komponente jeden weitergereichten Wert setzt oder überschreibt.
  4. Einstiegswege getrennt testen. Vergleichen Sie die öffentliche Produktionsdomain mit einer vorgesehenen Preview-Domain. Wenn ein direkter Testzugang vorhanden und betrieblich zulässig ist, nutzen Sie ihn nur als Diagnosehilfe; er bildet den öffentlichen Proxyweg nicht automatisch ab.
  5. Ursache an der passenden Schicht korrigieren. Beheben Sie eine falsche Host-Weitergabe am Proxy. Prüfen Sie eine Gateway-Ablehnung in der Gateway-Konfiguration. Ergänzen Sie allowedOrigins nur für einen belegten, legitimen zusätzlichen Ursprung.
  6. Vertrauensgrenze erneut testen. Bestätigen Sie, dass die gewünschte Domain eine Action ausführen kann und eine nicht vorgesehene Quelle weiterhin abgelehnt wird. Ein einzelner erfolgreicher Request belegt noch nicht, dass die Sicherheitsgrenze unverändert geblieben ist.
  7. Nachweise für spätere Releases sichern. Bewahren Sie bereinigte Headerwerte, die betroffene Proxyregel und die Ergebnisse für erlaubte sowie nicht erlaubte Einstiege gemäß den internen Datenschutz- und Aufbewahrungsregeln auf.

Für die Release-Freigabe sollte das Team damit nicht nur eine funktionierende Formularübermittlung, sondern auch die unverändert wirksame Ablehnung nicht vorgesehener Quellen belegen. Eine Änderung, die den Fehler beseitigt, indem sie alle möglichen Ursprünge akzeptiert, erfüllt dieses Kriterium nicht.

Häufige Fragen

Warum meldet Next.js 16 bei einer Server Action eine nicht erlaubte Quelle?

Next.js prüft bei Server Actions die Herkunft des Requests und vergleicht den Origin-Header mit dem Host des Requests. Stimmen diese Werte wegen eines vorgeschalteten Proxys, eines internen Hostnamens oder eines unerwarteten Einstiegs nicht überein, kann die Prüfung den Aufruf ablehnen. Belegen Sie zunächst die Werte am Browser und am Anwendungsserver; die Meldung allein beweist weder einen CORS-Fehler noch ein Next.js-Cacheproblem.

Was ist zu prüfen, wenn Origin und Host nach einem Reverse Proxy nicht übereinstimmen?

Vergleichen Sie die Browser-Anfrage mit dem Request, den Next.js tatsächlich erhält: Origin, Host und gegebenenfalls X-Forwarded-Host. Prüfen Sie für jede Proxy-Stufe, ob der öffentliche Host erhalten oder durch einen internen Namen ersetzt wird. Erst wenn diese Kette nachvollziehbar ist, sollten Sie entscheiden, ob eine Proxyregel korrigiert oder ein tatsächlich notwendiger zusätzlicher Ursprung zugelassen werden muss.

Soll serverActions.allowedOrigins den Browser-Domainnamen oder den Proxy-Namen enthalten?

Die Einstellung ist kein Feld für eine pauschale Proxy-Adresse, sondern erweitert die für Server Actions akzeptierten Ursprünge. Maßgeblich ist die konkrete Bereitstellung: Ermitteln Sie, welcher Origin den Browser verlässt und welchen Host Next.js nach der Weiterleitung sieht. Prüfen Sie Format und Verhalten anhand der Dokumentation Ihrer Next.js-Version; nehmen Sie nur den erforderlichen öffentlichen Ursprung auf und lassen Sie interne Hostnamen nicht ungeprüft zu.

Wie lässt sich ein Server-Actions-Fehler eingrenzen, der nur in der Produktion auftritt?

Erfassen Sie einen fehlgeschlagenen Request im Browser und suchen Sie ihn anhand von Zeitpunkt und Pfad in den Proxy- und Anwendungsprotokollen wieder. Vergleichen Sie anschließend dieselbe Action über den öffentlichen Produktionszugang und, sofern betrieblich zulässig, über einen direkten Testzugang. Prüfen Sie Unterschiede bei Host, Origin, TLS-Terminierung und Weiterleitungsregeln; testen Sie zusätzlich die Preview-Domain, ohne dafür produktive Sicherheitsregeln dauerhaft zu lockern.

Wenn für die Diagnose eine getrennte Entwicklungs- oder Testumgebung benötigt wird, kann ein gemieteter Mac als ergänzender Arbeitsplatz für lokale Entwicklung und Browserprüfungen infrage kommen. Er ersetzt weder den produktiven Reverse Proxy noch den Next.js-Anwendungsserver; für eine Einschätzung der verfügbaren Umgebung bietet KuzCloud eine Übersicht zur Mac-Nutzung. Bei fehlender physischer Mac-Anforderung ist ein vorhandenes Linux- oder Cloud-Testsystem oft die passendere Wahl. Für einen tatsächlichen Mac-Test außerhalb des eigenen Gerätebestands ist die gemietete Umgebung dagegen eine prüfbare Ergänzung, nicht die Reparatur der Produktionsweiterleitung.

Testen Sie Ihre Webanwendungen auf einem dedizierten Mac

Mit KuzCloud stellen Sie einen exklusiven Mac mini M4 für Entwicklung, Bereitstellung und Prüfung Ihrer Anwendungen bereit.

Verbinden Sie sich per SSH oder Browser-Desktop und untersuchen Sie Ihre Anwendung direkt auf einer entfernten Maschine.