راه‌اندازی سرور FiveM: گام به گام با txAdmin روی VPS لینوکس (Ubuntu 24.04)

FiveM یک پلتفرم چندنفره است که برای GTA V ساخته شده و در ترکیه به‌ویژه با سرورهای رول‌پلی (RP) بسیار محبوب است. وقتی سرور FiveM خودتان را راه‌اندازی می‌کنید، همه چیز را از نقشه و خودروها گرفته تا شغل‌ها و اقتصاد خودتان تعیین می‌کنید. راه‌اندازی سرور روی رایانه خانگی ممکن است، اما با خاموش شدن رایانه سرور هم خاموش می‌شود و سرعت آپلود اینترنت خانگی تعداد بازیکنان را محدود می‌کند. در مقابل، یک VPS یا VDS لینوکسی شبانه‌روز روشن می‌ماند و یک آدرس IP ثابت دارد.

در این راهنما سرور FiveM را با txAdmin روی Ubuntu 24.04 راه‌اندازی می‌کنیم. txAdmin یک پنل مدیریت تحت وب است که همراه فایل‌های سرور FiveM ارائه می‌شود؛ روشن و خاموش کردن سرور، مدیریت بازیکنان، پشتیبان‌گیری و نصب زیرساخت‌هایی مانند ESX یا QBCore را با «دستورالعمل‌های» آماده (recipe) آسان می‌کند.

پیش از شروع: به یک حساب Cfx.re و یک کلید لایسنس سرور نیاز دارید که آن را در portal.cfx.re می‌سازید. این کلید رایگان است؛ کافی است با حساب خود وارد شوید و برای سرورتان یک کلید بسازید. باید شرایط استفاده FiveM و Rockstar Games را رعایت کنید.

چه مقدار منابع لازم است؟

نیاز سرور بسته به زیرساختی که نصب می‌کنید و تعداد افزونه‌ها (resource) تفاوت زیادی دارد. به طور تقریبی:

• سرور خالی یا سبک، با بازیکنان کم: ۲ vCPU و ۴ گیگابایت RAM.
• سرور RP مبتنی بر ESX/QBCore در مقیاس متوسط: ۲ تا ۴ vCPU و ۸ گیگابایت RAM.
• افزونه‌های زیاد و بازیکنان پرشمار: RAM بیشتر و کارایی تک‌هسته بالا.

سرورهای FiveM دائماً از پردازنده استفاده می‌کنند و به تأخیر حساس‌اند. به همین دلیل، سروری که پردازنده‌اش به شما اختصاص داده شده نتیجه پایدارتری از یک VPS با پردازنده اشتراکی می‌دهد. دیسک NVMe را انتخاب کنید؛ کوئری‌های پایگاه داده و بارگذاری افزونه‌ها سریع‌تر می‌شوند.

۱. سرور را آماده کنید

با SSH به سرور متصل شوید و سیستم را به‌روز کنید:

sudo apt update && sudo apt upgrade -y
sudo apt install -y xz-utils wget tmux

اجرای سرور FiveM با root امن نیست. یک کاربر جداگانه بسازید:

sudo adduser --disabled-password --gecos "" fivem

۲. پایگاه داده را نصب کنید (برای ESX/QBCore)

زیرساخت‌هایی مانند ESX و QBCore داده‌های بازیکنان را در یک پایگاه داده MySQL/MariaDB نگه می‌دارند. اگر سرور خالی راه‌اندازی می‌کنید، می‌توانید این مرحله را رد کنید.

sudo apt install -y mariadb-server
sudo mariadb

در خط فرمان MariaDB که باز می‌شود، یک پایگاه داده و یک کاربر بسازید. رمز را با رمز قوی خودتان جایگزین کنید:

CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'GucluBirSifre123!';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

MariaDB به طور پیش‌فرض فقط از خود سرور (localhost) اتصال می‌پذیرد؛ نیازی نیست آن را به بیرون باز کنید.

۳. فایل‌های سرور FiveM را دانلود کنید

فایل‌های سرور لینوکسی FiveM (artifacts) در این نشانی منتشر می‌شوند: https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/. صفحه را در مرورگر باز کنید، روی دکمه LATEST RECOMMENDED راست‌کلیک کنید و پیوند را کپی کنید. این پیوند به fx.tar.xz ختم می‌شود و شماره نسخه را در خود دارد.

حالا به کاربر fivem بروید و فایل‌ها را دانلود کنید. در دستور زیر، نشانی داخل گیومه (KOPYALADIGINIZ_BAGLANTI) را با پیوندی که کپی کرده‌اید جایگزین کنید:

sudo -iu fivem
mkdir -p ~/server && cd ~/server
wget -O fx.tar.xz "KOPYALADIGINIZ_BAGLANTI"
tar xf fx.tar.xz
rm fx.tar.xz

در پوشه باید فایل run.sh و پوشه alpine ساخته شده باشند. با نوشتن exit به کاربر خودتان برگردید.

۴. فایروال را تنظیم کنید

FiveM برای اتصال بازیکنان از پورت 30120 به صورت TCP و UDP استفاده می‌کند. پنل txAdmin به طور پیش‌فرض روی پورت 40120/TCP اجرا می‌شود. به جای باز کردن پنل برای همه، امن‌تر است که آن را فقط برای آدرس IP خودتان باز کنید:

sudo ufw allow OpenSSH
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from SIZIN_IP_ADRESINIZ to any port 40120 proto tcp
sudo ufw enable

اگر IP خانگی شما تغییر می‌کند، می‌توانید پورت txAdmin را موقتاً برای همه باز کنید (sudo ufw allow 40120/tcp) و پس از راه‌اندازی آن را ببندید. برای اطلاعات بیشتر درباره UFW، مقاله دستورهای مدیریت سرور را ببینید.

۵. راه‌اندازی اولیه با txAdmin

اجرای نخست را در یک نشست tmux انجام می‌دهیم تا اگر اتصال SSH قطع شد، سرور همچنان اجرا شود:

sudo -iu fivem
tmux new -s fivem
cd ~/server && ./run.sh

پس از چند ثانیه، نشانی txAdmin و یک کد PIN چهاررقمی در ترمینال نمایش داده می‌شود. نشانی http://SUNUCU_IP:40120 را در مرورگر باز کنید و:

1. کد PIN را وارد کنید، با حساب Cfx.re خود وارد شوید و یک رمز مدیر تعیین کنید.
2. در جادوگر راه‌اندازی برای سرورتان یک نام انتخاب کنید.
3. از بخش Popular Recipes یک زیرساخت انتخاب کنید. برای سرور خالی می‌توانید «CFX Default» و برای RP یکی از دستورالعمل‌های ESX یا QBCore را انتخاب کنید.
4. کلید لایسنس خود را وارد کنید. اگر ESX یا QBCore را انتخاب کرده‌اید، در مرحله پایگاه داده کاربر fivem را که در مرحله ۲ ساختید، رمز آن و نام پایگاه داده fivem را وارد کنید.
5. پس از پایان نصب دستورالعمل، سرور را با Save & Run Server اجرا کنید.

برای خروج از نشست tmux، کلیدهای Ctrl+B را فشار دهید و رها کنید، سپس D را بزنید. سرور در پس‌زمینه به کار خود ادامه می‌دهد. برای بازگشت، tmux attach -t fivem را بنویسید.

برای اتصال به بازی، در کلاینت FiveM با F8 کنسول را باز کنید و connect SUNUCU_IP:30120 را بنویسید.

۶. با سرویس systemd آن را دائمی کنید

tmux برای آزمایش کافی است، اما اگر می‌خواهید FiveM پس از راه‌اندازی مجدد سرور به طور خودکار اجرا شود، یک سرویس systemd بسازید. ابتدا سرور داخل tmux را متوقف کنید (tmux attach -t fivem و سپس Ctrl+C)، بعد با کاربر خودتان:

sudo nano /etc/systemd/system/fivem.service

این محتوا را در فایل بنویسید:

[Unit]
Description=FiveM sunucusu (txAdmin)
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
User=fivem
WorkingDirectory=/home/fivem/server
ExecStart=/home/fivem/server/run.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

سرویس را فعال و اجرا کنید:

sudo systemctl daemon-reload
sudo systemctl enable --now fivem
sudo systemctl status fivem

برای دنبال کردن لاگ‌ها می‌توانید از دستور sudo journalctl -u fivem -f استفاده کنید. از این به بعد می‌توانید سرور را از پنل txAdmin مدیریت کنید.

۷. پشتیبان‌گیری و به‌روزرسانی

txAdmin داده‌ها و تنظیمات سرور را در پوشه txData نگه می‌دارد و پایگاه داده هم در MariaDB است. از هر دو به طور منظم پشتیبان بگیرید:

sudo mariadb-dump fivem > /root/fivem-db-$(date +%F).sql
sudo tar czf /root/fivem-files-$(date +%F).tar.gz -C /home/fivem server/txData

پشتیبان‌ها را فقط روی همان سرور نگه ندارید؛ با rsync آن‌ها را به جای دیگری کپی کنید. برای به‌روزرسانی فایل‌های سرور، FiveM را متوقف کنید، فایل artifact جدید را مانند مرحله ۳ دانلود کنید و در همان پوشه از حالت فشرده خارج کنید، سپس سرویس را دوباره اجرا کنید. پیش از به‌روزرسانی حتماً پشتیبان بگیرید.

اشتباهات رایج

• استفاده از افزونه‌های «لو رفته» (leak): نسخه‌هایی از افزونه‌های پولی که بدون مجوز پخش شده‌اند، اغلب درِ پشتی (backdoor) دارند و ممکن است به تصرف سرور شما منجر شوند. افزونه‌ها را فقط از منابع معتبر تهیه کنید.
• باز گذاشتن پورت txAdmin برای همه: این پنل کنترل کامل سرور را در اختیار می‌گذارد. از رمز قوی استفاده کنید و در صورت امکان پورت را فقط برای IP خودتان باز کنید.
• اجرا با root: یک آسیب‌پذیری در یک افزونه کل سرور را به خطر می‌اندازد. از کاربر جداگانه استفاده کنید.

برای امن کردن کلی سرور، مراحل راهنمای امنیت سرور لینوکس را هم انجام دهید.

سرورهای بازی TürkiyeVPS برای FiveM

پکیج‌های سرور بازی ما با vCPU اختصاصی روی Intel Core i5-10400F، رم تضمینی و ۱ آدرس IPv4 اختصاصی ارائه می‌شوند؛ چون دسترسی root دارید، می‌توانید مراحل این راهنما را مستقیماً اجرا کنید. برای یک سرور RP در مقیاس متوسط، پکیج‌های دارای ۸ گیگابایت RAM شروع خوبی هستند. سرورها در استانبول قرار دارند و تأخیر برای بازیکنان داخل ترکیه پایین است. تأثیر موقعیت سرور را در مقاله VPS با لوکیشن ترکیه توضیح داده‌ایم.

سوالات متداول

آیا راه‌اندازی سرور FiveM هزینه دارد؟

نرم‌افزار سرور FiveM و کلید لایسنس استاندارد رایگان هستند. هزینه‌های شما اجاره سرور و افزونه‌های پولی‌ای است که می‌خواهید استفاده کنید. سقف تعداد بازیکنان و قابلیت‌های اضافی به نوع لایسنس شما بستگی دارد؛ شرایط فعلی را در پورتال Cfx.re بررسی کنید.

سرور FiveM چند گیگابایت RAM لازم دارد؟

یک سرور سبک با ۴ گیگابایت RAM کار می‌کند. برای سرور RP مبتنی بر ESX یا QBCore با افزونه‌های زیاد، ۸ گیگابایت یا بیشتر توصیه می‌شود. با زیر نظر گرفتن مصرف در پنل txAdmin و با htop تصمیم بگیرید.

سرور FiveM روی ویندوز یا لینوکس؟

هر دو پشتیبانی می‌شوند. سرورهای لینوکسی منابع کمتری مصرف می‌کنند و برای کار طولانی‌مدت بدون وقفه مناسب‌اند. مراحل این راهنما برای Ubuntu 24.04 است.

اگر بازیکنان نتوانند به سرور وصل شوند چه کنم؟

ابتدا با sudo ufw status بررسی کنید که پورت‌های 30120 TCP و UDP باز باشند. سپس در کنسول txAdmin ببینید خطای کلید لایسنس وجود دارد یا نه. مطمئن شوید که کلید در پورتال معتبر نمایش داده می‌شود و با اطلاعات درست سرور ساخته شده است.