Dass sich eine Seite lokal öffnen lässt, beweist nicht, dass ihr API-Pfad funktioniert; die Browseroberfläche und die Backend-Anfrage können unterschiedliche Hosts, Ports, Protokolle oder Anmeldedaten verwenden.
Auf einem Homeserver können HTML und statische Ressourcen über einen Reverse-Proxy, den Browser-Cache oder einen lokalen Webcontainer geladen werden, während API-Aufrufe einen anderen Dienst, Unterpfad, WebSocket-Endpunkt oder eine extern konfigurierte Basis-URL verwenden. Erfasse zunächst eine fehlgeschlagene Anfrage im Browser, führe sie von der relevanten Netzwerkgrenze aus erneut aus und unterscheide anschließend Routing, TLS, Authentifizierung, Browserrichtlinien und Anwendungskonfiguration, statt die sichtbare Seite als Beleg dafür zu nehmen, dass der gesamte Stack erreichbar ist.
Nachweisen, ob Seite und API denselben Netzwerkpfad verwenden
Öffne die Entwicklertools des Browsers und lade die Aktion, bei der der Fehler auftritt, erneut. Notiere Anfrage-URL, Methode, Status, Antworttext, Remote-Adresse, Initiator und ob es sich um eine gewöhnliche HTTP-Anfrage, WebSocket, ein Server-Sent Event oder einen Hintergrundabruf handelt.
In einem selbst gehosteten Baserow-Fall zeigte die nutzbare Oberfläche wiederholt eine erneute Verbindung an, weil der Ereigniskanal des Browsers einem anderen Proxy-Pfad folgte. Das sichtbare Symptom war eine fehlgeschlagene Ereignisverbindung, kein vollständiger Ausfall des Webservers.
Vergleiche die erfolgreiche Dokumentanfrage und die fehlgeschlagene API-Anfrage Zeichen für Zeichen: Schema, Hostname, Port, Pfadpräfix und Abfragezeichenfolge. Unterscheiden sie sich, untersuche die erste abweichende Ebene. Sind sie identisch, fahre mit Headern, Cookies, Antwortverarbeitung und Backend-Routing fort.
Dieselbe Anfrage von jeder relevanten Netzwerkgrenze aus erneut ausführen
Kopiere eine fehlgeschlagene Anfrage als Befehl und führe sie vom Client, vom Reverse-Proxy-Host und von einem temporären Container im Anwendungsnetzwerk erneut aus. Behalte Methode, Autorisierungsheader, Inhaltstyp, Body und erwarteten Hostnamen bei.
Eine API kann auf TCP- und HTTP-Ebene erreichbar sein und dennoch die eigentliche Anfrage ablehnen, weil ein Token oder Header fehlt. Bei einer FreshRSS-API-Diskussion ließ sich ein externes Problem auf einen fehlenden Autorisierungskontext eingrenzen, nicht auf eine allgemeine Erreichbarkeit des Containers.
Ermitteln Sie die früheste fehlgeschlagene Stelle. Ein DNS-Fehler weist auf die Namensauflösung hin, eine Verbindungsablehnung auf den Listener, Port oder das Netzwerk, ein TLS-Fehler auf Identität oder Vertrauen, ein Fehler 401 oder 403 auf Authentifizierung oder Richtlinien und ein Fehler 404 häufig auf Routing oder Subpfad-Rewrites. Funktioniert ein direkter Aufruf, aber ein Browser-Aufruf nicht, richtet sich die weitere Diagnose auf Proxy- oder Browserregeln.
API-Basis-URL, Port und Subpfad überprüfen
Prüfen Sie die öffentliche URL der Anwendung, die API-URL, die WebSocket-URL, den Basispfad und die Build-time-Variablen des Frontends. Eine lokal ausgelieferte Oberfläche kann eine absolute API-Adresse enthalten, die auf eine alte Domain, eine private IP-Adresse, einen falschen Port oder einen Root-Pfad verweist, der nur auf dem Server verfügbar ist.
Bei Bereitstellungen unter einem Subpfad kommt es besonders auf den Umgang mit Schrägstrichen und Rewrite-Regeln an. In einem Frigate-Reverse-Proxy-Fall ließen sich fehlgeschlagene Ressourcen auf das Rewrite-Verhalten des Subpfads zurückführen, obwohl die Hauptoberfläche erreichbar war.
Testen Sie den API-Endpunkt mit und ohne das konfigurierte Präfix, um lediglich die richtige Route zu ermitteln. Richten Sie anschließend Anwendung und Proxy so ein, dass sie denselben kanonischen Pfad verwenden. Behalten Sie keine doppelten Rewrite-Ausnahmen bei, durch die manche Methoden funktionieren, während Uploads, Rückrufe oder Streaming-Endpunkte weiterhin am vorgesehenen Backend vorbeigeleitet werden.
Reverse-Proxy-Header, TLS und Streaming-Unterstützung überprüfen
Vergleichen Sie die Proxy-Route für gewöhnliche Seiten mit den Routen für API-, WebSocket- und Streaming-Anfragen. Prüfen Sie den Upstream-Dienstnamen, den internen Port, die HTTP-Version, das Verhalten beim Verbindungsupgrade, das Lesezeitlimit, die Pufferungsrichtlinie sowie die weitergeleiteten Host- und Protokoll-Header.
Open-WebUI-Nutzer haben von einer Oberfläche berichtet, die funktionsfähig wirkt, während die Ausgabe der proxied API stockt, weil sich Pufferung oder Streaming-Verhalten vom direkten Zugriff unterscheidet. Im Mittelpunkt der Diagnose steht der proxied Streaming-Pfad, nicht die statische Seite.
Leite den ursprünglichen Hostnamen und das Schema über eng konfigurierbare, vertrauenswürdige Proxy-Header an das Backend weiter. Aktiviere WebSocket-Upgrades nur für Routen, die sie benötigen, deaktiviere unangemessenes Buffering für Streaming-Endpunkte und prüfe, ob der Proxy den internen Listener der Anwendung verwendet, statt versehentlich den veröffentlichten Host-Port.
Trenne Browserrichtlinien von der Erreichbarkeit des Servers
Wenn ein direkter Befehl erfolgreich ist, der Browser aber fehlschlägt, prüfe die Browserkonsole auf CORS-, Mixed-Content-, Zertifikats-, Cookie- und Preflight-Fehler. Der Server antwortet möglicherweise korrekt, während der Browser die Anfrage nicht freigibt oder sendet.
Eine Diskussion zu Open WebUI hinter einem Reverse-Proxy verknüpft WebSocket- und API-Fehler mit der Behandlung von Origin und weitergeleitetem Protokoll und zeigt, warum Origin- und Protokollidentität über den Proxy hinweg konsistent bleiben müssen.
Stelle sicher, dass eine HTTPS-Seite niemals eine HTTP-API aufruft, die API nur die erforderliche Herkunft zulässt, Preflight-Anfragen dieselbe Route erreichen und Sitzungscookies die korrekten Attribute für Domain, Pfad, Secure und SameSite verwenden. Deaktiviere nicht pauschal die Browser-Schutzmechanismen, sondern korrigiere stattdessen die öffentliche Identität und Richtlinie des Servers.
Überprüfe den vollständigen API-Workflow in jedem erforderlichen Netzwerk
Sobald die erste fehlgeschlagene Anfrage funktioniert, teste Anmeldung, Auflisten oder Suchen, Erstellen oder Aktualisieren, Hochladen, Herunterladen, Hintergrundereignisse und eine Token-Erneuerung über das LAN und jeden unterstützten Fernzugriffspfad. Ein einzelner erfolgreicher GET beweist nicht, dass authentifizierte Schreibvorgänge oder langlebige Verbindungen wieder funktionieren.
Der ZimaSpace-Workflow zum Trennen der IP-Erreichbarkeit vom Domain-Routing ist der nächste Schritt, wenn direkte API-Aufrufe über die Adresse funktionieren, aber über den öffentlichen Hostnamen fehlschlagen.
Das Problem ist erst behoben, wenn Browser und Nicht-Browser-Client den vorgesehenen kanonischen Endpunkt verwenden, der Proxy das richtige Backend erreicht, die Authentifizierung Weiterleitungen übersteht, die Browserrichtlinien die Antwort zulassen und Streaming- oder WebSocket-Sitzungen stabil bleiben. Bewahre die aufgezeichnete fehlgeschlagene Anfrage als Regressionstest für künftige Upgrades auf.
Support und Tipps
Mehr zum Lesen

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



