Configuración de Proxy Inverso en ServBay: Mapea Sitios Internos o Remotos para Desarrollo y Depuración Local

ServBay es un entorno de desarrollo web local especialmente diseñado para macOS, que integra múltiples lenguajes de programación como PHP, Node.js, Python, Go, Java y bases de datos como MySQL, PostgreSQL, MongoDB, y Redis. Además de alojar directamente proyectos de código local, ServBay ofrece una potente función de proxy inverso. Mediante el proxy inverso, puedes mapear fácilmente sitios web ubicados en redes internas, máquinas virtuales, contenedores o incluso servidores remotos a tu entorno local con ServBay, simplificando el desarrollo, depuración y acceso a estos sitios.

En este artículo se explica detalladamente cómo configurar un proxy inverso en ServBay, ayudándote a redirigir sitios web ubicados en redes internas u otras direcciones accesibles a tu entorno local, para unificar su gestión y optimizar los procesos de desarrollo y depuración.

Descripción General

El servidor proxy inverso recibe solicitudes de los clientes (por ejemplo, tu navegador) y las reenvía a uno o varios servidores backend (en este caso, el sitio interno o remoto que deseas redirigir). ServBay utiliza su servidor web integrado (Caddy o Nginx) para implementar esta función.

En entornos de desarrollo local, las principales ventajas de configurar un proxy inverso incluyen:

• Punto de acceso unificado: Accede a todos los recursos internos o externos a través del dominio local de ServBay, sin necesidad de recordar direcciones IP y puertos complejos.
• Configuración SSL simplificada: Puedes utilizar la gestión de SSL de ServBay (como ServBay CA o ACME) para ofrecer acceso HTTPS incluso si el sitio backend solo está disponible por HTTP.
• Depuración local: Permite depurar aplicaciones web internas o remotas en el entorno familiar del navegador local.
• Evitar restricciones de red: En algunos casos, puedes acceder fácilmente a recursos de la red corporativa o redes restringidas desde tu entorno local (siempre que la máquina donde corre ServBay pueda alcanzar la dirección objetivo).

Requisitos Previos

Antes de comenzar la configuración del proxy inverso, asegúrate de cumplir con los siguientes requisitos:

1. ServBay instalado y en ejecución: Verifica que la aplicación ServBay esté correctamente instalada y funcionando en tu sistema macOS.
2. Accesibilidad del sitio objetivo: El sitio web interno o remoto que deseas redirigir debe estar en funcionamiento, y la máquina donde ServBay está instalado debe poder acceder a la IP/dominio y puerto del sitio. Por ejemplo, si el objetivo es 192.168.1.100:8080, asegúrate de que tu Mac pueda hacer ping a 192.168.1.100 y acceder a 192.168.1.100:8080.

Pasos para Añadir un Sitio de Proxy Inverso

A continuación, encontrarás una guía paso a paso para configurar un sitio de proxy inverso en ServBay:

Paso 1: Abre la Interfaz de Administración de ServBay

En la carpeta de aplicaciones de tu macOS, localiza el icono de ServBay y haz doble clic para iniciar la aplicación.

Paso 2: Navega a la Gestión de Sitios

Una vez se haya iniciado ServBay, verás la interfaz principal. En el menú de navegación a la izquierda, haz clic en Sitios. Esto te llevará a la página de gestión de sitios de ServBay, donde podrás administrar todos los sitios alojados localmente y los proxies inversos.

Paso 3: Añade un Nuevo Sitio

En la parte inferior de la página de gestión de sitios, localiza y haz clic en el botón +. Al hacerlo, en la zona derecha se desplegará un formulario nuevo para configurar el nuevo sitio.

Paso 4: Configura los Ajustes de Proxy Inverso del Sitio

En el formulario del nuevo sitio, debes completar la información clave que define el comportamiento del proxy inverso:

1. Nombre: Especifica un nombre fácilmente identificable para tu sitio proxy inverso. Ejemplo: Internal Backend Proxy.
2. Dominio: Introduce el dominio que utilizarás localmente para acceder al sitio redirigido. Ejemplo: backend.servbay.demo o proxy.to.local. ServBay generalmente agregará automáticamente este dominio al archivo hosts de tu sistema para resolverlo en 127.0.0.1 o ::1.
3. Protocolo: Selecciona el protocolo que soporta el sitio. Habitualmente, selecciona HTTP/HTTPS para habilitar ambos. ServBay manejará automáticamente los detalles de SSL según tu configuración.
4. Método de solicitud de certificado SSL:
   • ServBay CA (recomendado para desarrollo local): ServBay usará su CA interna para emitir y gestionar automáticamente el certificado SSL para el dominio. Es necesario confiar en el certificado raíz de ServBay CA en tu navegador o sistema para evitar advertencias.
   • ACME (Let's Encrypt): Si tu dominio es público y accesible desde Internet, elige esta opción para obtener un certificado SSL gratuito de Let's Encrypt.
   • Manual: Si ya dispones de los archivos de certificado SSL (.crt, .key, .ca-bundle), puedes cargarlos manualmente y configurar el sitio. Para desarrollo local y recursos internos, se recomienda usar ServBay CA.
5. Tipo de sitio: Selecciona Proxy inverso (Reverse Proxy). Es la opción esencial para habilitar la función de proxy.
6. Destino del proxy: Introduce la dirección completa a la que deseas redirigir el tráfico. Puede ser en formato IP:Puerto o una URL completa con protocolo.
   • Ejemplo 1 (IP:Puerto): 192.168.1.100:8080
   • Ejemplo 2 (URL con protocolo): http://192.168.1.100:8080
   • Ejemplo 3 (hostname interno): backend.internal:8443 (siempre que tu máquina pueda resolver este hostname)
   • Ejemplo 4 (URL remota): https://api.example.com Asegúrate de que la dirección ingresada sea accesible directamente desde la máquina donde se ejecuta ServBay.

Paso 5: Finaliza y Guarda la Configuración

Cuando hayas rellenado toda la información necesaria, haz clic en el botón Añadir (Add) en la parte inferior del formulario. ServBay guardará la configuración y generará automáticamente las reglas de proxy inverso en su servidor web (Caddy o Nginx).

Cuando la operación se complete correctamente, el nuevo sitio proxy inverso aparecerá en la lista de sitios.

Paso 6: Accede al Sitio de Proxy Inverso

Tras la configuración, podrás ingresar el dominio que estableciste en el Paso 4 (por ejemplo, proxy.to.local o backend.servbay.demo) en tu navegador para acceder al sitio interno o remoto.

Si configuraste ServBay CA y usas HTTPS, es posible que debas aceptar advertencias del navegador la primera vez que accedas (si aún no confiaste el certificado raíz de ServBay CA).

Paso 7: Acciones Rápidas del Sitio

ServBay proporciona botones de acceso rápido para cada sitio, facilitando su gestión:

1. Abrir raíz del sitio en IDE: Para sitios proxy inverso, esta función raramente se usa ya que no hay un directorio local asociado.
2. Abrir en el navegador: Acceso rápido al sitio usando el navegador predeterminado.
3. Ver los registros del sitio: Consulta los logs de acceso y error registrados por el servidor web de ServBay (Caddy/Nginx), una herramienta indispensable para depuración.
4. Pausar/activar el sitio: Habilita o deshabilita temporalmente la configuración proxy.
5. Eliminar el sitio: Quita la configuración del proxy inverso de ServBay.

Preguntas Frecuentes y Solución de Problemas (FAQ)

P: No puedo acceder al sitio, el navegador muestra un error.

• Revisa el estado de ServBay: Asegúrate de que ServBay esté corriendo y que el servidor web (Caddy/Nginx) esté iniciado.
• Verifica la resolución de dominio: Comprueba que el dominio que introduces en el navegador es correcto y resuelve la IP local de ServBay (generalmente se ajusta automáticamente el archivo hosts, pero puedes verificarlo manualmente).
• Consulta los registros del sitio: Haz clic en "Ver logs" en la lista de sitios y revisa los registros del servidor web de ServBay. Ahí encontrarás información de las peticiones del cliente, intentos de conexión al objetivo del proxy y cualquier error.
• Verifica el firewall/antivirus: Asegúrate de que el firewall de macOS o cualquier software de seguridad no impida que ServBay escuche en los puertos 80 o 443, ni bloquee la conexión de ServBay al objetivo del proxy.

P: El equipo de ServBay puede acceder al objetivo del proxy, pero el acceso vía el dominio de ServBay no funciona en el navegador.

• Verifica el formato del objetivo del proxy: Asegúrate de que la dirección configurada esté correctamente formateada y que sea accesible directamente por la máquina donde se ejecuta ServBay. Prueba la conectividad desde la terminal utilizando curl [dirección del objetivo del proxy].
• Comprueba la configuración del servidor de destino: Algunos servidores backend verifican la cabecera Host. De forma predeterminada, ServBay reenviará la cabecera original del cliente. Si el backend requiere una cabecera Host específica y accedes usando otro dominio, podría haber inconvenientes. En las opciones avanzadas de ServBay puedes ajustar las cabeceras (esto puede requerir editar manualmente el Caddyfile o la configuración de Nginx, fuera del alcance de la interfaz básica).
• Revisa el firewall del objetivo: Aunque la máquina local tenga acceso a la IP y el puerto, el firewall del servidor objetivo podría admitir solo conexiones desde ciertos rangos IP internos. Confirma que permita conexiones desde el IP de tu equipo ServBay.

P: Al acceder usando HTTPS al proxy inverso, aparece una advertencia de certificado.

• Usando ServBay CA: Si configuras ServBay CA, esta advertencia es esperada porque ServBay CA es una Autoridad de Certificación privada y no es reconocida por los navegadores. Debes instalar y confiar el certificado raíz de ServBay CA en tu sistema o navegador. Puedes hacerlo desde la sección de “Configuración” de ServBay.
• Usando ACME (Let's Encrypt): Asegúrate de que el dominio apunte correctamente al equipo donde corre ServBay y que hayas solicitado un certificado ACME usando la plataforma de gestión de SSL de ServBay. Revisa los registros para detalles de cualquier error en la obtención del certificado.

P: ¿Cómo puedo hacer proxy hacia un objetivo que requiere cabeceras o cookies específicas?

La configuración básica del proxy inverso en ServBay generalmente transfiere la mayor parte de la información de la solicitud del cliente. Para escenarios más complejos —como agregar cabeceras personalizadas, modificar cabeceras de respuesta, manejar cookies específicas o reescribir rutas— deberás ingresar a la configuración avanzada, editando manualmente el Caddyfile o el archivo de configuración de Nginx para aplicar reglas más ajustadas de proxy inverso. Esto requiere conocimientos sobre la sintaxis correspondiente de Caddy o Nginx.

Resumen

Con la función de proxy inverso de ServBay, puedes integrar fácilmente sitios web en redes internas, máquinas virtuales, contenedores o servidores remotos en tu entorno local de desarrollo. Esto no solo proporciona un único punto de acceso cómodo y centralizado, sino que también simplifica la depuración local y la gestión de SSL. Siguiendo estos pasos podrás configurar y poner en marcha tu proxy inverso rápidamente. Si además aprovechas las herramientas de logs y las sugerencias de resolución de problemas que ofrece ServBay, asegurarás el correcto funcionamiento de tu proxy, incrementando significativamente tu productividad como desarrollador.