Warum in deiner Konsole "Server list query returned an error" auftaucht¶

Direkt nach dem Start (oder Neustart) eines FiveM-Servers kann in der Konsole eine Zeile wie diese erscheinen:

[citizen-server-impl] Server list query returned an error: server request failed:
server request failed for endpoint https://<ip>:<port>/dynamic.json
(Get "https://<ip>:<port>/dynamic.json": EOF)

Das ist harmlos. Dein Server läuft, Spieler können sich über die Adresse aus dem Dashboard verbinden, und die Warnung verschwindet innerhalb weniger Minuten von selbst.

Was eigentlich passiert¶

FiveM betreibt eine öffentliche Master-Serverliste. Sobald dein Server bootet, schickt er einen Heartbeat an diesen Master, und der Master ruft regelmäßig deinen dynamic.json-Endpunkt ab, um zu prüfen, ob der Server noch online ist, und um seine Daten (Spielerzahl, Servername usw.) zu aktualisieren.

Der Master indexiert diese Endpunkte über deinen License Key. Wenn derselbe License Key vorher auf einer anderen Maschine im Einsatz war (zum Beispiel nach einem Hoster-Wechsel, einem Neuaufsetzen des Servers oder einer Migration), kann es sein, dass der Master noch einen veralteten Endpunkt abruft, während er sich auf den neuen einstellt. Diese Anfragen schlagen fehl, der Master meldet den Fehlschlag an deinen Server zurück, und FiveM schreibt die Warnung in deine Konsole.

Was Zaroz Cloud automatisch für dich erledigt¶

Bei jedem Start deines Containers patchen wir deine server.cfg, damit sie zu der IP und dem Port passt, die dir tatsächlich zugewiesen sind. Konkret tut unser Entrypoint folgendes:

Entfernt alle vorhandenen Zeilen endpoint_add_tcp, endpoint_add_udp und set sv_listingIpOverride.
Schreibt frische Zeilen, die an deinen echten Port und deine öffentliche IP gebunden sind.

Dein Server kündigt also gegenüber dem Master die richtige Adresse an. Der vorübergehende Fehler liegt rein auf der Master-Seite, nicht in deiner Konfiguration.

Wann er verschwindet¶

Der FiveM-Master aktualisiert seinen Endpunkt-Cache nach einigen erfolgreichen Heartbeats deines Servers. In der Praxis:

In den meisten Fällen: Die Warnung verschwindet nach 2 bis 5 Minuten.
Im schlimmsten Fall: bis zu etwa 15 Minuten nach dem ersten Start mit einer neuen Lizenzzuweisung.

Du musst während dieser Zeit nicht neu starten, nichts an der server.cfg ändern oder ein Ticket öffnen. Spieler, die die Adresse aus dem Dashboard verwenden, sind nicht betroffen.

Wann du dich melden solltest¶

Schreib uns, wenn:

Der Fehler länger als 30 Minuten nach einem Frischstart noch erscheint.
Spieler sich nicht über die Adresse aus dem Dashboard verbinden können.

In diesen Fällen schick uns die vollständige Logzeile und deine Bestellnummer, damit wir das Routing auf unserer Seite prüfen können.