Fehler 153 bei eingebetteten YouTube-Videos: warum er auftritt und wie du ihn behebst
Fehler 153 heißt: Der YouTube-Player weiß nicht, welche Website ihn eingebettet hat, weil der Referer-Header fehlt. Die Lösung für Websites, WebViews und Apps.
Du bettest ein YouTube-Video ein, der Player lädt, und statt des Videos siehst du einen schwarzen Kasten mit „Error 153. Video player configuration error“ (Fehler 153, Konfigurationsfehler des Videoplayers), oft mit einem Link „Auf YouTube ansehen“. Das Video ist in Ordnung, der Einbettungscode auch. Was fehlt, ist die Information, wer es einbettet.
Die Ursache: Der Player weiß nicht, welche Website ihn eingebettet hat
Die Entwicklerbedingungen von YouTube sind eindeutig. Auf der Seite
Required
Minimum Functionality steht, dass alles, was den eingebetteten Player nutzt, einschließlich der IFrame Player API,
sich über den HTTP-Header Referer ausweisen muss. Browser senden ihn normalerweise von selbst; die Seite
bittet darum, keine Einstellungen zu verwenden, die ihn unterdrücken, und empfiehlt die Referrer-Policy
strict-origin-when-cross-origin.
Lädt der Player ohne Referer, oder mit einem, der keine Website erkennen lässt, verweigert er die Wiedergabe
und zeigt Fehler 153. Entwickler, die das debuggt haben, etwa
Simon Willison, sind genau dort
gelandet. Die Seite von Google nennt die Nummer 153 nicht, aber die beschriebene Lösung ist die, mit der der Fehler verschwindet.
Was den Referer auf einer Website entfernt
- Ein
Referrer-Policy-Header mitno-referrerodersame-origin. Manche Frameworks und Sicherheits-Setups setzen ihn standardmäßig; bei Willison war es DjangosSecurityMiddleware, diesame-originsendet. - Ein Meta-Tag im Head der Seite:
<meta name="referrer" content="no-referrer">. - Ein
referrerpolicy-Attribut direkt am iframe, manchmal von einem Einbettungs-Plugin gesetzt. -
noreferreran einem Fenster, das du für den Player öffnest, wovon die YouTube-Seite abrät.
Die Lösung auf einer Website
Sende die Policy, die YouTube empfiehlt, als Header:
Referrer-Policy: strict-origin-when-cross-origin oder als Meta-Tag, wenn du die Header nicht ändern kannst:
<meta name="referrer" content="strict-origin-when-cross-origin">
Prüf danach, dass nichts Spezifischeres sie überschreibt: Entferne ein referrerpolicy-Attribut am iframe
oder setz es auf denselben Wert. Diese Policy sendet anderen Websites nur deinen Origin (zum Beispiel
https://beispiel.de), nie den vollständigen Pfad, du gibst also keine nennenswerte Privatsphäre auf.
Willison stellte außerdem fest, dass der Wechsel auf youtube-nocookie.com nur manchmal half; gelöst hat es
die korrigierte Policy.
Die Lösung in einer App (WebView, Electron, Tauri)
Apps trifft es häufiger, weil ihre Seiten nicht von einer Website kommen. Eine Seite, die aus einer lokalen Datei oder
über ein eigenes Schema geladen wird (file://, app://, tauri://localhost), hat
keinen Web-Origin, den sie senden könnte, also bekommt der Player keinen brauchbaren Referer. Die
YouTube-Seite nennt, was je Plattform zu tun ist:
- Mobile WebView mit lokalem HTML: Setz den Parameter
baseUrl, der denRefererbestimmt. -
SFSafariViewControllerunter iOS: Er kann keinenReferersetzen, nutz stattdessen den Player-Parameterorigin. - Desktop-Apps: Füge den
Refererals HTTP-Header zur Anfrage hinzu, oder konfiguriere die WebView so, dass sie einen sendet.
Eine letzte Option, wenn du die Header der WebView nicht steuern kannst: Leg auf einer echten https-Domain,
die dir gehört, eine kleine Seite ab, die den Player einbettet, und zeig diese Seite in deiner App. Der Player
sieht dann deine Domain als Einbettende.
Wie wir darauf gestoßen sind
Wir entwickeln Webstarted Toolbox, eine Menüleisten-App auf Basis von Tauri, und ihr Widget
Media spielt YouTube-Videos ab. Die Oberfläche läuft auf tauri://localhost, was kein gültiger Web-Origin ist,
also scheiterte ein direkter youtube.com/embed-iframe jedes Mal mit Fehler 153. Gelöst haben wir es mit der
letzten Option: Das Widget zeigt eine kleine Seite auf unserer eigenen https-Domain, die einen korrekten
Referer sendet und den Player einbettet. Das Video selbst kommt weiterhin direkt von Google zu den Zuschauenden;
nur diese kleine Seite läuft über unseren Server.
Wenn du das Video nur ansehen willst
Der Fehler liegt bei der Website oder App, die das Video eingebettet hat, nicht bei dir. Der Link „Auf YouTube ansehen“
spielt es auf youtube.com ab. Eine Ausnahme lohnt den Blick: Eine Browser-Erweiterung oder Datenschutzeinstellung, die den
Referer aus allen Anfragen entfernt, entfernt denselben Header und kann Fehler 153 auch auf korrekt
konfigurierten Websites auslösen.
Quellen
- YouTube API Services: Required Minimum Functionality (Google for Developers, Englisch).
- Error 153 Video player configuration error on YouTube embeds (Simon Willison, Englisch).
- Referrer-Policy (MDN).