Hostname-Verifizierung

Bevor Cache Rocket eine einzelne Anfrage an eine Domain sendet, müssen du nachweisen, dass du die Kontrolle darüber haben. Auf dieser Seite werden beide Überprüfungsmethoden behandelt und was zu tun ist, wenn eine davon fehlschlägt.

Hostnames live unter Konto → Hostnames.

Warum dies erforderlich ist#

Ein Cache warmer ist eine Maschine, die sehr schnell viele Anfragen an eine Website sendet. Das ist hilfreich, wenn es auf den eigenen Server gerichtet ist, und feindselig, wenn es auf den eines anderen Servers gerichtet ist – es handelt sich funktionell um ein Denial-of-Service-Tool.

Die Verifizierung ist das, was die beiden trennt. Das bedeutet, dass jede Anfrage, die Cache Rocket in deinem Namen sendet, an eine Infrastruktur geht, die du nachweislich kontrollieren. Es gibt keine Möglichkeit, sich abzumelden, und keinen Plan, der die Anforderung aufhebt.

Eine Methode wählen#

Beide Methoden führen zum gleichen verifizierten Status. Wählen du, was du schneller erledigen können.

Die hostname richtig machen#

Dies ist die häufigste Ursache für Verwirrung, daher lohnt es sich, präzise zu sein. Ein hostname ist der genaue Domänenteil deiner URLs. Diese sind alle *verschieden* hostnames, soweit es die Verifizierung betrifft:

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

Überprüfen du die in den Eintrags-URLs angezeigte URL, die Du verwendest möchten. Wenn deine Website example.com zu www.example.com weiterleitet, sollte deine Eintrags-URL die www-Version sein, also ist dies die hostname, die überprüft werden muss.

Mehrere Subdomains betreiben? Überprüfen du jedes einzeln. Es gibt keine Wildcard-Überprüfung.

Methode A – DNS-TXT-Eintrag#

1. 1

   hostname hinzufügen

   Geben du unter Konto → Hostnames die Domäne ein und wählen du DNS-TXT-Eintrag als Überprüfungsmethode aus.

2. 2

   Verifizierung starten

   Klicken du auf Verifizierung starten. Cache Rocket generiert ein eindeutiges Token und zeigt dir den Datensatznamen und den genauen zu veröffentlichenden Wert an.

3. 3

   Erstellen du den Eintrag bei deinem DNS-Anbieter

   Melden du sich dort an, wo dein DNS verwaltet wird – Cloudflare, dein Registrar, das Control Panel deines Hosts – und fügen du einen neuen TXT-Eintrag mit dem angezeigten Namen und Wert hinzu. Kopieren du den Wert und fügen du ihn ein. Geben du es nicht noch einmal ein.

4. 4

   Warten du auf die Ausbreitung

   DNS-Änderungen erfolgen nicht sofort. Ein paar Minuten sind typisch; Bis zu einer Stunde ist normal, wenn dein Anbieter eine lange TTL verwendet.

5. 5

   Klicken du auf Überprüfen

   Klicken du in Cache Rocket auf Bestätigen neben hostname. Wenn dies fehlschlägt, warten du länger und klicken du erneut. Ein erneuter Versuch ist kostenlos und setzt nichts zurück.

Überprüfen du die Aufzeichnung selbst

Wenn die Überprüfung weiterhin fehlschlägt, stellen du sicher, dass der Datensatz tatsächlich im öffentlichen Internet sichtbar ist, bevor du davon ausgehen, dass Cache Rocket schuld ist:

dig +short TXT _cacherocket.example.com

Resolve-DnsName -Type TXT _cacherocket.example.com

Ersetzen du den Datensatznamen, den dir Cache Rocket angezeigt hat. Wenn der Befehl nichts zurückgibt, wurde der Datensatz noch nicht weitergegeben oder wurde nicht korrekt gespeichert.

Methode B – HTTPS-Datei oder Meta-Tag#

Wählen du HTTPS-Datei oder Meta-Tag und klicken du auf Überprüfung starten. Cache Rocket zeigt dann drei Dinge an: die URL, die überprüft wird, den genauen Inhalt, den die URL zurückgeben muss, und ein entsprechendes <meta>-Tag. Du musst entweder die Datei oder das Meta-Tag veröffentlichen, nicht beides.

Veröffentlichen der Datei

Erstellen du im angezeigten Pfad eine Datei, die genau den angezeigten Inhalt enthält und sonst nichts. Bei einem Next.js-Projekt bedeutet das, dass du es in deinem public/-Verzeichnis ablegen:

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

Stellen du es bereit und öffnen du dann die Verifizierungs-URL in einem Browser. Du solltest nur das Token sehen. Wenn du die 404-Seite deiner Website, formatierten HTML-Code oder eine Weiterleitung sehen, wurde sie noch nicht korrekt veröffentlicht.

Oder verwenden du das Meta-Tag

Wenn das Hinzufügen von Dateien umständlich ist, fügen du stattdessen das mitgelieferte Tag <meta> in das <head> deiner Homepage ein. Im Next.js App Router können du es über den Metadatenexport hinzufügen:

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

Bereitstellen und dann auf Überprüfen klicken.

Nach Überprüfung#

Die hostname zeigt Verifiziert in deiner Liste an und kann sofort in Eintrags-URLs sowohl im Cache warmers als auch in der API warmers verwendet werden.

Du kannst den TXT-Eintrag oder die Verifizierungsdatei anschließend sicher entfernen, es ist jedoch einfacher, sie an Ort und Stelle zu belassen – das bedeutet, dass eine erneute Verifizierung sofort erfolgt, falls sie jemals benötigt wird.

Entfernen einer hostname#

Die Verifizierung schlägt immer wieder fehl#

Ich habe den DNS-Eintrag hinzugefügt, aber die Überprüfung schlägt immer noch fehl.

Fast immer Vermehrung. Bestätigen du mit dem obigen Befehl dig, dass der Datensatz öffentlich sichtbar ist. Wenn dig es findet, Cache Rocket jedoch nicht, suchen du nach einem doppelten Domänensuffix im Datensatznamen oder einem zweiten widersprüchlichen TXT-Eintrag mit demselben Namen.

Die Verifizierungsdatei lässt sich in meinem Browser problemlos öffnen, Cache Rocket kann sie jedoch nicht lesen.

dein Browser ist möglicherweise authentifiziert, während Cache Rocket dies nicht ist. Probieren du die URL in einem privaten Fenster aus. Überprüfen du außerdem, dass es über https ohne Weiterleitung bereitgestellt wird und dass die Antwort aus reinem Text und nicht aus einer HTML-Seite besteht, die das Token enthält.

Welche hostname überprüfe ich, wenn meine Website weiterleitet?

Das Ziel – die hostname, die nach Abschluss der Umleitung in der Adressleiste angezeigt wird. Dies ist diejenige, die deine Eintrags-URLs verwenden sollten.

Muss ich jede Subdomain verifizieren?

Ja. Jedes hostname wird unabhängig überprüft und es gibt keine Platzhalteroption. shop.example.com benötigt eine eigene Verifizierung, auch wenn example.com bereits verifiziert ist.

Kann ich eine Domain verifizieren, die ich für einen Kunden verwalte, aber nicht besitze?

Ja, vorausgesetzt, Du kannst einen DNS-Eintrag hinzufügen oder eine Datei veröffentlichen – genau das testet die Challenge. Agenturen verifizieren in der Regel jeden Kunden hostname innerhalb seines Workspaces. Siehe Teams und Rollen.

Kann ich eine localhost- oder nur interne Adresse erwärmen?

Nein. Cache Rocket wird über das öffentliche Internet bereitgestellt, daher muss hostname öffentlich auflösbar und erreichbar sein.