Αυτός ο οδηγός καλύπτει λύσεις για τα πιο συνηθισμένα προβλήματα διακομιστή FiveM — προβλήματα πρόσβασης στο TXAdmin, σφάλματα κλειδιού άδειας CFX, αποτυχίες σύνδεσης βάσης δεδομένων, κρασαρίσματα διακομιστή, προβλήματα σύνδεσης παικτών και resources που δεν φορτώνουν. Για την αρχική ρύθμιση του διακομιστή, δείτε τον Οδηγό Ρύθμισης Διακομιστή FiveM.
Γενική συμβουλή αντιμετώπισης προβλημάτων: Πάντα να ελέγχετε πρώτα την έξοδο της κονσόλας στο GPanel και τα logs του TXAdmin. Τα περισσότερα σφάλματα παράγουν ένα σαφές μήνυμα που υποδεικνύει την αιτία.
Το TXAdmin Δεν Φορτώνει ή Είναι Μη Προσβάσιμο
- Επιβεβαιώστε ότι ο διακομιστής εκτελείται στο GPanel — το TXAdmin ξεκινάει μόνο όταν η διεργασία του διακομιστή FiveM είναι ενεργή.
- Ελέγξτε την κονσόλα του GPanel για το URL και το port του TXAdmin. Το port του TXAdmin είναι διαφορετικό από το port του παιχνιδιού.
- Βεβαιωθείτε ότι χρησιμοποιείτε
http://και όχιhttps://— το TXAdmin δεν χρησιμοποιεί SSL από προεπιλογή. - Εάν το TXAdmin λειτουργούσε προηγουμένως αλλά σταματά να φορτώνει, δοκιμάστε να επανεκκινήσετε τον διακομιστή από το GPanel.
- Καθαρίστε την cache του προγράμματος περιήγησής σας ή δοκιμάστε ένα incognito/private παράθυρο.
Χάσατε τον κωδικό πρόσβασης του TXAdmin; Εάν δεν μπορείτε να συνδεθείτε, ίσως χρειαστεί να διαγράψετε τα δεδομένα προφίλ του TXAdmin και να εκτελέσετε ξανά τον οδηγό ρύθμισης. Ελέγξτε την καρτέλα Files του GPanel για τον κατάλογο δεδομένων του TXAdmin και αφαιρέστε τα αρχεία προφίλ του, στη συνέχεια επανεκκινήστε τον διακομιστή.
Σφάλματα Κλειδιού Άδειας CFX
| Μήνυμα Σφάλματος | Αιτία | Λύση |
|---|---|---|
Invalid license key |
Το κλειδί αντιγράφηκε λανθασμένα ή υπάρχουν επιπλέον κενά | Μεταβείτε στο Keymaster, επιβεβαιώστε ότι το κλειδί είναι ενεργό και αντιγράψτε το ξανά προσεκτικά. Επικολλήστε το τόσο στη μεταβλητή Startup του GPanel όσο και στο sv_licenseKey στο server.cfg. |
License key already in use |
Το κλειδί είναι καταχωρημένο σε διαφορετική IP διακομιστή | Κάθε κλειδί μπορεί να χρησιμοποιηθεί μόνο σε έναν διακομιστή κάθε φορά. Ανακαλέστε το παλιό κλειδί στο Keymaster και δημιουργήστε ένα νέο με την τρέχουσα IP του διακομιστή σας. |
Unable to verify license key |
Οι διακομιστές ταυτοποίησης του Cfx.re είναι προσωρινά μη διαθέσιμοι | Περιμένετε λίγα λεπτά και επανεκκινήστε τον διακομιστή. Ελέγξτε το status.cfx.re για διακοπές λειτουργίας. |
Συμβουλή: Βεβαιωθείτε ότι το κλειδί έχει οριστεί τόσο στη μεταβλητή Startup του GPanel όσο και στο
server.cfg (sv_licenseKey). Ανάλογα με τη διαμόρφωσή σας, ο διακομιστής μπορεί να διαβάζει από το ένα ή το άλλο.
Σφάλματα Σύνδεσης Βάσης Δεδομένων
| Μήνυμα Σφάλματος | Αιτία | Λύση |
|---|---|---|
Connection refused ή ETIMEDOUT |
Λάθος host ή port βάσης δεδομένων | Ελέγξτε ξανά τη διεύθυνση host και το port της βάσης δεδομένων από την καρτέλα Databases του GPanel. Μη χρησιμοποιείτε localhost ή 127.0.0.1. |
Access denied |
Λάθος όνομα χρήστη ή κωδικός πρόσβασης | Αντιγράψτε τα διαπιστευτήρια απευθείας από το GPanel για να αποφύγετε τυπογραφικά λάθη. Οι κωδικοί πρόσβασης διακρίνουν πεζά/κεφαλαία. |
Unknown database |
Το όνομα της βάσης δεδομένων δεν ταιριάζει | Βεβαιωθείτε ότι το όνομα της βάσης δεδομένων στη συμβολοσειρά σύνδεσής σας ταιριάζει ακριβώς με αυτό που εμφανίζεται στο GPanel. |
Επιπλέον βήματα αντιμετώπισης προβλημάτων βάσης δεδομένων:
- Εάν χρησιμοποιείτε oxmysql, βεβαιωθείτε ότι έχετε το resource
oxmysqlστον φάκελοresources/και ότι τοensure oxmysqlεμφανίζεται στο server.cfg πριν από οποιαδήποτε resources που απαιτούν βάση δεδομένων. - Εάν ο κωδικός πρόσβασής σας περιέχει ειδικούς χαρακτήρες όπως
@,#ή%, κωδικοποιήστε τους ως URL στη συμβολοσειρά σύνδεσης (π.χ. το@γίνεται%40). - Ελέγξτε τη συμβολοσειρά σύνδεσής σας για χαρακτήρες που λείπουν ή είναι περιττοί — ακόμα και ένας λανθασμένα τοποθετημένος χαρακτήρας θα προκαλέσει αποτυχία.
Μη χρησιμοποιείτε localhost. Ο διακομιστής βάσης δεδομένων είναι ξεχωριστός από τον διακομιστή του παιχνιδιού. Πάντα να χρησιμοποιείτε την πλήρη διεύθυνση host που εμφανίζεται στην καρτέλα Databases του GPanel.
Ο Διακομιστής Κρασάρει κατά την Εκκίνηση
- Ελέγξτε την κονσόλα του GPanel για μηνύματα σφάλματος. Οι συνηθισμένες αιτίες περιλαμβάνουν ένα
server.cfgπου λείπει ή είναι κακώς διαμορφωμένο, ένα μη έγκυρο κλειδί άδειας CFX, ή ένα χαλασμένο resource. - Δοκιμάστε να απενεργοποιήσετε τα custom resources σχολιάζοντάς τα στο server.cfg (προσθέστε
#πριν από κάθε γραμμήensure) και επανεκκινήστε. Προσθέστε τα ξανά ένα προς ένα για να εντοπίσετε το προβληματικό resource. - Βεβαιωθείτε ότι τα ports στα
endpoint_add_tcpκαιendpoint_add_udpταιριάζουν με το port που σας έχει ανατεθεί από το GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Δυαδική αναζήτηση για προβληματικά resources: Εάν έχετε πολλά resources, σχολιάστε τα μισά κάθε φορά αντί για ένα προς ένα. Αυτό περιορίζει το πρόβλημα πολύ πιο γρήγορα.
Οι Παίκτες Δεν Μπορούν να Συνδεθούν
- Επιβεβαιώστε ότι ο διακομιστής εμφανίζει Running στο GPanel.
- Επαληθεύστε την IP και το port — οι παίκτες θα πρέπει να χρησιμοποιούν το port του παιχνιδιού, όχι το port του TXAdmin.
- Ελέγξτε ότι το
sv_maxclientsδεν έχει οριστεί σε 0 ή σε έναν παράλογα χαμηλό αριθμό. - Εάν χρησιμοποιείτε κωδικό πρόσβασης διακομιστή (
sv_passwordστο server.cfg), βεβαιωθείτε ότι οι παίκτες τον γνωρίζουν. - Οι παίκτες πρέπει να έχουν εγκατεστημένο τον FiveM client — δεν μπορούν να συνδεθούν χρησιμοποιώντας τον κανονικό launcher του GTA V.
- Ελέγξτε την καρτέλα Network του GPanel και επιβεβαιώστε ότι τα ports στα
endpoint_add_tcpκαιendpoint_add_udpταιριάζουν. Μια αναντιστοιχία θα εμποδίσει τις συνδέσεις.
Ο διακομιστής δεν εμφανίζεται στον browser; Οι νέοι διακομιστές μπορεί να χρειαστούν 5-15 λεπτά για να εμφανιστούν στη λίστα διακομιστών του FiveM. Χρησιμοποιήστε άμεση σύνδεση (
IP:PORT) στο μεταξύ. Επίσης, επαληθεύστε ότι το sv_licenseKey σας είναι έγκυρο.
Τα Resources Δεν Φορτώνουν
- Ελέγξτε ότι ο φάκελος του resource βρίσκεται μέσα στον κατάλογο
resources/(ή σε έναν κατάλληλο υποφάκελο). - Επαληθεύστε ότι το όνομα του φακέλου ταιριάζει ακριβώς με τη γραμμή
ensureστο server.cfg (διακρίνει πεζά/κεφαλαία). - Κάθε resource πρέπει να περιέχει ένα έγκυρο
fxmanifest.lua(ή το παλαιότερο__resource.lua). Εάν αυτό το αρχείο λείπει, το resource δεν θα φορτώσει. - Ελέγξτε την κονσόλα του TXAdmin ή του GPanel για μηνύματα σφάλματος που σχετίζονται με το resource. Τα συνηθισμένα σφάλματα περιλαμβάνουν εξαρτήσεις που λείπουν ή σφάλματα σύνταξης Lua.
- Εάν το resource απαιτεί ένα framework (ESX, QBCore), βεβαιωθείτε ότι το framework φορτώνεται πριν από το resource στο server.cfg.
- Εάν το resource απαιτεί βάση δεδομένων, βεβαιωθείτε ότι το MySQL resource σας (oxmysql, mysql-async) φορτώνεται και ότι η σύνδεση με τη βάση δεδομένων λειτουργεί.
Ελέγξτε τη δομή των φακέλων. Ένα συνηθισμένο λάθος είναι το ανέβασμα ενός resource και η κατάληξη σε έναν διπλά εμφωλευμένο φάκελο όπως
resources/my-resource/my-resource/fxmanifest.lua. Το manifest πρέπει να βρίσκεται απευθείας μέσα στον φάκελο του resource: resources/my-resource/fxmanifest.lua.
Προβλήματα Απόδοσης Διακομιστή
- Ανοίξτε το TXAdmin και ελέγξτε το Dashboard για μετρήσεις απόδοσης (χρόνος tick, αριθμός παικτών, χρήση μνήμης).
- Ένας υγιής διακομιστής FiveM θα πρέπει να διατηρεί έναν χρόνο tick διακομιστή (γνωστό και ως "hitch") κάτω από 20ms. Οι σταθερές κορυφώσεις πάνω από αυτό υποδεικνύουν ότι ένα resource χρησιμοποιεί υπερβολικό χρόνο επεξεργασίας.
- Χρησιμοποιήστε τη σελίδα Resources του TXAdmin για να εντοπίσετε ποια resources καταναλώνουν τον περισσότερο χρόνο διακομιστή.
- Αφαιρέστε ή αντικαταστήστε κακώς βελτιστοποιημένα resources. Τα δωρεάν resources από άγνωστες πηγές είναι συχνά η αιτία προβλημάτων απόδοσης.
- Μειώστε τον αριθμό των φορτωμένων resources εάν προσεγγίζονται τα όρια μνήμης ή CPU του πλάνου του διακομιστή σας.
Λήψη Βοήθειας
Εάν έχετε δοκιμάσει τις παραπάνω λύσεις και εξακολουθείτε να αντιμετωπίζετε προβλήματα:
- Αντιγράψτε το πλήρες μήνυμα σφάλματος από την κονσόλα του GPanel ή το log του TXAdmin.
- Σημειώστε ποια βήματα αντιμετώπισης προβλημάτων έχετε ήδη δοκιμάσει.
- Ανοίξτε ένα ticket υποστήριξης στο https://legionhosting.net/submitticket.php με αυτές τις πληροφορίες. Η ομάδα μας θα σας βοηθήσει το συντομότερο δυνατό.