a2host/a2host.md

45 lines
5.1 KiB
Markdown

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`.