4.7 KiB
tmserver-docker
Ein vollständiges Docker-Setup für einen TrackMania Nations Forever-Server – inklusive Web-Verwaltung und Server-Controller:
- TrackMania Dedicated Server – der eigentliche Spielserver für Internet- oder LAN-Betrieb
- XAseco – Server-Controller, der lokale Rekorde, Dedimania-Weltrekorde, Karma/Votes und eine Track-Jukebox direkt im Spielchat verwaltet
- AdminServ – Web-Oberfläche zur komfortablen Verwaltung und Konfiguration des Servers
- RemoteCP – alternative Web-Verwaltungsoberfläche mit eigenem Login- und Benutzersystem
Alle Komponenten laufen in einem einzigen Container und werden über Umgebungsvariablen konfiguriert.
Hinweis: Dieses Projekt ist ein Fork von lduriez/tmserver-docker.
Der Server unterstützt sowohl den Internet-Dedicated-Modus (Standard) als auch den LAN-Dedicated-Modus.
Schnellstart
1. Umgebungsvariablen einrichten
cp .env.example .env
Passe die Werte in der .env-Datei an deine Umgebung an (Passwörter, Masterserver-Account, etc.).
⚠ Sicherheitshinweis: Die
.env.exampleenthält vorgenerierte Beispiel-Passwörter. Diese dienen nur als Platzhalter und sind öffentlich einsehbar! Ändere unbedingt alle Passwörter, bevor du den Server produktiv einsetzt.
2. Server starten
Das fertige Docker Image kann direkt verwendet werden – kein eigener Build nötig:
docker compose up -d
Das Image wird automatisch aus der Container-Registry geladen:
git.techniverse.net/scriptos/trackmania-server:latest
Tipp: Alle verfügbaren Tags findest du in der Container-Registry. Wenn du das Image lieber selbst bauen möchtest, findest du die Anleitung unter Schnellstart – Selbst bauen.
3. Verwaltungsoberflächen öffnen
- AdminServ:
http://<host-ip>/ - RemoteCP:
http://<host-ip>/remotecp/
Hinweis: Für den Internet-Modus müssen
SERVER_LOGINundSERVER_VALIDATION_KEYin der.env-Datei gesetzt sein. Einen Server-Account kannst du auf players.trackmaniaforever.com erstellen. Für den LAN-Modus setzeSERVER_MODE=lan.
Dokumentation
Die vollständige Dokumentation befindet sich im Ordner docs/:
- Schnellstart – Erste Schritte und minimale Konfiguration
- Konfiguration – Persistente Serverkonfiguration (dedicated_cfg.txt)
- Umgebungsvariablen – Alle verfügbaren Umgebungsvariablen
- Server-Modi – LAN- und Internet-Dedicated-Modus
- AdminServ – Einrichtung der Server-Verwaltungsoberfläche
- RemoteCP – Alternative Server-Verwaltungsoberfläche
- XAseco – Server-Controller für Rekorde, Karma und Jukebox
- IP-Watcher – Automatischer Neustart bei IP-Wechsel
- Ports – Freigegebene Ports und deren Verwendung
- Update – Bestehende Installation aktualisieren
Danksagung
Ein herzliches Dankeschön an Thomas – für seine tatkräftige Unterstützung, sein wertvolles Wissen und seine Mitwirkung an diesem Projekt. Ohne ihn wäre dieses Projekt nicht das, was es heute ist!
Spiegelung
Dieses Repository wird von Gitea auf GitHub gespiegelt. Das Master-Repository befindet sich auf Gitea:
- Gitea (Master): git.techniverse.net/scriptos/tmserver-docker
- GitHub (Spiegel): github.com/pscriptos/tmserver-docker
📝 Blog: www.cleveradmin.de
🌐 Webseite: www.patrick-asmus.de
📧 E-Mail: support@techniverse.net