Wie man einen einfachen HTTP-Webserver mit PowerShell betreibt

Wie man einen einfachen Webserver mit PowerShell unter Windows ausführt

Einen einfachen Webserver unter Windows zu betreiben ist zwar nichts Neues, aber überraschend praktisch, wenn man nur eine statische Seite bereitstellen oder Webanwendungen testen möchte, ohne IIS oder andere umfangreiche Tools installieren zu müssen. Oftmals scheitern Entwickler an komplexen Serverkonfigurationen, doch PowerShell + HttpListener erledigt die Aufgabe recht elegant, insbesondere für Tests oder Automatisierung. Wichtig: Es ist nicht für den Produktiveinsatz gedacht, sondern eher eine lokale, temporäre Testumgebung. Bei korrekter Einrichtung können Sie Ihre HTML-Seite unter `http://localhost:9090` oder der IP-Adresse Ihres Netzwerks aufrufen und den Inhalt anzeigen. Ideal für schnelle Tests oder einfache Entwicklungsarbeiten. Da jedoch Port-Einstellungen und Firewall-Regeln verwendet werden, sind unter Umständen einige Anpassungen erforderlich. Um den Server dauerhaft zu betreiben, muss außerdem eine Schleife eingerichtet werden, was beim ersten Mal etwas knifflig sein kann. Hat man es aber einmal verstanden, ist es sehr flexibel: Sie können statische Dateien bereitstellen, einfache APIs implementieren oder einfach das Verhalten von Webclients testen. Nun zum Wesentlichen.

So reparieren oder richten Sie einen PowerShell-Webserver unter Windows ein

Stellen Sie sicher, dass der Port frei ist und Ihre Firewall korrekt konfiguriert ist.

Prüfen Sie zunächst, ob Port 9090 (oder der gewünschte Port) bereits belegt ist. Die aktuell belegten Prozesse können Sie mit folgendem Befehl anzeigen: netstat -na | findstr 9090 [ Get-NetTCPConnection -State Listen | Select-Object LocalAddress, LocalPort | Where-Object {$_. LocalPort -eq 9090} Befehl einfügen].Ist der Port belegt, beenden Sie den entsprechenden Prozess oder wählen Sie einen anderen Port. Windows nutzt Ports manchmal problemlos, manchmal werden sie jedoch blockiert oder von anderen Anwendungen belegt. Beachten Sie, dass die Windows Defender Firewall eingehende Verbindungen blockiert. Um den Port schnell zu öffnen, New-NetFirewallRule -DisplayName "AllowTestWebServer" -Direction Inbound -Protocol TCP -LocalPort 9090 -Action Allow führen Sie folgenden Befehl in PowerShell mit Administratorrechten aus. Dadurch wird der Port (falls erforderlich) für externe Clients zugänglich.

Richten Sie Ihren HTML-Inhalt ein

Erstellen Sie Ihre Webseite als einfache HTML-Datei, z. B.`C:\PS\testwebpage.html`.Hier ist ein Beispielausschnitt – nur eine einfache Seite zum Testen:

Diese Seite wurde mit PowerShell und dem HttpListener generiert. Ganz einfach, oder?

Speichern Sie die Datei unter einem beliebigen Ort, beispielsweise `C:\PS\testwebpage.html`.Achten Sie darauf, dass sie UTF-8-kodiert ist, um Sonderzeichen zu vermeiden.

Starten Sie den Server einmal – nur eine einzige Anfrage

Öffnen Sie PowerShell als Administrator oder zumindest mit ausreichenden Rechten und geben Sie dann folgendes Skript ein: powershell $httpListener = New-Object System. Net. HttpListener $httpListener. Prefixes. Add(„http://+:9090/“) # Lauscht auf allen Netzwerkschnittstellen $httpListener. Start() $context = $httpListener. GetContext() $context. Response. StatusCode = 200 $context. Response. ContentType = ‚text/html‘ $WebContent = Get-Content -Path „C:\PS\testwebpage.html“ -Encoding UTF8 $EncodingWebContent = [Text. Encoding]::UTF8. GetBytes($WebContent) $context. Response. OutputStream. Write($EncodingWebContent, 0, $EncodingWebContent. Length) $context. Response. Close() $httpListener. Close() – Was bewirkt dieses Skript? Es wartet auf eine eingehende Verbindung, sendet Ihre Webseite und beendet dann die Verbindung. Nur ein Test, oder? Wenn Sie `http://localhost:9090` oder die IP-Adresse Ihres Rechners mit Port 9090 aufrufen, sollte Ihre Seite erscheinen. In seltenen Fällen kann es vorkommen, dass Ihre Anfrage nicht sofort registriert wird; ein Aktualisieren der Seite oder eine Überprüfung der Portregeln kann Abhilfe schaffen.

Richten Sie einen permanenten Server ein (der dauerhaft lauscht).

Für einen kontinuierlicheren Betrieb sollte der Code in eine Schleife eingeschlossen werden, etwa so: `powershell Write-Host „Drücken Sie eine beliebige Taste, um den Server zu stoppen…“ while (!$Host. UI. RawUI. KeyAvailable) { $context = $httpListener. GetContext() $context. Response. StatusCode = 200 $context. Response. ContentType = ‚text/html‘ $WebContent = Get-Content -Path „C:\PS\testwebpage.html“ -Encoding UTF8 $EncodingWebContent = [Text. Encoding]::UTF8. GetBytes($WebContent) $context. Response. OutputStream. Write($EncodingWebContent, 0, $EncodingWebContent. Length) $context. Response. Close() } $httpListener. Close()` – Der Server läuft nun so lange, bis Sie in PowerShell eine beliebige Taste drücken. Praktisch für schnelle lokale Tests.

Zusätzliche Tipps

Wenn Ihr Server mehrere Anfragen ohne Neustart bearbeiten muss, ist die Skriptprogrammierung der Schleife unerlässlich. Der Server läuft in der aktuellen PowerShell-Sitzung; das Schließen des Fensters beendet ihn. Sie können ihn als geplante Aufgabe oder mithilfe eines Skripts dauerhaft ausführen – beachten Sie jedoch, dass es sich um eine sehr einfache Lösung handelt: keine Sicherheitsfunktionen, keine Protokollierung. Benötigen Sie HTTPS oder eine andere Authentifizierungsmethode? Dann wird es komplexer, aber für lokale Tests reicht die einfache HTTP-Konfiguration aus.

Wie bei allem, was mit Netzwerken und Windows-Ports zu tun hat, ist ein wenig Ausprobieren nötig. Rechnen Sie mit einigen Versuchen, insbesondere bei Firewall-Regeln, und stellen Sie sicher, dass der Port nicht anderweitig blockiert ist.