Publicar en Cloudflare Pages: arrastra y publica sin saber Git
Esta es la lección 3 de la ruta A (crear sitios web), y también el tutorial de Cloudflare Pages más «amigable para principiantes» de todo el sitio: sin crear repositorios, sin instalar herramientas y sin tocar la línea de comandos, arrastra la carpeta hecha en A1 al navegador y obtienes una URL pública 项目名.pages.dev. Todo el proceso toma unos 12 minutos y el plan gratuito es suficiente.
- ¿Todavía no tienes lista la carpeta? Vuelve primero a A1 crea sitios web con IA para generar las páginas
- ¿Aún dudas entre varias plataformas? Mira primero A5 comparación de plataformas de despliegue y vuelve
Qué podrás hacer al terminar
- Arrastrar la carpeta del sitio web hecha en A1 a Cloudflare Pages, sin crear un repositorio Git ni tocar la línea de comandos, y obtener la URL pública
项目名.pages.dev - Saber explicar las tres formas de publicar en Cloudflare Pages (arrastrar y soltar / línea de comandos de Wrangler / integración con Git), para quién sirve cada una y cuáles dos no se pueden convertir entre sí
- Verificar la URL tú mismo tras el despliegue; al revisar el diseño, volver a arrastrar dentro del mismo proyecto para publicar la nueva versión
- Conocer los límites del plan gratuito: 25 MiB por archivo, 1,000 archivos por cada arrastre, 500 despliegues al mes
Tu situación actual
- «Probé a mitad de camino lo de A2 de crear repositorios y lo abandoné, ¿puedo simplemente subir la carpeta y ya?»
- «Solo quiero enviar el enlace de mi portafolio a mis contactos, no quiero entender qué es Git antes de publicar»
- «Escuché que Cloudflare también permite alojar sitios web gratis, pero la consola está llena de botones en inglés y no sé por dónde empezar»
Cuándo usar este método
Cuando necesitas:
- Publicar en la web pública el sitio estático hecho en A1 y obtener un enlace que puedas compartir
- Trabajar todo el tiempo en el navegador: clics + arrastrar y soltar, sin instalar nada
- Publicar gratis — la documentación oficial indica que Pages está «Available on all plans» (disponible en todos los planes), y el plan gratuito es suficiente para un sitio personal
Y además no quieres:
- Aprender repositorios y Git antes de publicar — ese es el camino de A2 publicar en GitHub Pages
- Ejecutar comandos en la carpeta del proyecto — ese es el camino de A4 publicar en Vercel
- Comprar un servidor, configurar entornos ni estudiar scripts de despliegue
🎒 Preparativos antes de empezar
- Haber completado A1 crea sitios web con IA: de una frase a una página lista para publicar, con una carpeta de páginas estáticas en la mano
- Un buzón de correo que pueda recibir mensajes, para registrar la cuenta de Cloudflare
- La carpeta del sitio web (o su zip) en un lugar a mano — la subida por arrastre admite ambas formas
- Un vaso de agua ☕
Idea central
Cloudflare Pages es el servicio de alojamiento de sitios web de Cloudflare: tú le entregas los archivos del sitio y él publica el sitio en la red global de Cloudflare. Un sitio puramente estático (el resultado de A1) se publica con solo subir los archivos.
Hay tres caminos para entregar los archivos; esta lección toma el primero:
| Método de subida | Qué hay que saber | Características | Para quién |
|---|---|---|---|
| Subida por arrastre (Direct Upload, el hilo principal de esta lección) | Arrastrar archivos en el navegador | Obtienes la URL de inmediato 项目名.pages.dev | Tú, que no quieres tocar para nada la línea de comandos ni Git |
| Línea de comandos de Wrangler | Dos comandos de npm | La misma URL, con un límite de archivos más alto | Quien esté dispuesto a abrir la terminal pero no quiera aprender Git |
| Integración con Git | GitHub/GitLab + push | Cada push construye y despliega automáticamente | Quien ya sepa Git y revise el sitio con frecuencia |
Una frase para recordar Direct Upload: lo que se sube son «archivos ya terminados». La plataforma ya no construye por ti — lo que subas es lo que se publica, así que antes de subir, los archivos deben estar en su forma final. Las páginas puramente estáticas escritas por la IA en A1 lo son exactamente.
⚠️ Piénsalo bien antes de elegir camino: los dos caminos son mutuamente excluyentes
- Un proyecto que usa integración con Git después no puede convertirse a Direct Upload — la documentación oficial menciona explícitamente esta limitación
- Un proyecto que eligió Direct Upload después tampoco puede convertirse a integración con Git; si algún día quieres despliegue automático con push, solo queda crear otro proyecto nuevo
- Buena noticia: dentro del mismo proyecto de Direct Upload, puedes alternar libremente entre la subida por arrastre y Wrangler
💡 La oficial está promocionando Workers; los principiantes pueden ignorarlo por ahora
La documentación oficial de Cloudflare muestra ahora un aviso en la parte superior de la página de Pages: Workers cubre la mayoría de los casos de uso de Pages y tiene más funciones, y recomienda que los proyectos nuevos empiecen con Workers. Workers es la plataforma de desarrollo principal de Cloudflare, adecuada para aplicaciones full-stack con backend; pero para publicar un sitio estático sin conocimientos previos, la subida por arrastre de Pages sigue siendo el camino más directo — no hay que instalar nada. Cuando en el futuro quieras hacer aplicaciones full-stack, no será tarde para conocer Workers.
Hazlo conmigo
En cinco pasos, tu sitio web tendrá una URL pública. El ejemplo sigue el «portafolio de fotografía» de A1; cámbialo por tu propio tema y haz lo mismo.
Paso 1: revisa la carpeta del sitio web y confirma que arrastras «el nivel correcto»
Por qué: Direct Upload no construye por ti, y el contenido del directorio que subes es el contenido del directorio raíz del sitio web — si añades una capa extra de carpeta, la página de inicio ya no queda en el primer nivel de la URL.
Abre la carpeta del proyecto de A1 y echa un vistazo: el primer nivel debería contener directamente estos archivos:
index.html ← página de inicio, debe estar en el primer nivel
style.css
script.js
images/Deberías ver: index.html directamente en el primer nivel de la carpeta; al hacer doble clic se abre tu página en el navegador.
Si prefieres arrastrar un zip, también puedes — la documentación oficial indica que la función de arrastrar admite «un archivo zip» o «una carpeta». Si vas a comprimir, comprime este nivel; no incluyas la carpeta de nivel superior dentro del zip.
- En el primer nivel de la carpeta (o del zip) se ve directamente
index.html
Paso 2: registra una cuenta de Cloudflare y entra en Workers & Pages
Por qué: los proyectos de Pages se crean y se gestionan todos en la página Workers & Pages de la consola.
Procedimiento: abre dash.cloudflare.com en el navegador, regístrate e inicia sesión (el plan gratuito es suficiente; Pages está disponible en todos los planes) y, en la consola, busca la página Workers & Pages y entra en ella.
Deberías ver: la página de Workers & Pages y el botón Create application (crear aplicación).
- Se puede ver el botón Create application
Paso 3: crea la aplicación y arrastra la carpeta — el paso clave del tutorial de Cloudflare Pages
Por qué: el nombre del proyecto determina el prefijo de tu URL; cuando completas este paso, la URL queda definida.
Sigue la ruta oficial: Workers & Pages → Create application → Get started → Drag and drop your files.
Escribe un nombre en el campo del nombre del proyecto (por ejemplo my-photo-site) y luego arrastra la carpeta o el zip al cuadro de subida.
Deberías ver: los archivos empiezan a subirse y en la lista aparecen nombres como index.html, sin advertencias en rojo.
💡 Nombre del proyecto = prefijo de la URL
Tu URL será 项目名.pages.dev. La documentación oficial indica que, si el nombre del proyecto ya está ocupado, Cloudflare añade automáticamente algunos caracteres aleatorios — si quieres conservar una URL limpia, elige desde la primera vez un nombre poco probable de repetirse.
- El proyecto se creó y no hay advertencias en rojo en la lista de subida
Paso 4: pulsa Deploy site y obtén la URL de pages.dev
Por qué: después de subir falta todavía la acción de «desplegar»; solo cuando el despliegue se completa existe la URL pública.
Procedimiento: cuando termine la subida, elige Deploy site (en este paso la interfaz también puede mostrar Save and Deploy; pulsa eso) y espera a que la barra de progreso termine.
Deberías ver: el despliegue completado y la página mostrando tu URL https://项目名.pages.dev; al continuar al panel del proyecto (continue to your newly deployed project), podrás ver el estado del despliegue y la URL.
- Aparece
https://项目名.pages.dev
Paso 5: abre la URL para verificar y aprende a actualizar a una nueva versión
Por qué: antes de publicar debes verlo tú mismo primero — la disciplina de la lista de verificación de revisión 3.4 también se aplica a un sitio web recién publicado.
Procedimiento: abre https://项目名.pages.dev en el navegador del ordenador y revisa bloque por bloque según la lista de estructura de A1; luego envía el enlace a tu móvil y ábrelo allí.
Deberías ver: tu página se abre correctamente tanto en el móvil como en el ordenador, sin desordenarse en pantallas estrechas.
¿Y si más adelante quieres hacer cambios? Pide a la IA que modifique los archivos, vuelve a la página de Workers & Pages de este proyecto, elige Create a new deployment, selecciona el entorno de producción (production) y arrastra de nuevo la nueva carpeta — la nueva versión quedará publicada. La versión anterior tampoco se pierde: Pages admite reversiones (Rollbacks), con un clic vuelves a la versión de producción anterior.
Deberías ver: la nueva versión reemplaza a la antigua y la URL no cambia.
- Has abierto tu propia URL tanto en el móvil como en el ordenador
Punto de control ✅
- El primer nivel de la carpeta (o del zip) es directamente
index.html - Proyecto creado en Workers & Pages mediante Create application → Get started → Drag and drop your files
- Despliegue completado y
https://项目名.pages.devabre tu página de inicio - También se abre correctamente en el móvil
- Sabes que tras una revisión basta usar Create a new deployment y volver a arrastrar para actualizar
Advertencias sobre errores comunes
❌ Arrastraste el nivel equivocado de la carpeta
Síntoma: el despliegue se completó con éxito, pero al abrir la URL no ves tu página de inicio.
Causa: el contenido del directorio que subes es el contenido del directorio raíz del sitio web — si metes la carpeta del sitio dentro de otra carpeta nueva antes de arrastrarla (o el zip incluye una capa extra), index.html ya no queda en el directorio raíz.
Solución correcta: antes de comprimir o arrastrar, abre y comprueba que el primer nivel sea directamente index.html. Si subiste algo mal, no hace falta borrar el proyecto: usa Create a new deployment y vuelve a arrastrar con la carpeta correcta.
❌ Archivos que exceden los límites: 25 MiB por archivo, 1,000 archivos por cada arrastre
Síntoma: durante la subida aparece un símbolo de advertencia en rojo junto a algunos archivos y esos archivos no se suben.
Causa: se superaron los límites de la subida directa — según la documentación oficial, los archivos individuales de más de 25 MiB muestran una advertencia en rojo; cada arrastre admite como máximo 1,000 archivos; Wrangler tiene límites más amplios (20,000 archivos, con el mismo límite de 25 MiB por archivo).
Solución correcta: la documentación oficial indica que los recursos con advertencia en rojo se pueden eliminar, pero no se pueden reemplazar en el mismo lugar; solo se puede volver a subir el sitio completo. Por lo tanto: comprime las imágenes antes de subirlas; si hay más de 1,000 archivos, usa Wrangler (ver las técnicas avanzadas más abajo). El plan gratuito permite 500 despliegues al mes, así que ordena los archivos antes de reenviar.
❌ El despliegue se completó, pero al abrir la URL da un error de DNS
Síntoma: el despliegue claramente terminó, pero el navegador no puede abrirlo y muestra un error de DNS.
Causa: la documentación oficial indica que, tras el primer despliegue, es posible que el DNS aún no se haya propagado (la propagación lleva tiempo).
Solución correcta: espera unos minutos y actualiza, o prueba con otro dispositivo u otra red (por ejemplo, los datos móviles).
❌ Acabas de registrarte y creas varios proyectos seguidos, y te lo bloquean
Síntoma: apenas terminas de crear el primer proyecto, intentas crear otro nuevo de inmediato y te lo restringen.
Causa: hay límites antiabuso para cuentas nuevas — durante las primeras 48 horas de uso del servicio se limita la cantidad de nuevos proyectos de Pages que se pueden crear, y después se levanta automáticamente; además, cada cuenta admite como máximo 100 proyectos.
Solución correcta: hoy haz funcionar primero un proyecto; si de verdad necesitas varios, vuelve pasadas 48 horas.
Técnicas avanzadas (opcional)
🔧 Publicar con dos comandos de Wrangler (opcional)
¿Te animas a abrir la terminal pero no quieres aprender Git? La herramienta oficial de línea de comandos Wrangler también usa Direct Upload, pertenece a la misma vía que arrastrar y se pueden combinar en cualquier momento:
npx wrangler pages project create
npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY>- El primer comando te pedirá el nombre del proyecto y la rama de producción, y luego se guarda en la caché en
node_modules/.cache/wrangler, así que los despliegues siguientes no vuelven a pedirlo - Sustituye
<BUILD_OUTPUT_DIRECTORY>por la ruta de tu carpeta; para el sitio web puramente estático de A1, lo que se sube es la propia carpeta del proyecto - Wrangler solo admite carpetas, no zip (con arrastrar y soltar ambos funcionan)
- Para publicar un entorno de vista previa: añade
--branch=<分支名>y obtendrás分支名.项目名.pages.dev - Límite de 20,000 archivos (arrastrar y soltar admite 1,000); el directorio
functionsde funciones solo Wrangler puede compilarlo y subirlo, arrastrar y soltar no lo admite (_worker.jscomo archivo único se admite en ambos) - Requisito previo: tener npm instalado en tu equipo (el requisito oficial es instalar primero npm y luego Wrangler); la primera vez, ejecuta
npx wrangler loginpara iniciar sesión y luego ejecuta los comandos siguientes
🔧 ¿Ya sabes Git? Haz que cada push despliegue automáticamente (opcional)
Esta es la integración de Git que es mutuamente excluyente con arrastrar y soltar; ve clic a clic por todo el proceso: Workers & Pages → Create application → Pages → Connect to Git, autoriza GitHub o GitLab → elige el repositorio (se admiten tanto privados como públicos) → configura la compilación: nombre del proyecto (por defecto igual que el repositorio), rama de producción (normalmente main), si no hay framework, deja vacío el Build command, directorio de salida de la compilación → Save and Deploy.
A partir de entonces, cada push compila y despliega automáticamente; las ramas que no son de producción generan automáticamente despliegues de vista previa (分支名.项目名.pages.dev). Aviso: si ya creaste un proyecto de subida directa y quieres cambiar a esta vía, solo puedes crear un proyecto nuevo; la regla de exclusión mutua está en la idea central de arriba.
🔧 ¿Quieres tu propio dominio? (opcional)
pages.dev es el subdominio que la plataforma te regala; para algo más formal puedes vincular un dominio que hayas comprado: el plan gratuito permite vincular 100 dominios personalizados por proyecto. Para el procedimiento general de resolución y vinculación de dominios, consulta 5.3 Dominio personalizado.
Un punto de atención propio de Cloudflare: la documentación oficial advierte que, antes de eliminar un proyecto con dominio personalizado, debes borrar primero el registro CNAME correspondiente; de lo contrario, el dominio apuntará a un proyecto que ya no existe.
Resumen de esta lección
✅ Has completado la ruta de publicación por arrastrar y soltar de este tutorial de Cloudflare Pages:
- Revisar la carpeta: la primera capa debe ser directamente
index.html; vale tanto arrastrar la carpeta como un zip - Crear el proyecto: Workers & Pages → Create application → Get started → Drag and drop your files; el nombre del proyecto es el prefijo de la URL
- Desplegar: Deploy site → obtén
https://项目名.pages.dev - Verificar: abrió tanto en el móvil como en el ordenador
- Actualizar: Create a new deployment y arrastra otra vez; dentro del mismo proyecto de subida directa puedes alternar libremente entre arrastrar y Wrangler, pero es mutuamente excluyente con la integración de Git
| Etapa | Operación clave | Qué recordar |
|---|---|---|
| Preparación | Revisar la primera capa de la carpeta | El contenido del directorio subido = raíz del sitio |
| Creación | Create application → entrada de arrastrar y soltar | El nombre del proyecto determina el prefijo pages.dev |
| Despliegue | Deploy site | Archivo único ≤ 25 MiB, arrastrar y soltar ≤ 1,000 archivos por vez |
| Verificación | Abrir en móvil + ordenador | Si el primer acceso da error de DNS, espera unos minutos |
| Actualización | Create a new deployment | Plan gratuito: 500 despliegues al mes, con posibilidad de revertir a versiones anteriores |
La comparación completa de cuotas y límites gratuitos de GitHub Pages, Cloudflare Pages y Vercel, de un vistazo en A5 Comparación de plataformas de despliegue.
Avance de la próxima lección
En la próxima lección, A4 Publicación en Vercel: despliegue con un solo comando para agentes de codificación de IA, cambiarás a otra filosofía de publicación: escribir un solo comando en la carpeta del proyecto y todo es automático, de la compilación a la publicación. Aprenderás:
- Instalar Node.js 18+ y Vercel CLI,
vercel logininiciar sesión una sola vez vercel --produn solo comando para completar el despliegue de producción- Qué significa que «la CLI detecte automáticamente el framework» y qué implica para tu sitio estático
- El plan gratuito Vercel Hobby prohíbe el uso comercial; tenlo claro antes de elegirlo
Cuando estés listo, ten la carpeta a mano y entra en A4 →