{"id":2632,"date":"2022-02-08T10:30:00","date_gmt":"2022-02-08T09:30:00","guid":{"rendered":"https:\/\/ictknow-how.ch\/blog\/?p=2632"},"modified":"2023-08-18T16:20:54","modified_gmt":"2023-08-18T14:20:54","slug":"nginx-als-windows-version-untauglich","status":"publish","type":"post","link":"https:\/\/ictknow-how.ch\/blog\/2022\/02\/08\/nginx-als-windows-version-untauglich\/","title":{"rendered":"nginx als Windows-Version untauglich"},"content":{"rendered":"\n

Viele kennen nginx<\/a> als zuverl\u00e4ssigen, stabilen und einfach zu installierenden Webserver. Es gibt diese Software nicht nur f\u00fcr Linux, sondern auch f\u00fcr Windows.<\/p>\n\n\n\n

Leider musste ich in eigenen Tests feststellen, dass die Windows-Version f\u00fcr den Betrieb in einem deutschsprachigen Umfeld bei der Verwendung des Befehls autoindex<\/code><\/a> * untauglich ist. <\/p>\n\n\n\n

Der Grund ist einfach:
nginx kann nicht mit Umlauten wie \u00e4\u00f6\u00fc in Pfadnamen umgehen!<\/strong><\/p>\n\n\n\n

* Den Befehl autoindex<\/code> verwendet man, wenn man eine einfache Auflistung des Verzeichnisinhaltes darstellen will<\/em>.<\/p>\n\n\n\n

Update 03.06.2023: <\/strong>
Diese Aussage stimmt seit der nginx-Version v1.24<\/a> nicht mehr!
Details siehe Updates am Schluss dieses Artikels.<\/p>\n\n\n\n

Schritte um das Problem selber festzustellen:<\/strong>
1.)<\/strong> nginx in der Windows-Version von nginx.org<\/a> (nicht nginx.com!) herunterladen, z.B. https:\/\/nginx.org\/download\/nginx-1.21.6.zip<\/a><\/p>\n\n\n\n

2.) <\/strong>Das Archiv in ein beliebiges Verzeichnis auspacken, z.B. \\Downloads\\nginx-1.21.6<\/code><\/p>\n\n\n\n

3.)<\/strong> Eine kleine zus\u00e4tzliche Testverzeichnis-Struktur anlegen, z.B. C:\\Temp\\nginx\\Blaetterwald<\/code> und C:\\Temp\\nginx\\Bl\u00e4tterwald<\/code> (Pfad also einmal mit „ae“ und einmal mit „\u00e4“). Nach Belieben irgendwelche Dateien in diese beiden Pfade kopieren.<\/p>\n\n\n\n

4.)<\/strong> Im ngnix-Verzeichnis das Unterverzeichnis \\conf<\/code> und darin die Datei nginx.conf<\/code> in einem Texteditor \u00f6ffnen<\/p>\n\n\n\n

5.)<\/strong> Folgende sogenannte location<\/code> hinter den bestehenden location<\/code>-Eintr\u00e4gen (im Abschnitt http -> server) hinzuf\u00fcgen (als Windows-User auf die seltsamen Vorw\u00e4rts-Slashes achten!<\/em>) <\/p>\n\n\n\n

location \/Test {
alias C:\/Temp\/nginx\/;
autoindex on;
}<\/code><\/p>\n\n\n\n

6.)<\/strong> nginx starten und im Browser http:\/\/localhost<\/code> aufrufen, die Willkommensmeldung von nginx erscheint, somit l\u00e4uft der Webserver<\/p>\n\n\n\n

7.)<\/strong> Hinter localhost h\u00e4ngt man nun manuell \/Test<\/code> an, es sollte folgendes angezeigt werden:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

8.)<\/strong> Bis hierher funktioniert alles einwandfrei. Klickt man nun auf den esten Eintrag Blaetterwald<\/strong>, erscheint erwartungsgem\u00e4ss entsprechend vorhandener Inhalt, z.B.<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

9.)<\/strong> F\u00fcr den erfolgreichen Aufruf von Blaetterwald<\/strong> findet man im Verzeichnis \\logs<\/code> in der Datei access.log<\/code> folgende Zeile:<\/p>\n\n\n\n

127.0.0.1 – – [08\/Feb\/2022:09:18:56 +0100] „GET \/Test\/ HTTP\/1.1“ 200 394 „http:\/\/localhost\/Test\/Blaetterwald\/“ „Mozilla\/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/98.0.4758.82 Safari\/537.36“<\/p>\n\n\n\n

10.)<\/strong> Aber was passiert, wenn man auf den zweiten Eintrag Bl\u00e4tterwald<\/strong> klickt?<\/p>\n\n\n\n

\"\"<\/a>
Fehlermeldung in nginx, findet man in \\logs\\error.log<\/figcaption><\/figure>\n\n\n\n

11.)<\/strong> F\u00fcr die Fehlermeldung aus Bl\u00e4tterwald<\/strong> findet man im Verzeichnis \\logs<\/code> in der Datei error.log<\/code> folgende Zeile:<\/p>\n\n\n\n

2022\/02\/08 08:48:59 [crit] 15012#15868: *1 GetFileAttributesEx() „C:\/Temp\/nginx\/\/Bl\u00e4tterwald“ failed (1113: F\u00fcr das Unicode-Zeichen ist kein zugeordnetes Zeichen in der Mehrbytecodepage vorhanden<\/strong>), client: 127.0.0.1, server: localhost, request: „GET \/Test\/Bl%E4tterwald\/ HTTP\/1.1“, host: „localhost“, referrer: „http:\/\/localhost\/Test\/“<\/p>\n\n\n\n

In der Windows-Version gibt es anscheinend keine korrekte Umsetzung f\u00fcr Umlaute oder sonstige Sonderzeichen im Zusammenhang mit autoindex<\/code>. Man findet zwar ein paar offizielle Einschr\u00e4nkungen<\/a>, aber nichts weist auf diesen gravierenden Mangel hin.<\/p>\n\n\n\n

Es gibt zudem ein \u00fcber 8 Jahre altes – immer noch offenes – Ticket<\/span> f\u00fcr diesen Mangel:
https:\/\/trac.nginx.org\/nginx\/ticket\/458<\/a>. Dieses Ticket enth\u00e4lt sogar einen Patch. Der wurde aber aus wenig hilfreichen Gr\u00fcnden mit „needs more work“ ignoriert.<\/p>\n\n\n\n

Zusammenfassung:<\/strong>
Der Befehl autoindex<\/code> von nginx kann in der Windows-Version keine Pfade mit Umlauten oder Sonderzeichen anzeigen. Das ist seit 8 Jahren ungel\u00f6st.
Stand 08.02.2022 und nginx-1.21.6.zip.<\/p>\n\n\n\n

—<\/p>\n\n\n\n

Update am 03.06.2023 (17.30 Uhr)<\/strong>:
Ein (anonymer) Kommentarschreiber hat gemeldet, dass die deutschen Umlaute seit der nginx-Version 1.23.4 funktionieren sollen.
Das habe ich eben getestet. Mit durchzogenem Erfolg.
Zwar kann man in der getesteten nginx-Version 1.25.0<\/a> f\u00fcr Windows tats\u00e4chlich neu auch Verzeichnisse mit Umlauten wie \\Bl\u00e4tterwald<\/code> aufrufen. Aber die Umlaute sehen leider immer noch be…scheiden aus, z.B. f\u00fcr eine Test-Datei namens
Wie s\u00e4he mein \u00f6liger Dateiname \u00e4hnlich \u00c4\u00d6\u00dc aus.txt<\/code><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n

Update am 03.06.2023 (17.45 Uhr)<\/strong>:
Folgender Eintrag in der Datei nginx.conf<\/code> scheint endlich die Darstellung so zu zeigen, wie man es als Standard erwarten w\u00fcrde:
Wie oben unter Punkt 4.) und 5.) beschrieben, erg\u00e4nzt man zus\u00e4tzlich unter http<\/code> und server<\/code>
charset UTF-8;<\/code>
(in meiner Standard nginx.conf gibt es eine deaktiverte Zeile #charset koi8-r;<\/code>)<\/p>\n\n\n\n

Beendet man dann die nginx.exe<\/code> im Taskmanager und startet nginx.exe<\/code> neu, dann sieht es endlich wie gew\u00fcnscht aus:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Also kann man als Windows-User festhalten: <\/strong>
Deutsche Umlaute funktionieren nach 9 Jahren nun endlich auch in der Windows-Version!
Der Dank daf\u00fcr geht an Maxim Dounin, der entsprechende Patches<\/a> eingereicht hat.<\/p>\n\n\n\n

Wer genug pingelig ist, damit seine Dateien mit der richtigen lokalen Uhrzeit dargestellt werden (und nicht in UTC), der kann folgende Konfigurations-Einstellung unmittelbar nach dem obigem charset UTF-8 in der nginx.conf<\/code> hinzuf\u00fcgen:
autoindex_localtime on;<\/code><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Nach einem nginx-Neustart wird meine Testdatei so dargestellt:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n
\n \n
\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
\n Rate this post<\/span>\n <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"

Viele kennen nginx als zuverl\u00e4ssigen, stabilen und einfach zu installierenden Webserver. Es gibt diese Software nicht nur f\u00fcr Linux, sondern auch f\u00fcr Windows. Leider musste ich in eigenen Tests feststellen, dass die Windows-Version f\u00fcr den Betrieb in einem deutschsprachigen Umfeld bei der Verwendung des Befehls autoindex * untauglich ist. Der Grund ist einfach:nginx kann nicht … Weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[28],"tags":[220,218,219,144],"class_list":["post-2632","post","type-post","status-publish","format-standard","hentry","category-software","tag-autoindex","tag-nginx","tag-sonderzeichen","tag-umlaute"],"_links":{"self":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts\/2632","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/comments?post=2632"}],"version-history":[{"count":0,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts\/2632\/revisions"}],"wp:attachment":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/media?parent=2632"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/categories?post=2632"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/tags?post=2632"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}