Que una página se abra localmente no demuestra que su ruta a la API funcione; la interfaz del navegador y la solicitud al backend pueden usar distintos hosts, puertos, protocolos o credenciales.
En un servidor doméstico, es posible que el HTML y los recursos estáticos se carguen desde un proxy inverso, la caché del navegador o un contenedor web local, mientras que las llamadas a la API se dirijan a otro servicio, subruta, punto de conexión WebSocket o URL base configurada externamente. Empieza por capturar una solicitud fallida en el navegador, vuelve a ejecutarla desde el punto de la red correspondiente y luego analiza por separado el enrutamiento, TLS, la autenticación, las políticas del navegador y la configuración de la aplicación, en lugar de tomar la página visible como prueba de que toda la pila es accesible.
Comprueba si la página y la API usan la misma ruta de red
Abre las herramientas para desarrolladores del navegador y vuelve a cargar la acción que falla. Registra la URL de la solicitud, el método, el estado, el cuerpo de la respuesta, la dirección remota, el iniciador y si el fallo corresponde a una solicitud HTTP normal, un WebSocket, un evento enviado por el servidor o una solicitud fetch en segundo plano.
En un caso de Baserow autoalojado, una interfaz funcional mostraba repetidamente mensajes de reconexión porque el canal de eventos del navegador seguía una ruta diferente a través del proxy. El síntoma visible era una conexión de eventos fallida, no una interrupción completa del servidor web.
Compara carácter por carácter la solicitud del documento que funcionó con la solicitud de la API que falló: esquema, nombre de host, puerto, prefijo de ruta y cadena de consulta. Si difieren, investiga la primera capa que cambió. Si son idénticas, continúa con los encabezados, las cookies, el procesamiento de la respuesta y el enrutamiento del backend.
Repite la solicitud exacta desde cada punto de la ruta
Copia una solicitud fallida como comando y vuelve a ejecutarla desde el cliente, el host del proxy inverso y un contenedor temporal conectado a la red de la aplicación. Conserva el método, el encabezado de autorización, el tipo de contenido, el cuerpo y el nombre de host esperado.
Una API puede ser accesible a nivel de TCP y HTTP y, aun así, rechazar la solicitud real porque falta un token o un encabezado. En un debate sobre la API de FreshRSS, se determinó que un fallo externo se debía a un contexto de autorización ausente, no a un problema general de accesibilidad del contenedor.
Interpreta el primer punto en el que se produce el fallo. Un fallo de DNS apunta a la resolución de nombres; una conexión rechazada apunta al servicio de escucha, al puerto o a la red; un error de TLS apunta a la identidad o la confianza; los errores 401 o 403 apuntan a la autenticación o a las políticas; un 404 suele apuntar al enrutamiento o a la reescritura de la subruta; y una llamada directa que funciona mientras falla la llamada del navegador orienta el diagnóstico hacia el proxy o las reglas del navegador.
Comprueba la URL base, el puerto y la subruta de la API
Inspecciona la URL pública de la aplicación, la URL de la API, la URL de WebSocket, la ruta base y las variables de compilación del frontend. Una interfaz servida localmente puede contener una dirección absoluta de API que apunte a un dominio antiguo, una IP privada, un puerto incorrecto o una ruta raíz que solo existe en el servidor.
Las implementaciones en subrutas son especialmente sensibles al manejo de las barras y a las reglas de reescritura. En un caso de proxy inverso de Frigate, los recursos fallidos se atribuyeron al comportamiento de reescritura de la subruta, aunque se podía acceder a la interfaz principal.
Prueba el punto de conexión de la API con y sin el prefijo configurado únicamente para identificar la ruta correcta; después, configura la aplicación y el proxy para que coincidan en una única ruta canónica. No mantengas excepciones de reescritura duplicadas que permitan funcionar a algunos métodos mientras las cargas, las devoluciones de llamada o los puntos de conexión de transmisión siguen omitiendo el backend previsto.
Verifica los encabezados del proxy inverso, TLS y la compatibilidad con la transmisión
Compara la ruta del proxy para las páginas normales con la ruta para las solicitudes de API, WebSocket y transmisión. Confirma el nombre del servicio ascendente, el puerto interno, la versión de HTTP, el comportamiento de actualización de la conexión, el tiempo de espera de lectura, la política de almacenamiento en búfer y los encabezados reenviados del host y el protocolo.
Los usuarios de Open WebUI han informado de una interfaz que parece funcionar, mientras que la respuesta de la API se bloquea al pasar por el proxy porque el almacenamiento en búfer o el comportamiento de transmisión difieren del acceso directo. El diagnóstico se centra en la ruta de transmisión a través del proxy, no en la página estática.
Envía al backend el nombre de host y el esquema originales mediante encabezados de proxy de confianza configurados de forma restrictiva. Habilita las actualizaciones de WebSocket solo en las rutas que las necesiten, desactiva el almacenamiento en búfer inadecuado en los endpoints de streaming y verifica que el proxy use el listener interno de la aplicación, en lugar del puerto de host publicado por error.
Distingue la política del navegador de la accesibilidad del servidor
Cuando un comando directo funciona, pero el navegador falla, revisa la consola del navegador en busca de errores de CORS, contenido mixto, certificados, cookies y solicitudes de preflight. Puede que el servidor responda correctamente, pero el navegador no permita mostrar ni enviar la solicitud.
Un debate sobre Open WebUI detrás de un proxy inverso relaciona los fallos de WebSocket y de la API con el manejo del origen y del protocolo reenviado, y muestra por qué la identidad del origen y del protocolo debe mantenerse coherente a través del proxy.
Confirma que una página HTTPS nunca llame a una API HTTP, que la API solo permita el origen necesario, que las solicitudes de preflight lleguen a la misma ruta y que las cookies de sesión usen los atributos correctos de dominio, ruta, Secure y SameSite. Evita desactivar globalmente las protecciones del navegador; corrige, en cambio, la identidad pública y la política del servidor.
Valida todo el flujo de la API desde cada red necesaria
Cuando funcione la primera solicitud que fallaba, prueba el inicio de sesión, la lista o búsqueda, la creación o actualización, la carga, la descarga, los eventos en segundo plano y una renovación del token desde la LAN y todas las rutas remotas admitidas. Una sola solicitud GET exitosa no demuestra que se hayan reparado las escrituras autenticadas ni las conexiones de larga duración.
El siguiente paso del flujo de trabajo de ZimaSpace para distinguir la accesibilidad por IP del enrutamiento por dominio es cuando las llamadas directas a la API funcionan por dirección, pero fallan a través del nombre de host público.
El problema solo se resuelve cuando el navegador y el cliente que no es navegador usan el endpoint canónico previsto, el proxy llega al backend correcto, la autenticación se conserva en las redirecciones, la política del navegador acepta la respuesta y las sesiones de streaming o WebSocket permanecen estables. Conserva la solicitud fallida capturada como prueba de regresión para futuras actualizaciones.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



