Dokumentation

Installation und erste Schritte

ServerBouncer kommt als MSI. Interaktiv ist es in wenigen Minuten eingerichtet; für viele Server gibt es die stille Installation.

Interaktive Installation

ServerBouncer-<version>.msi per Doppelklick installieren. Der Dienst startet im Lernmodus (7 Tage): Sperren werden nur simuliert. Die Web-UI ist nur lokal unter https://localhost:8443 erreichbar.

Stille Installation (GPO, Intune, RMM)

Öffentliche MSI-Properties:

PropertyStandardBedeutung
WEBUI_PORT8443Port der lokalen Web-UI und API
LEARNING_MODE11 = Lernmodus (Sperren nur simuliert), 0 = sofort scharf
CONFIGFILE–Pfad zu einer fertigen serverbouncer.json; wird als erste Konfiguration übernommen (WEBUI_PORT/LEARNING_MODE werden dann ignoriert)
WHITELIST–Mit ; getrennt: IP-Adressen, CIDR-Bereiche oder Hostnamen. Wird beim ersten Start einmalig übernommen
DESKTOP_SHORTCUT10 = keine Desktop-Verknüpfung

Die Properties wirken nur bei der Erstinstallation: Eine vorhandene %ProgramData%\ServerBouncer\serverbouncer.json wird nie überschrieben, Updates behalten die Konfiguration.

:: Standard, ohne Rückfragen, mit Protokoll
msiexec /i ServerBouncer-1.0.0.msi /qn /l*v "%TEMP%\serverbouncer-install.log"

:: Anderer Port, Lernmodus aus, Verwaltungsnetze auf die Whitelist
msiexec /i ServerBouncer-1.0.0.msi /qn WEBUI_PORT=9443 LEARNING_MODE=0 WHITELIST="10.0.0.0/8;192.168.10.0/24;jump.example.local"

:: Vorbereitete Konfiguration
msiexec /i ServerBouncer-1.0.0.msi /qn CONFIGFILE="\\fileserver\deploy\serverbouncer.json" WHITELIST="10.0.0.0/8"

:: Ohne Desktop-Verknüpfung
msiexec /i ServerBouncer-1.0.0.msi /qn DESKTOP_SHORTCUT=0

Exit-Codes von msiexec: 0 Erfolg, 3010 Erfolg mit Neustart erforderlich, 1603 Fehler (Protokoll prüfen).

Erste Schritte

  1. Web-UI öffnen: https://localhost:8443 auf dem Server. Als lokaler Administrator brauchen Sie dort kein Konto.
  2. Whitelist prüfen: Verwaltungsnetze und Jump-Hosts eintragen, damit Sie sich nie selbst aussperren.
  3. Profile aktivieren: RDP, SMB und Kerberos sind die Basis; weitere Profile für IIS, Exchange, SQL Server usw. nach Bedarf.
  4. Härtung ansehen: Die Härtungsseite zeigt die wichtigsten Befunde und drei Ein-Klick-Korrekturen.
  5. Lernmodus auswerten: In den ersten Tagen zeigt ServerBouncer, was es gesperrt hätte. Danach den Schutz scharf schalten.
  6. Optional: RDP als geschützten Dienst einrichten und Geräte für sbc knock registrieren.

CLI-Grundlagen

sbc status                         # Zustand des Dienstes
sbc whitelist list                 # Whitelist anzeigen
sbc blocks                         # aktive Sperren
sbc block 203.0.113.7 --minutes 60 # manuell sperren
sbc unblock 203.0.113.7            # Sperre aufheben
sbc config export C:\backup\sb.json
sbc config import C:\backup\sb.json --dry-run
sbc knock server.example.com rdp --minutes 60

Mit sbc config export und import übernehmen Sie Whitelist, manuelle Sperren und Profile auf weitere Server. Geheimnisse wie Datenbank-Verbindungszeichenfolgen sind nicht enthalten.

Deinstallation

msiexec /x ServerBouncer-1.0.0.msi /qn

Die Deinstallation entfernt alle WFP-Filter und Firewall-Regeln von ServerBouncer.

Installationspaket erhalten

Das MSI gibt es derzeit im Rahmen des Early Access.