Cómo publicar una web Astro en tu hosting sin Node en el servidor

Construye tu proyecto Astro en tu ordenador, sube la carpeta dist a tu dominio desde Plesk y sirve la web como estático puro, en cualquier plan de hosting.

Una web Astro sin partes dinámicas se construye una vez y sale como HTML, CSS y JavaScript planos: no necesita Node ni PHP en el servidor, solo una carpeta donde vivir. Eso la hace la web más rápida que puedes tener en un hosting compartido, y vale para cualquier plan de hosting de Netebu, también el Básico. Esta guía sigue un despliegue real con Astro 7 en un subdominio del hosting.

Antes de empezar

• Tu proyecto Astro en tu ordenador, con Node instalado ahí. La salida por defecto de Astro es estática (output: 'static'); si usas el adaptador de Node para páginas generadas en el servidor, tu guía es Cómo desplegar Astro con SSR en Node.js en tu plan Profesional o Avanzado.
• El dominio o subdominio donde irá la web ya creado en Plesk (Cómo crear un subdominio y qué puedes montar en él) y con su certificado (Cómo activar un certificado Let's Encrypt gratis en tu dominio).
• Si tu web va en un subdominio, apunta el nombre de su carpeta: aparece en la ficha del subdominio como Raíz del documento. En esta guía es astro; en un dominio principal es httpdocs.

Paso a paso

1. En tu ordenador, dentro del proyecto, ejecuta npm run build. Astro deja la web terminada en la carpeta dist: un index.html, la carpeta _astro con los estilos y scripts, y tus imágenes.

2. Comprime el contenido de dist, no la carpeta: entra en dist, selecciona todo y crea dist.zip. Si comprimes la carpeta entera, la web quedaría en tudominio.es/dist/.

3. En Plesk, entra en Archivos, abre la carpeta del dominio (httpdocs, o la del subdominio) y pulsa + → Cargar archivo para subir dist.zip. Verás el zip junto al index.html de bienvenida que Plesk pone en cada dominio nuevo.

4. Pulsa el menú de acciones del zip (los tres puntos al final de la fila) y elige Extraer archivos.

5. En el diálogo, marca Reemplazar archivos existentes y pulsa Aceptar: así el index.html de Astro sustituye al de bienvenida. Después borra dist.zip y la carpeta assets de la página de bienvenida, que ya no pintan nada.

6. Abre https://tudominio.es. Tu web Astro carga con el candado, servida directamente de disco.

7. Para actualizarla, repite: npm run build, nuevo dist.zip, subir y extraer con Reemplazar. Los ficheros de _astro llevan un hash en el nombre, así que los nuevos no pisan a los viejos; de vez en cuando vacía la carpeta antes de extraer para no acumular versiones.

Cómo comprobar que ha funcionado

La web abre en una ventana privada y las imágenes y estilos cargan (F12 → Red, sin peticiones en rojo). En Uso de Recursos de Plesk verás que las visitas apenas consumen CPU: nada pasa por PHP ni por Node. Una web así no necesita LSCache: el servidor ya la sirve tal cual de disco, y una caché encima solo añadiría pasos.

Si algo falla

• La web está en tudominio.es/dist/: comprimiste la carpeta en vez de su contenido. Entra en dist desde Archivos, selecciona todo, Mover a la carpeta de arriba y borra dist.
• Sigue saliendo la página de bienvenida de Plesk: no marcaste Reemplazar y el index.html antiguo se quedó; bórralo y extrae otra vez.
• Trabajas con Git y no quieres subir zips: Plesk puede desplegar tu repositorio (Cómo desplegar tu web desde GitHub, GitLab o Bitbucket), pero el build tiene que hacerse aparte. En los planes Profesional y Avanzado lo lanzas desde el panel Node.js con Ejecutar Script → build, como en Cómo desplegar Astro con SSR en Node.js en tu plan Profesional o Avanzado, y dejas la Raíz del documento en dist.
• Cualquier otra cosa: abre un ticket desde tu área de cliente (Cómo abrir un ticket de soporte y que se resuelva a la primera) con el dominio y lo que ves en pantalla.

Relacionados

• Cómo desplegar Astro con SSR en Node.js en tu plan Profesional o Avanzado
• Cómo usar el Administrador de archivos
• Cómo crear un subdominio y qué puedes montar en él
• Cómo activar un certificado Let's Encrypt gratis en tu dominio