Leitfaden: Automatische Directory-Listings in nginx aktivieren

Automatische Directory-Listings sind eine Funktion, mit der ein Webserver den Inhalt eines Verzeichnisses im Browser anzeigt, wenn keine spezielle Index-Datei wie index.html vorhanden ist. Statt einer Fehlermeldung erhält der Besucher also eine automatisch generierte Übersicht mit den darin enthaltenen Dateien und Unterordnern.

Typische Einsatzszenarien:

• Bereitstellen von Download-Servern (z.B. für Software, Backups, Dokumentationen)
• Interne Entwicklungsumgebungen, um Dateien schnell zugänglich zu machen
• Freigabe von Logfiles oder Daten ohne eigene Benutzeroberfläche

Wichtig: Directory-Listings eignen sich eher für kontrollierte Umgebungen, da alle Inhalte eines Verzeichnisses für den Besucher sichtbar sind. Für öffentliche Websites sollte man daher gut überlegen, ob diese Funktion gewünscht oder sicherheitsrelevant ist.

In nginx lässt sich das ganze mit dem Modul HttpAutoindexModule und wenigen Direktiven aktivieren.

Im gewünschten Block (http {}, server {} oder location {}) folgende Direktive einfügen:

location /downloads {
    autoindex on;
}

Standardmäßig zeigt nginx Dateigrößen exakt in Bytes an. Für eine gerundete Ausgabe in KB, MB oder GB:

location /downloads {
    autoindex on;
    autoindex_exact_size off;
}

Das letzte Änderungsdatum einer Datei wird standardmäßig in GMT angezeigt. Für die lokale Zeit:

location /downloads {
    autoindex on;
    autoindex_exact_size off;
    autoindex_localtime on;
}

Nach jeder Anpassung die Konfiguration neu laden:

/etc/init.d/nginx reload

oder je nach System:

systemctl reload nginx

• Directory-Listings funktionieren nicht, wenn eine index-Direktive gesetzt ist und gleichzeitig eine entsprechende Index-Datei im Verzeichnis existiert.
• Beispiel:

location /downloads {
    index index.html;
    autoindex on;
}

• Existiert index.html, wird diese angezeigt - kein Directory-Listing.
• Gibt es keine index.html, greift das Directory-Listing.

Geschafft! Mit diesen Schritten können Sie automatische Directory-Listings in nginx aktivieren und anpassen.

Noch mehr Anleitungen ▶