Cloudflare O2O: So richten Sie ConveyThis-Mitarbeiter ein (Orange-zu-Orange)

Fassen Sie diesen Beitrag zusammen mit: 9 Minuten Lesezeit

ChatGPT Ratlosigkeit Grok Google AI

Cloudflare O2O (Orange-to-Orange) ist ein Routing-Setup, bei dem eine Anfrage zwei Cloudflare-Zonen durchläuft: Ihr Zone zuerst, dann die Zone eines SaaS-Anbieters, auf den Sie verweisen. Sie schalten es ein, indem Sie a hinzufügen Proxyed (Orange-Cloud) CNAME-Eintrag, der auf den Hostnamen des Anbieters abzielt. Cloudflare wendet zuerst die Einstellungen Ihrer Zone und dann die des Anbieters an, sodass Ihr WAF und Ihre Regeln weiterhin funktionieren.

ConveyThis verwendet O2O, um übersetzte Seiten für Websites bereitzustellen, die sich bereits auf Cloudflare befinden, ohne dass eine Nameserver-Änderung erforderlich ist. In dieser Anleitung wird erklärt, wie O2O funktioniert, wie man es Schritt für Schritt mit ConveyThis einrichtet und was man überprüfen kann, wenn es sich nicht verhält.

Wichtige Erkenntnisse

• O2O gilt nur, wenn Sie auf a zeigen Proxys CNAME bei einem Cloudflare für SaaS-Anbieter und nur, wenn die beiden Zonen gehören zu Verschiedene Cloudflare-Konten.
• Die Einstellungen Ihrer Zone werden zuerst ausgeführt. Sicherheitsregeln, Bot-Einstellungen und Seitenregeln, die Sie bereits haben, sehen die Anfrage weiterhin.
• Ein Grauvolkendatensatz (nur DNS) oder ein A-Datensatz nimmt nicht den O2O-Pfad ein.
• Mit ConveyThis fügen Sie Proxied CNAMEs hinzu zu fallback.conveythis.net, warten Sie, bis die Zertifikate aktiv werden, und übersetzte Seiten werden von einem Cloudflare Worker am Rand bereitgestellt.
• O2O ist optional. Das Standard-DNS-Setup ConveyThis bleibt verfügbar.

Was Cloudflare O2O ist, im Klartext

Viele SaaS-Produkte (Site Builder, E-Commerce-Plattformen, Übersetzungsproxys) laufen auf Cloudflare für SaaS. Ihre Kunden verbinden eine benutzerdefinierte Domäne, indem sie einen CNAME-Eintrag hinzufügen, der auf den Anbieter verweist.

Wenn die Domain dieses Kunden ist auch Auf Cloudflare trifft die Anfrage auf dem Weg zur Seite auf zwei Cloudflare-Zonen. Cloudflares O2O-Dokumentation definiert dies als “eine spezifische Verkehrsrouting-Konfiguration, bei der der Verkehr durch zwei Cloudflare-Zonen geleitet wird: Die erste Cloudflare-Zone gehört Kunde 1 und die zweite Cloudflare-Zone gehört Kunde 2, der als SaaS-Anbieter gilt.”

Drei Fakten von dieser Seite entscheiden, ob O2O auf Sie zutrifft:

1. Datensatztyp. Sie benötigen “einen Proxy-DNS-Eintrag, der dem benutzerdefinierten Hostnamen mit einem vom SaaS-Anbieter definierten CNAME-Ziel entspricht.”
2. Befehl. “Die in Ihrer Cloudflare-Zone konfigurierten Einstellungen werden zuerst auf den Datenverkehr angewendet, und dann werden die in der Zone des SaaS-Anbieters konfigurierten Einstellungen als zweites auf den Datenverkehr angewendet.”
3. Konten. “O2O gilt nur, wenn die beiden Zonen Teil unterschiedlicher Cloudflare-Konten sind.” Es gilt auch “nicht, wenn ein A-Datensatz verwendet wird.”

Der Anbieter kann sehen, dass eine Anfrage über O2O kam: Cloudflare fügt den Header hinzu cf-connecting-o2o: 1 in der Zone des Anbieters.

Warum O2O für die Website-Übersetzung wichtig ist

Ein Übersetzungsproxy muss zwischen dem Besucher und Ihrer Site sitzen, damit er übersetztes HTML zurückgeben kann. Die klassische Methode besteht darin, DNS für die übersetzten Hostnamen auf den Proxy zu verweisen.

Das ist umständlich, wenn Ihre Domain bereits auf Cloudflare lebt. Ihr Team verlässt sich auf TLS, WAF und Caching der Zone, und niemand möchte DNS verschieben oder die orangefarbene Cloud ausschalten, nur um Sprachen hinzuzufügen. O2O vermeidet diesen Kompromiss: Die Anfrage gelangt wie gewohnt in Ihre Zone und wird dann zur Cloudflare-Zone ConveyThis’s für SaaS fortgesetzt, wo ein Worker die übersetzte Seite erstellt.

ConveyThis erkennt, dass sich die Domäne auf Cloudflare befindet und bietet die Option Workers (O2O) an.

Bevor Sie beginnen

• Die Nameserver Ihrer Domäne gehören Cloudflare und Sie können deren DNS-Einträge bearbeiten.
• Sie haben ein ConveyThis-Konto mit der hinzugefügten Domäne. Die URL-Strukturen für Unterordner und Unterdomänen sind im Geschäftsplan und darüber verfügbar (Preise).
• Sie wissen, welche URL-Struktur Sie wünschen. Unterordner gibt example.com/de/, Subdomäne gibt de.example.com. Unser Vergleich von Unterverzeichnisse vs. Subdomains für mehrsprachige SEO behandelt die SEO-Seite und den Hilfeartikel über Unterdomäne vs. Unterverzeichnis deckt Plattformgrenzen ab.

So richten Sie ConveyThis Cloudflare Workers (O2O) ein

Schritt 1: Fügen Sie die Domäne hinzu und bestätigen Sie die Cloudflare-Erkennung

Wenn Sie die Domäne hinzufügen, überprüft ConveyThis ihre Nameserver. Wenn sie zu Cloudflare gehören, zeigt das Setup einen Hinweis an, dass sich die Domäne auf Cloudflare befindet, und entsperrt Cloudflare-Mitarbeiter (O2O) für die Unterordner- und Unterdomänenstrukturen.

Schritt 2: Wählen Sie die URL-Struktur und wechseln Sie die Serve-Methode zu O2O

Wählen Unterordner oder Unterdomäne, dann wählen Cloudflare-Mitarbeiter (O2O) als Serviermethode. Der Standard-DNS-Proxy bleibt auf demselben Bildschirm verfügbar, wenn Sie ihn lieber verwenden möchten.

Der Standard-DNS-Proxy bleibt verfügbar. O2O ist die Cloudflare-native Option, wenn die Zone erkannt wird.

Schritt 3: Fügen Sie die Proxied CNAME-Einträge in Cloudflare hinzu

ConveyThis druckt die genauen Datensätze für Ihre Domain. Sie zeigen auf fallback.conveythis.net:

• Unterordner: typischerweise @ „ www, plus ein Ursprungsdatensatz, wenn Ihr Setup einen benötigt.
• Unterdomäne: Ein Datensatz pro Sprachhost (zum Beispiel de, fr), plus ein origin Aufzeichnen, damit der Worker Ihre tatsächliche Site erreichen kann, ohne in einer Schleife zurückzufahren.

Fügen Sie sie in Ihr Cloudflare DNS-Dashboard ein und verlassen Sie die Cloud Orange auf jeder Platte. Dies ist die einzige Regel, die Sie nicht umgehen können: Ein DNS-only-Eintrag wird nicht durch O2O geleitet.

DNS überprüfen: Proxied @ / www hin zu fallback.conveythis.net, plus der Ursprungsdatensatz für den echten Server.

Schritt 4: Warten Sie, bis SSL aktiv wird

Cloudflare für SaaS stellt die Zertifikate für Ihre Hostnamen aus. ConveyThis verwendet HTTP-Validierung, sodass Sie keine Validierungsdatensätze (TXT) hinzufügen oder etwas auf Ihren Server hochladen. Aktualisieren Sie die Statustabelle, bis jedes Zertifikat angezeigt wird Aktiv. In unserem Testlauf dauerte dies einige Minuten.

Wenn der Status aktiv ist, sind die übersetzten Hostnamen bereit.

Schritt 5: Öffnen Sie eine übersetzte URL

Laden Sie eine übersetzte Seite, z. B example.com/de/ oder de.example.com. Sie sollten Ihr normales Layout mit übersetztem Text und der Sprachumschalter sehen.

Eine übersetzte Seite, die über Cloudflare Workers (O2O) bereitgestellt wird.

Was passiert mit jeder Anfrage

Hier ist der Pfad, den die Anfrage eines Besuchers nimmt, basierend darauf, wie der ConveyThis Edge Worker aufgebaut ist:

1. Der Besucher fordert eine übersetzte URL an. Die Anfrage geht ein Ihr Cloudflare-Zone, und Ihre Regeln gelten.
2. Der Proxied CNAME übergibt es an ConveyThis’s Cloudflare für die SaaS-Zone (O2O).
3. Der Worker sucht nach den Einstellungen Ihrer Domäne, ermittelt die Zielsprache aus dem Unterordner oder der Unterdomäne und ruft die Originalseite von Ihrem Ursprung ab.
4. Während das HTML durchströmt wird, tauscht der Worker Übersetzungen aus einem gespeicherten Wörterbuch für Ihre Site aus. Es weist auch auf interne Links hin, das kanonische Tag und og:url in derselben Sprachversion und legt die Seiten lang Attribut.
5. Die übersetzte Seite geht zurück an den Besucher. Text, der noch keine Übersetzung hat, wird zur Übersetzung im Hintergrund gesendet, sodass er im Wörterbuch für die nächste Ansicht angezeigt wird.

Einige wissenswerte Details:

• Zwischenspeicherung. Übersetzte Seiten werden am Rand zwischengespeichert. Der Cache-Schlüssel enthält einen Fingerabdruck Ihrer Übersetzungen. Wenn Sie also eine Übersetzung bearbeiten, erhält die nächste Anfrage eine neue Seite ohne manuelle Bereinigung.
• Angemeldete Besucher. Anfragen, die Cookies enthalten, überspringen den Cache der gemeinsam genutzten Seite, sodass ein Besucher nie die personalisierte Seite eines anderen Besuchers sieht.
• Ausgeschlossene Inhalte. Text im Inneren script, style, code, pre „ textarea wird nie übersetzt, und auch nichts ist markiert translate="no".
• Schleifenschutz. Wenn ein falsch konfigurierter Datensatz die eigene Anfrage des Arbeiters an sich selbst zurücksendet, stoppt er mit einem Fehler, anstatt eine Schleife zu bilden.

Fehlerbehebung

Die übersetzte URL lädt Ihre ursprüngliche Site nicht und zeigt sie auch nicht an. Überprüfen Sie, ob jeder Routing-Datensatz noch proxiert ist. Die häufigste Ursache ist, dass jemand einen Datensatz nur auf DNS umstellt “zum Debuggen”.

Zertifikate bleiben auf “Ausgabe”. Warten Sie etwas länger und überprüfen Sie es erneut. Wechseln Sie Datensätze nicht in graue Wolken, um die Dinge zu beschleunigen. O2O benötigt sie als Proxy, Sie würden also nur ein zweites Problem erstellen, das Sie rückgängig machen müssen.

Fehler bezüglich einer Schleife oder Seiten, die nie vollständig geladen werden. Der Worker kann Ihre echte Site nicht erreichen. Stellen Sie sicher, dass der aufgeführte Ursprungsdatensatz ConveyThis existiert, korrekt ist und auf Ihren tatsächlichen Server oder Ihre Plattform zeigt.

Ihre eigene Firewall blockiert die übersetzten Seiten. Da Ihre Zone zuerst ausgeführt wird, kann eine strenge WAF-Regel oder Bot-Einstellung Anfragen blockieren, bevor sie ConveyThis erreichen. Überprüfen Sie Ihre Sicherheitsereignisse auf die übersetzten Hostnamen.

Ein Teil des Textes bleibt in der Originalsprache. Wenn es sich um brandneuen Text handelt, laden Sie ihn nach einem Moment neu. Wenn es bestehen bleibt, prüfen Sie, ob das Element vorhanden ist translate="no", oder bearbeiten Sie die Übersetzung in Ihrem ConveyThis-Dashboard.

Sollten Sie O2O oder das Standard-DNS-Setup verwenden?

Verwenden Cloudflare-Mitarbeiter (O2O) wenn Ihre Domäne bereits Cloudflare-Nameserver verwendet und Sie die Sicherheit und Kontrolle Ihrer Zone behalten möchten, während Sie übersetzte Unterordner- oder Unterdomänen-URLs hinzufügen.

Verwenden Sie die Standard-DNS-Setup wenn Ihre Domäne nicht auf Cloudflare ist oder Sie keine Proxied-Datensätze im Cloudflare-Dashboard verwalten möchten. Für Nicht-Cloudflare-Domänen folgen Sie den CNAME-Einrichtungshandbuch.

Überprüfen Sie in jedem Fall eine übersetzte Seite nach der Einrichtung mit “Quelle anzeigen”: die lang Attribut und Kanonik sollten mit der übersetzten URL übereinstimmen. Wenn Sie sich auf hreflang verlassen, bestätigen Sie, dass jede Sprachversion aufgeführt ist. Die mehrsprachige SEO-Funktionsseite erklärt, was ConveyThis für Suchmaschinen hinzufügt.

Häufig gestellte Fragen

Wofür steht O2O in Cloudflare? Orange-zu-Orange: Verkehr, der über einen Proxy-CNAME durch zwei Cloudflare-Zonen, Ihre und die eines SaaS-Anbieters, fließt.

Muss ich meine Nameserver für ConveyThis O2O ändern? Nein. O2O ist für Domänen, die sich bereits auf Cloudflare befinden. Sie fügen nur Proxied CNAME-Einträge in Ihrer vorhandenen Zone hinzu.

Funktioniert O2O mit einem A-Datensatz? Nein. In der Dokumentation von Cloudflare heißt es, dass O2O “nicht gilt, wenn ein A-Datensatz verwendet wird.” Verwenden Sie die CNAME-Einträge, die Ihnen ConveyThis angezeigt werden.

Gelten meine Cloudflare WAF- und Seitenregeln noch? Ja. Ihre Zone bearbeitet zuerst die Anfrage, dann die Zone des Anbieters.

Kann ich wieder zum Standard-DNS-Proxy wechseln? Ja. O2O ist Opt-in und Sie können die Serve-Methode in den URL-Einstellungen Ihrer Domain ändern.

Benötige ich ein CMS-Plugin? Nein. Der Worker übersetzt das HTML, das Ihre Site bereits sendet, sodass es unabhängig davon funktioniert, wie die Site erstellt wird.

Schon auf Cloudflare? Erstellen Sie ein ConveyThis-Konto, fügen Sie Ihre Domain hinzu und wählen Sie Cloudflare-Mitarbeiter (O2O) im Schritt der URL-Struktur.