Generador de Apps para VPS

RECETA PARA DESPLEGAR APPS NODE.JS

Sigue estos pasos en orden para desplegar cualquier app generada por IA.

FASE A

Petición a la IA (Prompt Maestro)

Cuando pidas código a ChatGPT o Gemini, usa este prompt para evitar errores de puertos o archivos faltantes:

"Crea una aplicación web en Node.js usando Express. 

El servidor debe escuchar en 0.0.0.0 y puerto 3000.

Usa app.use(express.static(__dirname)) para servir archivos HTML y estáticos de la raíz.

Entrégame el package.json y el index.js completo."

FASE B

Estructura de Carpetas en VPS

Entra a tu servidor mediante SSH y crea la carpeta para tu nueva idea.

# 1. Crear carpeta

mkdir -p ~/mis-apps/mi-app

# 2. Entrar

cd ~/mis-apps/mi-app

Ruta Estándar: Mantén todas tus apps dentro de ~/mis-apps/ para tener orden.

Aquí es donde subirás los archivos generados.

FASE C

Archivos de Configuración y Despliegue

Esta herramienta te genera los archivos de Docker necesarios. Sigue estos pasos:

Generar Kit: Ve a la pestaña "Crear App", rellena los datos y descarga el .zip.
Subir Archivos: Sube el contenido del ZIP + el código de la IA (`index.js`, `package.json`) a la carpeta del paso anterior.
Descomprimir (si subiste el zip):
unzip mi-app-kit-despliegue.zip
Base de Datos (Solo si aplica): Si marcaste "SQLite", crea el archivo vacío antes de arrancar:
touch data.db
Configurar DNS: Ve a tu proveedor de dominio y apunta el subdominio a la IP de tu VPS.
¡Desplegar!: Ejecuta el comando mágico:
docker compose up -d --build

Manual de Comandos y Mantenimiento

Ciclo de Vida de la App

Arrancar / Actualizar

docker compose up -d --build

Usa esto tras subir cambios de código.

Reiniciar Rápido

docker compose restart

Apagar Todo

docker compose down

Diagnóstico y Datos

Ver Logs en Vivo

docker compose logs -f

Ctrl + C para salir.

Backup de SQLite

cp data.db data.db.backup

Ejecutar antes de cambios peligrosos.

Limpieza Total (Reset)

docker compose down --rmi all

Borra contenedores e imágenes para empezar de cero.

Solución de Problemas Comunes

Error 404 "Page Not Found"

Error de Código

Síntoma: La web carga con certificado seguro, pero muestra texto plano "404 page not found".

Causa: Tu servidor Node.js está corriendo, pero no sabe qué archivo mostrar cuando entras a la raíz.

// Solución en index.js:
app.use(express.static(__dirname)); // Sirve los archivos de la carpeta
app.get('/', (req, res) => res.sendFile(__dirname + '/index.html'));

Traefik Default Cert / No Seguro

Error de Configuración

Síntoma: El navegador muestra advertencia de seguridad "Sitio no seguro".

Causa: Conflicto de nombres. Has copiado un docker-compose.yml de otra app y no has cambiado el nombre del router en las etiquetas.

# En docker-compose.yml, asegúrate de que esto sea ÚNICO:
traefik.http.routers.NOMBRE_UNICO.rule=...

Exec format error / App reiniciándose

Error de Sistema

Síntoma: La web da error 502 Bad Gateway y en los logs ves Exec format error o errores de librerías.

Causa: Has copiado la carpeta node_modules de tu Windows/Mac al servidor Linux. Los archivos no son compatibles.

# Solución:
1. Crea un archivo .dockerignore que incluya 'node_modules'.
2. Ejecuta: rm -rf node_modules en el servidor.
3. Reconstruye: docker compose up -d --build --force-recreate

Datos perdidos al reiniciar

Error de Persistencia

Síntoma: La aplicación vuelve a estado inicial (contadores a 0, usuarios borrados) cada vez que reinicias el contenedor.

Causa: No has configurado un "Volumen" para guardar la base de datos fuera del contenedor.

# En docker-compose.yml:
volumes:
- ./data.db:/app/data.db # Conecta archivo local con el del contenedor

Guía generada para la infraestructura de jesussanchez.online

Configuración de la Nueva App