Good to Know Database

Servergilt für Debian 12 und 13, Pi OS

Wie teste ich eine HTML-Seite lokal mit einem Webserver, ohne etwas zu installieren?

Eine HTML-Seite liegt als Datei auf dem Rechner. Per Doppelklick öffnet sie sich im Browser, aber Schriften laden nicht, fetch() bricht mit einer Fehlermeldung ab und Pfade wie /style.css laufen ins Leere. Wie bekomme ich ohne große Installation einen Webserver, der sich so verhält wie der spätere Server im Netz?

Lösung

Kurz: Im Ordner der Seite python3 -m http.server 8000 starten (oder php -S localhost:8000) und http://localhost:8000/ aufrufen. Für den Zugriff von Handy oder zweitem Rechner im Heimnetz die Adresse des Servers statt localhost nehmen.

Mit Python

Python 3 ist auf Debian, Ubuntu und Raspberry Pi OS schon da. In den Ordner mit der index.html wechseln und den Server starten:

cd ~/meine-seite
python3 -m http.server 8000

Die Seite liegt jetzt unter http://localhost:8000/. Beenden mit Strg + C. Ein anderer Ordner geht mit --directory, ohne vorher hineinzuwechseln:

python3 -m http.server 8000 --directory ~/meine-seite

Mit PHP

Enthält die Seite PHP-Dateien, braucht es den eingebauten PHP-Server. Er liefert auch reines HTML aus:

php -S localhost:8000 -t ~/meine-seite

Fehlt in einem Verzeichnis die Datei, sucht PHP zuerst index.php, dann index.html.

Vom Handy oder zweiten Rechner aufrufen

Der Python-Server lauscht standardmäßig auf allen Netzwerkschnittstellen, ist also im Heimnetz sofort erreichbar. Die Adresse des Rechners zeigt:

hostname -I

Heißt die erste Adresse 192.168.178.50, öffnet das Handy http://192.168.178.50:8000/. Beim PHP-Server geht das nur, wenn er mit 0.0.0.0:8000 statt localhost:8000 gestartet wurde. Läuft auf dem Rechner eine Firewall, muss der Port für das Heimnetz offen sein, bei ufw so:

sudo ufw allow from 192.168.178.0/24 to any port 8000 proto tcp

Dauerhaft mit nginx

Soll die Seite immer erreichbar sein, etwa auf einem Raspberry Pi, ist nginx die schlanke Lösung:

sudo apt install nginx
sudo cp -r ~/meine-seite/. /var/www/html/
sudo nginx -t

Das Paket liefert nach der Installation den Ordner /var/www/html/ aus. Nach Änderungen an der Konfiguration lädt sudo systemctl reload nginx sie neu ein. Die Dateien müssen für den Benutzer www-data lesbar sein.

Nachträge

Warum geht es per Doppelklick nicht?

Eine per Doppelklick geöffnete Seite hat die Adresse file:///…. Browser erlauben dort keine Anfragen mit fetch() oder XMLHttpRequest, ebenso wenig das Nachladen von Webfonts und JavaScript-Modulen, weil jede Datei als eigene Herkunft gilt. Ein Pfad mit führendem Schrägstrich wie /style.css meint zudem die Wurzel des Dateisystems statt den Seitenordner. Über localhost kommt alles vom selben Server und verhält sich wie im Netz.

Der Browser zeigt noch die alte Version

Der Browser hat die Datei zwischengespeichert. Strg + F5 lädt die Seite ohne Cache neu. In den Entwicklerwerkzeugen (F12) hilft auf dem Reiter Netzwerk die Option „Cache deaktivieren“.

Wie sicher ist das?

Beide Server sind zum Testen gedacht, nicht für den Betrieb im Internet. Die Python-Dokumentation warnt, dass http.server nur grundlegende Sicherheitsprüfungen kennt, und PHP nennt den eingebauten Server ausdrücklich nicht für den Produktivbetrieb gedacht. Gibt es in einem Ordner keine index.html, zeigt Python eine Dateiliste an. Deshalb nie im Home-Verzeichnis starten, sondern nur im Ordner der Seite. Soll er nur auf dem eigenen Rechner erreichbar sein, begrenzt --bind 127.0.0.1 ihn darauf.

Der Port ist belegt

Kommt „Address already in use“, läuft auf dem Port schon etwas. Einfach eine andere Nummer nehmen, etwa python3 -m http.server 8080. Wer wissen will, was den Port belegt, findet es mit ss -tlnp | grep 8000.

Quellen