101 lines
4.0 KiB
Markdown
101 lines
4.0 KiB
Markdown
# AdminServ – Server-Verwaltungsoberfläche
|
||
|
||
Die Server-Verwaltungsoberfläche basiert auf [AdminServ](https://github.com/Chris92de/AdminServ) und ist über Port 80 erreichbar.
|
||
|
||
## 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
|
||
|
||
## 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
|
||
|
||
## Standard-Passwörter
|
||
|
||
| Stufe | Standard-Passwort |
|
||
|-------|-------------------|
|
||
| SuperAdmin | `SuperAdmin` |
|
||
| Admin | `Admin` |
|
||
| User | `User` |
|
||
|
||
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).
|
||
|
||
## Persistente Speicherung
|
||
|
||
Alle AdminServ-Daten (Passwort, Server-Einträge, Konfiguration, Logs) werden über einen Bind-Mount (`./data/controlpanel`) persistent auf dem Host gespeichert. Beim ersten Start werden die Dateien automatisch aus dem Image ins Volume kopiert.
|
||
|
||
| Host-Pfad | Container-Pfad | Beschreibung |
|
||
|-----------|----------------|-------------|
|
||
| `./data/controlpanel` | `/var/www/html` | AdminServ- und RemoteCP-Installation |
|
||
|
||
> **Hinweis:** Im selben Volume befindet sich auch [RemoteCP](remotecp.md) unter `./data/controlpanel/remotecp/`.
|
||
|
||
## Fehlerbehebung
|
||
|
||
### Login funktioniert nicht nach dem Anlegen eines Servers
|
||
|
||
Falls der Login nicht funktioniert oder ein Authentifizierungsfehler angezeigt wird, können die PHP-Logs Aufschluss geben:
|
||
|
||
1. In der `.env`-Datei `PHP_DISPLAY_ERRORS=true` setzen
|
||
2. Container neu starten: `docker compose up -d`
|
||
3. AdminServ im Browser öffnen und den Fehler reproduzieren
|
||
4. Die PHP-Fehlermeldung wird direkt auf der Seite angezeigt
|
||
|
||
Alternativ können die PHP-Logs eingesehen werden:
|
||
|
||
```bash
|
||
docker exec tmserver cat /var/log/php_errors.log
|
||
```
|
||
|
||
### AdminServ komplett zurücksetzen
|
||
|
||
Falls AdminServ in einen inkonsistenten Zustand geraten ist:
|
||
|
||
```bash
|
||
# AdminServ-Daten auf dem Host löschen
|
||
rm -rf ./data/controlpanel/*
|
||
|
||
# Container neu starten – AdminServ wird frisch initialisiert
|
||
docker compose up -d
|
||
```
|
||
|
||
## 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.
|
||
|
||
### Falscher Pfad in MatchSettings-Dateien
|
||
|
||
Beim Erstellen einer neuen MatchSettings-Datei über AdminServ wurden die Track-Pfade falsch geschrieben. Statt des tatsächlichen Ordners (z.B. `Challenges/Downloaded/`) wurde immer der Speicherort der MatchSettings (`MatchSettings/`) als Pfad-Präfix verwendet:
|
||
|
||
```xml
|
||
<!-- Fehlerhaft (Original) -->
|
||
<file>MatchSettings/speed vs. fullspeed.Challenge.Gbx</file>
|
||
|
||
<!-- Korrekt (nach Patch) -->
|
||
<file>Challenges/Downloaded/speed vs. fullspeed.Challenge.Gbx</file>
|
||
```
|
||
|
||
**Ursache:** Die AJAX-Funktion `get_matchset_mapimport.php` hat den URL-Parameter `d` (= MatchSettings-Speicherordner) als relativen Pfad für die Map-Dateinamen verwendet, anstatt den tatsächlichen Ordner aus der Dropdown-Auswahl zu berechnen.
|
||
|
||
**Betroffene Datei:** `resources/ajax/get_matchset_mapimport.php`
|
||
|
||
### GetModeScriptInfo-Fehler (-506)
|
||
|
||
Beim Speichern einer MatchSettings-Datei erschien die Fehlermeldung:
|
||
|
||
```
|
||
[-506] Method 'GetModeScriptInfo' not defined
|
||
```
|
||
|
||
**Ursache:** `GetModeScriptInfo` ist eine XML-RPC-Methode, die nur in ManiaPlanet/TM2 existiert. AdminServ hat sie ohne Versionsprüfung aufgerufen. An anderen Stellen im Code wurde korrekt mit `SERVER_VERSION_NAME != 'TmForever'` unterschieden – nur hier fehlte die Prüfung.
|
||
|
||
**Betroffene Datei:** `resources/process/maps-creatematchset.php`
|