a2host/a2host.md

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 permisos sudo sin contraseña en /etc/sudoers.d/ggc) y el servidor web usa el usuario/grupo www-data.
  • Stack ya instalado en el servidor: Node.js v22 LTS + PM2, Python 3 (venv/pip), Apache2 con módulos proxy, proxy_http, rewrite, headers activos, y Gitea en el puerto 3000 (git.elingejose.com).
  • DNS: Ya existe o existirá un registro comodín *.elingejose.com apuntando 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:

  1. Autenticación básica segura:

    • Pantalla de login protegida por usuario y contraseña definidos en un archivo .env (con sesión por cookie HttpOnly o JWT) para que nadie externo pueda modificar la configuración del servidor.
  2. Dashboard / Listado de Subdominios Activos:

    • Leer los archivos .conf actuales en /etc/apache2/sites-available/ (ignorando 000-default.conf y default-ssl.conf, y marcando como protegidos los del sistema como git.conf para 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 / Deshabilitado según exista en sites-enabled/), y botones para Activar/Desactivar, Editar o Eliminar.
  3. 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):
      1. Crea automáticamente el directorio /var/www/<subdominio>.
      2. Crea un archivo index.html inicial de bienvenida indicando que el subdominio está listo para desplegar.
      3. Asigna permisos exactos para que el usuario ggc pueda desplegar por Git/SSH/SFTP sin usar sudo y Apache pueda leerlo:
        • sudo chown -R ggc:www-data /var/www/<subdominio>
        • sudo chmod -R 2775 /var/www/<subdominio>
      4. Genera /etc/apache2/sites-available/<subdominio>.conf con el <VirtualHost *:80> apuntando a DocumentRoot /var/www/<subdominio>, con AllowOverride All, Options -Indexes +FollowSymLinks y Require all granted.
    • Modo B — Aplicación por Puerto / Proxy Inverso (Node.js, Python, etc.):
      1. Recibe el nombre del subdominio y un número de puerto válido (1024-65535, verificando que no choque con puertos reservados como 22, 80, 443, 3000, 3306, 5101, 5432).
      2. Genera /etc/apache2/sites-available/<subdominio>.conf con <VirtualHost *:80>, ProxyPreserveHost On, AllowEncodedSlashes NoDecode, ProxyPass / http://127.0.0.1:<puerto>/ nocanon y ProxyPassReverse / http://127.0.0.1:<puerto>/.
    • Activación y Validación Segura en Apache (para ambos modos):
      1. Ejecuta sudo a2ensite <subdominio>.conf.
      2. Ejecuta sudo apache2ctl configtest.
      3. Rollback automático: Si apache2ctl configtest falla, deshabilita y elimina el .conf recién creado y devuelve el error exacto al frontend sin tumbar Apache. Si devuelve Syntax OK, ejecuta sudo systemctl reload apache2.
  4. Eliminación Segura:

    • Permite deshabilitar (sudo a2dissite <subdominio>.conf), eliminar el archivo .conf y, opcionalmente (mediante checkbox explícito), borrar la carpeta /var/www/<subdominio> antes de recargar Apache.

3. Entregables que debes generar

  1. Estructura completa de carpetas y código fuente listo para ejecutar (backend + frontend).
  2. Archivo .env.example con 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).
  3. Archivo de configuración de PM2 (ecosystem.config.js) limitado en memoria (max_memory_restart: '120M') para correr en segundo plano en el puerto 3005.
  4. Configuración del VirtualHost de Apache para exponer este mismo panel en panel.elingejose.com (o subdominios.elingejose.com).
  5. Guía breve de instalación y despliegue en el VPS usando el usuario ggc.