Orbe Edge: administra Nginx y certificados SSL desde un solo panel

Publicar una aplicación web en un servidor Linux suele requerir varios pasos: crear una configuración de Nginx, validarla, habilitar el sitio, recargar el servicio, comprobar que el backend responde y gestionar el certificado TLS. Aunque este flujo es habitual para quienes administran servidores, repetirlo manualmente para cada dominio consume tiempo y puede aumentar la posibilidad de errores.

Para simplificar ese trabajo desarrollé Orbe Edge, un panel de administración de reverse proxy basado en Nginx y Certbot. La aplicación reúne tareas habituales de publicación y mantenimiento en una interfaz web, con seguimiento de cada etapa y validación obligatoria de la configuración antes de recargar Nginx.

Orbe Edge es una alternativa propia y a la medida de Nginx Proxy Manager, pensada para evolucionar según las necesidades del ecosistema Orbe Tech.

Aplicación en producción: https://edge.orbetech.dev/

¿Qué es Orbe Edge?

Orbe Edge es un panel web para administrar configuraciones de Nginx que actúan como reverse proxy y coordinar la emisión y supervisión de certificados mediante Certbot.

En lugar de editar archivos .conf, crear enlaces simbólicos y ejecutar comandos manualmente para cada publicación, el administrador puede registrar un dominio, indicar el backend y ejecutar el flujo de aplicación desde la interfaz.

La aplicación muestra el progreso de las operaciones y mantiene un principio importante: la configuración debe validarse antes de cualquier recarga de Nginx. Esto reduce el riesgo de aplicar una configuración sintácticamente incorrecta sin que haya pasado la comprobación prevista.

Según la documentación del proyecto compartida para esta entrada, Orbe Edge se encuentra en estado de MVP funcional. Algunas capacidades están completadas y otras forman parte de la hoja de ruta.

Publicar un dominio con un flujo guiado

El flujo Aplicar coordina varias operaciones que normalmente se realizan por separado. Según la configuración y las herramientas disponibles, el proceso contempla:

Generar el archivo de configuración de Nginx.
Validar la configuración mediante nginx -t.
Activar el sitio mediante el enlace simbólico correspondiente.
Recargar Nginx después de la validación.
Comprobar la disponibilidad del backend mediante un health check.
Verificar la configuración DNS del dominio.
Solicitar el certificado con Certbot cuando corresponda.
Actualizar la configuración para utilizar TLS/SSL.
Validar y recargar la configuración resultante.

La interfaz transmite el progreso mediante Server-Sent Events (SSE), lo que permite mostrar los resultados de las etapas mientras se ejecuta el flujo.

La secuencia real puede variar según las condiciones del entorno. Por ejemplo, si Certbot no está instalado en el entorno de desarrollo, la aplicación puede detectar su ausencia y mostrar una advertencia en lugar de emitir el certificado.

Gestión de dominios y opciones avanzadas

Orbe Edge permite crear, consultar, editar y eliminar registros de dominios desde la interfaz. Cada configuración puede incluir información como:

Dominio público.
Dirección IP o nombre del backend y su puerto.
Tipo de destino: Docker, servicio local o servidor remoto.
Compatibilidad con WebSocket.
Configuración para forzar HTTPS.
Opción de HSTS.
HTTP/2, según la configuración soportada por el entorno.

También dispone de un bloque de opciones avanzadas para incorporar directivas adicionales de Nginx, como límites de tamaño de solicitudes, reglas de limitación de peticiones o bloques location específicos. Las configuraciones generadas deben superar la validación de Nginx antes de recargar el servicio.

La aplicación permite ver el archivo .conf que Nginx tiene en disco y marca los registros con cambios pendientes de aplicar. Así es más sencillo distinguir entre lo editado en el panel y lo que ya se ha desplegado.

Certificados TLS y seguimiento de vencimientos

Los certificados TLS necesitan supervisión para evitar interrupciones por vencimiento. Orbe Edge presenta información de los certificados detectados, como:

Días restantes hasta el vencimiento.
Emisor.
Nombres alternativos del certificado (SANs).
Estado de renovación.

El sistema escanea los certificados de /etc/letsencrypt/live, incluidos los que no fueron creados directamente desde el panel. Además, un proceso periódico actualiza la información de vencimiento cada seis horas y permite generar alertas.

La interfaz también contempla acciones para intentar renovar certificados y corregir ciertos casos en los que una emisión anterior mediante el método manual requiere volver a emitirse usando el plugin de Nginx. El resultado debe comprobarse en cada servidor: depende del estado de DNS, la accesibilidad del dominio, los permisos y la configuración de Certbot.

Estado del servidor desde el panel

Además de los dominios, Orbe Edge reúne indicadores del servidor que ayudan a revisar el entorno de publicación. La información contemplada incluye:

Sistema operativo, versión del kernel y tiempo activo.
Uso de CPU, memoria RAM y disco.
Versión y estado de Nginx.
Resultado de nginx -t, última recarga y número de sitios.
Versión de Certbot, estado del temporizador y cantidad de certificados.
Contenedores Docker.
Puertos en escucha.

Estos datos permiten tener una vista operativa más completa sin limitar el panel a la edición de archivos de configuración.

Importar configuraciones de Nginx existentes

Migrar un servidor que ya publica aplicaciones puede ser complejo si es necesario reconstruir cada sitio desde cero. Por eso, Orbe Edge incluye una función de importación que analiza configuraciones existentes.

El importador utiliza nginx-go-crossplane para procesar archivos .conf y clasificar configuraciones como:

Reverse proxy.
Aplicaciones PHP-FPM.
Sitios estáticos.
Redirecciones.

También consulta la información de expiración de los certificados cuando está disponible en los archivos PEM.

Los sitios importados se muestran inicialmente en modo de solo lectura. Según la documentación del proyecto, la acción Aplicar permanece bloqueada para estos registros hasta que se complete el flujo de adopción con comparación de cambios (diff). Este comportamiento ayuda a evitar que una configuración existente se sobrescriba accidentalmente.

Autenticación, notificaciones y auditoría

La administración de un reverse proxy requiere controlar quién puede realizar cambios y poder investigar qué ocurrió cuando una operación falla.

Orbe Edge incorpora:

Acceso para un usuario administrador, con credenciales configurables mediante variables de entorno.
Sesión basada en cookie httpOnly.
Gestión de autenticación básica para dominios seleccionados, con generación de archivos htpasswd al aplicar la configuración.
Registro de auditoría de las acciones.
Notificaciones dentro de la interfaz y por correo electrónico mediante SMTP.
Alertas relacionadas con fallos al aplicar configuraciones, certificados próximos a vencer y problemas de renovación.

La autenticación del panel y la autenticación básica configurada para un dominio cumplen funciones diferentes. En un despliegue real, ambas deben configurarse según el modelo de acceso que requiera cada aplicación.

Tecnologías utilizadas

La arquitectura combina un backend en Go con una interfaz web moderna:

Componente	Tecnología
Backend	Go
Interfaz	React, Vite y Tailwind CSS
Base de datos	PostgreSQL
API HTTP	chi
Acceso a PostgreSQL	pgx
Configuración Nginx	Plantillas `text/template` de la biblioteca estándar de Go
Análisis de configuraciones	`nginx-go-crossplane`
Flujo de progreso	Server-Sent Events (SSE)
Certificados	Certbot y herramientas de certificados de Go
Frontend en producción	Embebido en el binario del backend

Uno de los aspectos del diseño es que el frontend compilado se integra en el binario de producción. Esto permite distribuir la aplicación como un ejecutable que incluye la API y la interfaz web. PostgreSQL, Nginx y las herramientas de certificados siguen siendo componentes del entorno que deben instalarse y configurarse según el despliegue.

Diseño con validación antes de recargar

En una herramienta de administración de Nginx, los errores de configuración pueden dejar fuera de servicio uno o varios dominios. Por eso, una decisión importante de Orbe Edge es exigir la validación con nginx -t antes de cualquier recarga.

Este control no sustituye las pruebas funcionales ni garantiza por sí solo que el backend esté disponible, que DNS sea correcto o que el certificado sea válido. Es una comprobación específica de la configuración de Nginx y debe complementarse con los chequeos correspondientes.

Las operaciones privilegiadas deben limitarse a las acciones necesarias, los registros deben ser revisables y las pruebas deben realizarse primero en un entorno controlado. En producción, conviene disponer de copias de seguridad y de un procedimiento de recuperación ante cambios fallidos.

Estado actual y hoja de ruta

Orbe Edge cuenta con un MVP funcional. Los hitos descritos como completados incluyen la edición de dominios, generación de configuraciones, directivas avanzadas, autenticación básica, gestión de certificados y notificaciones.

Entre los siguientes pasos previstos se encuentran:

Gestión de múltiples servidores mediante SSH.
Historial de cambios y posibilidad de rollback de configuraciones.
Detección de diferencias entre la configuración esperada y la configuración real (configuration drift).
Health checks periódicos.
Despliegue de producción y ampliación de la gestión remota.

Estas capacidades pertenecen a la hoja de ruta y no deben confundirse con las funciones que ya están disponibles en el MVP.

¿Para quién puede ser útil Orbe Edge?

Orbe Edge puede resultar útil para administradores de sistemas, desarrolladores y equipos pequeños que mantienen aplicaciones web en servidores Linux y quieren centralizar las operaciones frecuentes de Nginx y Certbot.

Puede ayudar especialmente cuando se gestionan varios dominios, se necesita supervisar vencimientos de certificados o se quiere importar y revisar configuraciones existentes desde una interfaz común.

No pretende eliminar la necesidad de conocer Nginx, TLS, DNS o la administración de Linux. Su objetivo es hacer que las operaciones habituales sean más visibles, consistentes y fáciles de seguir.

Prueba Orbe Edge

Orbe Edge nació de una necesidad práctica: simplificar la publicación y el mantenimiento de aplicaciones web sin perder visibilidad sobre lo que sucede en el servidor. Al reunir la configuración de dominios, la validación, los certificados, las alertas y el estado operativo en un solo panel, busca reducir la cantidad de pasos manuales y facilitar el seguimiento de cada cambio.

Puedes conocer la aplicación en producción en https://edge.orbetech.dev/.

Pregunta para la comunidad: ¿qué función te resultaría más útil en un panel de administración de Nginx: gestión de certificados, importación de configuraciones existentes, historial y rollback, monitoreo de varios servidores o alertas avanzadas?