Hướng dẫn này trình bày các giải pháp cho những sự cố máy chủ FiveM phổ biến nhất — vấn đề truy cập TXAdmin, lỗi khóa giấy phép CFX, lỗi kết nối cơ sở dữ liệu, sập máy chủ, vấn đề kết nối của người chơi và tài nguyên không tải được. Để thiết lập máy chủ ban đầu, xem Hướng dẫn Thiết lập Máy chủ FiveM.

TXAdmin Không Tải Được hoặc Không Truy Cập Được

• Xác minh rằng máy chủ đang chạy trong GPanel — TXAdmin chỉ khởi động khi tiến trình máy chủ FiveM đang hoạt động.
• Kiểm tra console của GPanel để biết URL và port của TXAdmin. Port của TXAdmin khác với port của trò chơi.
• Đảm bảo bạn đang sử dụng http:// chứ không phải https:// — TXAdmin không sử dụng SSL theo mặc định.
• Nếu TXAdmin trước đây hoạt động nhưng nay ngừng tải, hãy thử khởi động lại máy chủ từ GPanel.
• Xóa bộ nhớ đệm trình duyệt hoặc thử mở cửa sổ ẩn danh/riêng tư.

Lỗi Khóa Giấy Phép CFX

Lỗi Kết Nối Cơ Sở Dữ Liệu

Các bước khắc phục sự cố cơ sở dữ liệu bổ sung:

• Nếu sử dụng oxmysql, hãy đảm bảo bạn có tài nguyên oxmysql trong thư mục resources/ và rằng ensure oxmysql xuất hiện trong server.cfg trước bất kỳ tài nguyên nào cần cơ sở dữ liệu.
• Nếu mật khẩu của bạn chứa các ký tự đặc biệt như @, # hoặc %, hãy mã hóa URL chúng trong chuỗi kết nối (ví dụ: @ trở thành %40).
• Kiểm tra chuỗi kết nối của bạn xem có ký tự thiếu hoặc thừa không — chỉ một ký tự đặt sai chỗ cũng sẽ gây ra lỗi.

Máy Chủ Sập Khi Khởi Động

• Kiểm tra console của GPanel để tìm thông báo lỗi. Các nguyên nhân phổ biến bao gồm server.cfg bị thiếu hoặc cấu hình sai, khóa giấy phép CFX không hợp lệ, hoặc một tài nguyên bị hỏng.
• Thử vô hiệu hóa các tài nguyên tùy chỉnh bằng cách chú thích chúng trong server.cfg (thêm # trước mỗi dòng ensure) rồi khởi động lại. Thêm lại từng cái một để xác định tài nguyên gây ra vấn đề.
• Đảm bảo các port trong endpoint_add_tcp và endpoint_add_udp khớp với port được GPanel chỉ định cho bạn.

# 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

Người Chơi Không Thể Kết Nối

• Xác nhận máy chủ hiển thị Running trong GPanel.
• Xác minh IP và port — người chơi nên sử dụng port trò chơi, không phải port TXAdmin.
• Kiểm tra rằng sv_maxclients không được đặt thành 0 hoặc một con số thấp bất hợp lý.
• Nếu sử dụng mật khẩu máy chủ (sv_password trong server.cfg), hãy đảm bảo người chơi biết mật khẩu đó.
• Người chơi phải cài đặt client FiveM — họ không thể kết nối bằng trình khởi chạy GTA V thông thường.
• Kiểm tra tab Network trong GPanel và xác nhận các port trong endpoint_add_tcp và endpoint_add_udp khớp với nhau. Sự không khớp sẽ ngăn cản kết nối.

Tài Nguyên Không Tải Được

• Kiểm tra rằng thư mục tài nguyên nằm bên trong thư mục resources/ (hoặc một thư mục con phù hợp).
• Xác minh tên thư mục khớp chính xác với dòng ensure trong server.cfg (phân biệt chữ hoa chữ thường).
• Mỗi tài nguyên phải chứa một fxmanifest.lua hợp lệ (hoặc __resource.lua cũ hơn). Nếu thiếu tệp này, tài nguyên sẽ không tải được.
• Kiểm tra console của TXAdmin hoặc GPanel để tìm thông báo lỗi liên quan đến tài nguyên. Các lỗi phổ biến bao gồm thiếu phụ thuộc hoặc lỗi cú pháp Lua.
• Nếu tài nguyên yêu cầu một framework (ESX, QBCore), hãy đảm bảo framework được tải trước tài nguyên đó trong server.cfg.
• Nếu tài nguyên yêu cầu cơ sở dữ liệu, hãy đảm bảo tài nguyên MySQL của bạn (oxmysql, mysql-async) được tải và kết nối cơ sở dữ liệu đang hoạt động.

Vấn Đề Hiệu Suất Máy Chủ

• Mở TXAdmin và kiểm tra Dashboard để biết các chỉ số hiệu suất (thời gian tick, số người chơi, mức sử dụng bộ nhớ).
• Một máy chủ FiveM lành mạnh nên duy trì thời gian tick của máy chủ (còn gọi là "hitch") dưới 20ms. Các đỉnh tăng đột biến liên tục vượt quá mức này cho thấy một tài nguyên đang sử dụng quá nhiều thời gian xử lý.
• Sử dụng trang Resources của TXAdmin để xác định tài nguyên nào đang tiêu tốn nhiều thời gian máy chủ nhất.
• Xóa hoặc thay thế các tài nguyên được tối ưu hóa kém. Các tài nguyên miễn phí từ những nguồn không rõ ràng thường là nguyên nhân của các vấn đề hiệu suất.
• Giảm số lượng tài nguyên được tải nếu giới hạn bộ nhớ hoặc CPU của gói máy chủ của bạn đang bị chạm đến.

Nhận Trợ Giúp

Nếu bạn đã thử các giải pháp trên mà vẫn gặp sự cố:

1. Sao chép thông báo lỗi đầy đủ từ console của GPanel hoặc nhật ký TXAdmin.
2. Ghi lại những bước khắc phục sự cố mà bạn đã thử.
3. Mở một ticket hỗ trợ tại https://legionhosting.net/submitticket.php kèm theo thông tin này. Đội ngũ của chúng tôi sẽ hỗ trợ bạn nhanh nhất có thể.

Bài Viết Liên Quan

• Hướng dẫn Thiết lập Máy chủ FiveM
• Thiết lập Tài nguyên, Script và Cơ sở dữ liệu FiveM
• Cách Tìm IP và Port Máy chủ của Bạn
• Hướng dẫn Khởi động Máy chủ