30 Commits

Author SHA1 Message Date
22733ce651 Merge pull request 'release-1.3.2' (#18) from release-1.3.2 into master
All checks were successful
Build & Push Docker Image / build-and-push (push) Successful in 51s
Reviewed-on: #18
2026-03-26 22:08:33 +00:00
2382546308 Release: Docker Image Version 1.3.2 gepusht 2026-03-26 23:05:50 +01:00
e89ac156ce fix(ip-watcher): IP-Prüfung bei unveränderter IP im Log ausgeben 2026-03-26 23:03:09 +01:00
32a09ba808 docs: Update-Anleitung hinzugefügt, .env.example um fehlende XAseco-Healthcheck-Variablen ergänzt 2026-03-26 22:59:26 +01:00
931c62eb6b docs: IP-Watcher in Dokumentationsübersicht der README ergänzt 2026-03-26 22:54:39 +01:00
44dde46067 fix: logrotate-Fehler durch unsichere Permissions am logs-Verzeichnis beheben 2026-03-26 22:52:21 +01:00
14c47bbdd7 Merge pull request 'release-1.3.1' (#17) from release-1.3.1 into master
All checks were successful
Build & Push Docker Image / build-and-push (push) Successful in 4m6s
Reviewed-on: #17
2026-03-26 20:27:09 +00:00
5601b1469d Release: Docker Image Version 1.3.1 gepusht 2026-03-26 21:24:26 +01:00
d77961818a ci: Gitea Action für automatischen Docker-Build und Registry-Push hinzugefügt 2026-03-26 21:21:22 +01:00
7bf847d31c feat: IP-Watcher – automatischer Neustart bei IP-Wechsel 2026-03-26 21:09:23 +01:00
7539e18a46 Merge pull request 'feat: Map-Shuffle beim Containerstart (SHUFFLE_MAPLIST) - Variable ergänzt' (#15) from release-1.3.0 into master
Reviewed-on: #15
2026-03-23 22:23:01 +00:00
2c3aaaee23 Merge branch 'master' into release-1.3.0 2026-03-23 22:22:48 +00:00
69bfa07457 feat: Map-Shuffle beim Containerstart (SHUFFLE_MAPLIST) - Variable ergänzt 2026-03-23 23:20:48 +01:00
af44a273fa Merge pull request 'release-1.3.0' (#14) from release-1.3.0 into master
Reviewed-on: #14
2026-03-23 22:12:34 +00:00
e60cc0804c Release: Docker Image Version 1.3.0 gepusht 2026-03-23 23:08:54 +01:00
e453ab6dbd Startup-Zusammenfassung: HOST_IP-Variable entfernt, Platzhalter beibehalten 2026-03-23 23:01:02 +01:00
6cb5f783bf Startup-Zusammenfassung: Servername aus Config lesen, Host-IP ermitteln 2026-03-23 22:55:17 +01:00
4ec60113f7 Fix: Signal-Handler dash-kompatibel (SIGTERM -> TERM) 2026-03-23 22:49:01 +01:00
8b61571ac5 Doku sauber formatiert 2026-03-23 22:33:55 +01:00
d7be0b37ef Startup-Zusammenfassung am Ende des Startscripts hinzugefuegt 2026-03-23 22:28:13 +01:00
7eb2b6ff0b Graceful Shutdown: Signal-Handler für sauberes Herunterfahren aller Dienste 2026-03-23 22:20:05 +01:00
cbb918d6b2 Log-Rotation fuer Apache-, PHP- und XAseco-Logs eingerichtet 2026-03-23 22:14:38 +01:00
7710a032d9 XAseco-Healthcheck: Automatische Überwachung und Neustart bei Absturz 2026-03-23 22:06:58 +01:00
12a8e0f778 feat: Map-Shuffle beim Containerstart (SHUFFLE_MAPLIST) 2026-03-23 21:55:27 +01:00
ca6c0faaa0 fix: TS3-Konfiguration wird bei Update nicht mehr überschrieben 2026-03-23 21:47:22 +01:00
77ac9cc37a Merge pull request 'release-1.2.2' (#13) from release-1.2.2 into master
Reviewed-on: #13
2026-03-23 08:51:05 +00:00
8a3ef5241e Release: Docker Image Version 1.2.2 gepusht 2026-03-23 09:50:21 +01:00
634cd8c0a6 docs(xaseco): umfassende Chat-Befehlsreferenz ergänzt
Bisherige Kurztabelle durch vollständige Befehlsübersicht ersetzt,
gegliedert nach Kategorien: Hilfe, Rekorde, Rankings, Strecken,
Karma/Voting, Kommunikation, Spieleroptionen und Admin-Befehle.
Verweis auf offizielle Dokumentation (docs.xaseco.org) hinzugefügt.
2026-03-23 09:47:52 +01:00
daaace417b fix(security): AdminServ-Konfigurationspasswort durch zufälligen Hash ersetzen 2026-03-23 09:43:28 +01:00
f7d3a9ce83 docs: Doku an Code anpassen, AdminServ-Konfigurationspasswort automatisch absichern 2026-03-23 09:25:48 +01:00
17 changed files with 1378 additions and 47 deletions

View File

@@ -69,12 +69,20 @@ FORCE_MOD_SPEED=
FORCE_MOD_ALPINE=
FORCE_MOD_RALLY=
# --- MatchSettings ---
# --- Spieleinstellungen (MatchSettings) ---
# Steuert, welche MatchSettings-Datei beim Serverstart geladen wird.
# "auto" = die neueste .txt-Datei in data/gamedata/Tracks/MatchSettings/ wird automatisch erkannt.
# Alternativ kann ein expliziter Dateiname angegeben werden (z.B. "turnier_settings.txt").
MATCHSETTINGS_FILE=auto
# Warmup-Dauer für alle Runden (0 = deaktiviert, 1 = eine Runde Warmup)
ALLWARMUPDURATION=0
# Map-Reihenfolge beim Containerstart zufällig mischen (true = aktiviert, false = deaktiviert)
# Bei jedem Start werden die Maps in der aktiven MatchSettings-Datei neu durchgemischt,
# sodass der Server jedes Mal mit einer anderen Map beginnt.
SHUFFLE_MAPLIST=false
# --- Debugging ---
# Setze diesen Wert auf true, um PHP-Fehlermeldungen anzuzeigen. Dies kann bei der Fehlersuche hilfreich sein, sollte aber in einer Produktionsumgebung auf false belassen werden.
PHP_DISPLAY_ERRORS=false
@@ -109,3 +117,15 @@ XASECO_DB_PASSWORD="4KpL8mWnR3xYvBq"
# Dedimania-Nation (3-Zeichen IOC-Code, z.B. DEU, AUT, CHE)
# Server-Login und -Passwort werden automatisch aus SERVER_LOGIN / SERVER_LOGIN_PASSWORD übernommen.
XASECO_DEDIMANIA_NATION=DEU
# XAseco-Healthcheck: Überwacht XAseco und startet es automatisch neu bei Absturz oder Verbindungsverlust.
XASECO_HEALTHCHECK=true
# Prüfintervall des Healthchecks in Sekunden (Standard: 60)
XASECO_HEALTHCHECK_INTERVAL=60
# --- IP-Watcher ---
# Der IP-Watcher überwacht die ausgehende öffentliche IP des Containers und startet tmserver
# automatisch neu, wenn sich die IP ändert damit er sich beim Masterserver neu registriert.
# Intervall in Sekunden, in dem die IP geprüft wird (Standard: 300 = 5 Minuten).
IP_WATCHER_INTERVAL=300

View File

@@ -0,0 +1,41 @@
name: Build & Push Docker Image
# Wird ausgeloest, wenn ein Tag wie "v1.3.0" gepusht wird
on:
push:
tags:
- 'v*'
jobs:
build-and-push:
runs-on: ubuntu-latest
steps:
- name: Checkout Repository
uses: actions/checkout@v4
# "v1.3.0" -> "1.3.0" (fuehrendes "v" entfernen)
- name: Version aus Tag extrahieren
id: version
run: |
VERSION=$(echo "${{ gitea.ref_name }}" | sed 's/^v//')
echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
- name: Bei Gitea Registry einloggen
run: |
echo "${{ secrets.REGISTRY_TOKEN }}" | \
docker login git.techniverse.net \
--username "${{ secrets.REGISTRY_USER }}" \
--password-stdin
- name: Docker Image bauen
run: |
docker build \
-t git.techniverse.net/scriptos/trackmania-server:${{ steps.version.outputs.VERSION }} \
-t git.techniverse.net/scriptos/trackmania-server:latest \
.
- name: Docker Image pushen
run: |
docker push git.techniverse.net/scriptos/trackmania-server:${{ steps.version.outputs.VERSION }}
docker push git.techniverse.net/scriptos/trackmania-server:latest

View File

@@ -15,6 +15,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
php-mysql \
php-curl \
default-mysql-client \
logrotate \
&& rm -rf /var/lib/apt/lists/*
# Apache mod_rewrite aktivieren und AllowOverride fuer .htaccess (RemoteCP-Sicherheit)
@@ -47,12 +48,16 @@ COPY assets/bin/RunTrackmaniaServer.sh /opt/tmserver/
RUN sed -i 's/\r$//' /opt/tmserver/RunTrackmaniaServer.sh \
&& chmod +x /opt/tmserver/RunTrackmaniaServer.sh
COPY assets/bin/XAsecoHealthcheck.sh /opt/tmserver/
RUN sed -i 's/\r$//' /opt/tmserver/XAsecoHealthcheck.sh \
&& chmod +x /opt/tmserver/XAsecoHealthcheck.sh
COPY assets/bin/AdminServ_v2.1.1.zip /var/www/html
RUN unzip /var/www/html/AdminServ_v2.1.1.zip -d /var/www/html \
&& rm -f /var/www/html/AdminServ_v2.1.1.zip \
&& rm -f /var/www/html/index.html \
&& mkdir -p /var/www/html/logs \
&& chmod -R 777 /var/www/html/logs \
&& chmod 755 /var/www/html/logs \
&& chmod 666 /var/www/html/config/adminlevel.cfg.php \
&& chmod 666 /var/www/html/config/servers.cfg.php \
&& chmod 666 /var/www/html/config/adminserv.cfg.php \
@@ -144,6 +149,11 @@ RUN cp -a /opt/tmserver/xaseco /opt/tmserver/default-xaseco
# PHP-Debug-Konfiguration: wird zur Laufzeit vom Startup-Script gesetzt
# (kein Rebuild noetig nur Container neustarten)
# Log-Rotation: logrotate-Konfiguration ins Image kopieren
# Wird zur Laufzeit stuendlich per Background-Loop ausgefuehrt (kein cron noetig).
COPY assets/config/logrotate.conf /etc/logrotate.d/tmserver
RUN chmod 644 /etc/logrotate.d/tmserver
# --- Umgebungsvariablen ---
# Sensible Werte (Passwoerter, Keys) werden NICHT im Image hinterlegt,
# sondern muessen zur Laufzeit uebergeben werden (z.B. via .env-Datei).
@@ -169,6 +179,7 @@ ENV FORCE_CONFIG_UPDATE=false
# Spieleinstellungen (MatchSettings)
ENV ALLWARMUPDURATION=0
ENV SHUFFLE_MAPLIST=false
# Forced Mods (Skins) - URL zu ZIP-Dateien, die beim Start forciert werden
ENV FORCE_MOD_STADIUM=""
@@ -191,6 +202,8 @@ ENV XASECO_DB_HOST=mariadb
ENV XASECO_DB_NAME=xaseco
ENV XASECO_DB_USER=xaseco
ENV XASECO_DEDIMANIA_NATION=DEU
ENV XASECO_HEALTHCHECK=true
ENV XASECO_HEALTHCHECK_INTERVAL=60
# Debugging
ENV PHP_DISPLAY_ERRORS=false
@@ -206,4 +219,8 @@ EXPOSE 2350/udp
EXPOSE 3450/tcp
EXPOSE 80/tcp
# Graceful Shutdown: SIGTERM wird vom Signal-Handler im Startscript abgefangen
# und alle Dienste (XAseco, TM-Server, Apache) sauber heruntergefahren.
STOPSIGNAL SIGTERM
CMD ["/opt/tmserver/RunTrackmaniaServer.sh"]

View File

@@ -6,7 +6,6 @@ Ein vollständiges Docker-Setup für einen **TrackMania Nations Forever**-Server
- **[XAseco](docs/xaseco.md)** Server-Controller, der lokale Rekorde, Dedimania-Weltrekorde, Karma/Votes und eine Track-Jukebox direkt im Spielchat verwaltet
- **[AdminServ](docs/adminserv.md)** Web-Oberfläche zur komfortablen Verwaltung und Konfiguration des Servers
- **[RemoteCP](docs/remotecp.md)** alternative Web-Verwaltungsoberfläche mit eigenem Login- und Benutzersystem
- **[Mods / Skins](docs/remotecp.md#mods--skins)** über 50 vorkonfigurierte Stadium-Skins (gehostet auf [assets.techniverse.net](https://assets.techniverse.net/tm/skins/)), automatisch beim Start forcierbar
Alle Komponenten laufen in einem einzigen Container und werden über Umgebungsvariablen konfiguriert.
@@ -60,11 +59,13 @@ Die vollständige Dokumentation befindet sich im Ordner [`docs/`](docs/README.md
- [AdminServ](docs/adminserv.md) Einrichtung der Server-Verwaltungsoberfläche
- [RemoteCP](docs/remotecp.md) Alternative Server-Verwaltungsoberfläche
- [XAseco](docs/xaseco.md) Server-Controller für Rekorde, Karma und Jukebox
- [IP-Watcher](docs/ip-watcher.md) Automatischer Neustart bei IP-Wechsel
- [Ports](docs/ports.md) Freigegebene Ports und deren Verwendung
- [Update](docs/update.md) Bestehende Installation aktualisieren
## Danksagung
Danke an **Thomas** ([retronerd.at](https://retronerd.at)), dass er mir sein Wissen zur Verfügung gestellt hat und dass er hier im Projekt mitgewirkt hat.
Ein herzliches Dankeschön an **[Thomas](https://retronerd.at)** 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

View File

@@ -39,7 +39,7 @@ DEFAULT_CONTROLPANEL="/opt/tmserver/default-controlpanel"
if [ ! -f "$ADMINSERV_DIR/index.php" ]; then
echo "==> Erster Start erkannt: Kopiere AdminServ-Dateien ins Volume..."
cp -a "$DEFAULT_CONTROLPANEL"/* "$ADMINSERV_DIR/"
chmod -R 777 "$ADMINSERV_DIR/logs/"
chmod 755 "$ADMINSERV_DIR/logs/"
chmod 666 "$ADMINSERV_DIR/config/adminlevel.cfg.php"
chmod 666 "$ADMINSERV_DIR/config/servers.cfg.php"
chmod 666 "$ADMINSERV_DIR/config/adminserv.cfg.php"
@@ -71,6 +71,18 @@ EOPHP
chown www-data:www-data "$ADMINSERV_DIR/config/servers.cfg.php"
echo " AdminServ-Server-Eintrag automatisch konfiguriert (Port: ${XMLRPC_PORT})."
# AdminServ-Konfigurationspasswort automatisch sichern
# OnlineConfig::PASSWORD in adminserv.cfg.php schuetzt die /config-Seite
# (Server hinzufuegen/aendern/loeschen). Da der Server-Eintrag bereits
# automatisch konfiguriert wird, ist kein manueller Zugriff noetig.
# Der Standard-Hash aus dem ZIP wird durch einen zufaelligen ersetzt.
ADMINSERV_CFG="$ADMINSERV_DIR/config/adminserv.cfg.php"
if [ -f "$ADMINSERV_CFG" ]; then
RANDOM_HASH=$(head -c 32 /dev/urandom | md5sum | cut -d' ' -f1)
sed -i "s|const PASSWORD = '[^']*';|const PASSWORD = '${RANDOM_HASH}';|" "$ADMINSERV_CFG"
echo " AdminServ-Konfigurationspasswort automatisch gesichert."
fi
echo " AdminServ-Dateien erfolgreich kopiert."
# ============================================================
@@ -356,10 +368,12 @@ fi
# ============================================================
# XAseco: TeamSpeak3-Plugin Gateway aktualisieren (fuer bestehende Volumes)
# ============================================================
# Das Original-TS3-Gateway ist nicht mehr verfuegbar. Die eigene
# teamspeak3.xml mit dem Ersatz-Gateway wird in das Volume kopiert,
# falls sie fehlt oder noch das alte (nicht mehr erreichbare) Gateway
# referenziert. Gleichzeitig wird das Plugin reaktiviert, falls es
# Das Original-TS3-Gateway ist nicht mehr verfuegbar. Falls die
# teamspeak3.xml fehlt, wird sie aus dem Template kopiert. Falls sie
# bereits existiert (= Nutzer hat eigene TS3-Daten konfiguriert),
# werden NUR die Gateway-URLs (helperURL/logoURL) gezielt aktualisiert.
# Alle anderen Einstellungen (Server, Port, Channel etc.) bleiben
# erhalten. Gleichzeitig wird das Plugin reaktiviert, falls es
# in einer frueheren Version auskommentiert wurde.
# ============================================================
XASECO_DIR_TS3="/opt/tmserver/xaseco"
@@ -367,16 +381,30 @@ TS3_XML="$XASECO_DIR_TS3/teamspeak3.xml"
TS3_DEFAULT="/opt/tmserver/default-xaseco/teamspeak3.xml"
TS3_PLUGINS_XML="$XASECO_DIR_TS3/plugins.xml"
# teamspeak3.xml aktualisieren: Kopieren wenn fehlend oder veraltet
# teamspeak3.xml aktualisieren: Kopieren wenn fehlend, Gateway-URLs gezielt patchen
# WICHTIG: Bei bestehender Datei wird NICHT die gesamte Datei ueberschrieben,
# damit benutzerdefinierte Einstellungen (Server, Port, Channel) erhalten bleiben.
# Nur die Gateway-URLs (helperURL/logoURL) werden aktualisiert, falls sie noch
# auf ein altes, nicht mehr erreichbares Gateway zeigen.
if [ -f "$TS3_DEFAULT" ]; then
if [ ! -f "$TS3_XML" ]; then
echo "==> TeamSpeak3-Gateway: teamspeak3.xml fehlt, kopiere aus Template..."
cp "$TS3_DEFAULT" "$TS3_XML"
echo " teamspeak3.xml erfolgreich kopiert."
elif ! diff -q "$TS3_DEFAULT" "$TS3_XML" > /dev/null 2>&1; then
echo "==> TeamSpeak3-Gateway: teamspeak3.xml wird aktualisiert..."
cp "$TS3_DEFAULT" "$TS3_XML"
echo " teamspeak3.xml erfolgreich aktualisiert."
else
# Gateway-URLs aus dem Template auslesen
NEW_HELPER_URL=$(grep -oP '(?<=<helperURL>).*?(?=</helperURL>)' "$TS3_DEFAULT")
NEW_LOGO_URL=$(grep -oP '(?<=<logoURL>).*?(?=</logoURL>)' "$TS3_DEFAULT")
# Aktuelle URLs aus der bestehenden Datei auslesen
CUR_HELPER_URL=$(grep -oP '(?<=<helperURL>).*?(?=</helperURL>)' "$TS3_XML")
CUR_LOGO_URL=$(grep -oP '(?<=<logoURL>).*?(?=</logoURL>)' "$TS3_XML")
# Nur patchen, wenn sich die Gateway-URLs unterscheiden
if [ "$CUR_HELPER_URL" != "$NEW_HELPER_URL" ] || [ "$CUR_LOGO_URL" != "$NEW_LOGO_URL" ]; then
echo "==> TeamSpeak3-Gateway: Aktualisiere Gateway-URLs (Server-Einstellungen bleiben erhalten)..."
[ -n "$NEW_HELPER_URL" ] && sed -i "s|<helperURL>.*</helperURL>|<helperURL>${NEW_HELPER_URL}</helperURL>|" "$TS3_XML"
[ -n "$NEW_LOGO_URL" ] && sed -i "s|<logoURL>.*</logoURL>|<logoURL>${NEW_LOGO_URL}</logoURL>|" "$TS3_XML"
echo " Gateway-URLs erfolgreich aktualisiert."
fi
fi
fi
@@ -447,6 +475,42 @@ if [ -f "$MODS_SETTINGS_FILE" ] && grep -q 'blacksunonline.com' "$MODS_SETTINGS_
echo " Mods/settings.xml erfolgreich aktualisiert."
fi
# ============================================================
# AdminServ: Konfigurationspasswort absichern (fuer bestehende Volumes)
# ============================================================
# AdminServ wird mit einem oeffentlich bekannten Standard-Hash
# ausgeliefert (0b28a5799a32c687dad2c5183718ceac, aus dem
# AdminServ-GitHub-Repo). Dieser wird durch einen zufaelligen
# MD5-Hash ersetzt, damit die /config-Seite abgesichert ist.
# ============================================================
ADMINSERV_CFG_VOL="/var/www/html/config/adminserv.cfg.php"
if [ -f "$ADMINSERV_CFG_VOL" ] && grep -q "0b28a5799a32c687dad2c5183718ceac" "$ADMINSERV_CFG_VOL"; then
echo "==> SICHERHEIT: AdminServ-Konfigurationspasswort wird ersetzt (Standard-Hash erkannt)..."
RANDOM_HASH=$(head -c 32 /dev/urandom | md5sum | cut -d' ' -f1)
sed -i "s|const PASSWORD = '0b28a5799a32c687dad2c5183718ceac';|const PASSWORD = '${RANDOM_HASH}';|" "$ADMINSERV_CFG_VOL"
echo " Standard-Hash durch zufaelligen Hash ersetzt."
echo " Die /config-Seite ist jetzt abgesichert."
fi
# ============================================================
# AdminServ: Logs-Verzeichnis-Berechtigungen korrigieren (fuer bestehende Volumes)
# ============================================================
# In aelteren Versionen wurde /var/www/html/logs/ mit chmod 777
# (world-writable) angelegt. logrotate verweigert die Rotation von
# Log-Dateien in world-writable Verzeichnissen aus Sicherheitsgruenden.
# Die korrekte Berechtigung ist 755: www-data (Owner) behaelt
# Schreibzugriff, anderen Nutzern wird Write entzogen.
# ============================================================
ADMINSERV_LOGS_DIR="/var/www/html/logs"
if [ -d "$ADMINSERV_LOGS_DIR" ]; then
CURRENT_PERMS=$(stat -c '%a' "$ADMINSERV_LOGS_DIR")
if [ "$CURRENT_PERMS" != "755" ]; then
echo "==> Korrigiere Berechtigungen fuer AdminServ-Logs-Verzeichnis (${CURRENT_PERMS} -> 755)..."
chmod 755 "$ADMINSERV_LOGS_DIR"
echo " Berechtigungen erfolgreich korrigiert."
fi
fi
echo "Starting apache server"
service apache2 start
@@ -698,6 +762,83 @@ fi
echo " Aktive MatchSettings: ${GAME_SETTINGS_PATH}"
# ============================================================
# MatchSettings: Map-Reihenfolge zufaellig mischen
# ============================================================
# Ueber die Umgebungsvariable SHUFFLE_MAPLIST kann gesteuert werden,
# ob die Reihenfolge der Maps in der aktiven MatchSettings-Datei
# beim Containerstart zufaellig durchgemischt wird:
# - "false" (Standard): Reihenfolge bleibt unveraendert.
# - "true": Alle <challenge>-Eintraege werden zufaellig gemischt
# und <startindex> wird auf 0 gesetzt.
# Die originale Datei wird dabei ueberschrieben.
# ============================================================
SHUFFLE_MAPLIST="${SHUFFLE_MAPLIST:-false}"
if [ "$SHUFFLE_MAPLIST" = "true" ]; then
# Vollstaendigen Pfad zur aktiven MatchSettings-Datei bestimmen
ACTIVE_MS_FILE="$GAMEDATA_DIR/Tracks/${GAME_SETTINGS_PATH}"
if [ -f "$ACTIVE_MS_FILE" ]; then
echo "==> Map-Shuffle: Mische Maps in ${GAME_SETTINGS_PATH}..."
php -r '
$file = $argv[1];
$xml = file_get_contents($file);
if ($xml === false) {
echo " FEHLER: Konnte MatchSettings-Datei nicht lesen.\n";
exit(1);
}
// Alle <challenge>...</challenge>-Bloecke extrahieren
if (!preg_match_all("/<challenge>.*?<\/challenge>/s", $xml, $matches)) {
echo " Keine <challenge>-Eintraege gefunden. Shuffle uebersprungen.\n";
exit(0);
}
$challenges = $matches[0];
$count = count($challenges);
echo " $count Maps gefunden. Mische Reihenfolge...\n";
// Zufaellig mischen
shuffle($challenges);
// Alle bestehenden <challenge>-Bloecke aus dem XML entfernen
$xmlClean = preg_replace("/(\s*<challenge>.*?<\/challenge>)+/s", "", $xml, 1);
// Gemischte Challenges vor </playlist> wieder einfuegen
$challengeBlock = "";
foreach ($challenges as $ch) {
$challengeBlock .= "\t" . $ch . "\n";
}
$xmlNew = str_replace("</playlist>", $challengeBlock . "</playlist>", $xmlClean);
// <startindex> auf 0 setzen (damit ab der ersten gemischten Map gestartet wird)
$xmlNew = preg_replace("/<startindex>[^<]*<\/startindex>/", "<startindex>0</startindex>", $xmlNew);
// Datei zurueckschreiben
if (file_put_contents($file, $xmlNew) === false) {
echo " FEHLER: Konnte MatchSettings-Datei nicht schreiben.\n";
exit(1);
}
// Erste 3 Maps anzeigen
echo " Reihenfolge erfolgreich gemischt.\n";
echo " Neue Startreihenfolge (erste 3 Maps):\n";
for ($i = 0; $i < min(3, $count); $i++) {
if (preg_match("/<file>(.*?)<\/file>/", $challenges[$i], $m)) {
echo " " . ($i + 1) . ". " . $m[1] . "\n";
}
}
if ($count > 3) echo " ... und " . ($count - 3) . " weitere Maps\n";
' "$ACTIVE_MS_FILE"
else
echo "==> Map-Shuffle: MatchSettings-Datei nicht gefunden: ${ACTIVE_MS_FILE}"
echo " Shuffle uebersprungen."
fi
else
echo "==> Map-Shuffle: Deaktiviert (SHUFFLE_MAPLIST=false)."
fi
# Bestimme Server-Modus (Standard: internet)
SERVER_MODE="${SERVER_MODE:-internet}"
@@ -778,10 +919,22 @@ if [ "$XMLRPC_READY" = "true" ]; then
cd /opt/tmserver/xaseco
php aseco.php TMN </dev/null >>aseco.log 2>&1 &
XASECO_PID=$!
echo "$XASECO_PID" > /tmp/xaseco.pid
echo " XAseco gestartet (PID: ${XASECO_PID})"
cd /opt/tmserver
# XAseco Healthcheck / Watchdog starten
XASECO_HEALTHCHECK="${XASECO_HEALTHCHECK:-true}"
if [ "$XASECO_HEALTHCHECK" = "true" ] && [ -f "/opt/tmserver/XAsecoHealthcheck.sh" ]; then
echo "==> Starte XAseco-Healthcheck (Watchdog)..."
/opt/tmserver/XAsecoHealthcheck.sh &
HEALTHCHECK_PID=$!
echo " XAseco-Healthcheck gestartet (PID: ${HEALTHCHECK_PID})"
elif [ "$XASECO_HEALTHCHECK" != "true" ]; then
echo "==> XAseco-Healthcheck ist deaktiviert (XASECO_HEALTHCHECK=${XASECO_HEALTHCHECK})."
fi
elif [ "${XASECO_ENABLED:-true}" != "true" ]; then
echo "==> XAseco ist deaktiviert (XASECO_ENABLED=${XASECO_ENABLED})."
echo "==> XAseco ist deaktiviert (XASECO_ENABLED=${XASECO_ENABLED})."
fi
else
echo " WARNUNG: XMLRPC nicht erreichbar - XAseco und Forced Mods wurden NICHT gestartet."
@@ -967,5 +1120,293 @@ elif [ "$XMLRPC_READY" = "true" ]; then
echo "==> Forced Mods: Keine FORCE_MOD_*-Variablen gesetzt. Ueberspringe."
fi
# ============================================================
# Log-Rotation: Hintergrundprozess starten
# ============================================================
# logrotate wird stuendlich ausgefuehrt, um Apache-, PHP- und
# XAseco-Logs groessenbasiert zu rotieren (max. 10 MB pro Datei,
# 5 rotierte Dateien). Da im Container kein cron laeuft, wird
# ein einfacher Background-Loop verwendet.
# ============================================================
echo "==> Starte Log-Rotation (stuendlich, groessenbasiert 10 MB)..."
(
while true; do
sleep 3600
/usr/sbin/logrotate /etc/logrotate.d/tmserver --state /tmp/logrotate.state
done
) &
LOGROTATE_PID=$!
echo " Log-Rotation gestartet (PID: ${LOGROTATE_PID})"
# ============================================================
# Graceful Shutdown: Signal-Handler
# ============================================================
# Faengt TERM/INT ab und beendet alle Dienste sauber in
# der richtigen Reihenfolge:
# 1. XAseco-Healthcheck (verhindert Neustart waehrend Shutdown)
# 2. XAseco (schliesst DB-Connections ordentlich)
# 3. TrackmaniaServer
# 4. Apache (AdminServ/RemoteCP)
# 5. Log-Rotation
# Verhindert Datenbank-Korruption beim Container-Stop.
# ============================================================
graceful_shutdown() {
echo ""
echo "============================================================"
echo "==> Graceful Shutdown eingeleitet (Signal empfangen)..."
echo "============================================================"
# 1. XAseco-Healthcheck beenden (verhindert Neustart waehrend Shutdown)
if [ -n "${HEALTHCHECK_PID:-}" ] && kill -0 "$HEALTHCHECK_PID" 2>/dev/null; then
echo " Beende XAseco-Healthcheck (PID: ${HEALTHCHECK_PID})..."
kill "$HEALTHCHECK_PID" 2>/dev/null
wait "$HEALTHCHECK_PID" 2>/dev/null
echo " XAseco-Healthcheck beendet."
fi
# 2. XAseco beenden (schliesst DB-Connections ordentlich)
XASECO_PID_CURRENT=""
if [ -f "/tmp/xaseco.pid" ]; then
XASECO_PID_CURRENT=$(cat /tmp/xaseco.pid 2>/dev/null)
fi
if [ -n "$XASECO_PID_CURRENT" ] && kill -0 "$XASECO_PID_CURRENT" 2>/dev/null; then
echo " Beende XAseco (PID: ${XASECO_PID_CURRENT})..."
kill "$XASECO_PID_CURRENT" 2>/dev/null
# Warte max. 10 Sekunden auf sauberes Beenden
WAIT_COUNT=0
while kill -0 "$XASECO_PID_CURRENT" 2>/dev/null && [ $WAIT_COUNT -lt 10 ]; do
sleep 1
WAIT_COUNT=$((WAIT_COUNT + 1))
done
if kill -0 "$XASECO_PID_CURRENT" 2>/dev/null; then
echo " XAseco reagiert nicht, sende SIGKILL..."
kill -9 "$XASECO_PID_CURRENT" 2>/dev/null
fi
echo " XAseco beendet."
rm -f /tmp/xaseco.pid
fi
# 3. TrackmaniaServer beenden
if [ -n "${TM_PID:-}" ] && kill -0 "$TM_PID" 2>/dev/null; then
echo " Beende TrackmaniaServer (PID: ${TM_PID})..."
kill "$TM_PID" 2>/dev/null
# Warte max. 10 Sekunden auf sauberes Beenden
WAIT_COUNT=0
while kill -0 "$TM_PID" 2>/dev/null && [ $WAIT_COUNT -lt 10 ]; do
sleep 1
WAIT_COUNT=$((WAIT_COUNT + 1))
done
if kill -0 "$TM_PID" 2>/dev/null; then
echo " TrackmaniaServer reagiert nicht, sende SIGKILL..."
kill -9 "$TM_PID" 2>/dev/null
fi
echo " TrackmaniaServer beendet."
fi
# 4. Apache beenden (AdminServ/RemoteCP)
echo " Beende Apache..."
service apache2 stop 2>/dev/null
echo " Apache beendet."
# 5. Log-Rotation beenden
if [ -n "${LOGROTATE_PID:-}" ] && kill -0 "$LOGROTATE_PID" 2>/dev/null; then
echo " Beende Log-Rotation (PID: ${LOGROTATE_PID})..."
kill "$LOGROTATE_PID" 2>/dev/null
wait "$LOGROTATE_PID" 2>/dev/null
echo " Log-Rotation beendet."
fi
echo "============================================================"
echo "==> Graceful Shutdown abgeschlossen."
echo "============================================================"
exit 0
}
trap graceful_shutdown TERM INT
echo "==> Signal-Handler registriert (TERM/INT -> Graceful Shutdown)"
# ============================================================
# Startup-Zusammenfassung
# ============================================================
# Gibt am Ende des Startprozesses eine uebersichtliche Box mit
# allen wichtigen Server-Informationen aus. Die Box-Breite passt
# sich automatisch an den laengsten Inhalt an.
# Bei bestehenden Installationen ist dieses Feature nach einem
# Image-Update automatisch aktiv (keine manuellen Schritte noetig).
# ============================================================
print_startup_summary() {
_SUMMARY_TMP=$(mktemp /tmp/startup_summary.XXXXXX)
# Map-Anzahl aus aktiver MatchSettings-Datei zaehlen
_ACTIVE_MS_FULL="$GAMEDATA_DIR/Tracks/${GAME_SETTINGS_PATH}"
_MAP_COUNT="0"
if [ -f "$_ACTIVE_MS_FULL" ]; then
_MAP_COUNT=$(grep -c '<challenge>' "$_ACTIVE_MS_FULL" 2>/dev/null)
_MAP_COUNT=${_MAP_COUNT:-0}
fi
# MatchSettings-Dateiname extrahieren
_MS_FILENAME=$(basename "$GAME_SETTINGS_PATH")
# XAseco-Status ermitteln
if [ "${XASECO_ENABLED:-true}" != "true" ]; then
_XASECO_STATUS="Deaktiviert"
elif [ -n "${XASECO_PID:-}" ] && kill -0 "$XASECO_PID" 2>/dev/null; then
_XASECO_STATUS="Aktiv (PID ${XASECO_PID})"
else
_XASECO_STATUS="Nicht gestartet"
fi
# Healthcheck-Status ermitteln
if [ "${XASECO_ENABLED:-true}" != "true" ]; then
_HC_STATUS="—"
elif [ "${XASECO_HEALTHCHECK:-true}" = "true" ] && [ -n "${HEALTHCHECK_PID:-}" ]; then
_HC_STATUS="Aktiv (PID ${HEALTHCHECK_PID})"
elif [ "${XASECO_HEALTHCHECK:-true}" != "true" ]; then
_HC_STATUS="Deaktiviert"
else
_HC_STATUS="Nicht gestartet"
fi
# Forced Mods zaehlen
_MOD_COUNT=0
for _ENV_NAME in FORCE_MOD_STADIUM FORCE_MOD_ISLAND FORCE_MOD_BAY FORCE_MOD_COAST FORCE_MOD_SPEED FORCE_MOD_ALPINE FORCE_MOD_RALLY; do
eval "_MOD_VAL=\${$_ENV_NAME:-}"
[ -n "$_MOD_VAL" ] && _MOD_COUNT=$((_MOD_COUNT + 1))
done
if [ "$_MOD_COUNT" -gt 0 ]; then
_MODS_STATUS="${_MOD_COUNT} Mod(s) aktiv"
else
_MODS_STATUS="Keine"
fi
# Shuffle-Status
if [ "${SHUFFLE_MAPLIST:-false}" = "true" ]; then
_SHUFFLE_STATUS="Aktiviert"
else
_SHUFFLE_STATUS="Deaktiviert"
fi
# Server-Modus-Anzeige
case "${SERVER_MODE:-internet}" in
internet) _MODE_DISPLAY="Internet" ;;
lan) _MODE_DISPLAY="LAN" ;;
*) _MODE_DISPLAY="${SERVER_MODE}" ;;
esac
# PHP-Debug-Status
if [ "${PHP_DISPLAY_ERRORS:-false}" = "true" ]; then
_PHP_DEBUG="Aktiviert"
else
_PHP_DEBUG="Deaktiviert"
fi
# Servername aus dedicated_cfg.txt lesen (nicht aus Env-Variable, da diese
# nach AdminServ-Aenderungen oder manuellen Edits veraltet sein kann)
_SERVER_NAME=""
if [ -f "$CONFIG" ]; then
# Nur <name> innerhalb von <server_options> lesen (nicht aus <authorization_levels>)
_SERVER_NAME=$(php -r '
$cfg = file_get_contents($argv[1]);
if (preg_match("/<server_options>.*?<name>([^<]*)<\/name>/s", $cfg, $m)) {
echo trim($m[1]);
}
' "$CONFIG" 2>/dev/null)
fi
_SERVER_NAME=${_SERVER_NAME:-${SERVER_NAME:-Trackmania Server}}
# Ladder-Modus aus dedicated_cfg.txt lesen
_LADDER_MODE=""
if [ -f "$CONFIG" ]; then
_LADDER_MODE=$(grep -oP '(?<=<ladder_mode>)[^<]+' "$CONFIG" 2>/dev/null | head -1)
fi
_LADDER_MODE=${_LADDER_MODE:-${SERVER_LADDER_MODE:-forced}}
# Max-Players und Max-Spectators aus Config lesen (falls verfuegbar)
_MAX_PLAYERS=""
_MAX_SPECS=""
if [ -f "$CONFIG" ]; then
_MAX_PLAYERS=$(grep -oP '(?<=<max_players>)[^<]+' "$CONFIG" 2>/dev/null | head -1)
_MAX_SPECS=$(grep -oP '(?<=<max_spectators>)[^<]+' "$CONFIG" 2>/dev/null | head -1)
fi
_MAX_PLAYERS=${_MAX_PLAYERS:-${SERVER_MAX_PLAYERS:-32}}
_MAX_SPECS=${_MAX_SPECS:-${SERVER_MAX_SPECTATORS:-32}}
# --- Zeilen in Temp-Datei schreiben ('---' = Trennlinie) ---
cat > "$_SUMMARY_TMP" <<EOSUMMARY
TrackMania Nations Forever - Server gestartet
---
Servername: ${_SERVER_NAME}
Modus: ${_MODE_DISPLAY} (Ladder: ${_LADDER_MODE})
Spieler: max. ${_MAX_PLAYERS} Spieler / ${_MAX_SPECS} Zuschauer
Server-Port: ${SERVER_PORT:-2350} (TCP/UDP) | P2P: ${SERVER_P2P_PORT:-3450} (TCP)
XMLRPC-Port: ${SERVER_XMLRPC_PORT:-5000}
---
MatchSettings: ${_MS_FILENAME}
Maps: ${_MAP_COUNT} Maps geladen
Map-Shuffle: ${_SHUFFLE_STATUS}
---
XAseco: ${_XASECO_STATUS}
Healthcheck: ${_HC_STATUS}
Forced Mods: ${_MODS_STATUS}
---
AdminServ: http://<host-ip>/
RemoteCP: http://<host-ip>/remotecp/
---
Log-Rotation: Aktiv (stuendlich, max. 10 MB)
PHP-Debug: ${_PHP_DEBUG}
TM-Server: PID ${TM_PID}
EOSUMMARY
# --- Maximale Zeilenlaenge ermitteln ---
_MAX_LEN=0
while IFS= read -r _line; do
if [ "$_line" != "---" ]; then
_cur_len=${#_line}
[ "$_cur_len" -gt "$_MAX_LEN" ] && _MAX_LEN=$_cur_len
fi
done < "$_SUMMARY_TMP"
# Box-Breite: Inhalt + je 2 Zeichen Padding (links/rechts)
_BOX_INNER=$((_MAX_LEN + 4))
# --- Horizontale Linie erzeugen ---
_HLINE=""
_i=0
while [ "$_i" -lt "$_BOX_INNER" ]; do
_HLINE="${_HLINE}"
_i=$((_i + 1))
done
# --- Box ausgeben ---
echo ""
printf '╔%s╗\n' "$_HLINE"
_is_title=true
while IFS= read -r _line; do
if [ "$_line" = "---" ]; then
printf '╠%s╣\n' "$_HLINE"
elif [ "$_is_title" = "true" ]; then
# Titelzeile zentriert ausgeben
_title_len=${#_line}
_pad_total=$((_MAX_LEN - _title_len))
_pad_left=$((_pad_total / 2))
_pad_right=$((_pad_total - _pad_left))
printf '║ %*s%s%*s ║\n' "$_pad_left" "" "$_line" "$_pad_right" ""
_is_title=false
else
printf '║ %-*s ║\n' "$_MAX_LEN" "$_line"
fi
done < "$_SUMMARY_TMP"
printf '╚%s╝\n' "$_HLINE"
echo ""
# Aufraeumen
rm -f "$_SUMMARY_TMP"
}
print_startup_summary
# Auf TrackmaniaServer warten (Hauptprozess)
wait $TM_PID

View File

@@ -0,0 +1,33 @@
#!/bin/sh
# Überwacht die ausgehende öffentliche IP des Containers und startet tmserver neu,
# wenn sich die IP ändert, damit er sich mit der neuen IP beim Masterserver registriert.
set -e
apk add --no-cache curl docker-cli > /dev/null 2>&1
set +e
INTERVAL="${IP_WATCHER_INTERVAL:-300}"
LAST_IP=""
echo "[ip-watcher] Gestartet. Prüfintervall: ${INTERVAL}s"
while true; do
CURRENT_IP=$(curl -s --max-time 10 https://api.ipify.org 2>/dev/null)
if [ -z "$CURRENT_IP" ]; then
echo "[ip-watcher] Öffentliche IP konnte nicht ermittelt werden. Neuer Versuch in ${INTERVAL}s."
elif [ "$CURRENT_IP" != "$LAST_IP" ]; then
if [ -n "$LAST_IP" ]; then
echo "[ip-watcher] IP geändert: ${LAST_IP} -> ${CURRENT_IP}. Starte tmserver neu..."
docker restart tmserver
echo "[ip-watcher] tmserver erfolgreich neu gestartet."
else
echo "[ip-watcher] Initiale öffentliche IP: ${CURRENT_IP}"
fi
LAST_IP="$CURRENT_IP"
else
echo "[ip-watcher] IP-Prüfung OK: ${CURRENT_IP} (unverändert). Nächste Prüfung in ${INTERVAL}s."
fi
sleep "$INTERVAL"
done

View File

@@ -0,0 +1,182 @@
#!/bin/sh
# ============================================================
# XAseco Healthcheck / Watchdog
# ============================================================
# Ueberwacht den XAseco-Prozess und startet ihn automatisch
# neu, wenn er abgestuerzt ist oder die Verbindung zum
# TrackmaniaServer verloren hat (kein Overlay mehr sichtbar).
#
# Pruefungen:
# 1) PID-Check: Ist der XAseco-PHP-Prozess noch aktiv?
# 2) XMLRPC-Check: Kann XAseco den TM-Server noch erreichen?
# (Erkennt haengende Prozesse, die das Overlay verloren haben)
#
# Umgebungsvariablen:
# XASECO_HEALTHCHECK - true/false (Standard: true)
# XASECO_HEALTHCHECK_INTERVAL - Pruefintervall in Sekunden (Standard: 60)
# SERVER_XMLRPC_PORT - XMLRPC-Port des TM-Servers (Standard: 5000)
# ============================================================
XASECO_DIR="/opt/tmserver/xaseco"
HEALTHCHECK_INTERVAL="${XASECO_HEALTHCHECK_INTERVAL:-60}"
XMLRPC_PORT="${SERVER_XMLRPC_PORT:-5000}"
XASECO_PID_FILE="/tmp/xaseco.pid"
RESTART_COUNT=0
MAX_CONSECUTIVE_FAILURES=3
FAILURE_COUNT=0
log() {
echo "[XAseco-Healthcheck] $(date '+%Y-%m-%d %H:%M:%S') $1"
}
# ============================================================
# XAseco starten und PID speichern
# ============================================================
start_xaseco() {
cd "$XASECO_DIR"
php aseco.php TMN </dev/null >>aseco.log 2>&1 &
NEW_PID=$!
echo "$NEW_PID" > "$XASECO_PID_FILE"
cd /opt/tmserver
RESTART_COUNT=$((RESTART_COUNT + 1))
FAILURE_COUNT=0
log "XAseco gestartet (PID: ${NEW_PID}, Neustart #${RESTART_COUNT})"
}
# ============================================================
# Pruefen, ob der XAseco-Prozess noch laeuft
# ============================================================
check_pid() {
if [ ! -f "$XASECO_PID_FILE" ]; then
return 1
fi
CURRENT_PID=$(cat "$XASECO_PID_FILE")
if [ -z "$CURRENT_PID" ]; then
return 1
fi
# Pruefen ob der Prozess existiert und ein PHP-Prozess ist
if kill -0 "$CURRENT_PID" 2>/dev/null; then
return 0
fi
return 1
}
# ============================================================
# XMLRPC-Verbindungscheck: Pruefen, ob der TM-Server noch
# erreichbar ist (erkennt verlorene Verbindungen)
# ============================================================
check_xmlrpc_connection() {
php -r '
$port = (int)$argv[1];
// Testen ob der XMLRPC-Port noch erreichbar ist
$fp = @fsockopen("127.0.0.1", $port, $errno, $errstr, 5);
if (!$fp) { exit(1); }
// Handshake lesen
$data = @fread($fp, 4);
if (strlen($data) < 4) { fclose($fp); exit(1); }
$info = unpack("Vsize", $data);
$handshake = @fread($fp, $info["size"]);
if (strpos($handshake, "GBXRemote") === false) { fclose($fp); exit(1); }
fclose($fp);
exit(0);
' "$XMLRPC_PORT" 2>/dev/null
return $?
}
# ============================================================
# XAseco-Log auf aktuelle Fehler pruefen
# ============================================================
check_xaseco_log() {
LOG_FILE="$XASECO_DIR/aseco.log"
if [ ! -f "$LOG_FILE" ]; then
return 0
fi
# Letzte 20 Zeilen auf fatale Fehler / Verbindungsabbrueche pruefen
LAST_LINES=$(tail -20 "$LOG_FILE" 2>/dev/null)
# Typische Fehlermeldungen bei XAseco-Verbindungsverlust
if echo "$LAST_LINES" | grep -qi "connection refused\|broken pipe\|server not responding\|transport error\|socket error\|fatal error"; then
return 1
fi
return 0
}
# ============================================================
# Hauptschleife: Regelmaeige Ueberwachung
# ============================================================
log "Watchdog gestartet (Intervall: ${HEALTHCHECK_INTERVAL}s, XMLRPC-Port: ${XMLRPC_PORT})"
while true; do
sleep "$HEALTHCHECK_INTERVAL"
# Pruefen ob der TM-Server selbst noch laeuft
if ! check_xmlrpc_connection; then
log "XMLRPC-Port ${XMLRPC_PORT} nicht erreichbar - TM-Server vermutlich beendet. Watchdog stoppt."
break
fi
NEED_RESTART=false
REASON=""
# 1) PID-Check: Prozess noch aktiv?
if ! check_pid; then
NEED_RESTART=true
REASON="Prozess nicht mehr aktiv (PID: $(cat "$XASECO_PID_FILE" 2>/dev/null || echo 'unbekannt'))"
fi
# 2) Log-Check: Fatale Fehler erkannt?
if [ "$NEED_RESTART" = "false" ] && ! check_xaseco_log; then
FAILURE_COUNT=$((FAILURE_COUNT + 1))
log "WARNUNG: Fehler im XAseco-Log erkannt (${FAILURE_COUNT}/${MAX_CONSECUTIVE_FAILURES})"
if [ "$FAILURE_COUNT" -ge "$MAX_CONSECUTIVE_FAILURES" ]; then
NEED_RESTART=true
REASON="Wiederholte Fehler im Log (${FAILURE_COUNT}x)"
fi
else
# Kein Fehler -> Zaehler zuruecksetzen (nur wenn PID OK)
if [ "$NEED_RESTART" = "false" ]; then
FAILURE_COUNT=0
fi
fi
# Neustart durchfuehren
if [ "$NEED_RESTART" = "true" ]; then
log "NEUSTART ERFORDERLICH: ${REASON}"
# Alten Prozess sicherheitshalber beenden
OLD_PID=$(cat "$XASECO_PID_FILE" 2>/dev/null)
if [ -n "$OLD_PID" ] && kill -0 "$OLD_PID" 2>/dev/null; then
log "Beende haengenden Prozess (PID: ${OLD_PID})..."
kill "$OLD_PID" 2>/dev/null
sleep 3
# Falls noch aktiv: SIGKILL
if kill -0 "$OLD_PID" 2>/dev/null; then
kill -9 "$OLD_PID" 2>/dev/null
sleep 1
fi
fi
# Log rotieren (altes Log sichern fuer Debugging)
if [ -f "$XASECO_DIR/aseco.log" ]; then
TIMESTAMP=$(date '+%Y%m%d_%H%M%S')
cp "$XASECO_DIR/aseco.log" "$XASECO_DIR/aseco_crash_${TIMESTAMP}.log"
log "Crash-Log gesichert: aseco_crash_${TIMESTAMP}.log"
# Maximal 5 Crash-Logs aufbewahren
ls -t "$XASECO_DIR"/aseco_crash_*.log 2>/dev/null | tail -n +6 | xargs rm -f 2>/dev/null
fi
# Kurz warten, damit evtl. Ressourcen freigegeben werden
sleep 2
# XAseco neu starten
start_xaseco
log "XAseco erfolgreich neugestartet."
# Nach Neustart etwas laenger warten, damit XAseco sich initialisieren kann
sleep 10
fi
done
log "Watchdog beendet."

View File

@@ -0,0 +1,56 @@
# ============================================================
# Log-Rotation fuer tmserver-docker
# ============================================================
# Wird stuendlich per Background-Loop ausgefuehrt.
# Rotation: groessenbasiert (10 MB), max. 5 rotierte Dateien.
# ============================================================
# Apache Access- und Error-Log
/var/log/apache2/access.log
/var/log/apache2/error.log
{
size 10M
rotate 5
missingok
notifempty
compress
delaycompress
copytruncate
}
# PHP Error-Log
/var/log/php_errors.log
{
size 10M
rotate 5
missingok
notifempty
compress
delaycompress
copytruncate
}
# XAseco-Log (liegt im persistenten Volume)
/opt/tmserver/xaseco/aseco.log
{
size 10M
rotate 5
missingok
notifempty
compress
delaycompress
copytruncate
}
# AdminServ-Logs (liegen im persistenten Volume)
/var/www/html/logs/*.log
{
su www-data www-data
size 10M
rotate 5
missingok
notifempty
compress
delaycompress
copytruncate
}

View File

@@ -1,10 +1,11 @@
services:
tmserver:
image: git.techniverse.net/scriptos/trackmania-server:1.2.1
image: git.techniverse.net/scriptos/trackmania-server:1.3.2
build:
context: .
container_name: tmserver
restart: unless-stopped
stop_grace_period: 30s
depends_on:
mariadb:
condition: service_healthy
@@ -52,6 +53,22 @@ services:
tmserver_net:
ipv4_address: 172.20.60.11
ip-watcher:
image: alpine:3.21
container_name: tmserver-ip-watcher
restart: unless-stopped
depends_on:
- tmserver
command: ["/bin/sh", "/opt/WatchPublicIP.sh"]
env_file:
- .env
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./assets/bin/WatchPublicIP.sh:/opt/WatchPublicIP.sh:ro
networks:
tmserver_net:
ipv4_address: 172.20.60.12
networks:
tmserver_net:
name: tmserver.dockernetwork.local

View File

@@ -9,40 +9,57 @@
| Dokument | Beschreibung |
|----------|-------------|
| [Schnellstart](schnellstart.md) | Erste Schritte und minimale Konfiguration |
| [Konfiguration](konfiguration.md) | Persistente Serverkonfiguration (dedicated_cfg.txt) |
| [Konfiguration](konfiguration.md) | Persistente Serverkonfiguration (dedicated_cfg.txt), Graceful Shutdown |
| [Umgebungsvariablen](umgebungsvariablen.md) | Alle verfügbaren Umgebungsvariablen |
| [Server-Modi](server-modi.md) | LAN- und Internet-Dedicated-Modus |
| [AdminServ](adminserv.md) | Einrichtung der Server-Verwaltungsoberfläche |
| [RemoteCP](remotecp.md) | Alternative Server-Verwaltungsoberfläche (inkl. Mods/Skins) |
| [XAseco](xaseco.md) | Server-Controller für Rekorde, Karma und Jukebox |
| [IP-Watcher](ip-watcher.md) | Automatischer Neustart bei IP-Wechsel |
| [Ports](ports.md) | Freigegebene Ports und deren Verwendung |
| [Update](update.md) | Bestehende Installation aktualisieren |
## Projektstruktur
```
├── assets/
│ ├── bin/ # Binaries und Startscript
│ │ ├── AdminServ_v2.1.1.zip # AdminServ Web-UI
│ │ ├── remoteCP_v4.0.3.5.zip # RemoteCP Web-UI
│ │ ├── xaseco_v1.16.zip # XAseco Server-Controller
│ │ ├── AdminServ_v2.1.1.zip # AdminServ Web-UI
│ │ ├── remoteCP_v4.0.3.5.zip # RemoteCP Web-UI
│ │ ├── RunTrackmaniaServer.sh # Container-Startscript
│ │ ── TrackmaniaServer_*.zip # Trackmania Server Binary
│ │ ── TrackmaniaServer_2011-02-21.zip # Trackmania Server Binary
│ │ ├── WatchPublicIP.sh # IP-Watcher-Script
│ │ └── xaseco_v1.16.zip # XAseco Server-Controller
│ ├── config/
│ │ ├── adminserv/ # AdminServ-Konfiguration
│ │ │ ├── get_matchset_mapimport.php # MatchSet Map-Import Script
│ │ │ └── maps-creatematchset.php # MatchSet-Erstellung Script
│ │ ├── custom_game_settings.txt # MatchSettings (Spielmodus, Map-Rotation)
│ │ ├── dedicated_cfg.txt # Server-Config-Template (mit Platzhaltern)
│ │ ── remotecp/
│ │ └── plugins/
│ │ ── CustomPoints/
│ │ │ └── index.php # CustomPoints-Plugin fuer RemoteCP
│ │ └── Mods/
│ │ └── settings.xml # Skin-Bibliothek (techniverse.net)
│ │ ── logrotate.conf # Log-Rotation-Konfiguration (groessenbasiert)
│ │ ├── remotecp/
│ │ ── plugins/
│ │ ├── CustomPoints/
│ │ └── index.php # CustomPoints-Plugin fuer RemoteCP
│ │ └── Mods/
│ │ │ ├── index.php # Mods-Plugin fuer RemoteCP
│ │ │ └── settings.xml # Skin-Bibliothek (techniverse.net)
│ │ └── xaseco/
│ │ └── teamspeak3.xml # TeamSpeak3-Konfiguration fuer XAseco
│ └── db/
│ └── init-xaseco-db.sh # MariaDB Init-Script fuer XAseco-DB
├── docs/ # Dokumentation
├── .gitea/
│ └── workflows/
│ └── docker-publish.yml # CI/CD: Docker Image Build & Push bei neuem Release-Tag
├── docs/ # Dokumentation (siehe Tabelle oben)
│ └── update.md # Update-Anleitung
├── docker-compose.yml # Docker Compose Konfiguration
├── Dockerfile # Docker Build-Definition
├── .dockerignore # Docker-Ignore-Regeln
├── .env.example # Vorlage fuer Umgebungsvariablen
├── .env # Lokale Umgebungsvariablen (nicht im Git!)
├── .gitattributes # Git-Attribut-Konfiguration
├── .gitignore # Git-Ignore-Regeln
├── LICENSE # Lizenz
├── README.md # Projektbeschreibung
└── data/ # Persistente Daten (zur Laufzeit)

View File

@@ -4,17 +4,19 @@ Die Server-Verwaltungsoberfläche basiert auf [AdminServ](https://github.com/Chr
## Einrichtung
1. `http://<host-server-des-containers>` im Browser aufrufen
2. Ein Passwort festlegen dieses wird als AdminServ-Passwort verwendet
3. TM-Server-Informationen eintragen (Standardwerte können beibehalten werden)
4. `Address` auf `localhost` setzen, um den eingebetteten Server zu verwalten
5. Speichern
AdminServ wird beim ersten Container-Start **vollständig automatisch konfiguriert**:
- Serververbindung (Adresse `127.0.0.1`, XML-RPC-Port)
- Server-Eintrag (Name, DisplayServ-Passwort)
- Konfigurationspasswort (siehe [Konfigurationsseite (`/config`)](#konfigurationsseite-config))
Es ist kein manuelles Setup nötig.
## Verbindung zum Server
1. Über den Button „Servers" zur Serverliste navigieren
2. Den gewünschten Server auswählen
3. Admin-Stufe wählen und zugehöriges Passwort eingeben
1. `http://<host-server-des-containers>` im Browser aufrufen
2. Den Server aus der Liste auswählen
3. Admin-Stufe wählen (SuperAdmin, Admin oder User) und das zugehörige Passwort eingeben
## Standard-Passwörter
@@ -24,9 +26,11 @@ Die Server-Verwaltungsoberfläche basiert auf [AdminServ](https://github.com/Chr
| Admin | `Admin` |
| User | `User` |
Diese Passwörter werden über die `.env`-Datei gesetzt (`SERVER_SA_PASSWORD`, `SERVER_ADM_PASSWORD`, `SERVER_USER_PASSWORD`) und beim ersten Start in die `dedicated_cfg.txt` geschrieben. AdminServ liest die Passwörter über die XML-RPC-Verbindung direkt vom TM-Server.
Die Admin-Stufen können unter `http://<host-server-des-containers>/config` geändert werden.
> **Hinweis:** Es wird empfohlen, die Standard-Passwörter über die `.env`-Datei (`SERVER_SA_PASSWORD`, `SERVER_ADM_PASSWORD`) zu ändern. Siehe [Umgebungsvariablen](umgebungsvariablen.md).
> **Hinweis:** Die Standard-Passwörter in der `.env.example` sind öffentlich einsehbar. Ändere sie unbedingt, bevor du den Server produktiv einsetzt. Siehe [Umgebungsvariablen](umgebungsvariablen.md).
## Persistente Speicherung
@@ -55,6 +59,8 @@ Alternativ können die PHP-Logs eingesehen werden:
docker exec tmserver cat /var/log/php_errors.log
```
> **Hinweis:** Alle Logs (Apache, PHP, AdminServ) werden automatisch per logrotate rotiert (max. 10 MB pro Datei, 5 rotierte Dateien). Siehe [Konfiguration Log-Rotation](konfiguration.md#log-rotation).
### AdminServ komplett zurücksetzen
Falls AdminServ in einen inkonsistenten Zustand geraten ist:
@@ -67,6 +73,16 @@ rm -rf ./data/controlpanel/*
docker compose up -d
```
## Konfigurationsseite (`/config`)
AdminServ bringt unter `http://<host-ip>/config` eine eigene Konfigurationsseite mit, über die Server-Einträge hinzugefügt, geändert oder gelöscht werden können. Diese Seite ist durch ein separates Passwort geschützt (`OnlineConfig::PASSWORD` in `adminserv.cfg.php`, MD5-gehasht).
Da dieser Container als **Standalone-Setup** läuft und ausschließlich den einen lokalen TrackMania-Server bedient, wird die `/config`-Seite **nicht benötigt** der Server-Eintrag wird beim ersten Start automatisch angelegt (Adresse, XML-RPC-Port, Passwörter).
Zur Absicherung wird das Konfigurationspasswort beim ersten Container-Start automatisch durch einen **zufällig generierten MD5-Hash** ersetzt. Damit ist die `/config`-Seite vor unbefugtem Zugriff geschützt, ohne dass ein Benutzer ein Passwort vergeben oder sich merken muss.
> **Hinweis:** Falls du dennoch Zugriff auf die `/config`-Seite benötigst (z.B. für Debugging), kannst du den MD5-Hash in `data/controlpanel/config/adminserv.cfg.php` manuell auf ein bekanntes Passwort setzen. Beispiel: `const PASSWORD = '5f4dcc3b5aa765d61d8327deb882cf99';` entspricht dem Passwort `password`.
## Gepatchte AdminServ-Bugs (TmForever)
AdminServ (v2.1.1) enthält zwei Bugs, die speziell im Zusammenspiel mit TmForever auftreten. Diese werden beim Container-Start automatisch gepatcht auch bei bestehenden Volumes.

36
docs/ip-watcher.md Normal file
View File

@@ -0,0 +1,36 @@
# IP-Watcher
Der IP-Watcher ist ein Service (`tmserver-ip-watcher`), der automatisch die öffentliche IP des Hosts überwacht und den `tmserver`-Container neu startet, sobald sich die IP ändert.
## Hintergrund
Trackmania-Server registrieren sich beim Start mit ihrer aktuellen öffentlichen IP beim Nadeo-Masterserver. Bei dynamischen IP-Adressen kann sich diese IP jederzeit ändern der Server bleibt dann unter der veralteten IP registriert und ist für Spieler nicht mehr erreichbar.
Der IP-Watcher erkennt solche IP-Wechsel automatisch und startet `tmserver` neu, sodass er sich mit der neuen IP beim Masterserver neu registriert.
## Funktion
Der Watcher läuft als eigener Docker-Container und:
1. Prüft regelmäßig die ausgehende öffentliche IP (identisch mit der IP, die auch `tmserver` nach außen verwendet)
2. Erkennt Abweichungen zur zuletzt bekannten IP
3. Startet `tmserver` über den Docker-Socket automatisch neu
## Konfiguration
| Variable | Beschreibung | Standard |
|----------|-------------|----------|
| `IP_WATCHER_INTERVAL` | Prüfintervall in Sekunden | `300` (5 Minuten) |
## Deaktivieren
Um den IP-Watcher zu deaktivieren, kommentiere den `ip-watcher`-Service in der `docker-compose.yml` aus:
```yaml
# ip-watcher:
# ...
```
## Sicherheitshinweis
Der IP-Watcher benötigt Zugriff auf den Docker-Socket (`/var/run/docker.sock`), um den `tmserver`-Container neu starten zu können. Dieser Zugriff ermöglicht volle Kontrolle über alle Docker-Container und -Images auf dem Host. Stelle sicher, dass der Host ausreichend abgesichert ist und der Zugriff auf den Docker-Socket auf vertrauenswürdige Dienste beschränkt bleibt.

View File

@@ -18,6 +18,7 @@ Das gesamte **GameData-Verzeichnis** wird über ein Bind-Mount (`./data/gamedata
|-----------|----------------|-------------|
| `./data/gamedata` | `/opt/tmserver/GameData` | Gesamtes GameData-Verzeichnis |
| `./data/controlpanel` | `/var/www/html` | AdminServ- und RemoteCP-Daten |
| `./data/xaseco` | `/opt/tmserver/xaseco` | XAseco-Konfiguration und Logs |
| `./data/mariadb` | `/var/lib/mysql` | MariaDB-Datenbankdateien |
### Enthaltene Unterordner
@@ -105,6 +106,105 @@ Der Ordner `GameData/Config/` enthält:
| `Default.SystemConfig.Gbx` | System-Konfiguration |
| `AdminServ/ServerOptions/` | Von AdminServ exportierte Server-Einstellungen |
## Graceful Shutdown
Beim Stoppen des Containers (`docker compose stop`, `docker compose down` oder `docker stop`) werden alle Dienste **sauber und in der richtigen Reihenfolge** heruntergefahren:
1. **XAseco-Healthcheck** wird zuerst beendet, damit XAseco nicht während des Shutdowns neu gestartet wird
2. **XAseco** beendet sich ordentlich und schließt alle Datenbank-Connections (verhindert DB-Korruption)
3. **TrackmaniaServer** der Spielserver wird sauber gestoppt
4. **Apache** AdminServ und RemoteCP werden beendet
5. **Log-Rotation** Hintergrundprozess wird gestoppt
Jeder Dienst hat maximal 10 Sekunden Zeit, sich sauber zu beenden. Falls ein Prozess nicht reagiert, wird er zwangsweise beendet (SIGKILL). Die `stop_grace_period` in der `docker-compose.yml` ist auf 30 Sekunden gesetzt, um genügend Zeit für den gesamten Shutdown-Prozess zu geben.
Der Shutdown-Fortschritt wird in der Konsole protokolliert und kann mit `docker logs tmserver` nachvollzogen werden.
> **Hinweis:** Der Graceful Shutdown ist nach einem Image-Update automatisch aktiv auch bei bestehenden Installationen. Es sind keine manuellen Schritte nötig.
## Log-Rotation
Alle Log-Dateien im Container werden automatisch per `logrotate` rotiert, damit sie nicht unbegrenzt wachsen. Die Rotation läuft **größenbasiert** als Hintergrundprozess (stündliche Prüfung, kein Cron nötig).
### Einstellungen
| Parameter | Wert |
|-----------|------|
| Maximale Dateigröße | 10 MB |
| Rotierte Dateien behalten | 5 |
| Komprimierung | Ja (gzip, verzögert) |
| Leere Logs überspringen | Ja |
### Rotierte Log-Dateien
| Log | Pfad im Container | Persistenz |
|-----|--------------------|------------|
| Apache Access | `/var/log/apache2/access.log` | Nur im Container |
| Apache Error | `/var/log/apache2/error.log` | Nur im Container |
| PHP Errors | `/var/log/php_errors.log` | Nur im Container |
| XAseco | `/opt/tmserver/xaseco/aseco.log` | Volume (`./data/xaseco/`) |
| AdminServ | `/var/www/html/logs/*.log` | Volume (`./data/controlpanel/logs/`) |
Rotierte Dateien werden als `*.1` (vorherige), `*.2.gz`, `*.3.gz` usw. aufbewahrt.
### Konfigurationsdatei
Die logrotate-Konfiguration liegt im Image unter `/etc/logrotate.d/tmserver` (Quelle: `assets/config/logrotate.conf`). Sie wird beim Bau des Images fest eingebettet und erfordert keine manuelle Anpassung.
> **Hinweis:** Die Log-Rotation ist nach einem Image-Update automatisch aktiv auch bei bestehenden Installationen. Es sind keine manuellen Schritte nötig.
## Startup-Zusammenfassung
Nach Abschluss des gesamten Startprozesses wird automatisch eine übersichtliche Zusammenfassung aller wichtigen Server-Informationen als formatierte Box in der Konsole ausgegeben. Die Box-Breite passt sich dynamisch an den längsten Inhalt an.
Alle angezeigten Werte (Servername, Spielerzahl, Ladder-Modus etc.) werden direkt aus der `dedicated_cfg.txt` gelesen nicht aus den Umgebungsvariablen. So werden auch nachträgliche Änderungen (z.B. über AdminServ oder manuelles Editieren) korrekt angezeigt.
**Angezeigte Informationen:**
| Bereich | Details | Quelle |
|---------|---------|--------|
| **Server** | Servername, Modus (Internet/LAN), Ladder, Spieler-/Zuschauerlimit | `dedicated_cfg.txt` |
| **Netzwerk** | Server-Port, P2P-Port, XMLRPC-Port | Umgebungsvariablen |
| **Maps** | Aktive MatchSettings-Datei, Anzahl geladener Maps, Shuffle-Status | MatchSettings-XML |
| **Dienste** | XAseco-Status (mit PID), Healthcheck, Forced Mods | Laufzeit-PIDs |
| **Web-Interfaces** | AdminServ- und RemoteCP-URLs | Platzhalter |
| **System** | Log-Rotation, PHP-Debug-Modus, TM-Server-PID | Laufzeit |
**Beispielausgabe:**
```
╔════════════════════════════════════════════════════════════════════╗
║ TrackMania Nations Forever - Server gestartet ║
╠════════════════════════════════════════════════════════════════════╣
║ Servername: Mein Trackmania Server ║
║ Modus: Internet (Ladder: forced) ║
║ Spieler: max. 32 Spieler / 32 Zuschauer ║
║ Server-Port: 2350 (TCP/UDP) | P2P: 3450 (TCP) ║
║ XMLRPC-Port: 5000 ║
╠════════════════════════════════════════════════════════════════════╣
║ MatchSettings: custom_game_settings.txt ║
║ Maps: 24 Maps geladen ║
║ Map-Shuffle: Deaktiviert ║
╠════════════════════════════════════════════════════════════════════╣
║ XAseco: Aktiv (PID 1234) ║
║ Healthcheck: Aktiv (PID 5678) ║
║ Forced Mods: Keine ║
╠════════════════════════════════════════════════════════════════════╣
║ AdminServ: http://<host-ip>/ ║
║ RemoteCP: http://<host-ip>/remotecp/ ║
╠════════════════════════════════════════════════════════════════════╣
║ Log-Rotation: Aktiv (stuendlich, max. 10 MB) ║
║ PHP-Debug: Deaktiviert ║
║ TM-Server: PID 42 ║
╚════════════════════════════════════════════════════════════════════╝
```
Die Zusammenfassung kann jederzeit mit `docker logs tmserver` erneut eingesehen werden.
> **Hinweis:** `<host-ip>` ist ein Platzhalter ersetze ihn durch die tatsächliche IP oder Domain deines Hosts (z.B. `http://192.168.1.100/`).
> **Hinweis:** Die Startup-Zusammenfassung ist nach einem Image-Update automatisch aktiv auch bei bestehenden Installationen. Es sind keine manuellen Schritte nötig.
## AdminServ ServerOptions-Import
Wenn über AdminServ Änderungen an den Server-Optionen vorgenommen und als Export gespeichert werden (z.B. Servername, Beschreibung, Spielerzahl), werden diese beim nächsten Container-Start **automatisch** in die `dedicated_cfg.txt` übernommen.

View File

@@ -43,11 +43,9 @@ Die Konfiguration erfolgt über die `.env`-Datei, die automatisch eingelesen wir
Alternativ kannst du das Image auch selbst bauen:
```bash
docker build -t tmserver:latest -t tmserver:1.1.1 .
docker build -t tmserver:latest .
```
Damit wird das Image mit zwei Tags erstellt: `tmserver:latest` und `tmserver:1.1.1`.
Anschließend den Server starten:
```bash

View File

@@ -73,6 +73,7 @@ nano .env
|----------|-------------|----------|
| `MATCHSETTINGS_FILE` | MatchSettings-Datei beim Serverstart: `auto` = neueste `.txt`-Datei im Ordner wird automatisch geladen, oder ein expliziter Dateiname (z.B. `meine_settings.txt`) | `auto` |
| `ALLWARMUPDURATION` | Warmup-Dauer für alle Runden (`0` = deaktiviert, `1` = eine Runde Warmup) | `0` |
| `SHUFFLE_MAPLIST` | Map-Reihenfolge beim Containerstart zufällig mischen (`true` = aktiviert, `false` = deaktiviert) | `false` |
### Automatische MatchSettings-Erkennung
@@ -90,6 +91,27 @@ MATCHSETTINGS_FILE=turnier_settings.txt
> **Hinweis:** Falls die angegebene oder automatisch ermittelte Datei nicht existiert, wird auf `custom_game_settings.txt` zurückgefallen. Die aktiv geladene Datei wird beim Serverstart in der Konsole ausgegeben.
### Map-Shuffle
Mit `SHUFFLE_MAPLIST=true` wird die Reihenfolge aller Maps in der aktiven MatchSettings-Datei beim **jedem Containerstart** zufällig durchgemischt. So startet der Server jedes Mal mit einer anderen Map, statt immer bei Map #1 zu beginnen.
- Die `<challenge>`-Einträge in der MatchSettings-XML werden zufällig neu angeordnet
- Der `<startindex>` wird automatisch auf `0` gesetzt
- Die aktive MatchSettings-Datei wird dabei direkt überschrieben
- Die ersten 3 Maps der neuen Reihenfolge werden beim Start in der Konsole angezeigt
**Beispiel:**
```bash
# Map-Reihenfolge bei jedem Start mischen
SHUFFLE_MAPLIST=true
# Deaktiviert (Standard) Reihenfolge bleibt wie in der Datei
SHUFFLE_MAPLIST=false
```
> **Hinweis:** Der Shuffle wird auf die MatchSettings-Datei angewendet, die durch `MATCHSETTINGS_FILE` bestimmt wird (entweder automatisch oder explizit). Die Änderung ist persistent die Datei wird tatsächlich umgeschrieben. Bei jedem Neustart wird erneut gemischt.
## RemoteCP
RemoteCP verwendet die SuperAdmin-Zugangsdaten (`SERVER_SA_PASSWORD`) des TM-Servers für den Web-Login. Es werden keine separaten Login-Variablen benötigt.
@@ -161,9 +183,19 @@ XAseco ist ein Server-Controller für Rekorde, Karma, Jukebox und mehr. Siehe [X
| `XASECO_DB_USER` | Datenbank-Benutzername | `xaseco` |
| `XASECO_DB_PASSWORD` | Datenbank-Passwort | *(muss gesetzt werden)* |
| `XASECO_DEDIMANIA_NATION` | Dedimania-Nation (IOC-Code) | `DEU` |
| `XASECO_HEALTHCHECK` | Automatische Überwachung und Neustart von XAseco bei Absturz/Verbindungsverlust | `true` |
| `XASECO_HEALTHCHECK_INTERVAL` | Prüfintervall des Healthchecks in Sekunden | `60` |
> **Hinweis:** Die Server-Zugangsdaten (`SERVER_SA_PASSWORD`, `SERVER_XMLRPC_PORT`) und Dedimania-Daten (`SERVER_LOGIN`, `SERVER_LOGIN_PASSWORD`) werden automatisch aus der bestehenden Konfiguration übernommen.
## IP-Watcher
| Variable | Beschreibung | Standard |
|----------|-------------|----------|
| `IP_WATCHER_INTERVAL` | Prüfintervall in Sekunden, in dem die öffentliche IP geprüft wird | `300` |
> **Hinweis:** Der IP-Watcher verwendet den Docker-Socket (`/var/run/docker.sock`), um `tmserver` bei einer IP-Änderung automatisch neu zu starten. Weitere Details unter [IP-Watcher](ip-watcher.md).
## Debugging
| Variable | Beschreibung | Standard |

105
docs/update.md Normal file
View File

@@ -0,0 +1,105 @@
# Update-Anleitung
Diese Anleitung beschreibt, wie du eine **bestehende Installation** auf den neuesten Stand bringst ohne Daten zu verlieren und ohne alles neu aufsetzen zu müssen.
> **Hinweis:** Alle persistenten Daten (Konfiguration, Tracks, Datenbanken, Logs) liegen im Ordner `./data/` und werden bei einem Update nicht berührt.
---
## 1. Repository aktualisieren
Wechsle in den Projektordner und lade die neuesten Änderungen:
```bash
git pull
```
Damit werden aktualisierte Konfigurationsdateien, Skripte und Dokumentation aus dem Repository übernommen.
---
## 2. Neue Umgebungsvariablen prüfen
Mit neuen Versionen können neue Variablen in der `.env.example` hinzugekommen sein. Deine persönliche `.env`-Datei wird dabei **nicht überschrieben** du musst neue Variablen manuell nachtragen.
Vergleiche `.env.example` mit deiner `.env`, um fehlende Einträge zu finden:
```bash
diff .env.example .env
```
Zeilen, die in `.env.example` vorhanden sind, aber nicht in deiner `.env`, erscheinen mit `<` am Anfang. Diese solltest du in deine `.env` übernehmen und die Werte anpassen.
> **Tipp:** Neue Variablen haben in der Regel sinnvolle Standardwerte, die du oft einfach übernehmen kannst. Achte nur auf sicherheitsrelevante Werte wie Passwörter.
---
## 3. Docker Image aktualisieren
Lade das neueste Image aus der Registry:
```bash
docker compose pull
```
---
## 4. Container neu starten
Starte die Container mit dem neuen Image neu. Docker Compose erkennt automatisch, ob ein Rebuild nötig ist:
```bash
docker compose up -d
```
> **Hinweis:** Wenn sich die `docker-compose.yml` geändert hat (z.B. neue Services oder geänderte Konfiguration), werden betroffene Container automatisch neu erstellt. Deine Daten in `./data/` bleiben dabei vollständig erhalten.
---
## Zusammenfassung
```bash
# Im Projektordner ausführen:
git pull
docker compose pull
docker compose up -d
```
Das war's der Server läuft jetzt auf dem neuesten Stand.
---
## Was passiert mit meinen Daten?
| Ordner | Inhalt | Beim Update |
|--------|--------|-------------|
| `./data/gamedata/` | TM-Server-Daten, Konfiguration, Tracks | Bleibt erhalten |
| `./data/controlpanel/` | AdminServ- und RemoteCP-Daten | Bleibt erhalten |
| `./data/xaseco/` | XAseco-Konfiguration und Logs | Bleibt erhalten |
| `./data/mariadb/` | Datenbankdateien | Bleibt erhalten |
| `.env` | Deine Umgebungsvariablen | Wird nicht überschrieben |
---
## Häufige Situationen
### Neue Umgebungsvariable hat keinen Effekt
Einige Variablen (z.B. `SERVER_SA_PASSWORD`) werden nur beim **ersten Start** in die `dedicated_cfg.txt` geschrieben. Falls du eine neue Variable nachträglich setzen möchtest, kannst du das erzwingen:
```bash
# In der .env setzen:
FORCE_CONFIG_UPDATE=true
```
Dann Container neu starten. Danach unbedingt wieder auf `false` setzen, damit manuelle Änderungen erhalten bleiben. Weitere Details unter [Konfiguration](konfiguration.md).
### Welches Image-Tag wird verwendet?
In der `docker-compose.yml` ist das Image-Tag angegeben (z.B. `1.3.2` oder `latest`). Du kannst auf `latest` umstellen, um immer automatisch das neueste Image zu bekommen:
```yaml
image: git.techniverse.net/scriptos/trackmania-server:latest
```
Alle verfügbaren Tags findest du in der [Container-Registry](https://git.techniverse.net/scriptos/-/packages/container/trackmania-server/).

View File

@@ -77,6 +77,8 @@ Die Konfiguration erfolgt ausschließlich über Umgebungsvariablen in der `.env`
| `XASECO_DB_NAME` | Name der XAseco-Datenbank | `xaseco` |
| `XASECO_DB_USER` | Datenbank-Benutzername | `xaseco` |
| `XASECO_DEDIMANIA_NATION` | Dedimania-Nation ([IOC-Code](https://en.wikipedia.org/wiki/List_of_IOC_country_codes), z.B. `DEU`, `AUT`, `CHE`) | `DEU` |
| `XASECO_HEALTHCHECK` | Automatische Überwachung und Neustart bei Absturz | `true` |
| `XASECO_HEALTHCHECK_INTERVAL` | Prüfintervall des Healthchecks in Sekunden | `60` |
### Automatisch übernommene Variablen
@@ -147,6 +149,37 @@ XASECO_ENABLED=false
Der TrackMania-Server läuft dann ohne Server-Controller.
## Healthcheck / Watchdog
XAseco wird automatisch durch einen Watchdog-Prozess überwacht. Dieser erkennt Abstürze und verlorene Verbindungen (z.B. wenn das Overlay im Spiel verschwindet) und startet XAseco selbstständig neu.
### Funktionsweise
Der Watchdog prüft regelmäßig (Standard: alle 60 Sekunden):
1. **PID-Check:** Läuft der XAseco-PHP-Prozess noch?
2. **Log-Check:** Enthält das XAseco-Log fatale Fehler oder Verbindungsabbrüche?
3. **XMLRPC-Check:** Ist der TM-Server noch erreichbar?
Bei erkannten Problemen wird XAseco automatisch beendet und neu gestartet. Crash-Logs werden zur Fehleranalyse unter `data/xaseco/aseco_crash_<TIMESTAMP>.log` gesichert (max. 5 Dateien).
### Konfiguration
| Variable | Beschreibung | Standard |
|----------|-------------|----------|
| `XASECO_HEALTHCHECK` | Watchdog aktivieren/deaktivieren | `true` |
| `XASECO_HEALTHCHECK_INTERVAL` | Prüfintervall in Sekunden | `60` |
```env
# Healthcheck deaktivieren
XASECO_HEALTHCHECK=false
# Prüfintervall auf 30 Sekunden verkürzen
XASECO_HEALTHCHECK_INTERVAL=30
```
> **Hinweis:** Der Watchdog ist standardmäßig aktiviert und erfordert keine zusätzliche Konfiguration. Bei bestehenden Installationen wird er nach dem nächsten Image-Update automatisch aktiv.
## Logs
Die XAseco-Logdatei befindet sich unter:
@@ -157,13 +190,199 @@ Die XAseco-Logdatei befindet sich unter:
Bei Problemen ist dies die erste Anlaufstelle für die Fehlersuche.
## Wichtige Chat-Befehle
> **Hinweis:** Die XAseco-Logdatei wird automatisch per logrotate rotiert (max. 10 MB pro Datei, 5 rotierte Dateien). Alte Logs werden komprimiert als `aseco.log.1.gz`, `aseco.log.2.gz` usw. aufbewahrt. Siehe [Konfiguration Log-Rotation](konfiguration.md#log-rotation).
## Chat-Befehle
Nachfolgend eine Übersicht der wichtigsten Befehle, die im Spielchat verfügbar sind. Eine vollständige Liste aller Befehle findest du in der offiziellen Dokumentation unter: https://docs.xaseco.org/commands.php
### Hilfe & Info
| Befehl | Beschreibung |
|--------|-------------|
| `/helpadmin` | Admin-Befehle anzeigen |
| `/recs` | Lokale Rekorde anzeigen |
| `/dedirecs` | Dedimania-Rekorde anzeigen |
| `/jukebox` | Track-Jukebox öffnen |
| `/stats` | Spieler-Statistiken anzeigen |
| `/admin help` | Alle Admin-Befehle |
| `/help` | Zeigt alle verfügbaren Befehle |
| `/helpall` | Zeigt ausführliche Hilfe zu allen Befehlen |
| `/xaseco` | Zeigt Infos über die XAseco-Version |
| `/server` | Zeigt Infos über den Server |
| `/plugins` | Zeigt Liste der aktiven Plugins |
| `/time` | Zeigt aktuelle Serverzeit und Datum |
### Rekorde & Statistiken
| Befehl | Beschreibung |
|--------|-------------|
| `/recs` | Zeigt alle lokalen Rekorde auf der aktuellen Strecke |
| `/recs pb` | Zeigt deine persönliche Bestzeit |
| `/recs new` | Zeigt neu gefahrene Rekorde |
| `/recs live` | Zeigt Rekorde der Online-Spieler |
| `/pb` | Zeigt deine persönliche Bestzeit auf der aktuellen Strecke |
| `/dedirecs` | Zeigt Dedimania-Rekorde auf der aktuellen Strecke |
| `/dedipb` | Zeigt deine persönliche Dedimania-Bestzeit |
| `/dedistats` | Zeigt Dedimania-Streckenstatistiken |
| `/best` | Zeigt deine besten Rekorde |
| `/worst` | Zeigt deine schlechtesten Rekorde |
| `/summary` | Zeigt eine Zusammenfassung aller deiner Rekorde |
| `/stats` | Zeigt Statistiken des aktuellen Spielers |
| `/wins` | Zeigt Siege des aktuellen Spielers |
### Rankings & Toplisten
| Befehl | Beschreibung |
|--------|-------------|
| `/rank` | Zeigt deinen aktuellen Serverrang |
| `/nextrank` | Zeigt den nächst besser platzierten Spieler |
| `/top10` | Zeigt die 10 bestplatzierten Spieler |
| `/top100` | Zeigt die 100 bestplatzierten Spieler |
| `/topwins` | Zeigt die 100 siegreichsten Spieler |
| `/toprecs` | Zeigt Top 100 der Rekord-Halter |
| `/topsums` | Zeigt Top 100 der Top-3-Rekord-Halter |
| `/active` | Zeigt die 100 aktivsten Spieler |
| `/topclans` | Zeigt die 10 bestplatzierten Clans |
### Strecken & Jukebox
| Befehl | Beschreibung |
|--------|-------------|
| `/track` | Zeigt Infos über die aktuelle Strecke |
| `/nextmap` | Zeigt den Namen der nächsten Strecke |
| `/playtime` | Zeigt, wie lange die aktuelle Strecke läuft |
| `/list` | Listet Strecken auf dem Server (siehe `/list help`) |
| `/list nofinish` | Strecken, auf denen du keinen Rang hast |
| `/list newest` | Die neuesten Strecken |
| `/list <name>` | Suche nach Strecken- oder Autorennamen |
| `/jukebox` | Track-Jukebox (siehe `/jukebox help`) |
| `/jukebox list` | Zeigt kommende Strecken |
| `/jukebox <#>` | Fügt Strecke Nr. `<#>` aus `/list` hinzu |
| `/jukebox drop` | Entfernt deine hinzugefügte Strecke |
| `/add <ID>` | Fügt eine Strecke direkt von TMX hinzu |
| `/history` | Zeigt die 10 zuletzt gespielten Strecken |
### Karma & Voting
| Befehl | Beschreibung |
|--------|-------------|
| `/karma` | Zeigt Karma der aktuellen Strecke |
| `/++` | Positive Bewertung für die aktuelle Strecke |
| `/--` | Negative Bewertung für die aktuelle Strecke |
| `/helpvote` | Zeigt Infos zum Chat-Voting-System |
| `/endround` | Startet Vote zum Beenden der aktuellen Runde |
| `/replay` | Startet Vote zum Wiederholen der Strecke |
| `/skip` | Startet Vote zum Überspringen der Strecke |
| `/kick` | Startet Vote zum Kicken eines Spielers |
| `/y` | Stimmt mit Ja bei einem laufenden Vote |
| `/cancel` | Bricht deinen aktuellen Vote ab |
### Kommunikation
| Befehl | Beschreibung |
|--------|-------------|
| `/pm <login> <msg>` | Sendet eine private Nachricht |
| `/pmlog` | Zeigt Verlauf deiner privaten Nachrichten |
| `/chatlog` | Zeigt Verlauf der letzten Chat-Nachrichten |
| `/me` | Drückt eine Aktion/Emotion aus |
| `/hi` | Sendet eine Hallo-Nachricht an alle |
| `/bye` | Sendet eine Tschüss-Nachricht an alle |
| `/gg` | Sendet "Good Game" an alle |
| `/n1` | Sendet "Nice One" an alle |
| `/brb` | Sendet "Be Right Back" an alle |
| `/afk` | Sendet "Away From Keyboard" an alle |
### Spieleroptionen
| Befehl | Beschreibung |
|--------|-------------|
| `/settings` | Zeigt deine persönlichen Einstellungen |
| `/cps` | Setzt Checkpoint-Tracking für lokale Rekorde |
| `/dedicps` | Setzt Checkpoint-Tracking für Dedimania-Rekorde |
| `/mute <login>` | Chat eines Spielers stummschalten |
| `/unmute <login>` | Stummschaltung aufheben |
| `/mutelist` | Zeigt Liste der stummgeschalteten Spieler |
| `/players` | Zeigt aktuelle Spieler-Liste (Nicks/Logins) |
| `/ranks` | Zeigt Liste der Online-Ränge |
| `/bootme` | Kickt dich selbst vom Server |
### Admin-Befehle (`/admin`)
Diese Befehle sind nur für Admins und MasterAdmins verfügbar.
| Befehl | Beschreibung |
|--------|-------------|
| `/admin help` | Zeigt alle Admin-Befehle |
| `/admin helpall` | Zeigt ausführliche Hilfe zu allen Admin-Befehlen |
**Server-Einstellungen:**
| Befehl | Beschreibung |
|--------|-------------|
| `/admin setservername <name>` | Ändert den Servernamen |
| `/admin setpwd <pwd>` | Ändert das Spieler-Passwort |
| `/admin setspecpwd <pwd>` | Ändert das Zuschauer-Passwort |
| `/admin setmaxplayers <#>` | Setzt maximale Spieleranzahl |
| `/admin setmaxspecs <#>` | Setzt maximale Zuschauerzahl |
| `/admin setgamemode <mode>` | Setzt Spielmodus (ta/rounds/team/laps/stunts/cup) |
**Strecken-Verwaltung:**
| Befehl | Beschreibung |
|--------|-------------|
| `/admin nextmap` | Erzwingt nächste Strecke |
| `/admin restartmap` | Startet aktuelle Strecke neu |
| `/admin replaymap` | Wiederholt aktuelle Strecke (via Jukebox) |
| `/admin endround` | Erzwingt Ende der aktuellen Runde |
| `/admin add <ID>` | Fügt Strecke von TMX hinzu |
| `/admin addlocal <datei>` | Fügt lokale Strecke hinzu |
| `/admin remove <#>` | Entfernt Strecke aus der Rotation |
| `/admin erasethis` | Entfernt aktuelle Strecke und löscht Datei |
| `/admin shuffle` | Mischt die Streckenliste zufällig |
| `/admin writetracklist` | Speichert aktuelle Streckenliste |
| `/admin readtracklist` | Lädt Streckenliste aus Datei |
**Jukebox:**
| Befehl | Beschreibung |
|--------|-------------|
| `/admin dropjukebox <#>` | Entfernt eine Strecke aus der Jukebox |
| `/admin clearjukebox` | Leert die gesamte Jukebox |
| `/admin pass` | Genehmigt einen laufenden Vote |
| `/admin cancel` | Bricht einen laufenden Vote ab |
**Spieler-Moderation:**
| Befehl | Beschreibung |
|--------|-------------|
| `/admin warn <login>` | Sendet eine Warnung an einen Spieler |
| `/admin kick <login>` | Kickt einen Spieler vom Server |
| `/admin kickghost <login>` | Kickt einen Ghost-Spieler |
| `/admin ban <login>` | Bannt einen Spieler |
| `/admin unban <login>` | Entbannt einen Spieler |
| `/admin black <login>` | Setzt einen Spieler auf die Blacklist |
| `/admin unblack <login>` | Entfernt einen Spieler von der Blacklist |
| `/admin mute <login>` | Schaltet einen Spieler global stumm |
| `/admin unmute <login>` | Hebt globale Stummschaltung auf |
| `/admin forcespec <login>` | Erzwingt Zuschauer-Modus |
| `/admin forceteam <login>` | Erzwingt Team-Zuordnung (Blue/Red) |
**Admin-Verwaltung:**
| Befehl | Beschreibung |
|--------|-------------|
| `/admin addadmin <login>` | Fügt einen neuen Admin hinzu |
| `/admin removeadmin <login>` | Entfernt einen Admin |
| `/admin addop <login>` | Fügt einen neuen Operator hinzu |
| `/admin removeop <login>` | Entfernt einen Operator |
| `/admin listmasters` | Zeigt MasterAdmin-Liste |
| `/admin listadmins` | Zeigt Admin-Liste |
| `/admin listops` | Zeigt Operator-Liste |
**Rekorde & System:**
| Befehl | Beschreibung |
|--------|-------------|
| `/admin delrec <#>` | Löscht einen bestimmten Rekord auf der aktuellen Strecke |
| `/admin wall <msg>` | Zeigt Popup-Nachricht für alle Spieler |
| `/admin pm <msg>` | Sendet private Nachricht an alle Admins |
| `/admin server` | Zeigt detaillierte Server-Einstellungen |
| `/admin shutdown` | Fährt XAseco herunter |
| `/admin shutdownall` | Fährt Server und XAseco herunter |
> **Tipp:** Eine vollständige Referenz aller Befehle (inkl. `/jfreu`-Befehle für erweiterte Moderation) findest du unter: https://docs.xaseco.org/commands.php