5.1 KiB
5.1 KiB
Actúa como un desarrollador Full-Stack Senior e Ingeniero DevOps experto en Linux (Ubuntu) y Apache2. Necesito que desarrolles una aplicación web ligera y segura para gestionar dinámicamente todos los subdominios de mi dominio principal (elingejose.com) en mi VPS.
1. Contexto de Infraestructura del VPS (Obligatorio respetar)
- Sistema Operativo: Ubuntu Server con solo 1 GB de RAM (el backend y el frontend deben ser extremadamente ligeros y sin procesos pesados).
- Servidor Web: Apache2 nativo de Ubuntu (
/etc/apache2/sites-available/y/etc/apache2/sites-enabled/). No usar Nginx ni Docker. - Usuario operativo: El servidor corre servicios bajo el usuario
ggc(con permisossudosin contraseña en/etc/sudoers.d/ggc) y el servidor web usa el usuario/grupowww-data. - Stack ya instalado en el servidor: Node.js v22 LTS + PM2, Python 3 (
venv/pip), Apache2 con módulosproxy,proxy_http,rewrite,headersactivos, y Gitea en el puerto3000(git.elingejose.com). - DNS: Ya existe o existirá un registro comodín
*.elingejose.comapuntando a la IP del VPS (201.32.134.58), por lo que la aplicación solo debe gestionar la capa de Apache y el sistema de archivos local.
2. Requerimientos Funcionales de la Aplicación Web
Crea una aplicación web completa (puede ser un backend ligero en Node.js + Express o Python + FastAPI/Flask con una interfaz web limpia en HTML/CSS/JS o Tailwind CDN sin build pesado) que permita:
-
Autenticación básica segura:
- Pantalla de login protegida por usuario y contraseña definidos en un archivo
.env(con sesión por cookieHttpOnlyo JWT) para que nadie externo pueda modificar la configuración del servidor.
- Pantalla de login protegida por usuario y contraseña definidos en un archivo
-
Dashboard / Listado de Subdominios Activos:
- Leer los archivos
.confactuales en/etc/apache2/sites-available/(ignorando000-default.confydefault-ssl.conf, y marcando como protegidos los del sistema comogit.confpara evitar borrarlos por accidente). - Mostrar para cada subdominio: nombre completo (
subdominio.elingejose.com), tipo (Estático/PHP o Proxy Inverso por Puerto), ruta de carpeta o puerto destino, estado (Habilitado/Deshabilitadosegún exista ensites-enabled/), y botones para Activar/Desactivar, Editar o Eliminar.
- Leer los archivos
-
Creación Automática de Nuevo Subdominio (Dos modos):
- Validación estricta de entrada: El nombre del subdominio solo debe aceptar caracteres alfanuméricos y guiones (
^[a-z0-9-]+$) para evitar inyección de comandos en la shell. - Modo A — Proyecto Web / Estático / PHP (Carpeta):
- Crea automáticamente el directorio
/var/www/<subdominio>. - Crea un archivo
index.htmlinicial de bienvenida indicando que el subdominio está listo para desplegar. - Asigna permisos exactos para que el usuario
ggcpueda desplegar por Git/SSH/SFTP sin usarsudoy Apache pueda leerlo:sudo chown -R ggc:www-data /var/www/<subdominio>sudo chmod -R 2775 /var/www/<subdominio>
- Genera
/etc/apache2/sites-available/<subdominio>.confcon el<VirtualHost *:80>apuntando aDocumentRoot /var/www/<subdominio>, conAllowOverride All,Options -Indexes +FollowSymLinksyRequire all granted.
- Crea automáticamente el directorio
- Modo B — Aplicación por Puerto / Proxy Inverso (Node.js, Python, etc.):
- Recibe el nombre del subdominio y un número de puerto válido (
1024-65535, verificando que no choque con puertos reservados como22,80,443,3000,3306,5101,5432). - Genera
/etc/apache2/sites-available/<subdominio>.confcon<VirtualHost *:80>,ProxyPreserveHost On,AllowEncodedSlashes NoDecode,ProxyPass / http://127.0.0.1:<puerto>/ nocanonyProxyPassReverse / http://127.0.0.1:<puerto>/.
- Recibe el nombre del subdominio y un número de puerto válido (
- Activación y Validación Segura en Apache (para ambos modos):
- Ejecuta
sudo a2ensite <subdominio>.conf. - Ejecuta
sudo apache2ctl configtest. - Rollback automático: Si
apache2ctl configtestfalla, deshabilita y elimina el.confrecién creado y devuelve el error exacto al frontend sin tumbar Apache. Si devuelveSyntax OK, ejecutasudo systemctl reload apache2.
- Ejecuta
- Validación estricta de entrada: El nombre del subdominio solo debe aceptar caracteres alfanuméricos y guiones (
-
Eliminación Segura:
- Permite deshabilitar (
sudo a2dissite <subdominio>.conf), eliminar el archivo.confy, opcionalmente (mediante checkbox explícito), borrar la carpeta/var/www/<subdominio>antes de recargar Apache.
- Permite deshabilitar (
3. Entregables que debes generar
- Estructura completa de carpetas y código fuente listo para ejecutar (backend + frontend).
- Archivo
.env.examplecon variables configurables (PORT,BASE_DOMAIN=elingejose.com,WEB_ROOT=/var/www,SYSTEM_USER=ggc,ADMIN_USER,ADMIN_PASS,PROTECTED_SITES=000-default.conf,default-ssl.conf,git.conf). - Archivo de configuración de PM2 (
ecosystem.config.js) limitado en memoria (max_memory_restart: '120M') para correr en segundo plano en el puerto3005. - Configuración del VirtualHost de Apache para exponer este mismo panel en
panel.elingejose.com(osubdominios.elingejose.com). - Guía breve de instalación y despliegue en el VPS usando el usuario
ggc.