# Hosting para Astro: salida estática, adaptadores y lo que el sitio necesita

El hosting para Astro arranca por el renderizado. Si el HTML se genera en el build, publicá dist. Si cada visita pide datos del usuario, usá un adaptador.

Canonical URL: https://unbroker.cloud/es/blog/astro-hosting
Published: 2026-11-09
Reviewed: 2026-11-09
Author: Timoteo Borgobello

## La respuesta corta

Para desplegar un sitio Astro, arrancá por el modo de renderizado. Si el HTML se puede generar en el build, hospedá los archivos de `dist`. El preset Astro de Unbroker sirve ese build. Si una página necesita los datos del visitante en cada request, agregá un adaptador de servidor y desplegá esa salida como servicio Node.js o con un Dockerfile.

Dejá el preset estático apuntando a los archivos generados. Configurá `site` con el origen público que vas a publicar, para que las URLs canónicas y el sitemap lo usen. La página de producto es [Desplegar Astro](https://unbroker.cloud/deploy/astro). Los pasos están en [Desplegar un sitio Astro](https://docs.unbroker.cloud/guides/deploy-astro).

## Empezá por el modo de renderizado

La pregunta de hosting es qué páginas existen antes de que alguien las pida. El `output` por defecto de Astro es `'static'`: las páginas se prerenderizan en el build, y el resultado es un sitio estático si ninguna página se excluye. `output: 'server'` renderiza las páginas en el servidor por defecto. El renderizado bajo demanda, también llamado renderizado del lado del servidor, necesita un adaptador. La referencia es la [configuración de Astro](https://docs.astro.build/en/reference/configuration-reference/) y [on-demand rendering](https://docs.astro.build/en/guides/on-demand-rendering/).

| | Salida estática | Adaptador de servidor |
| --- | --- | --- |
| Qué escribe el build | HTML, CSS y JavaScript en `dist`, salvo que cambies `outDir` | Los archivos de servidor que pide ese adaptador. Es otra salida, distinta del preset estático. |
| Qué corre en producción | Un servidor de archivos. El preset Astro de Unbroker hace eso. | El proceso del adaptador: un servicio Node.js o un Dockerfile en Unbroker. |
| Cuándo conviene | Páginas de marketing, docs y blogs cuyo HTML se puede generar en el build. | Una página que necesita los datos de un usuario logueado, u otros datos del request, en cada visita. |

Podés dejar el modo estático por defecto y sacar una ruta con `export const prerender = false` después de instalar un adaptador. El resto del sitio sigue estático. `output: 'server'` cambia el default. La guía de Astro pide arrancar con `'static'` hasta que la mayoría de las páginas necesiten renderizarse bajo demanda, y aclara que `'server'` no agrega capacidades: solo cambia qué páginas se renderizan bajo demanda por defecto.

## Hospedar la salida estática de Astro

Confirmá el build con el gestor de paquetes y el lockfile que el repositorio ya usa. El ejemplo de la guía de Unbroker es `npm ci` y después `npm run build`. Un script `build` estándar de Astro corre `astro build`. Por defecto eso escribe `dist/`. `outDir` cambia el directorio. La guía de deploy de Astro lista el comando de build como `astro build` o `npm run build`, y el directorio de publicación como `dist`. Mirá [Desplegar tu sitio Astro](https://docs.astro.build/en/guides/deploy/).

En Cloud, creá un servicio de repositorio y elegí **Astro**. Dejá el comando de build en el script de build del proyecto y el directorio de salida en `dist`, salvo que hayas cambiado el directorio de salida de Astro.

Abrí la URL del servicio. Pedí una página anidada directo, recargala y seguí los links a imágenes y hojas de estilo. Si faltan assets, revisá el directorio de salida y cualquier `base` configurado. `base` es la ruta que Astro usa como raíz de páginas y assets. Si solo existe la home, mirá las rutas generadas. Agregar un comando de servidor a un servicio estático no crea las páginas que faltan.

`astro preview` levanta un servidor local para el directorio estático ya construido. La CLI de Astro dice que sirve para revisar el build antes de desplegar, y que no está pensado para correr en producción. La guía de Unbroker dice lo mismo para el preset estático: el preview local revisa la salida, y el preset es el servidor de producción de esos archivos. La referencia del comando es [astro preview](https://docs.astro.build/en/reference/cli-reference/#astro-preview).

## Cuándo hace falta un adaptador de servidor

Una página que necesita los datos de un usuario logueado en el momento del request no se cubre con HTML estático. Agregá un adaptador para el runtime que va a renderizar esas rutas. Astro mantiene adaptadores oficiales para Node.js, Netlify, Vercel y Cloudflare. En Unbroker, desplegá esa salida como servicio Node.js o con un Dockerfile, y seguí las instrucciones de build y de arranque del adaptador. El preset estático de Astro sirve un sitio estático ya construido, así que la salida de servidor va por Node.js o Dockerfile.

La tabla de planes incluye Node.js gestionado en Free y lista los builds con Dockerfile como disponibles en Pro. La guía de Astro nombra el preset estático como el camino que corre en Free. Las filas están en [Plans](https://docs.unbroker.cloud/billing/plans).

## Astro estático y una API aparte

Si solo unas pocas interacciones necesitan backend, dejar Astro estático y sumar una API aparte puede ser más simple. La configuración pública del frontend la ve el visitante. Astro deja las variables con prefijo `PUBLIC_` disponibles para el código del cliente a través de `import.meta.env`. Unbroker elige los prefijos públicos de build, incluidos `PUBLIC_`, `VITE_` y `NEXT_PUBLIC_`, antes del build. Un valor que queda en el bundle que descarga el visitante es público, aunque lo hayas cargado en Variables.

Poné las credenciales de la base y el resto de los secretos en el servicio de la API. Las variables privadas quedan solo en runtime, salvo las credenciales documentadas de un registro de paquetes. Cómo funcionan los alcances está en [Variables de entorno y secretos](https://unbroker.cloud/es/blog/environment-variables-and-secrets).

Desplegá la API primero y confirmá un endpoint en su URL pública. Apuntá la variable pública del frontend a ese origen y después construí el frontend. Un cambio en un valor incrustado en el bundle pide un build nuevo. Configurá el CORS de la API para el origen exacto del frontend. Un hostname privado del proyecto no es alcanzable desde el navegador del visitante. Las llamadas del navegador necesitan una ruta pública. El recorrido está en [Desplegar un frontend y una API juntos](https://docs.unbroker.cloud/guides/frontend-and-api). CORS, cookies y un preview que no tiene que llamar a la API de producción están en [desplegar un frontend y una API por separado](https://unbroker.cloud/es/blog/frontend-and-api). Qué puede correr Free para esa API está en [Hosting de backend gratis](https://unbroker.cloud/es/blog/free-backend-hosting).

## Usá la URL real de producción

Configurá `site` de Astro con la URL final desplegada. Astro usa esa URL completa para generar el sitemap y las URLs canónicas en el build. La opción es [`site`](https://docs.astro.build/en/reference/configuration-reference/#site). Si el sitio se sirve bajo una ruta, `base` es el ajuste que corresponde para páginas y assets.

Un dominio propio es un paso posterior, y pide Pro. Cuando está listo, revisá que las URLs canónicas y las imágenes sociales usen ese origen. Astro documenta `site` para el sitemap y las URLs canónicas. La guía de Unbroker también pide verificar las imágenes sociales contra el origen de producción, en lugar de un hostname de preview. El DNS y el certificado están en [Dominio propio y HTTPS](https://unbroker.cloud/es/blog/custom-domain-https).

Dejá el hostname que da Unbroker. Sirve para distinguir un problema del deploy de un problema de DNS.

## Cómo funciona en Unbroker

El preset Astro sirve un sitio estático ya construido. Está en Free y en Pro. En Free corre con Serverless: un servicio inactivo baja a cero y despierta con el próximo request. El primer request después de dormir puede tardar más mientras la aplicación arranca. Las apps de Pro no se duermen por inactividad. Se duermen solo si prendés Serverless. Los dominios propios y el TLS gestionado están en Pro.

Creá un servicio de repositorio, elegí **Astro**, y configurá el comando de build y el directorio de salida. Pro sale $25 al mes con $25 de crédito de uso. El crédito se reinicia en cada ciclo y no se acumula. Si el uso elegible queda por debajo del crédito, el cargo mensual sigue siendo el precio del plan. Las cifras actuales están en [precios](https://unbroker.cloud/es/precios) y en [Plans](https://docs.unbroker.cloud/billing/plans).

La página de producto es [Desplegar Astro](https://unbroker.cloud/deploy/astro). Qué push produjo la revisión está en [Desplegar con git push](https://unbroker.cloud/es/blog/deploy-on-git-push).

## Lista de control

1. Decidí si cada página se puede generar en el build.
2. En ese caso, dejá la salida estática por defecto y construí con el script de build del proyecto.
3. Confirmá que `dist`, o tu `outDir`, tiene las páginas y los assets que esperás.
4. En Unbroker, elegí el preset Astro y configurá el comando de build y el directorio de salida.
5. Abrí una página anidada, recargala y seguí una imagen y una hoja de estilo.
6. Usá `astro preview` para revisar el build en local. Dejalo fuera del comando de arranque de producción.
7. Si una página necesita los datos del visitante en cada request, agregá un adaptador de servidor y desplegá esa salida como Node.js o Dockerfile.
8. Poné los secretos en la API. Limitá los valores `PUBLIC_` a configuración que el visitante puede ver, y configurá el CORS con el origen del frontend.
9. Configurá `site` con el origen público real. Después de un dominio propio, revisá las URLs canónicas, el sitemap y las imágenes sociales. Dejá el hostname de Unbroker. Los dominios propios piden Pro.

## Preguntas frecuentes

### ¿Hace falta un servidor para hospedar un sitio Astro?

No, si el HTML se puede generar en el build. La salida por defecto de Astro es estática, y el preset Astro de Unbroker sirve ese build en Free y en Pro. Una página que tiene que renderizarse en cada request, por ejemplo con los datos de un usuario logueado, necesita un adaptador de servidor. Ese resultado se despliega como servicio Node.js o con un Dockerfile. El preset estático queda para los archivos generados.

### ¿Cuál es la diferencia entre la salida estática de Astro y el renderizado en el servidor, para el hosting?

La salida estática prerenderiza las páginas en el build, y hospedás esos archivos. El renderizado en el servidor, que Astro también llama on-demand rendering, ejecuta un adaptador cuando llega la ruta. output: 'static' es el default. output: 'server' hace que el renderizado por request sea el default. Después de agregar un adaptador, una ruta puede salir del prerender con prerender = false, y el resto del sitio sigue estático. La referencia es la [guía de on-demand rendering de Astro](https://docs.astro.build/en/guides/on-demand-rendering/).

### ¿A qué directorio construye Astro?

A dist, salvo que cambies outDir. La guía de deploy de Astro lista dist como directorio de publicación y el comando de build como astro build o npm run build. En Unbroker, dejá el directorio de salida del preset Astro en dist salvo que lo hayas cambiado, y el comando de build en el script de build del proyecto.

### ¿Puedo usar astro preview en producción?

No. astro preview levanta un servidor local para el directorio estático ya construido, para que revises ese build. La CLI de Astro dice que el comando no está pensado para correr en producción. La guía de Unbroker dice lo mismo para el preset estático: el preview local revisa el build, y el preset es el que sirve esos archivos.

### ¿Puedo hospedar un sitio Astro en el plan Free de Unbroker?

Sí, con el preset estático de Astro. En Free corre con Serverless: un servicio inactivo baja a cero y despierta con el próximo request. Los dominios propios piden Pro. El renderizado en el servidor se despliega como servicio Node.js o con un Dockerfile. Node.js gestionado está en Free. Los builds con Dockerfile son Pro. La guía de Astro nombra el preset estático como el camino de Free.

### ¿Los dominios propios funcionan en Free?

No. La tabla de planes lista los dominios propios y el TLS gestionado como no disponibles en Free y disponibles en Pro. Pro sale $25 al mes con $25 de crédito de uso. El crédito se reinicia en cada ciclo y no se acumula. Si el uso elegible queda por debajo del crédito, el cargo mensual sigue siendo el precio del plan. Mirá [precios](https://unbroker.cloud/es/precios) y [Plans](https://docs.unbroker.cloud/billing/plans).

### ¿Cómo despliego en Unbroker un sitio Astro con adaptador de servidor?

Agregá el adaptador y desplegá su salida como servicio Node.js o con un Dockerfile. Seguí las instrucciones de build y de arranque de ese adaptador. El preset estático de Astro sirve archivos generados, así que la salida de servidor va por Node.js o Dockerfile. Los builds con Dockerfile piden Pro. Node.js gestionado está incluido en Free. Los adaptadores oficiales de Astro incluyen uno para Node.js.

### ¿Dónde van las API keys en un sitio Astro?

En el servicio de backend, no en el código del cliente. Astro deja las variables con prefijo PUBLIC_ disponibles para el navegador, y Unbroker elige ese prefijo, junto con VITE_ y NEXT_PUBLIC_, como variable pública de build. Un valor que queda en el bundle que descarga el visitante es público. Las variables privadas quedan solo en runtime, salvo las credenciales documentadas de un registro de paquetes. El corte está en la [guía de frontend y API](https://docs.unbroker.cloud/guides/frontend-and-api), y los alcances en [Variables de entorno y secretos](https://unbroker.cloud/es/blog/environment-variables-and-secrets).

### ¿Por qué mis URLs canónicas apuntan a un hostname de preview?

Las URLs canónicas y el sitemap salen del valor site de Astro. Poné site en el origen público final y volvé a construir. Si siguen mostrando un hostname de preview, ese es el origen que quedó configurado en ese build. Cuando el dominio propio está listo, revisá las URLs canónicas, el sitemap y las imágenes sociales contra el origen de producción. Dejá el hostname de Unbroker para separar un problema de DNS del deploy. Los dominios propios piden Pro.

## Related reading

- [Desplegar Astro](https://unbroker.cloud/deploy/astro)
- [Dominio propio y HTTPS](https://unbroker.cloud/es/blog/custom-domain-https)
- [Variables de entorno y secretos](https://unbroker.cloud/es/blog/environment-variables-and-secrets)
- [Hosting de backend gratis](https://unbroker.cloud/es/blog/free-backend-hosting)
- [Desplegar con git push](https://unbroker.cloud/es/blog/deploy-on-git-push)
- [Frontend y API](https://unbroker.cloud/es/soluciones/frontend-and-api)
- [Precios](https://unbroker.cloud/es/precios)
