Ein FiveM-Server, der sich weigert zu starten, gibt stets eine Erklärung an: Diese finden Sie in den ersten zwanzig Zeilen des Protokolls. Allerdings muss man wissen, wo man nachsehen muss und wie man die Meldungen interpretiert. Im Folgenden finden Sie die Fälle, die unser Support am häufigsten sieht, sowie deren Bedeutung.
Falls der Server zwar ordnungsgemäß startet, aber zeitweise nicht erreichbar ist, sollten Sie auch einen Netzwerkangriff in Betracht ziehen: Lesen Sie dazu unseren Anti-DDoS-Schutz für FiveM.
1. Die richtige Zeitung lesen
Drei Stellen, je nach Ihrer Installation:
journalctl -u fivem -n 80 --no-pager # serveur lancé par systemd
tmux attach -t fivem # serveur lancé dans tmux
# txAdmin : onglet Live Console
Suchen Sie nach dem ersten Fehler, nicht nach dem letzten: Die folgenden Fehler ergeben sich oft daraus. Ein Fehler, der rot markiert ist oder dem ein ^1 Ein Fehler in der Konsole führt zu einer Blockierung; eine Warnung hingegen nicht.
2. Lizenzprobleme
| Nachricht | Ursache und Lösung |
|---|---|
Invalid license key | Der Schlüssel wurde falsch übertragen oder es fehlen Anführungszeichen in sv_licenseKey. Erstellen Sie sie bei Bedarf auf portal.cfx.re neu. |
License key does not match server IP | Der Schlüssel ist mit einer anderen IP-Adresse verknüpft. Ändern Sie die zugehörige Adresse im Cfx.re-Portal oder erstellen Sie einen neuen Schlüssel für diesen Server. |
Your license key has been banned | Der Schlüssel wurde gesperrt, in der Regel wegen eines Verstoßes gegen die Nutzungsbedingungen. Wenden Sie sich bitte an Cfx.re: Nur dort kann der Schlüssel wieder freigeschaltet werden. |
Could not contact Cfx.re | Der Server hat keinen Ausgangszugang zum Internet. Bitte überprüfen Sie die DNS-Auflösung und die ausgehende Firewall. |
Ein Lizenzschlüssel ist kostenlos und an einen bestimmten Server gebunden. Geben Sie ihn nicht weiter und veröffentlichen Sie ihn keinesfalls in einem Screenshot Ihrer Konfiguration.
3. Port belegt, Spieler wurden rausgeworfen
Address already in use : Ein anderer Prozess überwacht den Port bereits – fast immer handelt es sich dabei um eine zuvor nicht ordnungsgemäß beendete Instanz.
ss -tulpn | grep 30120
systemctl stop fivem # ou kill du processus restant
Die Spieler melden sich an und werden anschließend sofort abgemeldet, mit einer Zeitüberschreitungsmeldung: In neun von zehn Fällen ist der Port über TCP offen, nicht jedoch über UDP. FiveM benötigt beide.
ufw allow 30120 comment 'FiveM TCP et UDP'
ufw status | grep 30120
Bitte überprüfen Sie auch, ob Ihr server.cfg die beiden Abhörzeilen tatsächlich enthält und dass der Server auf allen Schnittstellen abhört:
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
Unser server.cfg-Generator fügt stets beide ein.
4. Ressourcen im Bereich Schach
Couldn't find resource X: der Name inensurestimmt nicht mit dem Namen des Ordners überein. Bitte beachten Sie die Groß- und Kleinschreibung: Linux unterscheidetesx_menu_defaultvonESX_Menu_Default, im Gegensatz zu Windows. Dies ist der häufigste Grund bei einer Migration von einem Windows-Server.Failed to load scriptgefolgt von einem Syntaxfehler: Das Skript ist mit Ihrem Build nicht kompatibel oder wurde bei der Übertragung beschädigt. Siehe Welchen Artefakt-Build soll man wählen?.Unable to find dependency: Eine Ressource benötigt eine andere, die bereits vor ihr gestartet wurde. Die Reihenfolge der ZeilenensureKonto:oxmysqlUnd zuerst das Framework, dann der Rest.- Eine Ressource wird gestartet und stoppt anschließend von selbst : Lesen Sie die Zeilen unmittelbar davor; der eigentliche Fehler ist fast immer dort zu finden.
Um einen Schuldigen zu ermitteln, bewerten Sie die Hälfte Ihrer ensure, starten Sie den Computer neu, und dann gilt das Prinzip der Dichotomie: In drei oder vier Versuchen haben Sie die fehlerhafte Ressource ausgemacht.
5. Datenbank
[oxmysql] Connection refused oder Access denied for user : Die Verbindungszeichenfolge ist falsch, oder MariaDB wurde nicht gestartet.
systemctl status mariadb
mariadb -u utilisateur -p nom_base -e "SELECT 1;"
Sollte dieser Befehl funktionieren, der Server jedoch nicht, vergleichen Sie die Verbindungszeichenfolge des server.cfg. Die klassischen Fehler: ein Passwort, das ein nicht kodiertes Sonderzeichen enthält, oder localhost zu erwarten, da der Server in einem Container läuft. Einzelheiten finden Sie unter MariaDB absichern.
6. Der Server startet, wird jedoch nicht in der Liste angezeigt
- Bitte stellen Sie sicher, dass
sv_master1wurde nicht in einer anderweitig wiederhergestellten Konfiguration geleert: Dadurch wird der Server bewusst aus der öffentlichen Liste entfernt. - Stellen Sie sicher, dass der Port von außen erreichbar ist und nicht nur lokal.
- Bitte warten Sie nach dem vollständigen Systemstart einige Minuten: Die Indizierung erfolgt nicht sofort.
- In der Zwischenzeit können Ihre Spieler weiterhin direkt mit dem Befehl beitreten
connect adresse:30120in der F8-Konsole.
7. Die Checkliste, wenn nichts mehr funktioniert
- Lesen Sie den ersten Fehler im Protokoll, nicht den letzten.
- Erste Schritte mit einem
server.cfgMinimal, ohne jegliche zusätzliche Ressourcen: Wenn das Programm startet, liegt das Problem bei Ihren Ressourcen. - Überprüfen Sie zunächst die Lizenz und anschließend die beiden TCP- und UDP-Listening-Einträge.
- Aktivieren Sie die Ressourcen schrittweise, jeweils die Hälfte, bis die fehlerhafte Ressource ermittelt ist.
- Den Speicherplatz überprüfen mit
df -h: Eine volle Festplatte führt zu unerklärlichen Fehlern. - Als letzte Möglichkeit sollten Sie mit txAdmin eine Neuinstallation durchführen und anschließend Ihre Ressourcen nacheinander erneut importieren.
Bevor Sie neue Ressourcen hinzufügen oder den Build ändern, kopieren Sie bitte den Serverordner und exportieren Sie die Datenbank. Das Zurücksetzen dauert dann nur noch dreißig Sekunden statt eines ganzen Abends.
Die vollständige Installationsanleitung finden Sie in unserem Leitfaden Einen FiveM-Server auf einem VPS installieren, und die Leistungsprobleme werden behandelt in FiveM-Server mit Verzögerungen: Die eigentliche Ursache finden.
Weiterlesen
FiveM-Server mit Verzögerungen: Die Ursache finden
Fehlerdiagnose bei einem FiveM-Server mit Leistungseinbußen: resmon auslesen, die fehlerhafte Ressource identifizieren und feststellen, ob das Problem von den Skripten oder vom Server selbst verursacht wird.
FiveM: Welchen Artefakt-Build soll man wählen?
FXServer-Artefakte verstehen: empfohlener Build oder aktuellster Build, wie man die Version wechselt, ohne den Server lahmzulegen, und die Rolle von…
Einen FiveM-Server auf einem VPS einrichten: Die umfassende Anleitung
Schritt-für-Schritt-Anleitung zur Installation eines FiveM-Servers auf einem Linux-VPS: Vorbereitung, Artefakte, Cfx.re-Schlüssel, server.cfg, txAdmin, MariaDB-Datenbank, systemd-Dienst, …
Häufig gestellte Fragen
Warum werden meine Spieler unmittelbar nach der Anmeldung wieder abgemeldet?
Dies liegt fast immer daran, dass der Port über TCP, nicht jedoch über UDP geöffnet ist. FiveM benötigt beide, und Ihre server.cfg-Datei muss die Zeilen „endpoint_add_tcp“ und „endpoint_add_udp“ enthalten. Überprüfen Sie außerdem, ob der Lizenzschlüssel mit der IP-Adresse des Servers übereinstimmt.
Was bedeutet die Meldung „Couldn't find resource“ beim Start?
Der nach „ensure“ angegebene Name stimmt nicht genau mit dem Ordnernamen der Ressource überein. Unter Linux wird zwischen Groß- und Kleinschreibung unterschieden, im Gegensatz zu Windows: Dies ist der häufigste Fehler nach einer Migration von einem Windows-Server.
Mein Lizenzschlüssel wird abgelehnt – was kann ich tun?
Bitte überprüfen Sie, ob die Adresse korrekt in Anführungszeichen eingegeben wurde, und vergewissern Sie sich anschließend, dass die im Portal Cfx.re angegebene IP-Adresse die Ihres Servers ist. Falls Sie den Rechner gewechselt haben, aktualisieren Sie bitte die Adresse oder erstellen Sie einen neuen Schlüssel.
Wie lässt sich feststellen, welche Ressource den Start verhindert?
Beginnen Sie mit einer minimalen „server.cfg“-Datei, ohne hinzugefügte Ressourcen. Wenn der Server startet, aktivieren Sie Ihre Ressourcen schrittweise wieder – jeweils die Hälfte: Nach drei oder vier Neustarts können Sie die fehlerhafte Ressource isolieren.
Mein Server startet zwar, erscheint aber nicht in der öffentlichen Liste – warum?
Bitte stellen Sie sicher, dass der Port von außen erreichbar ist, dass „sv_master1“ in Ihrer Konfiguration nicht deaktiviert wurde, und warten Sie nach dem Start einige Minuten ab. Ihre Spieler können sich in der Zwischenzeit direkt mit dem Befehl „connect“, gefolgt von der Adresse und dem Port, verbinden.










