FiveM Sunucusu Neden Listede Görünmez? server.cfg ve Port Ayarları

FiveM sunucusu yönetirken en sık karşılaşılan teknik sorunlardan biri, sunucuya F8 konsolu üzerinden doğrudan IP adresi yazılarak sorunsuz girilebilmesi ancak sunucunun FiveM genel sunucu listesinde (server browser) aratıldığında hiçbir şekilde görünmemesidir. Bu durum, FXServer sürecinin yerel olarak çalıştığını fakat Cfx.re ana dizin sunucuları (Master Server) ile kurulan listeleme iletişiminde bir engel olduğunu gösterir.

Doğrudan IP bağlantısı istemci ile sunucu arasında bire bir iletişim kurarken; genel listede yer almak sunucunun dış dünyadan doğrulanabilir olmasına, yapılandırma parametrelerine ve periyodik sinyal akışına bağlıdır. Bu sorunu çözmek için server.cfg ayarları, port yönlendirmeleri, heartbeat çalışma mantığı ve güvenlik duvarı kuralları adım adım denetlenmelidir.

server.cfg yapılandırması: sv_master1 ve lisans anahtarı denetimi

Sunucu listesinde görünmeme problemlerinin en yaygın kaynağı server.cfg dosyasına eklenen hatalı veya güncelliğini yitirmiş değişkenlerdir:

sv_master1 değişkeninin güncel işlevi

Eski FXServer sürümlerinde sv_master1 değişkeni heartbeat sinyalinin gönderileceği hedef sunucu adresini belirlemek amacıyla kullanılıyordu. Güncel FXServer yapısında ise sunucu, başlangıçta heartbeat sinyalini doğrudan varsayılan Cfx.re dizin adresine iletir.

Günümüzde sv_master1 değişkeni yalnızca sunucuyu gizli (private) moda almak amacıyla kullanılır:

# Sunucunun listede görünmesini engeller (gizli sunucu modu):
sv_master1 ""

Yapılandırma dosyanızda yukarıdaki gibi bir satır bulunuyorsa, sunucu istemci arayüzündeki bağlanma butonunu devre dışı bırakır ve genel arama dizininden çıkar. Sunucunuzun herkes tarafından görülebilmesini istiyorsanız bu satırı tamamen silmeli veya satırın başına # işareti koyarak yorum satırına dönüştürmelisiniz:

# Herkese açık listeleme için satırı devre dışı bırakın:
# sv_master1 ""

Lisans anahtarı (sv_licenseKey) doğruluğu

FiveM sunucunuzun açılması ve dizine kaydedilmesi için Keymaster üzerinden oluşturulan geçerli bir lisans anahtarı şarttır:

1. Keymaster paneline giriş yaparak sunucunuza atanan anahtarın aktif olduğunu kontrol edin.
2. Anahtar oluştururken belirttiğiniz IP adresi ile sunucunuzun dış dünyaya açılan statik IP adresinin bire bir örtüştüğünden emin olun.
3. Aynı lisans anahtarını aynı anda iki farklı sunucuda çalıştırmayın. Çift kullanım tespit edildiğinde ana sunucu her iki oturumu da listeden düşürür.

Port bağlama yönergeleri

Sunucunun doğru ağ arayüzünü dinlemesi için server.cfg dosyasında port atamalarının açıkça yapılması gerekir:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Yerel IP adresi yerine 0.0.0.0 kullanılması, sunucunun makinedeki tüm ağ arayüzlerinden gelen 30120 bağlantılarını kabul etmesini sağlar.

Port ve ağ erişilebilirliği: TCP 30120 info.json testi ve UDP yönlendirmesi

FiveM ağ mimarisinde hem TCP hem de UDP protokolleri ayrı ayrı görev yapar. Sunucu listesinin çalışabilmesi için iki protokolün de doğru yapılandırılmış olması gerekir.

info.json ile TCP erişim doğrulaması

Cfx.re tarayıcıları, sunucunuzun aktif olup olmadığını doğrulamak için HTTP üzerinden durum sorgusu gönderir. TCP 30120 portunuzun dış dünyaya açık olup olmadığını kendi bilgisayarınızdan kolayca test edebilirsiniz:

• Web tarayıcınızı açın ve adres çubuğuna http://SUNUCU_IP_ADRESINIZ:30120/info.json yazın.
• Eğer ekranda sunucu adınız, yüklü kaynaklarınız ve oyun yapısı bilgilerini içeren bir metin (JSON formatında) listeleniyorsa, TCP portunuz sorunsuz çalışıyor demektir.
• Tarayıcı "Bağlantı zaman aşımına uğradı" veya "Siteye ulaşılamıyor" hatası veriyorsa, işletim sistemi güvenlik duvarı veya barındırma altyapınız TCP 30120 trafiğini engelliyordur.

UDP yönlendirmesi ve NAT sınırlamaları

TCP portu açık olsa bile UDP 30120 portu engelliyse sunucu listede görünmez. UDP bağlantısız bir protokol olduğu için durum paketlerinin iletimi yerel ağ geçitlerinde takılabilir.

Ev interneti üzerinden açılan sunucularda internet servis sağlayıcılarının uyguladığı CGNAT (Carrier-Grade NAT) yapısı, UDP kaynak portlarını maskeleyerek gelen yanıtların sunucuya dönmesini engelleyebilir. Bu sebeple topluluk sunucularının doğrudan statik IP yönlendirmesi sunan sanal sunucularda barındırılması önerilir.

Heartbeat mekanizması, önbellek süresi ve temel kaynak gereksinimleri

FXServer çalışmaya başladığında Cfx.re sunucu listesi giriş noktasına (ingress) bir "heartbeat" (yaşam sinyali) paketi gönderir. Bu paket, sunucunun açık olduğunu ve oyuncu kabul edebileceğini bildirir.

[FXServer (Sunucunuz)]
        │
        ▼ (Heartbeat Sinyali - UDP/TCP 30120)
[Cfx.re Master Ingress]
        │
        ▼ (Doğrulama ve info.json Sorgusu)
[Cfx.re Önbellek ve Arama Dizini]
        │
        ▼ (5-10 Dakika Yayılım Süresi)
[FiveM İstemcisi Sunucu Listesi (Server Browser)]

Önbellek gecikmesi ve sabır faktörü

Sunucuyu başlattıktan hemen sonra listenin en üstünde yer almayı beklemek doğru değildir:

• Ana dizin sunucularının gelen heartbeat sinyalini işlemesi, sunucuyu sorgulaması ve arama indeksine eklemesi 5 ila 10 dakika sürer. Yoğun saatlerde bu süre 15 dakikayı bulabilir.
• Sunucuyu açtıktan 2 dakika sonra listede göremediğiniz için süreci durdurup yeniden başlatmak, sinyal döngüsünü sıfırlar ve bekleme süresini baştan başlatır.
• Bekleme süresini hızlandırmak için sunucu konsoluna heartbeat yazarak yaşam sinyalini manuel olarak tetikleyebilirsiniz.

Temel kaynakların (mapmanager ve spawnmanager) önemi

FiveM çekirdek yapısında bazı kaynaklar doğrudan sunucunun durum yanıtlarını üretir:

• mapmanager kaynağı aktif olmayan bir sunucu, ana dizine geçerli bir harita durumu bildiremez.
• spawnmanager ve sessionmanager gibi temel paketlerin başlatılması zorunludur.
• server.cfg dosyanızda ensure mapmanager, ensure spawnmanager ve ensure sessionmanager satırlarının yer aldığından emin olun.

TRSHIELD koruması ve güvenlik duvarı filtreleme uyumu

Birçok sunucu yöneticisinin yaşadığı en büyük sorunlardan biri, sunucu barındırma sağlayıcılarının uyguladığı orantısız yurt dışı filtrelemeleridir. Yurt dışı UDP trafiğini toptan kapatan veya katı kurallarla süzen yapılar, Cfx.re'nin İngiltere ve Avrupa'daki tarama botlarını da engelleyerek sunucunun yerli oyunculara açık kalmasını ancak global sunucu listesinden tamamen silinmesini doğurur.

TREAS altyapısında sunulan sanal sunucularda bu riskler ortadan kaldırılmıştır. TREAS'ın kendi geliştirdiği DDoS koruma katmanı olan TRSHIELD, Anycast ağ yapısı üzerinde çalışır ve 12 Tbps DDoS koruma kapasitesi ile bilinen bütün saldırı vektörlerine karşı koruma sağlar.

TRSHIELD'ın FiveM'e özel geliştirilmiş koruma profili şunları sunar:

• udp/30120 portunda oyuna özel bağlantı doğrulaması yapar.
• tcp/30120 portunda SYN taşkınlarına karşı filtreleme uygular.
• TRSHIELD'ın FiveM profili sunucunun FiveM sunucu listesinde görünmesine engel olmaz ve ek bir izin listesi ayarı gerektirmez.
• Aynı profil RedM sunucularını da korur.
• DDoS koruması tüm paketlerde ek ücret olmadan standart olarak yer alır.

TREAS, oyun projeleri için ayrılmış vCore kaynaklı sanal sunucular sağlar. FiveM sunucularının yüksek oyuncu sayısında kare düşmesi ve gecikme yaşamaması için Ekstrem VDS paketlerinde AMD Ryzen 9 9950X işlemci ve DDR5 bellek sunulur. FiveM projeleriniz için oyun sunucusu çözümlerimizi ve DDoS koruması detaylarını inceleyebilirsiniz.

Yönetici izinleri ve ACE rollerini yapılandırmak için FiveM Hex ID öğrenme ve yetki verme rehberimizden; işletim sistemindeki port açma adımları için VDS port açma ve güvenlik duvarı başlıklı kılavuzumuzdan yararlanabilirsiniz.

FiveM sunucu listesi sorun giderme kontrol listesi

Sunucunuz listede çıkmıyorsa aşağıdaki adımları sırayla takip ederek sorunu tespit edebilirsiniz: