workers.dev: el subdominio de pruebas

Cuando despliegas tu primer Worker, Cloudflare te entrega una dirección pública sin que toques un solo registro de DNS ni gestiones un certificado: algo como mi-api.mi-cuenta.workers.dev. Es la vía más corta entre wrangler deploy y una URL que puedes abrir en el navegador o mandarle a un compañero. Esa comodidad, sin embargo, esconde decisiones de arquitectura —tenencia compartida, cookies, marca, control de la zona— que explican por qué workers.dev es inmejorable para probar y frágil como hogar definitivo de un producto.

Anatomía de una URL gratis

Cada cuenta de Cloudflare elige, una sola vez, un subdominio propio bajo workers.dev, del tipo mi-cuenta.workers.dev. A partir de ahí, cada Worker que despliegas con esta ruta activa cuelga de él como un tercer nivel: <worker>.<mi-cuenta>.workers.dev.

No hay DNS que configurar porque el subdominio ya vive dentro de la infraestructura de Cloudflare; el despliegue registra el nombre y lo propaga a toda la red global en segundos.

flowchart LR
A[wrangler deploy] --> B[Worker en el edge global]
B --> C[Subdominio de la cuenta en workers.dev]
C --> D[URL publica lista para abrir]

Ese árbol de tres niveles no es casual: refleja la jerarquía del DNS. workers.dev es el dominio, tu cuenta es el subdominio, y cada Worker una etiqueta más a la izquierda. El nombre del Worker, por tanto, hereda las reglas de una etiqueta de DNS: hasta 63 caracteres, solo alfanuméricos y guiones, sin empezar ni terminar en guion.

Al desplegar, Wrangler te devuelve la dirección final junto con el identificador de versión:

wrangler deploy
# Total Upload: 1.02 KiB / gzip: 0.54 KiB
# Uploaded mi-api (2.1 sec)
# Published mi-api (3.4 sec)
#   https://mi-api.mi-cuenta.workers.dev
# Current Version ID: 0e2c9b...

Esa dirección responde mientras el Worker exista y workers.dev siga activo; en cuanto lo apagas, deja de contestar sin redirección ni rastro. No cuelgues de ella nada que deba perdurar.

Preview URLs: una dirección por versión

workers.dev publica la versión activa de tu Worker. Aparte de esa dirección estable, Cloudflare puede generar preview URLs: una dirección por cada versión desplegada, con la forma <prefijo-version>-<worker>.<mi-cuenta>.workers.dev. Sirven para revisar un cambio antes de promoverlo, sin pisar la versión que ya está en producción.

Hay dos sabores: la preview versionada, atada a un identificador concreto y por tanto inmutable, y la con alias, un nombre estable que apuntas a la versión que quieras probar. La primera es ideal para revisar un commit exacto; la segunda, para un entorno de staging con URL fija.

Desde 2025 las preview URLs son opt-in y su valor por defecto sigue al de workers.dev: si el subdominio está activo, las previews también; si lo desactivas, se apagan con él. Esta simetría evita el error clásico de creer que apagaste tu Worker cuando en realidad seguía expuesto por una preview olvidada.

{
  // Previews activas aunque workers.dev este apagado
  "workers_dev": false,
  "preview_urls": true
}

Por qué no para producción seria

workers.dev funciona, pero arrastra propiedades que chocan con un producto serio:

Ninguna de estas pegas es un fallo de la plataforma: son la consecuencia lógica de vivir en un dominio prestado y compartido. Aparecen justo cuando dejas de prototipar y empiezas a necesitar identidad, reputación y control propios.

Dicho de otro modo, workers.dev optimiza el arranque, no la operación. El día que te importe quién puede leer una cookie o qué aparece en la barra del navegador, ya habrás salido de su terreno.

Cuándo sí, y cómo apagarlo

workers.dev brilla exactamente donde producción no llega. Estos son sus terrenos naturales:

El hilo común de los cuatro casos es que la URL es desechable: nadie la va a memorizar, indexar ni confiar en ella a largo plazo. Mientras esa premisa se cumpla, workers.dev es la opción más rápida y sensata.

Cuando el proyecto madura y conectas un dominio, conviene cerrar la puerta trasera. Basta con desactivar la ruta en la configuración:

{
  "name": "mi-api",
  "main": "src/index.ts",
  "compatibility_date": "2026-07-03",
  // Apaga la URL publica en workers.dev y, por defecto, sus previews
  "workers_dev": false
}

De hecho, si añades un bloque routes a tu configuración y no dices nada, Wrangler infiere workers_dev como false en el siguiente despliegue: la plataforma asume que ya tienes tu propia puerta de entrada.