Files

T

hkoeck 4da7890119 Vereinheitliche Stack-Steuerung auf scripts/lab.sh

Eine einzige Quelle der Wahrheit fuer alle Stack-Aktionen statt
doppelt gepflegter Verb-Tabellen in Makefile und PowerShell-Wrapper.

- scripts/lab.sh: zentraler Dispatcher (bootstrap/up/redeploy/
  proxy-reload/down/logs/reset/reset-hard/reset-origin)
- workshop.ps1: switch-Tabelle kollabiert zu Delegation an lab.sh
  (kein --remove-orphans-Drift mehr zwischen den Oberflaechen)
- Makefile entfernt: WSL/Ubuntu bringt make nicht standardmaessig
  mit, Doku-Verben (make X) passten nicht zur PowerShell-Mehrheit
- bootstrap.sh: Logik inline, redundante bootstrap-unix.sh und
  bootstrap-wsl.sh entfernt
- Doku/HTML: alle 32 "make X" -> "./scripts/lab.sh X", Prosa
  (macOS-make-Hinweis, PowerShell-Wrapper-Text) angepasst

Verifiziert: bootstrap -> proxy-reload -> redeploy -> reset laufen
end-to-end gegen den Stack, Basisrouten und Done-Checks gruen.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-05-31 22:30:16 +02:00

3.7 KiB

Raw Blame History

HTL Workshop - Reverse Proxy & TLS Lab

Dieses Repo ist ein leichtes HTTP-Basissetup fuer einen Workshop mit Fokus auf:

Reverse Proxy Grundlagen (Nginx)
Routing auf mehrere Backends
TLS/HTTPS manuell umsetzen (z. B. Easy-RSA)
Security-Hardening im Proxy

Die Aufgaben sind absichtlich auf manuelle Konfiguration ausgelegt, nicht auf App-Entwicklung.

Architektur

reverse-proxy (Nginx, Port 8080)
backend-a (einfaches statisches Backend)
backend-b (einfaches statisches Backend)

Basisrouten nach dem Start:

http://localhost:8080/ -> Startseite
http://localhost:8080/service/a -> Backend A via Proxy
http://localhost:8080/service/b -> Backend B via Proxy

WebUI Struktur

http://localhost:8080/ -> Ueberblick + Navigation
http://localhost:8080/challenges.html -> Detaillierte Challenges
http://localhost:8080/hints.html -> Hint Cheatsheet
http://localhost:8080/solutions.html -> Musterloesungen

Voraussetzungen (Linux / macOS / Windows WSL)

Docker + Compose (docker compose oder docker-compose)
Optional fuer TLS-Challenges: easy-rsa, openssl, wireshark

Plattformhinweise:

Linux: Docker Engine oder Docker Desktop
macOS: Docker Desktop
Windows: Docker Desktop + WSL Integration aktiv

Schnellstart

Linux / macOS

./scripts/bootstrap.sh

Windows (WSL)

Option A (im WSL-Terminal):

./scripts/bootstrap.sh

Option B (PowerShell Wrapper):

./scripts/workshop.ps1 -Action bootstrap

Der PowerShell-Wrapper ruft intern ./scripts/lab.sh in WSL auf - die gleiche Steuer-Oberflaeche wie unter Linux/WSL.

Falls PowerShell das Script blockiert:

Set-ExecutionPolicy -Scope Process Bypass

Weitere Aktionen in PowerShell:

./scripts/workshop.ps1 -Action redeploy
./scripts/workshop.ps1 -Action proxy-reload
./scripts/workshop.ps1 -Action reset
./scripts/workshop.ps1 -Action reset-hard
./scripts/workshop.ps1 -Action reset-origin

Wenn mehrere Distros installiert sind:

./scripts/workshop.ps1 -Action bootstrap -Distro Ubuntu-24.04

Das Skript:

prueft Docker + Compose
erstellt .env aus .env.example (falls nicht vorhanden)
startet den Stack

Neu deployen / resetten

Alle Aktionen laufen ueber ./scripts/lab.sh <aktion> (in WSL/Linux). Windows-PowerShell-Nutzer nehmen ./scripts/workshop.ps1 -Action <aktion> - dahinter steckt dasselbe Skript.

./scripts/lab.sh redeploy
./scripts/lab.sh proxy-reload
./scripts/lab.sh reset
./scripts/lab.sh reset-hard
./scripts/lab.sh reset-origin

redeploy: build + restart aller Services
proxy-reload: nur Reverse Proxy restart
reset: Container/Netzwerk/Volumes aufraeumen
reset-hard: wie reset, plus lokale Git-Aenderungen verwerfen (falls Git-Repo)
reset-origin: wie reset-hard, aber bevorzugt Ruecksetzen auf origin/main

Hinweis: redeploy startet zusaetzlich den Reverse Proxy neu, damit Nginx-Config-Aenderungen sicher aktiv sind.

Kurz testen

curl http://localhost:8080/service/a
curl http://localhost:8080/service/b

Windows: Diese und alle weiteren Test-Kommandos (curl, openssl, grep, Schleifen) im WSL-Terminal (bash) ausfuehren, nicht in PowerShell. In PowerShell ist curl ein Alias fuer Invoke-WebRequest und versteht die genutzten Flags (-I, -k, --cacert) nicht. PowerShell nur fuer den Stack-Wrapper scripts/workshop.ps1.

Fokus im Workshop

Die Basis ist bewusst nur HTTP. HTTPS ist Teil der Aufgaben:

CA + Server-Zertifikat selbst erstellen
Nginx auf 443 erweitern
Root-CA importieren
HSTS und TLS-Haertung umsetzen
TLS mitschneiden und analysieren

Vollstaendige TLS-Beispielkonfiguration mit HSTS: proxy/nginx.tls.example.conf.

3.7 KiB Raw Blame History