Checklist para montar un sitio con Cloudflare Pages, VSCode y Git.
El repositorio es la carpeta en la nube donde vivirá tu sitio. Tienes dos opciones según preferencias éticas y prácticas:
GitHub — integración directa con Cloudflare, OAuth en VSCode sin configurar nada. Es Microsoft, entrena IA con código público a menos que estés en Enterprise.
Codeberg — asociación sin ánimo de lucro europea (Forgejo, FOSS), no entrena IA. Cloudflare no integra nativo con Codeberg: requiere mirror automático Codeberg → GitHub o deploy por wrangler desde local (ver paso 8).
VSCode es el editor de código que usaremos para editar los archivos del sitio.
La barra lateral izquierda tiene varios iconos. Los importantes por ahora:
Git es la herramienta que permite subir los cambios al repositorio de GitHub.
Abrir la terminal en VSCode (Ctrl+Ñ o Cmd+Ñ en Mac) y ejecutar:
git config --global user.name "Tu Nombre" git config --global user.email "tu@email.com"
Para verificar: git config --global --list
Clonar = descargar una copia del repositorio a tu ordenador. Desde VSCode es lo más cómodo.
Con GitHub: VSCode abre el navegador para hacer OAuth, sin pasos extra.
Con Codeberg: VSCode pide usuario y contraseña la primera vez. Mejor opción: ir a Codeberg → Settings → Applications → generar un access token con permiso de repository y usarlo como contraseña. Solo hay que hacerlo una vez por máquina.
Ahora que la carpeta está abierta en VSCode, toca meter los archivos de la web.
Puedes arrastrar los archivos directamente al panel Explorer de VSCode, o copiarlos desde el Finder / Explorador de archivos.
Antes de subir nada, comprobamos que la web funciona bien en tu ordenador.
Live Server abre el navegador y recarga automáticamente cada vez que guardas un archivo.
Todo funciona en local — toca subir los archivos a GitHub.
Cloudflare ha unificado Pages y Workers bajo una sola plataforma: cualquier sitio (estático o no) se despliega como Worker con assets estáticos, y eso requiere dos archivos de configuración en el repo. El flujo es el mismo para GitHub que para Codeberg.
Si tu repo está en Codeberg, lee el paso previo (sirve igual) y luego salta a la sección "Repo en Codeberg" más abajo.
Antes de tocar el dashboard de Cloudflare hay que añadir dos archivos a la raíz del repo. Si no, el deploy falla con ? Proceed with setup? (Wrangler intenta inicializar interactivamente y se cuelga) o con [ERROR] Asset too large (intenta subir .git/, que excede los 25 MiB del límite de Workers).
{
"$schema": "node_modules/wrangler/config-schema.json",
"name": "mi-sitio",
"compatibility_date": "2026-05-05",
"assets": {
"directory": "./",
"not_found_handling": "404-page"
}
}
name debe coincidir con el Project name que pondrás en Cloudflare. Si el repo no tiene 404.html, quita la línea not_found_handling.
.git .gitignore .assetsignore .wrangler node_modules wrangler.jsonc *.md .DS_Store .vscode
En la pantalla "Set up your application":
El primer deploy tarda alrededor de un minuto. Cuando termine, Cloudflare te da una URL tipo nombre.<cuenta>.workers.dev.
Cloudflare no integra con Codeberg directamente. Eliges una de estas dos:
Opción 1 · Mirror automático Codeberg → GitHub (recomendada para empezar)
Mantienes el desarrollo en Codeberg, GitHub recibe una copia espejo, Cloudflare se conecta al espejo de GitHub. Para el flow diario es transparente: empujas a Codeberg, en segundos llega a GitHub y Cloudflare despliega.
Opción 2 · Deploy directo con wrangler desde local (sin mirror, más control)
El repo vive solo en Codeberg. Despliegas a Cloudflare desde tu terminal con la CLI wrangler. No hay auto-deploy: cada cambio requiere un comando manual o un pipeline en Woodpecker CI (Codeberg).
Tras cada cambio en Codeberg, repite npx wrangler deploy para publicar. Para automatizarlo: pipeline Woodpecker en .woodpecker.yml con el token de Cloudflare como secret.
Si tienes un dominio propio, lo conectamos al Worker que acabamos de desplegar.
Si la zona DNS del dominio ya está en la misma cuenta de Cloudflare, Cloudflare crea el registro CNAME automáticamente y no hay que tocar nada más. Salta al paso 11.
Si el dominio aún no está en Cloudflare, hay que añadirlo primero como zona DNS. Lo vemos en el paso 10.
HTTPS es automático: Cloudflare emite un certificado en cuanto el DNS responde. No hay que activar nada.
Solo necesario si tu dominio aún no está como zona DNS en tu cuenta de Cloudflare. Si ya lo está, Cloudflare creó solo los registros en el paso 9 y puedes saltar a la sección 11.
Una vez la zona está activa, vuelve al paso 9 y añade el dominio desde Settings → Domains & Routes del proyecto. Cloudflare creará automáticamente el CNAME a nombre.<cuenta>.workers.dev.
| Tipo | Nombre | Contenido | Proxy |
|---|---|---|---|
CNAME |
@ |
nombre.<cuenta>.workers.dev |
Proxied |
CNAME |
www |
nombre.<cuenta>.workers.dev |
Proxied |
Estos registros los crea Cloudflare automáticamente cuando añades el Custom Domain desde el panel del proyecto. Solo tendrías que tocarlos a mano si por algún motivo no aparecen.
El certificado lo emite Cloudflare automáticamente al detectar que el DNS responde. No hay checkbox de "Enforce HTTPS" — está activo por defecto. Cuando entres con http:// redirige solo a https://.
A partir de ahora, cada vez que quieras modificar algo en la web:
Cloudflare despliega en ~1 minuto tras detectar el push (si tu repo está conectado vía Git). Si usas el flow con wrangler desde local, tienes que ejecutar npx wrangler deploy después del push.
Asset too large y Proceed with setup?)main en Settings → Build[ERROR] Asset too large por culpa de .git/".git/ (que pesa mucho por el historial). Workers tiene límite de 25 MiB por archivo..assetsignore en la raíz del repo con .git, .gitignore, node_modules, wrangler.jsonc, *.md, etc. (ver paso 8, "Paso previo: preparar el repo")? Proceed with setup? en el log"wrangler.jsonc: Wrangler no sabe qué desplegar y abre un setup interactivo que en el contexto del build no se puede completarwrangler.jsonc en la raíz del repo con la config de assets (ver paso 8, "Paso previo: preparar el repo")name del wrangler.jsonc debe coincidir con el Project name en CloudflareWorker apuntando al proyecto (raíz y www)MX, TXT de SPF/DKIM/DMARC ni records de otros subdominios.npx wrangler deploy tras cada cambioThis project is disconnected from your Git account"main no disparan redeploy automáticorepo)repository) y usarlo como contraseñagit --version — si no está, instala Xcode Command Line Tools con xcode-select --installindex.html en cada carpeta. Si tienes /sobre.html, accede con /sobre.html o crea /sobre/index.html y accede a /sobre/404.html, añade "not_found_handling": "404-page" dentro de "assets" en wrangler.jsonc_redirects en la raíz con /* /index.html 200Cmd+Shift+R (recarga forzada)