gamesrv.disisto.de
Eine Plattform für Counter-Strike-Server, komplett als Infrastructure as Code: Container-Orchestrierung, eigene Server-Plugins, zentrales Single Sign-on und eine Pipeline, die vom Git-Push bis zum geprüften Deploy alles automatisiert.
Live seit
Herbst 2026
Umfang
Infrastruktur, CI/CD, Plugins, Web-App und Betrieb
Technologien
Die Herausforderung
gamesrv löst eine selbst gebaute Installation auf klassischer Hardware ab, die von 2021 bis 2023 lief. Server, Plugins und ein eigenes PHP-Panel waren dort von Hand eingerichtet, Updates und Fehlersuche entsprechend aufwendig. Ziel war eine Plattform, die mehrere Spiele und Modi parallel betreibt, sich selbst aktualisiert, reproduzierbar aus Git entsteht und nach dem Prinzip der geringsten Rechte arbeitet.
Die Lösung
Alles liegt in einem Git-Repository: Server-Katalog, Compose-Dateien, Spielkonfiguration pro Modus, Dockerfiles, Plugin-Quellcode, Addon-Manifeste mit Prüfsummen, Monitoring-Regeln und Dokumentation. GitLab CI baut daraus die Images, prüft sie und rollt sie aus. Eine Laravel-Anwendung liefert die öffentliche Website und das Dashboard. Hostspezifische Werte stehen in einer Datei pro Host, ein Umzug heißt also: CI auf den neuen Host zeigen lassen und die Daten zurückspielen.
Datenschutz nach DSGVO: Spieler steuern ihre Daten selbst
Datenschutz ist Teil der Architektur, kein Anhang: Spielen geht ganz ohne Konto, gespeichert wird nur das Nötige, und wer ein Konto hat, verwaltet seine Daten selbst, ohne Admin und ohne Anfrage.
Konto selbst löschen
Im Dashboard, ohne Hilfe eines Admins, wahlweise samt aller Statistiken. gamesrv löscht zuerst die eigenen Daten, danach löscht Keycloak das Konto nach erneuter Passwortabfrage sofort. In Matches erscheint die Person als „gelöschter Spieler“, damit die Ergebnisse der anderen erhalten bleiben.
Sichtbarkeit selbst steuern
Getrennte Schalter für Website und Spiel. Wer auf der Website verborgen ist, hat kein öffentliches Profil. Steam-IDs erscheinen nie öffentlich, Profil-URLs nutzen einen Zufallsschlüssel.
Auskunft
Angemeldete Spieler sehen ihre gespeicherten Daten im Dashboard: Statistik, Rang, Spielzeit und Benachrichtigungen. Eine vollständige Kopie gibt es auf Anfrage.
Datensparsamkeit
Keine IP-Adressen der Spieler, nur Steam-ID, Name, Server und Zeiten. Sitzungen und Tagesstatistik 90 Tage, Versandprotokoll 7 Tage, Webserver-Logs etwa 15 Tage. Ohne Konto genügt das Kontaktformular, dann löscht der Betreiber alle Spieldaten einer Steam-ID mit einer Aktion.
Einwilligung
Statistik nur mit Einwilligung: selbst gehostetes Matomo, serverseitig gemessen, ohne Tracking-Skript, jederzeit widerrufbar. E-Mail- und Push-Hinweise sind Opt-in, in jeder Mail gibt es die Abmeldung mit einem Klick (RFC 8058).
Keine Dritten, Hosting in Deutschland
Keine Tracker, keine Werbung, keine CDNs, nur notwendige Cookies. Betrieb auf eigener Hardware in Deutschland. Backups liegen verschlüsselt auf getrennten Servern in Deutschland und höchstens ein Jahr; danach sind gelöschte Daten endgültig weg.
Orchestrierung der Spieleserver
Jeder der 12 öffentlichen Modi und die 2 Match-Server laufen als eigener Container mit eigener Adresse, alle parallel. Welche Server es gibt, steht als Katalog in Git; CI erzeugt daraus die Docker-Compose-Services. Das Dashboard kann keine Server erfinden, es startet und stoppt nur, was Git definiert.
Pro Spiel gibt es ein Image auf gepinnter Debian-Basis. Die großen Spieldateien stecken nicht im Image: Ein Updater-Container pro Spiel holt Valves Updates regelmäßig per SteamCMD in ein gemeinsames Volume, das die Server nur lesend einbinden. Ein neuer Build wird automatisch übernommen, sobald ein Server leer ist. Ein laufendes Match wird nie unterbrochen.
Server auf Abruf starten angemeldete Spieler über die Website; nach 30 Minuten ohne Spieler stoppt ein Idle-Reaper sie wieder. Dauerhafte Server kommen nach einem Neustart des Hosts von selbst zurück, gestaffelt im Minutentakt. Die Web-App bekommt nie vollen Docker-Zugriff: Sie spricht über einen filternden Proxy, der nur Start, Stopp und Neustart von Spieleserver-Containern sowie lesende Abfragen erlaubt.
CI/CD mit Docker-in-Docker
Jeder Build-Job in GitLab CI bekommt einen frischen, wegwerfbaren Docker-in-Docker-Daemon. Images entstehen isoliert und ohne Reste früherer Jobs. Ihr Tag ist ein Hash über alle Eingaben (Dockerfile, Quellen, Addon-Versionen und ein monatliches Salt), deshalb baut eine Pipeline nur neu, was sich geändert hat. Ein monatlicher Lauf baut alles ohne Cache, damit Sicherheitsupdates des Betriebssystems auch ohne Codeänderung ankommen. Abgeleitete Images, etwa das CS2-Match-Image, holen ihr Basis-Image aus der eigenen Registry derselben Pipeline.
Pipeline
- Lint, PHPUnit-Tests und Prüfung der Abhängigkeiten auf bekannte Schwachstellen, die den Deploy blockiert
- Build nur der geänderten Images
- Schwachstellen-Scan der Images mit Trivy (High und Critical)
- Deploy per SSH
- Automatische Prüfung von Sicherheit und Health-Checks nach dem Deploy, bei Fehlern Rollback
Addons von Drittanbietern liegen gespiegelt in der eigenen Package Registry und werden gegen gepinnte SHA-256-Summen geprüft, Builds hängen also nicht an fremden Download-Seiten. Versionen und Image-Digests sind überall gepinnt, „latest“ gibt es nicht. Secrets liegen weder in Git noch in Images; CI liest sie beim Deploy aus einem Secrets-Vault.
Eigene Plugins und Statistik-Pipeline
Für CS:Source sind neun Plugins in SourcePawn auf SourceMod entstanden. Sie haben ältere Community-Plugins schrittweise abgelöst. Alle Plugins, auch Community-Plugins wie GunGame und der Anti-Cheat, werden in CI aus dem Quellcode gebaut; alte Binaries werden nicht übernommen.
gs_statsPunkte, Kills, Headshots, Genauigkeit, Schaden und Trefferzonen, getrennt nach Menschen und Botsgs_damageSchadensberichtgs_botsBot-Verwaltunggs_moneyGeld-Regelngs_serversServer-Wechsel im Spiel (!servers)gs_mapchooserMap-Abstimmung, rtv, nominategs_noticesHinweise und Glückwünschegs_bansSperrengs_adminsAdmin-Rechte
Das Statistik-Plugin zählt nur im Speicher. Alle 30 Sekunden holt das Dashboard über die Remote-Konsole die Zähler seit dem letzten Abruf von jedem belegten Server und setzt sie zurück, so wird nichts doppelt gezählt. PostgreSQL ist die einzige Quelle der Wahrheit. Zurück an die Server gehen die Top 10 und der Rang jedes Spielers, damit !rank und !top im Spiel genau die Zahlen der Website zeigen.
Eine Sperre im Spiel, durch einen Admin oder den Anti-Cheat, landet in einer Warteschlange. Das Dashboard macht daraus eine zentrale Sperre mit Eintrag im Audit-Log und entfernt die Person innerhalb von 30 Sekunden von allen CS:Source- und CS-1.6-Servern. Die Sperre übersteht Neustarts und Deploys. Für den Server-Wechsel erfahren die Server vom Dashboard, welche anderen gerade laufen.
CS2-Matches und Plugin-Check
Matches laufen mit dem Open-Source-Plugin MatchZy auf CounterStrikeSharp (C#/.NET) und Metamod; eigen ist die Anbindung an das Dashboard: Teams, Best of 1/3/5, Messerrunde oder feste Seiten, Map-Veto, automatische Ergebnisse, Statistiken und Demos. Nach jedem CS2-Update oder neuen Match-Image bootet das Dashboard einen Match-Server, prüft über die Remote-Konsole, ob alle drei Addons geladen sind, und speichert das Ergebnis pro Kombination aus Spiel-Build und Image. Schlägt der Check fehl, sind Matches gesperrt und ein Alarm geht raus; nach einem Fix hebt der nächste Check die Sperre selbst auf. Die öffentlichen Server laufen ohne diese Addons, ein Valve-Update kann sie also nicht lahmlegen.
Single Sign-on mit Keycloak
Website und Dashboard melden über OpenID Connect (Authorization Code Flow) am zentralen Keycloak von disisto.de an, mit eigenem Realm und einem Login-Theme im Design der Seite, auf Deutsch und Englisch. Steam ist in Keycloak als Identity Provider eingebunden; die App spricht nur OIDC mit Keycloak, nie direkt mit Steam. Keycloak-Rollen werden in der App zu Berechtigungen, von Superadmin bis zu einzelnen Rechten wie Matches, Spieler oder Server-Steuerung. Wer sich über Steam anmeldet, bekommt nur die Nutzerrolle; Admin-Rollen verlangen Passwort und Einmalcode.
Web-App
Website und Dashboard sind eine Laravel-Anwendung mit PostgreSQL und nginx, zweisprachig mit übersetzten URLs, hreflang und strukturierten Daten. Ein Queue-Worker verarbeitet Map-Uploads im Hintergrund; der Laravel-Scheduler fährt den 30-Sekunden-Takt für Spieler und Statistik, Benachrichtigungen, Matches, den Plugin-Check und den Idle-Reaper. Hinweise „jemand spielt gerade“ gehen per E-Mail oder als Web Push mit VAPID raus, begrenzt auf einen pro Server alle drei Stunden. Für Deploys ohne Ausfall laufen zwei Instanzpaare hinter dem Reverse Proxy und werden nacheinander erneuert; getestet mit rund 300 Anfragen während beider Wechsel und null Fehlern. Eigene Maps liefert ein separater, bandbreitenbegrenzter FastDL-Container aus. Fonts und Assets sind selbst gehostet, die Content Security Policy ist strikt.
Betrieb
Datenbank und Map-Daten werden verschlüsselt außerhalb des Hosts gesichert, mit regelmäßigen automatischen Wiederherstellungstests. Die App liefert Prometheus-Metriken, Alarme decken unter anderem einen fehlgeschlagenen Plugin-Check ab. Ein täglicher Job meldet neue Versionen der Addons. Die Status-Seite läuft auf einem eigenen Server außerhalb des Hosts und misst von außen: Spieleserver, Website, Login und FastDL, mit 90 Tagen Verlauf.
Entwickelt mit Claude Code
Das Projekt ist von Anfang bis Ende mit Claude Code als Entwicklungspartner entstanden, die Entscheidungen lagen bei mir: Architektur und Planung, Dockerfiles und Härtung der Images, die CI-Pipeline, Dashboard und Website samt Tests, die SourcePawn-Plugins, die Keycloak-Anbindung sowie Dokumentation und Runbooks. Auch im Betrieb: Deploys mit Prüfung nach jedem Push, Fehlersuche, etwa als ein CS2-Update die Match-Server abstürzen ließ, und Sicherheitsupdates. Mehrere Claude-Code-Sitzungen mit klar getrennten Zuständigkeiten (Spieleplattform, Host-Infrastruktur, Identität und Secrets, Website) haben sich untereinander abgestimmt. Änderungen, die Spieler oder Daten betreffen, brauchten immer meine ausdrückliche Freigabe.
Was Spieler davon sehen
Eine zweisprachige Website mit Live-Status aller Server, einer Seite pro Server mit Heatmap der Auslastung, einer Rangliste mit Saisons und Filtern, Spielerprofilen mit Trefferzonen-Diagramm, Map-Statistiken, Regeln und FAQ. Angemeldete Spieler steuern ihre Sichtbarkeit in der Rangliste und abonnieren Hinweise, wenn auf einem Server gespielt wird.
Ergebnisse
Seit Herbst 2026 laufen drei Spiele mit zwölf öffentlichen Modi und zwei Match-Servern. Updates von Valve, Sicherheitsupdates und Deploys passieren ohne Handarbeit, die Website wechselt ohne Ausfall, und jede Änderung ist in Git nachvollziehbar. Die Plattform lässt sich aus dem Repository auf einem neuen Host wieder aufbauen.
Galerie
Die Dashboard-Ansichten stammen aus der Entwicklungsinstanz mit Demo-Daten; Namen sind erfunden. In den GitLab-Bildern ist der Gruppenpfad geschwärzt.