Verificación de hostname

Demuestra que controlas un dominio mediante un registro DNS TXT o un archivo HTTPS, para poder calentarlo.

9 min read

Antes de que Cache Rocket envíe una sola solicitud a un dominio, debes demostrar que lo controlas. Esta página cubre ambos métodos de verificación y qué hacer cuando uno falla.

Hostnames vive en Cuenta → Hostnames.

¿Por qué esto es necesario?

Un caché warmer es una máquina que envía muchas solicitudes a un sitio web muy rápidamente. Esto es útil cuando apunta a tu propio servidor y hostil cuando apunta al de otra persona; funcionalmente, es una herramienta de denegación de servicio.

La verificación es lo que separa a los dos. Significa que cada solicitud que Cache Rocket envía en tu nombre va a la infraestructura que tú ha demostrado que controla. No hay forma de darse de baja ni ningún plan que elimine el requisito.

Note

Esto también te protege. Nadie más puede crear un warmer apuntado a tu dominio porque no puede pasar el desafío de verificación.

Elegir un método

	Registro DNS TXT	Archivo HTTPS o metaetiqueta
Necesitas acceso a	Tu proveedor de DNS	Los archivos o plantillas de tu sitio
Espera típica	Minutos a una hora, para la propagación.	Tan rápido como puedas implementar
Mejor cuando	Administra DNS y desea un cambio que sobreviva a las redespliegues	Implementas una aplicación pero no controlas DNS
Buen ajuste para	Hosting tradicional, cPanel, servidores autoadministrables	Next.js, Vercel, Netlify, hosts estáticos

Cualquiera de los métodos da como resultado el mismo estado verificado. Elige lo que puedas hacer más rápido.

Obteniendo el hostname correcto

Esta es la fuente de confusión más común, por lo que conviene ser preciso. Un hostname es la parte exacta del dominio de tus URL. Todos estos son *diferentes* hostnames en lo que respecta a la verificación:

text

example.com
www.example.com
shop.example.com
blog.example.com

Verifica la que aparece en las URL de entrada que pretendes utilizar. Si tu sitio redirige example.com a www.example.com, tu URL de entrada debe ser la versión www, por lo que esa es la hostname para verificar.

¿Está ejecutando varios subdominios? Verifique cada uno por separado. No hay verificación con comodines.

Tip

¿No estás seguro de qué formulario utiliza tu sitio? Ábrelo en un navegador y mira la barra de direcciones cuando termine de cargarse. Lo que se muestra allí, después de cualquier redireccionamiento, es el hostname para verificar.

Método A: registro DNS TXT

1
Agrega el hostname
En Cuenta → Hostnames, escriba el dominio y seleccione Registro DNS TXT como método de verificación.
2
Iniciar verificación
Haga clic en Iniciar verificación. Cache Rocket genera un token único y te muestra el nombre del registro y el valor exacto a publicar.
3
Crea el registro en tu proveedor de DNS
Inicie sesión dondequiera que se administre tu DNS (Cloudflare, tu registrador, el panel de control de tu host) y agregue un nuevo registro TXT usando el nombre y el valor que se muestran. Copie y pegue el valor; no lo vuelvas a escribir.
4
Esperar a que se propague
Los cambios de DNS no son instantáneos. Unos pocos minutos es lo típico; hasta una hora es normal si tu proveedor utiliza un TTL largo.
5
Haga clic en Verificar
De vuelta en Cache Rocket, haz clic en Verificar junto a hostname. Si falla, espere más y haga clic nuevamente; volver a intentarlo es gratis y no restablece nada.

Comprobando el registro tú mismo

Si la verificación sigue fallando, confirme que el registro sea realmente visible desde la Internet pública antes de asumir que Cache Rocket tiene la culpa:

macOS y Linux

bash

dig +short TXT _cacherocket.example.com

ventanas

powershell

Resolve-DnsName -Type TXT _cacherocket.example.com

Sustituya el nombre del registro que le mostró Cache Rocket. Si el comando no devuelve nada, el registro aún no se ha propagado o no se ha guardado correctamente.

Errores comunes de DNS

Los proveedores varían en cuanto a si esperan el nombre de registro completo o solo la parte del subdominio: ingresando _cacherocket.example.com donde el proveedor ya agrega tu dominio produce _cacherocket.example.com.example.com. También esté atento a las comillas que se agregan automáticamente y a los espacios en blanco al pegar.

Método B: archivo HTTPS o metaetiqueta

Elija archivo HTTPS o metaetiqueta y haga clic en Iniciar verificación. Cache Rocket luego muestra tres cosas: la URL que verificará, el contenido exacto que debe devolver esa URL y una etiqueta <meta> equivalente. Debes publicar ya sea el archivo o la metaetiqueta, no ambos.

Publicando el archivo

Cree un archivo en la ruta que se muestra, que contenga exactamente el contenido que se muestra y nada más. En un proyecto Next.js, esto significa colocarlo en tu directorio public/:

Next.js, Vite, Astro y la mayoría de los hosts estáticos

text

public/
  └── .well-known/
        └── cacherocket-verification.txt

Implemente y luego abra la URL de verificación en un navegador. Deberías ver sólo el token. Si ve la página 404 de tu sitio, HTML con estilo o una redirección, todavía no está publicado correctamente.

O usando la metaetiqueta

Si agregar archivos le resulta incómodo, coloque la etiqueta <meta> proporcionada en el <head> de tu página de inicio. En el Next.js App Router puedes agregarlo a través de la exportación de metadatos:

app/layout.tsx

export const metadata = {
  other: {
    'cacherocket-site-verification': 'YOUR_TOKEN_HERE',
  },
};

Implementar y luego hacer clic en Verificar.

El archivo debe ser accesible públicamente.

Si tu sitio cuenta con autenticación básica HTTP, una lista de IP permitidas, una contraseña provisional o una página "próximamente", Cache Rocket no puede leer el archivo de verificación. Permita el acceso público a esa ruta o utilice el método DNS en tu lugar.

Agregué el registro DNS pero la verificación aún falla.: Casi siempre propagación. Confirme que el registro sea visible públicamente con el comando dig anterior. Si dig lo encuentra pero Cache Rocket no, verifique si hay un sufijo de dominio duplicado en el nombre del registro o un segundo registro TXT en conflicto con el mismo nombre.
El archivo de verificación se abre bien en mi navegador pero Cache Rocket no puede leerlo.: Su navegador puede estar autenticado donde Cache Rocket no lo está. Pruebe la URL en una ventana privada. También verifique que se entregue a través de https sin redireccionamiento y que la respuesta sea texto sin formato en lugar de una página HTML que contenga el token.
¿Cuál hostname verifico si mi sitio redirige?: El destino: el hostname que aparece en la barra de direcciones una vez que se completa la redirección. Esa es la que deberían usar tus URL de entrada.
¿Necesito verificar cada subdominio?: Sí. Cada hostname se verifica de forma independiente y no hay ninguna opción comodín. shop.example.com necesita tu propia verificación incluso si example.com ya está verificado.
¿Puedo verificar un dominio que administro para un cliente pero que no soy de mi propiedad?: Sí, siempre que pueda agregar un registro DNS o publicar un archivo; eso es exactamente lo que prueba el desafío. Las agencias suelen verificar a cada cliente hostname dentro del espacio de trabajo de ese cliente. Consulte Equipos y roles.
¿Puedo activar una dirección localhost o solo interna?: No. Cache Rocket proviene de la Internet pública, por lo que hostname debe poder resolverse y ser accesible públicamente.