Dat een pagina lokaal opent, bewijst niet dat het API-pad werkt; de browserinterface en het backendverzoek kunnen verschillende hosts, poorten, protocollen of inloggegevens gebruiken.
Op een homeserver kunnen de HTML en statische bestanden worden geladen vanaf een reverse proxy, uit de browsercache of vanaf een lokale webcontainer, terwijl API-aanroepen naar een andere service, een subpad, een WebSocket-endpoint of een extern geconfigureerde basis-URL gaan. Leg eerst รฉรฉn mislukt verzoek vast in de browser, voer het opnieuw uit vanaf de relevante netwerkgrens en maak vervolgens onderscheid tussen routering, TLS, authenticatie, browserbeleid en applicatieconfiguratie, in plaats van de zichtbare pagina te zien als bewijs dat de hele stack bereikbaar is.
Stel vast of de pagina en API hetzelfde netwerkpad gebruiken
Open de ontwikkelaarstools van de browser en laad de actie die mislukt opnieuw. Noteer de verzoek-URL, methode, status, responsbody, het externe adres, de initiator en of het om een gewoon HTTP-verzoek, WebSocket, server-sent event of achtergrondverzoek gaat.
In een geval met zelfgehoste Baserow bleef een bruikbare interface melden dat er opnieuw verbinding werd gemaakt, omdat het eventkanaal van de browser een ander proxypad volgde. Het zichtbare symptoom was een mislukte eventverbinding, niet een volledige uitval van de webserver.
Vergelijk het geslaagde documentverzoek en het mislukte API-verzoek teken voor teken: schema, hostnaam, poort, padprefix en querystring. Als ze verschillen, onderzoek dan de eerste laag waar het verschil optreedt. Als ze identiek zijn, ga dan verder met headers, cookies, responsafhandeling en routering naar de backend.
Voer exact hetzelfde verzoek opnieuw uit vanaf elke relevante netwerkgrens
Kopieer รฉรฉn mislukt verzoek als opdracht en voer het opnieuw uit vanaf de client, de host van de reverse proxy en een tijdelijke container die aan het applicatienetwerk is gekoppeld. Behoud de methode, autorisatieheader, contenttype, body en verwachte hostnaam.
Een API kan bereikbaar zijn via de TCP- en HTTP-lagen, maar het echte verzoek afwijzen omdat een token of header ontbreekt. In een discussie over de FreshRSS API bleek een externe fout te worden veroorzaakt door ontbrekende autorisatiecontext, niet door algemene bereikbaarheid van de container.
Bepaal waar de eerste fout optreedt. Een DNS-fout wijst op naamresolutie; een geweigerde verbinding wijst op de listener, poort of het netwerk; een TLS-fout wijst op identiteit of vertrouwen; 401 of 403 wijst op authenticatie of beleid; 404 wijst vaak op routering of het herschrijven van een subpad; en als een directe aanroep slaagt maar een browseraanroep mislukt, verschuift de diagnose naar proxy- of browserregels.
Controleer de API-basis-URL, poort en subpad
Controleer de openbare URL, API-URL, WebSocket-URL, het basispad en de frontendvariabelen die tijdens het bouwen worden ingesteld. Een lokaal aangeboden interface kan een absoluut API-adres bevatten dat verwijst naar een oud domein, een privรฉ-IP-adres, een verkeerde poort of een basispad dat alleen op de server bestaat.
Implementaties op een subpad zijn bijzonder gevoelig voor de verwerking van schuine strepen en herschrijfregels. In een Frigate-geval met een reverse proxy bleken mislukte resources het gevolg van herschrijfgedrag van het subpad, hoewel de hoofdinterface bereikbaar was.
Test het API-eindpunt zowel met als zonder het geconfigureerde prefix, uitsluitend om de juiste route te bepalen. Stem daarna de applicatie en proxy op elkaar af, zodat ze รฉรฉn canoniek pad gebruiken. Behoud geen dubbele uitzonderingen voor herschrijven waardoor sommige methoden werken, terwijl uploads, callbacks of streaming-eindpunten de bedoelde backend blijven omzeilen.
Controleer reverse-proxyheaders, TLS en ondersteuning voor streaming
Vergelijk de proxyroute voor gewone paginaโs met de route voor API-, WebSocket- en streamingverzoeken. Controleer de naam van de upstreamservice, de interne poort, de HTTP-versie, het gedrag bij het upgraden van de verbinding, de leestime-out, het bufferbeleid en de doorgestuurde host- en protocolheaders.
Gebruikers van Open WebUI hebben gemeld dat de interface goed lijkt te werken, terwijl de proxied API-uitvoer vastloopt doordat buffering of streaming zich anders gedraagt dan bij directe toegang. De diagnostische focus ligt op het geproxiede streamingpad, niet op de statische pagina.
Stuur de oorspronkelijke hostnaam en het oorspronkelijke schema via beperkt geconfigureerde headers voor vertrouwde proxy's door naar de backend. Schakel WebSocket-upgrades alleen in op routes die ze nodig hebben, schakel ongeschikte buffering uit voor streaming-eindpunten en controleer of de proxy de interne listener van de applicatie gebruikt, en niet per ongeluk de gepubliceerde hostpoort.
Maak onderscheid tussen browserbeleid en serverbereikbaarheid
Wanneer een directe opdracht slaagt maar de browser faalt, controleer je de browserconsole op fouten rond CORS, mixed content, certificaten, cookies en preflightverzoeken. De server kan correct antwoorden terwijl de browser weigert het verzoek te tonen of te versturen.
Een discussie over Open WebUI achter een reverse proxy koppelt problemen met WebSockets en API's aan de afhandeling van origin en doorgestuurde protocollen. Dit laat zien waarom de identiteit van origin en protocol consistent moet blijven via de proxy.
Controleer of een HTTPS-pagina nooit een HTTP-API aanroept, of de API alleen de vereiste origin toestaat, of preflightverzoeken dezelfde route bereiken en of sessiecookies de juiste kenmerken voor domain, path, Secure en SameSite hebben. Schakel browserbeveiligingen niet overal uit; herstel in plaats daarvan de openbare identiteit en het beleid van de server.
Valideer de volledige API-werkwijze via elk vereist netwerk
Nadat het eerste mislukte verzoek werkt, test je aanmelden, lijsten of zoekopdrachten, aanmaken of bijwerken, uploaden, downloaden, achtergrondgebeurtenissen en het vernieuwen van een token, zowel via het LAN als via elk ondersteund extern verbindingstraject. Eรฉn geslaagde GET bewijst niet dat geauthenticeerde schrijfacties of langdurige verbindingen zijn hersteld.
De ZimaSpace-werkwijze voor het onderscheiden van IP-bereikbaarheid en domeinroutering is de volgende stap wanneer directe API-aanroepen via een adres werken, maar via de openbare hostnaam mislukken.
Het probleem is pas opgelost wanneer de browser en de client die niet via een browser werkt het bedoelde canonieke eindpunt gebruiken, de proxy de juiste backend bereikt, de authenticatie behouden blijft bij omleidingen, het browserbeleid het antwoord accepteert en streaming- of WebSocket-sessies stabiel blijven. Bewaar het vastgelegde mislukte verzoek als regressietest voor toekomstige upgrades.
Ondersteuning en tips
Meer om te lezen

Zo houd je pornofilms op je NAS verborgen voor gezinsleden
Houd video's voor volwassenen privรฉ op een NAS voor het hele gezin. Controleer mapmachtigingen, toegang tot Plex- en Jellyfin-bibliotheken, miniaturen, kijkgeschiedenis, gedeelde tv-aanmeldingen en...

Wat je moet controleren voordat je een communitymodel in Transformers laadt
Gebruik de Transformers Jinja-sandboxupdate om de herkomst van modellen, chatsjablonen, externe code, geserialiseerde gewichten en geรฏsoleerde eerste uitvoeringen te controleren.

Voer Mirage lokaal uit: OCR en objectdetectie vanuit รฉรฉn afbeelding
Probeer het kleine lokale visiemodel van Cactus Compute, test OCR en objectextractie met echte invoer en krijg inzicht in de beperkingen op het gebied...



