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:
| Property | Standard | Bedeutung |
|---|---|---|
WEBUI_PORT | 8443 | Port der lokalen Web-UI und API |
LEARNING_MODE | 1 | 1 = 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_SHORTCUT | 1 | 0 = 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
- Web-UI öffnen:
https://localhost:8443auf dem Server. Als lokaler Administrator brauchen Sie dort kein Konto. - Whitelist prüfen: Verwaltungsnetze und Jump-Hosts eintragen, damit Sie sich nie selbst aussperren.
- Profile aktivieren: RDP, SMB und Kerberos sind die Basis; weitere Profile für IIS, Exchange, SQL Server usw. nach Bedarf.
- Härtung ansehen: Die Härtungsseite zeigt die wichtigsten Befunde und drei Ein-Klick-Korrekturen.
- Lernmodus auswerten: In den ersten Tagen zeigt ServerBouncer, was es gesperrt hätte. Danach den Schutz scharf schalten.
- Optional: RDP als geschützten Dienst einrichten und Geräte für
sbc knockregistrieren.
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.