RemoteCP hinzugefügt.

docs/remotecp.md

@@ -0,0 +1,115 @@
+# RemoteCP – Alternative Server-Verwaltungsoberfläche
+
+RemoteCP ist eine weitere Web-Verwaltungsoberfläche für Trackmania-Server, die parallel zu AdminServ installiert ist. Es handelt sich um ein älteres Tool mit eigenem Login-System und eigener Benutzerverwaltung.
+
+## Zugriff
+
+RemoteCP ist als Subpath unter der gleichen Adresse wie AdminServ erreichbar:
+
+- **AdminServ:** `http://<host-ip>/`
+- **RemoteCP:** `http://<host-ip>/remotecp/`
+
+## Standard-Zugangsdaten
+
+RemoteCP verwendet die SuperAdmin-Zugangsdaten des Trackmania-Servers:
+
+| Benutzer | Passwort | Beschreibung |
+|----------|----------|-------------|
+| `SuperAdmin` | Wert aus `SERVER_SA_PASSWORD` | Administrator (volle Rechte) |
+| `Guest` | `Guest` | Gast-Zugang (nur Lesen) |
+
+Der Admin-Login für RemoteCP ist identisch mit dem SuperAdmin-Passwort des TM-Servers (`SERVER_SA_PASSWORD`). Es werden keine separaten Zugangsdaten benötigt.
+
+## Umgebungsvariablen
+
+| Variable | Beschreibung | Standard |
+|----------|-------------|----------|
+| `REMOTECP_DB_HOST` | Hostname des Datenbankservers | `mariadb` |
+| `REMOTECP_DB_NAME` | Name der RemoteCP-Datenbank | `remotecp` |
+| `REMOTECP_DB_USER` | Datenbank-Benutzername | `remotecp` |
+| `REMOTECP_DB_PASSWORD` | Datenbank-Passwort | *(muss gesetzt werden)* |
+
+## Datenbank (MariaDB)
+
+RemoteCP benötigt eine MariaDB-Datenbank für erweiterte Funktionen (Spielerstatistiken, Records, Chat-Nachrichten, etc.). Ein MariaDB-Container wird automatisch als Teil des Docker-Setups bereitgestellt.
+
+### Automatische Einrichtung
+
+Wenn die Datenbank-Variablen in der `.env`-Datei gesetzt sind (`REMOTECP_DB_HOST`, `REMOTECP_DB_PASSWORD`), wird beim ersten Start:
+
+1. Die **MariaDB** erstellt automatisch die Datenbank und den Benutzer (über `MYSQL_DATABASE`, `MYSQL_USER`, `MYSQL_PASSWORD`)
+2. Das **Startup-Script** wartet, bis MariaDB erreichbar ist
+3. Die **Datenbank-Tabellen** werden automatisch aus den SQL-Schema-Dateien importiert
+4. Die **Installer-Markierung** (`cache/installed`) wird gesetzt, damit der Web-Installer übersprungen wird
+
+Es ist kein manuelles Setup über den Web-Installer nötig.
+
+### Manuelle Einrichtung
+
+Falls die automatische Einrichtung nicht gewünscht ist oder fehlschlägt (z.B. MariaDB nicht erreichbar), kann RemoteCP auch manuell eingerichtet werden:
+
+1. Die Datenbank-Variablen (`REMOTECP_DB_HOST`, `REMOTECP_DB_PASSWORD`) **müssen trotzdem in der `.env`-Datei gesetzt sein**, damit die MariaDB die Datenbank und den Benutzer beim ersten Start erstellt
+2. RemoteCP-Installer im Browser aufrufen: `http://<host-ip>/remotecp/index.php?page=install`
+3. „Install with remoteCP-Database" wählen
+4. Die Datenbank-Zugangsdaten eingeben:
+   - **Database DSN:** `mysql:dbname=remotecp;host=mariadb` (bzw. die Werte aus der `.env`)
+   - **Database Username:** Wert aus `REMOTECP_DB_USER`
+   - **Database Password:** Wert aus `REMOTECP_DB_PASSWORD`
+5. Server-Daten eingeben (XMLRPC-Port, SuperAdmin-Passwort)
+6. Installation abschließen
+
+### Persistente Daten
+
+Die MariaDB-Daten werden über ein eigenes Bind-Mount persistent gespeichert:
+
+| Host-Pfad | Container-Pfad | Beschreibung |
+|-----------|----------------|-------------|
+| `./data/MariaDB` | `/var/lib/mysql` | MariaDB-Datenbankdateien |
+
+> **Hinweis:** Der MariaDB-Container kann auch für weitere Tools genutzt werden. Zusätzliche Datenbanken und Benutzer können über den Root-Zugang (`MARIADB_ROOT_PASSWORD`) erstellt werden.
+
+## Automatische Konfiguration
+
+Beim ersten Start wird RemoteCP automatisch konfiguriert:
+
+- Die **Serververbindung** wird mit dem XML-RPC-Port und dem SuperAdmin-Passwort (`SERVER_SA_PASSWORD`) aus der `.env`-Datei eingerichtet
+- Der **Admin-Zugang** verwendet den Benutzernamen `SuperAdmin` mit dem Passwort aus `SERVER_SA_PASSWORD`
+- Das Passwort wird als MD5-Hash in der Konfiguration gespeichert
+- Die **Datenbankverbindung** wird automatisch in `servers.xml` eingetragen (wenn DB-Variablen gesetzt sind)
+
+## Persistente Speicherung
+
+RemoteCP wird im gleichen Volume wie AdminServ gespeichert:
+
+| Host-Pfad | Container-Pfad | Beschreibung |
+|-----------|----------------|-------------|
+| `./data/AdminServ/remotecp` | `/var/www/html/remotecp` | RemoteCP-Installation |
+
+Die Konfigurationsdateien befinden sich unter `./data/AdminServ/remotecp/xml/`:
+
+| Datei | Beschreibung |
+|-------|-------------|
+| `servers.xml` | Server-Verbindungsdaten (Host, Port, Passwort, Datenbank) |
+| `admins.xml` | Benutzer und Zugangsdaten |
+| `groups.xml` | Berechtigungsgruppen |
+
+## Sicherheit
+
+RemoteCP liefert eine `.htaccess`-Datei mit, die den direkten Zugriff auf XML-Konfigurationsdateien über den Browser verhindert. Apache `mod_rewrite` und `AllowOverride` sind im Image aktiviert, damit dieser Schutz funktioniert.
+
+## Fehlerbehebung
+
+Falls RemoteCP nicht erreichbar ist oder Fehler anzeigt:
+
+1. Prüfe, ob beide Container laufen: `docker ps`
+2. MariaDB-Verbindung testen: `docker exec tmserver mysql -h mariadb -u remotecp -p remotecp -e "SELECT 1"`
+3. PHP-Debug-Modus aktivieren: `PHP_DISPLAY_ERRORS=true` in der `.env`-Datei setzen
+4. Container neu starten: `docker compose restart`
+5. PHP-Logs prüfen: `docker exec tmserver cat /var/log/php_errors.log`
+6. MariaDB-Logs prüfen: `docker logs tmserver-mariadb`
+
+### Bekannte Hinweise
+
+- RemoteCP ist ein älteres Tool (Version 4.0.3.5) und wurde für PHP 5.x entwickelt, läuft aber mit PHP 7.4
+- Die Live-Funktionen (`remoteCP[Live]`) benötigen eine laufende Serververbindung
+- Die Registrierung neuer Benutzer ist standardmäßig aktiviert und kann in `xml/settings/settings.xml` über `<register>false</register>` deaktiviert werden