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.