Astro Stack

Acerca de Astro Stack

Lo que se instala

Listo al arrancar el VPS

SO compatibles

Ubuntu 24.04

Aplicación

Astro Stack

Stack técnico

Node.js LTSPM2Nginx

RAM mínima

1 GB (2 GB para SSR)

CPU mínima

1 vCPU

Acceso

root por SSH

Funcionalidades clave

• Node.js LTS desde NodeSource — la última versión estable, no el paquete envejecido de la distribución.
• PM2 — reinicio automático, cero interrupción durante los despliegues, rotación de logs y modo cluster para VPS multinúcleo.
• Nginx como reverse proxy con gzip y cabeceras Cache-Control largas en los recursos versionados.
• Compatible con la salida estática de Astro (output: 'static') y con el SSR (output: 'server' + @astrojs/node).
• Huella de memoria mínima — un sitio Astro estático servido por Nginx consume menos de 50 MB. El SSR mediante PM2 añade unos 50 MB por worker.
• Renderizado híbrido: marque las páginas con export const prerender = true para pregenerarlas en la compilación y mantener las rutas dinámicas en SSR.

¿Cuándo usar esta solución?

Guía

Desplegar Astro Stack en su VPS

1. 1

   Crear el VPS

   Seleccione la plantilla «Astro Stack». 1 GB de RAM basta para un sitio estático; 2 GB si tiene previsto usar SSR con PM2.

2. 2

   Elegir el modo de salida

   En astro.config.mjs, defina output: 'static' para un sitio totalmente pregenerado, o output: 'server' con adapter: node({ mode: 'standalone' }) para SSR. Esta elección condiciona el resto del despliegue.

3. 3

   Primer acceso

   Esta plantilla instala una cadena de herramientas (Node.js LTS, PM2, Nginx). No hay interfaz web que abrir: conéctese por SSH y despliegue su propio proyecto Astro.

4. 4

   Compilar y transferir

   Ejecute npm run build en local o en CI. En estático, copie la carpeta dist/ a /var/www/astro/dist en el VPS. En SSR, copie dist/ y arranque el servidor con pm2 start dist/server/entry.mjs --name astro.

5. 5

   Configurar Nginx

   En estático: root /var/www/astro/dist; y try_files $uri $uri/ /404.html;. En SSR: proxy_pass http://localhost:4321; con las cabeceras adecuadas. Obtenga un certificado Let's Encrypt mediante Certbot.