Leitfaden: Encoding / Charset einer Seite in nginx ändern

Die Zeichencodierung (Encoding/Charset) legt fest, wie Zeichen einer Webseite intern gespeichert und an den Browser übermittelt werden.
Ein falsches Charset kann dazu führen, dass Inhalte im Browser verstümmelt oder unlesbar angezeigt werden - zum Beispiel „ö“ statt „ö“.

Typische Probleme:

• Eine MySQL-Datenbank ist auf Latin-1 (ISO-8859-1) konfiguriert, während die Webseite eigentlich UTF-8 erwartet.
• Unterschiedliche Systeme (z.B. Datenbank, CMS, Webserver) verwenden nicht dasselbe Charset.
• Proxy- oder FastCGI-Server liefern bereits einen Content-Type-Header mit Charset, das nicht passt.

nginx bietet eine einfache Möglichkeit, die Charset-Angabe im HTTP-Header festzulegen oder zu überschreiben.
Wichtig: nginx konvertiert Inhalte nicht automatisch, sondern weist dem Browser lediglich an, welches Charset verwendet werden soll. Wenn der Content in diesem Charset vorliegt, reicht das für die korrekte Darstellung.

Mit der Direktive charset können Sie das gewünschte Charset im HTTP-Header setzen:

# ISO-8859-1 (Latin-1)
charset iso-8859-1;

# UTF-8 (empfohlener Standard)
charset utf-8;

Die Direktive kann in folgenden Blöcken verwendet werden:

• http {} (global)
• server {} (für eine bestimmte Domain)
• location {} (für einzelne Verzeichnisse)
• if-Statements innerhalb eines location-Blocks

Wenn Ihre Inhalte in einem anderen Charset vorliegen, können Sie zusätzlich source_charset angeben. Damit führt nginx eine Umwandlung in das Ziel-Charset durch:

charset utf-8;
source_charset koi8-r;

In diesem Beispiel werden Inhalte von koi8-r nach UTF-8 konvertiert.

Manchmal liefern Proxy- oder FastCGI-Backends bereits einen Content-Type-Header mit Charset. Falls dieser nicht korrekt ist, können Sie ihn mit override_charset überschreiben:

charset utf-8;
source_charset koi8-r;
override_charset on;

Wie immer nach einer Konfigurationsänderung nginx neu laden:

/etc/init.d/nginx reload

oder

systemctl reload nginx

Mit nur wenigen Direktiven können Sie in nginx sicherstellen, dass Ihre Webseiten mit dem richtigen Charset ausgeliefert werden:

• charset -> setzt die Kodierung im HTTP-Header
• source_charset -> konvertiert Inhalte von einem Quell-Charset in das gewünschte Ziel-Charset
• override_charset -> überschreibt falsche Header von Backend-Systemen

So stellen Sie sicher, dass Besucher Ihre Inhalte ohne Zeichensalat angezeigt bekommen

Geschafft! Mit diesen Einstellungen stellen Sie sicher, dass Ihre Webseiten immer im richtigen Charset ausgeliefert werden und Ihre Besucher keine Probleme mehr mit unlesbaren Sonderzeichen haben.

Noch mehr Anleitungen ▶