Für die Einrichtung übersetzter Subdomains sind die korrekten DNS-, SSL/TLS- und Ursprungskonfigurationen erforderlich. Um die Fehlersuche zu vereinfachen, bietet Linguise jetzt einen Subdomain-Übersetzungs-Debugger, der Ihre Einrichtung überprüft und Konfigurations- oder Verbindungsprobleme hervorhebt.
Der Debugger hilft Ihnen dabei, die Ursache für das Fehlschlagen einer Setup-Prüfung zu identifizieren und liefert die relevanten Fehlerinformationen, damit Sie das Problem beheben und Ihre Konfiguration erneut überprüfen können.
Was überprüft der Subdomain Translation Debugger?
Der Debugger prüft die DNS-Konfiguration, SSL/TLS-Verbindungen und die ursprüngliche Website (Ursprungswebsite). Er verifiziert die Domaininhaberschaft, übersetzte Subdomain-CNAME-Einträge, A/AAAA-Einträge, Zertifikate und die Verfügbarkeit von HTTPS.
Es prüft außerdem, ob der Ursprung öffentlich erreichbar ist und gibt eine verwendbare HTTP-Antwort zurück. Jede Prüfung liefert einen Status und gegebenenfalls einen Fehlercode.
Verständnis der Diagnoseergebnisse
Der Debugger verwendet unterschiedliche Statusanzeigen, um das Ergebnis jeder Überprüfung anzuzeigen.
Fehlgeschlagen
Der Status „Fehlgeschlagen“ bedeutet, dass der Debugger ein Konfigurations- oder Verbindungsproblem festgestellt hat, das behoben werden muss. Überprüfen Sie den Fehlercode und die Diagnosedetails, um die betroffene Komponente zu identifizieren, z. B. DNS, SSL/TLS oder die Ursprungswebsite. Führen Sie nach der Behebung des Problems die Setup-Prüfung erneut aus, um das Ergebnis zu überprüfen.
Warnung
Der Warnstatus bedeutet, dass die Website erreichbar ist, ihre Antwort jedoch eine zuverlässige Übersetzung verhindern oder auf ein Konfigurationsproblem hinweisen kann. Überprüfen Sie die Diagnosedetails und die Konfiguration der Ursprungswebsite, des Servers oder des Netzwerks wie angegeben. Sobald das Problem behoben ist, führen Sie die Einrichtungsprüfung erneut aus.
Unbekannt
Der Status „Unbekannt“ bedeutet, dass der Debugger kein zuverlässiges Ergebnis für die Prüfung ermitteln konnte. Führen Sie die Setup-Prüfung zunächst erneut durch. Sollte der Status weiterhin bestehen, überprüfen Sie die Diagnoseinformationen und untersuchen Sie, ob ein zugrundeliegendes DNS-, TLS- oder Verbindungsproblem die Ursache ist.
Übersprungen
Der Status „Übersprungen“ bedeutet, dass die Prüfung nicht ausgeführt werden konnte, weil eine vorhergehende, erforderliche Prüfung fehlgeschlagen ist. Beispielsweise kann eine TLS-Prüfung übersprungen werden, wenn der übersetzte Hostname nicht über DNS aufgelöst werden kann. Beheben Sie in diesem Fall zuerst die zuvor fehlgeschlagene Prüfung und führen Sie die Setup-Prüfung anschließend erneut aus.
DNS-Fehler
DNS-Fehler treten auf, wenn die Datensätze, die zum Verbinden Ihrer übersetzten Subdomains oder Ihrer ursprünglichen Website erforderlich sind, fehlen, falsch sind oder nicht aufgelöst werden können.
Falscher oder fehlender Subdomain-CNAME
Dieser Fehler bedeutet, dass ein übersetzter Sprachhostname nicht zum erforderlichen Linguise CNAME-Ziel aufgelöst werden kann.
Überprüfen Sie die DNS-Konfiguration für den betroffenen Sprachhostnamen und stellen Sie sicher, dass der CNAME-Eintrag auf das Linguise Ziel verweist. Falls der Eintrag fehlt oder auf das falsche Ziel verweist, aktualisieren Sie ihn bitte bei Ihrem DNS-Anbieter. Der Debugger meldet möglicherweise die folgenden Fehler:
- DNS_CNAME_NXDOMAIN: Der übersetzte Hostname kann nicht aufgelöst werden.
- DNS_CNAME_MISMATCH: Der CNAME verweist auf ein falsches Ziel.
Überprüfung der Domaininhaberschaft
Dieser Fehler bedeutet, dass der erforderlichelinguise fehlt oder sein Wert nicht mit dem aktuellen Prüfwert übereinstimmt. Der Debugger meldet möglicherweise DNS_TXT_MISMATCH, wenn der TXT-Eintrag nicht den erwarteten Prüfwert enthält.
Öffnen Sie Ihren DNS-Anbieter und überprüfen Sie dielinguise.<domain> TXT-Eintrag. Fügen Sie den Eintrag hinzu, falls er fehlt, oder aktualisieren Sie seinen Wert auf den von Linguisebereitgestellten Verifizierungswert.
Entfernen Sie keine nicht zugehörigen TXT-Einträge aus Ihrer Domain. Führen Sie nach der DNS-Änderung die Einrichtungsprüfung erneut durch.
DNS-Fehler der ursprünglichen Domain
Dieser Fehler bedeutet, dass die ursprüngliche Domain nicht zu einem gültigen öffentlichen A- oder AAAA-Eintrag aufgelöst werden kann. Überprüfen Sie Ihre DNS-Einträge und stellen Sie sicher, dass die Domain zur korrekten öffentlichen IP-Adresse aufgelöst wird.
Falls der Eintrag fehlt oder fehlerhaft ist, aktualisieren Sie ihn bei Ihrem DNS-Anbieter. Warten Sie, bis die DNS-Änderungen wirksam geworden sind, und führen Sie dann die Einrichtungsprüfung erneut durch.
SSL/TLS-Fehler
SSL/TLS-Fehler treten auf, wenn Linguise keine gültige sichere HTTPS-Verbindung zur übersetzten Subdomain oder zur Original-Website herstellen kann.
SSL/TLS-Fehler bei der Übersetzung der Subdomain
Dieser Fehler bedeutet, dass Linguise keine gültige TLS-Verbindung zum übersetzten Hostnamen herstellen konnte.
Prüfen Sie, ob für den Hostnamen ein gültiges, nicht abgelaufenes SSL-Zertifikat existiert, das exakt mit dem Hostnamen übereinstimmt. Vergewissern Sie sich außerdem, dass die Zertifikatskette vollständig ist und HTTPS auf Port 443 verfügbar ist.
Wenn Sie ein CDN, einen Reverse-Proxy oder eine WAF verwenden, überprüfen Sie deren TLS-Konfiguration und stellen Sie sicher, dass diese die Verbindung nicht blockiert. Führen Sie nach der Korrektur der Konfiguration die Setup-Prüfung erneut aus.
SSL/TLS-Fehler der Originalwebsite
Dieser Fehler bedeutet, dass Linguise keine gültige HTTPS-Verbindung zur ursprünglichen Website herstellen konnte.
Prüfen Sie das Ursprungszertifikat auf Ablaufdatum, Hostnamenkonflikt, unvollständige Zertifikatskette oder andere TLS-Konfigurationsprobleme. Wenn Ihre Website ein CDN oder einen Reverse-Proxy verwendet, stellen Sie außerdem sicher, dass für die Ursprungsverbindung das korrekte Zertifikat verwendet wird. Korrigieren Sie das Zertifikat oder die TLS-Konfiguration und führen Sie die Einrichtungsprüfung erneut aus.
Fehler auf der Ursprungswebsite
Ursprungsfehler treten auf, wenn Linguise die ursprüngliche Website nicht ordnungsgemäß erreichen kann oder keine brauchbare Antwort von ihr erhält.
Fehler beim Ursprungsziel
Dieser Fehler bedeutet, dass die konfigurierte Ursprungsdomain auf ein Linguise erreichbares Ziel verweist. Stellen Sie sicher, dass die Domain auf ein öffentlich erreichbares Ziel verweist.
Wenn der Ursprung eine private, Loopback- oder Link-Local-Adresse verwendet, aktualisieren Sie die Ursprungskonfiguration, um ein öffentlich erreichbares Ziel zu verwenden, und führen Sie dann die Setup-Prüfung erneut aus.
Ursprungs-HTTP-Fehler
Dieser Fehler bedeutet, dass Linguise zwar die Originalwebsite erreichen kann, aber eine HTTP-Antwort erhält, die eine zuverlässige Übersetzung verhindern kann.
Häufige Ursachen sind Zeitüberschreitungen bei Anfragen, Authentifizierungsanforderungen, Ratenbegrenzung, Weiterleitungen oder Serverfehler. Überprüfen Sie die Ursprungswebsite direkt und kontrollieren Sie Ihre Server-, Firewall-, WAF-, Authentifizierungs- und Ratenbegrenzungskonfiguration.
Stellen Sie sicher, dass die ursprüngliche Website eine gültige Antwort auf Anfragen von Linguisezurückgeben kann, und führen Sie dann die Einrichtungsprüfung erneut aus.
Diagnose- und Laufzeitfehler
Diagnose- und Laufzeitfehler beziehen sich eher auf den Debugger oder dessen Diagnoseprozess und weisen nicht unbedingt auf ein Problem mit der DNS-, TLS- oder Ursprungskonfiguration hin.
CORE_CHECKER_FAILED
Dieser Fehler bedeutet, dass die Systemdiagnose nicht erfolgreich abgeschlossen werden konnte. Wiederholen Sie die Systemprüfung und prüfen Sie gegebenenfalls die Diagnosedetails. Tritt der Fehler weiterhin auf, prüfen Sie, ob Konfigurations- oder Verbindungsprobleme den Diagnoseprozess beeinträchtigen.
DIAGNOSTIC_CONFIG_CHANGED
Dieser Fehler bedeutet, dass sich die Diagnosekonfiguration während der Prüfung geändert hat. Das Ergebnis ist daher möglicherweise nicht mehr gültig. Führen Sie die Diagnose mit der aktuellen Konfiguration erneut aus, um sicherzustellen, dass die Prüfung die neuesten Einstellungen verwendet.
DIAGNOSEFRIST ÜBERSCHRITTEN
Dieser Fehler bedeutet, dass die Diagnose nicht innerhalb der vorgegebenen Zeit abgeschlossen wurde. Wiederholen Sie die Setup-Prüfung und überprüfen Sie die Diagnosedetails, um festzustellen, ob die Prüfung durch die aktuelle Konfiguration oder die Verbindung verzögert wird.
DIAGNOSTIC_DOMAIN_NOT_FOUND
Dieser Fehler bedeutet, dass die Diagnose die konfigurierte Domäne nicht finden oder auflösen konnte. Überprüfen Sie, ob die Domäne korrekt konfiguriert ist und ihre DNS-Einträge öffentlich verfügbar sind. Führen Sie die Setup-Prüfung erneut aus, nachdem Sie etwaige DNS- oder Domänenkonfigurationsprobleme behoben haben.
DIAGNOSTIC_INVALID_REQUEST
Dieser Fehler bedeutet, dass die Diagnoseanfrage aufgrund einer ungültigen Anfrage nicht verarbeitet werden konnte. Wiederholen Sie die Setup-Prüfung und stellen Sie sicher, dass die Diagnose mit der aktuellen Konfiguration und gültigen Anfragedetails ausgeführt wird.
DIAGNOSE_PROBE_FEHLGESCHLAGEN
Dieser Fehler bedeutet, dass eine einzelne Diagnoseprüfung nicht erfolgreich abgeschlossen werden konnte. Versuchen Sie die Diagnose erneut und überprüfen Sie die verfügbaren Details, um festzustellen, welche Prüfung fehlgeschlagen ist und ob das Problem mit der aktuellen Konfiguration oder der Verbindung zusammenhängt.
DIAGNOSE_FEHLGESCHLAGEN
Dieser Fehler bedeutet, dass der Diagnoseprozess kein gültiges Ergebnis geliefert hat. Wiederholen Sie die Setup-Prüfung und überprüfen Sie alle verfügbaren Diagnosedetails, einschließlich des betroffenen Hostnamens, der Anforderungs-ID und des Zeitstempels, um die Ursache zu ermitteln.
Wenn der Fehler nach erneutem Versuch und Überprüfung der entsprechenden Konfiguration weiterhin besteht, übermitteln Sie den Fehlercode und die Details der Diagnoseanfrage an Linguise Support zur weiteren Untersuchung.
Wie lässt sich das Problem lösen?
Bei der Fehlerbehebung nach einem fehlgeschlagenen Setup-Check sollten die Probleme in der durch die Diagnoseergebnisse angegebenen Reihenfolge behoben werden:
- Domaininhaberschaft und DNS: Stellen Sie sicher, dass die erforderlichen TXT-, CNAME- und A/AAAA-Einträge korrekt konfiguriert und öffentlich auflösbar sind.
- SSL/TLS: Überprüfen Sie die entsprechenden Zertifikate, die Hostnamenkonfiguration, die Zertifikatskette und die HTTPS-Verfügbarkeit.
- Ursprung: Stellen Sie sicher, dass die ursprüngliche Website öffentlich erreichbar ist und dass deren Server-, Firewall-, WAF-, Authentifizierungs- und Ratenbegrenzungskonfiguration Linguise den Zugriff darauf ermöglicht.
- Führen Sie Check setup erneut aus: Nachdem Sie die notwendigen Korrekturen vorgenommen und genügend Zeit für die Verbreitung der DNS-Änderungen eingeplant haben, führen Sie Check setup erneut aus.
Durch die Behebung eines zuvor aufgetretenen DNS- oder Verbindungsfehlers können auch abhängige TLS- oder Ursprungsfehler sowie Prüfungen, die zuvor als übersprungen markiert wurden, behoben werden.
Der Subdomain-Übersetzungs-Debugger erleichtert die Identifizierung und Behebung von DNS-, SSL/TLS- und Ursprungsproblemen, die übersetzte Subdomains betreffen. Überprüfen Sie den gemeldeten Fehler, wenden Sie die empfohlene Lösung an und führen Sie die Konfigurationsprüfung erneut aus, um sicherzustellen, dass Ihre Einrichtung korrekt funktioniert.
Sollte das Problem nach Durchführung der empfohlenen Schritte zur Fehlerbehebung weiterhin bestehen, wenden Sie sich bitte an Linguise Support, um weitere Unterstützung zu erhalten.
