این راهنما راهحلهای رایجترین مشکلات سرور FiveM را پوشش میدهد — مشکلات دسترسی TXAdmin، خطاهای کلید لایسنس CFX، خطاهای اتصال دیتابیس، کرش سرور، مشکلات اتصال بازیکنان و بارگذاری نشدن ریسورسها. برای راهاندازی اولیه سرور، راهنمای راهاندازی سرور FiveM را ببینید.
نکته کلی عیبیابی: همیشه ابتدا خروجی کنسول GPanel و لاگهای TXAdmin را بررسی کنید. اکثر خطاها پیام واضحی تولید میکنند که به علت مشکل اشاره دارد.
TXAdmin بارگذاری نمیشود یا قابل دسترسی نیست
- بررسی کنید سرور در GPanel در حال اجرا باشد — TXAdmin فقط وقتی فرآیند سرور FiveM فعال باشد شروع به کار میکند.
- کنسول GPanel را برای آدرس و پورت TXAdmin بررسی کنید. پورت TXAdmin با پورت بازی متفاوت است.
- مطمئن شوید که از
http://استفاده میکنید نهhttps://— TXAdmin به طور پیشفرض از SSL استفاده نمیکند. - اگر TXAdmin قبلاً کار میکرد اما دیگر بارگذاری نمیشود، سرور را از GPanel ریستارت کنید.
- کش مرورگر خود را پاک کنید یا یک پنجره ناشناس/خصوصی امتحان کنید.
رمز عبور 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 |
آدرس یا پورت دیتابیس اشتباه است | آدرس و پورت دیتابیس را از تب Databases در GPanel دوباره بررسی کنید. از localhost یا 127.0.0.1 استفاده نکنید. |
Access denied |
نام کاربری یا رمز عبور اشتباه است | اطلاعات ورود را مستقیماً از GPanel کپی کنید تا از اشتباهات تایپی جلوگیری شود. رمزهای عبور به بزرگی و کوچکی حروف حساس هستند. |
Unknown database |
نام دیتابیس مطابقت ندارد | مطمئن شوید نام دیتابیس در رشته اتصال دقیقاً با آنچه در GPanel نمایش داده شده مطابقت دارد. |
مراحل عیبیابی اضافی دیتابیس:
- اگر از oxmysql استفاده میکنید، مطمئن شوید ریسورس
oxmysqlدر پوشهresources/شما وجود دارد وensure oxmysqlدر server.cfg قبل از هر ریسورسی که به دیتابیس نیاز دارد ظاهر شده باشد. - اگر رمز عبور شما حاوی کاراکترهای خاص مانند
@،#یا%است، آنها را در رشته اتصال URL-encode کنید (مثلاً@تبدیل به%40میشود). - رشته اتصال خود را برای کاراکترهای جا افتاده یا اضافی بررسی کنید — حتی یک کاراکتر اشتباه باعث شکست میشود.
از localhost استفاده نکنید. سرور دیتابیس جدا از سرور بازی است. همیشه از آدرس کامل که در تب Databases در GPanel نمایش داده شده استفاده کنید.
کرش سرور هنگام راهاندازی
- کنسول GPanel را برای پیامهای خطا بررسی کنید. دلایل رایج شامل
server.cfgناقص یا پیکربندی نادرست، کلید لایسنس CFX نامعتبر یا ریسورس خراب است. - سعی کنید ریسورسهای سفارشی را با کامنت کردن آنها در server.cfg غیرفعال کنید (قبل از هر خط
ensureعلامت#اضافه کنید) و ریستارت نمایید. آنها را یکییکی اضافه کنید تا ریسورس مشکلساز شناسایی شود. - مطمئن شوید پورتها در
endpoint_add_tcpوendpoint_add_udpبا پورت اختصاص داده شده در 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
جستجوی دودویی برای ریسورسهای مشکلدار: اگر ریسورسهای زیادی دارید، به جای یکییکی، نصف آنها را همزمان کامنت کنید. این کار مشکل را بسیار سریعتر محدود میکند.
بازیکنان نمیتوانند متصل شوند
- تأیید کنید سرور در GPanel وضعیت Running را نشان میدهد.
- IP و پورت را بررسی کنید — بازیکنان باید از پورت بازی استفاده کنند، نه پورت TXAdmin.
- بررسی کنید که
sv_maxclientsروی ۰ یا عدد نامعقولی تنظیم نشده باشد. - اگر از رمز عبور سرور استفاده میکنید (
sv_passwordدر server.cfg)، مطمئن شوید بازیکنان آن را میدانند. - بازیکنان باید کلاینت FiveM نصب شده داشته باشند — نمیتوانند با لانچر معمولی GTA V متصل شوند.
- تب Network در GPanel را بررسی کنید و تأیید نمایید که پورتها در
endpoint_add_tcpوendpoint_add_udpمطابقت دارند. عدم تطابق مانع از اتصال میشود.
سرور در مرورگر نمایش داده نمیشود؟ سرورهای جدید ممکن است ۵ تا ۱۵ دقیقه طول بکشد تا در لیست سرور FiveM ظاهر شوند. در این مدت از اتصال مستقیم (
IP:PORT) استفاده کنید. همچنین بررسی کنید که sv_licenseKey معتبر باشد.
ریسورسها بارگذاری نمیشوند
- بررسی کنید پوشه ریسورس داخل پوشه
resources/(یا زیرپوشه مناسب) باشد. - تأیید کنید نام پوشه دقیقاً با خط
ensureدر server.cfg مطابقت دارد (حساس به بزرگی و کوچکی حروف). - هر ریسورس باید حاوی یک فایل
fxmanifest.luaمعتبر (یا__resource.luaقدیمیتر) باشد. اگر این فایل وجود نداشته باشد، ریسورس بارگذاری نخواهد شد. - کنسول TXAdmin یا GPanel را برای پیامهای خطای مربوط به ریسورس بررسی کنید. خطاهای رایج شامل وابستگیهای ناقص یا خطاهای نحوی Lua هستند.
- اگر ریسورس به فریمورکی (ESX، QBCore) نیاز دارد، مطمئن شوید فریمورک قبل از ریسورس در server.cfg بارگذاری شده باشد.
- اگر ریسورس به دیتابیس نیاز دارد، مطمئن شوید ریسورس MySQL شما (oxmysql، mysql-async) بارگذاری شده و اتصال دیتابیس فعال است.
ساختار پوشه را بررسی کنید. یک اشتباه رایج آپلود ریسورسی است که منجر به پوشه تودرتوی دوتایی مانند
resources/my-resource/my-resource/fxmanifest.lua میشود. مانیفست باید مستقیماً داخل پوشه ریسورس باشد: resources/my-resource/fxmanifest.lua.
مشکلات عملکرد سرور
- TXAdmin را باز کنید و Dashboard را برای معیارهای عملکرد (زمان tick، تعداد بازیکنان، مصرف حافظه) بررسی کنید.
- یک سرور FiveM سالم باید زمان tick سرور (که "hitch" نیز نامیده میشود) را زیر ۲۰ میلیثانیه حفظ کند. جهشهای مداوم بالاتر از این نشاندهنده استفاده بیش از حد یک ریسورس از زمان پردازش است.
- از صفحه Resources در TXAdmin برای شناسایی ریسورسهایی که بیشترین زمان سرور را مصرف میکنند استفاده کنید.
- ریسورسهای بهینهسازی نشده را حذف یا جایگزین کنید. ریسورسهای رایگان از منابع ناشناس اغلب عامل مشکلات عملکردی هستند.
- اگر به محدودیتهای حافظه یا CPU پلن سرور خود رسیدهاید، تعداد ریسورسهای بارگذاری شده را کاهش دهید.
دریافت کمک
اگر راهحلهای بالا را امتحان کردهاید و همچنان با مشکل مواجه هستید:
- پیام خطای کامل را از کنسول GPanel یا لاگ TXAdmin کپی کنید.
- یادداشت کنید چه مراحل عیبیابی را قبلاً انجام دادهاید.
- یک تیکت پشتیبانی در https://legionhosting.net/submitticket.php با این اطلاعات ارسال کنید. تیم ما در سریعترین زمان ممکن به شما کمک خواهد کرد.
