FiveM sunucusu nasıl kurulur? Adım adım rehber
Bu rehber sıfırdan çalışan bir FiveM sunucusu kurar: işletim sistemi seçiminden veritabanına, port açmaktan ilk açılışta en sık yapılan hatalara kadar. Framework olarak ESX veya QBCore varsayılmıştır, çünkü Türkçe roleplay sunucularının neredeyse tamamı bu ikisinden birini kullanıyor.
Başlamadan önce: neye ihtiyacınız var?
- Bir sunucu. FiveM ana işini tek çekirdekte yaptığı için önemli olan çekirdek sayısı değil çekirdek başına performanstır. 64 slotluk bir roleplay sunucusu için 8 GB RAM / 4 vCPU / 60 GB NVMe pratik tabandır. Hesabın nasıl kurulduğunu ayrıca yazdık: kaç vCPU ve kaç GB RAM gerekir?
- Bir keymaster lisans anahtarı.
keymaster.fivem.netüzerinden ücretsiz alınır ve sunucunun IP adresine bağlanır. - Framework dosyaları. ESX veya QBCore sürümü ve ona ait veritabanı dökümü.
1. İşletim sistemi
Ubuntu 22.04 LTS veya Debian 12 seçin. CitizenFX'in resmi Linux artifact'ları bu dağıtımlarla test ediliyor; başka bir dağıtımda kütüphane sürümü uyuşmazlıkları vakit kaybettirir.
Windows da mümkündür ama Linux'ta aynı donanımdan daha fazla verim alırsınız ve artifact güncellemeleri daha sorunsuz ilerler.
2. txAdmin ile FXServer kurulumu
FXServer'ı elle kurmak yerine txAdmin kullanın. txAdmin artifact yönetimi, otomatik yeniden başlatma, yedek ve canlı konsolu bir arada verir; elle kurulumda bunların hepsini kendiniz kurmanız gerekir.
Kurulum sırası:
- Artifact'ı indirip çıkarın (
fx.tar.xz). run.shile başlatın; txAdmin ilk açılışta bir kurulum bağlantısı ve tek kullanımlık PIN yazdırır.- Tarayıcıdan bu bağlantıya gidip yönetici hesabını oluşturun.
- Recipe adımında ESX veya QBCore şablonunu seçin; txAdmin sunucu dosyalarını ve veritabanı şemasını kendisi indirir.
- Keymaster anahtarınızı
sv_licenseKeyalanına girin.
3. Veritabanı
MariaDB'yi aynı makinede kurun. Ayrı sunucu, ancak 200+ eşzamanlı oyuncuya çıktığınızda anlamlı olur; öncesinde ağ gecikmesi yerel soketten daha kötü sonuç verir.
apt install mariadb-server
mysql_secure_installationArdından framework'ün veritabanı dökümünü içe aktarın ve bağlantı dizesini server.cfg içine yazın:
set mysql_connection_string "mysql://kullanici:parola@localhost/veritabani?charset=utf8mb4"`utf8mb4` karakter setini atlamayın. Türkçe karakterler ve emoji utf8 ile bozulur; sonradan düzeltmek tüm tabloları dönüştürmek demektir.
4. Portlar
FiveM tek port üzerinden çalışır ama hem TCP hem UDP gerekir:
| Port | Protokol | Ne için |
|---|---|---|
| 30120 | TCP + UDP | Oyun trafiği ve sunucu listesi |
| 40120 | TCP | txAdmin paneli (yalnızca kendi IP'nize açın) |
txAdmin portunu herkese açmak yaygın ve ciddi bir hatadır — o panel sunucunuzun tam yönetimidir. Güvenlik duvarında yalnızca kendi IP adresinize izin verin.
Datafex kullanıyorsanız port yönetimi ve ek IP talepleri müşteri panelinden yapılır.
5. Kaynakların yükleme sırası
server.cfg içinde ensure satırlarının sırası önemlidir. Framework çekirdeği, sonra veritabanı katmanı, sonra bağımlı kaynaklar:
ensure oxmysql
ensure es_extended # veya qb-core
ensure [framework kaynaklari]
ensure [ozel kaynaklarınız]Sıra bozulduğunda konsolda "resource not found" veya boş bir hata yığını görürsünüz; kaynak aslında var, henüz yüklenmemiştir.
İlk açılışta en sık yapılan altı hata
- `sv_licenseKey` boş veya başka IP'ye bağlı. Sunucu açılır ama listede görünmez.
- `utf8mb4` yerine `utf8`. Türkçe karakterler soru işaretine döner.
- 30120 yalnızca TCP açık. Oyuncular listede görür, bağlanamaz.
- Stream klasörü çok büyük ve yükleme sırası sabitlenmemiş. İlk açılış varlık indeksleme yüzünden dakikalarca sürebilir; yarıda kesmeyin.
- txAdmin portu herkese açık. Panel dışarıdan erişilebilir olduğu anda sunucunuz size ait değildir.
- Yedek kurulmamış. Veritabanı roleplay sunucusunun tamamıdır; oyuncu ilerlemesi bozulduğunda geri dönüş tek yoldur.
DDoS tarafı
FiveM sunucuları 30120 UDP üzerinde taşma saldırılarına sık maruz kalır ve UDP'de kaynak adresi sahte olabildiği için bunu uygulama seviyesinde çözmek mümkün değildir; ağ seviyesinde filtrelenmesi gerekir. Konuyu ayrıca yazdık: DDoS koruması nedir?
Datafex sunucularında Fexwall L3/L4 filtreleme tüm paketlerde ücretsiz dahildir.
Sonraki adım
Oyuncu sayısına göre hangi paketin yeterli olduğunu, işlemci seçeneklerini ve FiveM'e özgü 12 soruluk SSS'i tek sayfada topladık: FiveM sunucu paketleri.