Pourquoi ta console affiche « Server list query returned an error »¶

Juste après le démarrage (ou le redémarrage) d'un serveur FiveM, tu peux voir apparaître dans la console une ligne de ce style :

[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)

C'est sans conséquence. Ton serveur tourne, les joueurs peuvent se connecter à l'adresse affichée dans ton tableau de bord, et l'avertissement disparaît tout seul en quelques minutes.

Ce qu'il se passe vraiment¶

FiveM maintient une liste publique de serveurs sur un master server. Dès que ton serveur démarre, il envoie un heartbeat à ce master, et le master interroge périodiquement ton endpoint dynamic.json pour vérifier qu'il est toujours en ligne et rafraîchir ses données (nombre de joueurs, nom du serveur, etc.).

Le master indexe ces endpoints par ta license key. Si cette même licence a été utilisée précédemment sur une autre machine (changement d'hébergeur, recréation du serveur, migration entre fournisseurs), il se peut que le master tape encore sur un endpoint périmé le temps de se synchroniser sur le nouveau. Ces requêtes échouent, le master remonte l'échec à ton serveur, et FiveM logge l'avertissement dans ta console.

Ce que Zaroz Cloud fait automatiquement pour toi¶

À chaque démarrage de ton conteneur, nous patchons ton server.cfg pour qu'il colle à l'IP et au port qui te sont réellement attribués. Concrètement, notre entrypoint :

Supprime toutes les lignes existantes endpoint_add_tcp, endpoint_add_udp et set sv_listingIpOverride.
En écrit de nouvelles, accrochées à ton vrai port et à ton IP publique.

Autrement dit, ton serveur annonce bien la bonne adresse au master. L'erreur passagère que tu vois vient uniquement du côté du master, pas de ta configuration.

Combien de temps avant qu'elle disparaisse¶

Le master FiveM rafraîchit son cache d'endpoints après quelques heartbeats réussis. En pratique :

Dans la plupart des cas : l'avertissement disparaît en 2 à 5 minutes.
Au pire : jusqu'à environ 15 minutes après le premier démarrage avec une nouvelle attribution de licence.

Pas besoin de redémarrer, de toucher au server.cfg ou d'ouvrir un ticket pendant ce laps de temps. Les joueurs qui utilisent l'adresse du tableau de bord ne voient rien.

Quand nous écrire¶

Contacte-nous si :

L'erreur continue d'apparaître plus de 30 minutes après un démarrage à neuf.
Les joueurs n'arrivent pas à se connecter avec l'adresse du tableau de bord.

Dans ces cas-là, envoie-nous la ligne complète du log et ton numéro de commande pour qu'on vérifie le routage de notre côté.