Lisans anahtarı hataları, sunucu tarayıcısı görünürlüğü, kaynak hataları, istemci bağlantıları, veritabanı sorunları ve performans optimizasyonu dahil yaygın RedM sunucu sorunları için sorun giderme kılavuzu. İlk kurulum talimatları için RedM Sunucu Kurulum Kılavuzu sayfamıza bakın.
Lisans Anahtarı Hataları
Lisans anahtarı sorunları, yeni bir RedM sunucusu başlatırken en yaygın sorundur. İşte tipik hatalar ve çözümleri:
"Invalid license key" veya "Could not authenticate"
| Neden | Çözüm |
|---|---|
| Lisans anahtarı yanlış yazılmış veya fazladan boşluklar içeriyor | Anahtarı doğrudan Keymaster'dan kopyalayın. GPanel'deki CFX_LICENSE başlangıç değişkeninden veya server.cfg içindeki sv_licenseKey satırından baştaki/sondaki boşlukları kaldırın. |
| IP adresi uyuşmazlığı | Anahtar, sunucunuzun gerçek IP'sinden farklı bir IP'ye kayıtlı. Keymaster'a gidin, kayıtlı IP'yi kontrol edin ve GPanel'de gösterilen sunucu IP'nizle eşleşecek şekilde güncelleyin. |
| Anahtar hem GPanel'de hem de server.cfg'de farklı değerlerle ayarlanmış | Anahtarın tutarlı olduğundan emin olun. Anahtarı GPanel başlangıç değişkeninde ayarlamak ve egg'in onu sunucuya iletmesine izin vermek en iyisidir. GPanel bunu hallederse sv_licenseKey'i server.cfg'den kaldırın veya yorum satırı yapın. |
| Cfx.re hesap sorunu veya anahtar iptal edilmiş | Keymaster'a giriş yapın ve anahtarın hâlâ etkin olduğunu doğrulayın. Eski anahtar silinmiş veya süresi dolmuşsa yeni bir anahtar oluşturun. |
| Keymaster hizmeti geçici olarak çalışmıyor | Kesintiler için Cfx.re durum sayfasını kontrol edin. Bekleyin ve daha sonra tekrar deneyin. |
Önemli: Yakın zamanda yeni bir sunucu aldıysanız veya sunucu IP'niz değiştiyse (ör. bir düğüm taşımasından sonra), Keymaster'daki IP'yi güncellemeniz veya yeni bir lisans anahtarı oluşturmanız gerekir. Eski anahtar farklı bir IP'de çalışmayacaktır.
Sunucu Tarayıcıda Görünmüyor
Sunucunuz çalışıyor ancak oyuncular onu RedM sunucu tarayıcısında bulamıyorsa:
Kontrol Listesi
- En az 5 dakika bekleyin. Başlatıldıktan sonra, sunucunun Cfx.re ana sunucu listesine kaydolması için zamana ihtiyacı vardır. Yeni sunucuların görünmesi birkaç dakika sürebilir.
- Lisans anahtarının geçerli olduğunu doğrulayın. Sunucu, çalışan bir lisans anahtarı olmadan listelenmeyecektir. Lisansla ilgili hatalar için sunucu konsolunu kontrol edin.
- Uç nokta yapılandırmasını kontrol edin.
server.cfgiçindekiendpoint_add_tcpveendpoint_add_udp'nin doğru portu kullandığından emin olun:
Port, GPanel'de atanan portla eşleşmelidir.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - "sv_master1" veya listeleme ayarlarını kontrol edin. Sunucuyu yanlışlıkla kendini listelememeye ayarlamadığınızdan emin olun. Yapılandırmanızda
sv_master1 ""bulunmamalıdır (bu, ana liste kaydını devre dışı bırakır). - Sunucunun gerçekten çalıştığını doğrulayın. GPanel konsolunu kontrol edin. Sunucu çöktüyse veya durduysa, tarayıcıda görünmeyecektir.
- Doğrudan bağlanmayı deneyin. Sunucu tarayıcıda olmasa bile, doğrudan bağlanma çalışmalıdır. Bir oyuncudan RedM'de F8 tuşuna basmasını ve şunu yazmasını isteyin:
connect YOUR_SERVER_IP:PORT
İpucu: Cfx.re sunucu aramasını kullanarak sunucunuza ulaşılabilir olduğunu doğrulayabilirsiniz. Bir web tarayıcısında
http://YOUR_SERVER_IP:PORT/info.json adresine gitmeyi deneyin. Sunucu çalışıyor ve erişilebilir durumdaysa, sunucu bilgileriyle bir JSON yanıtı döndürecektir.
Kaynak Yükleme Hataları
Sunucunuza yeni betikler veya çerçeveler eklerken kaynak hataları yaygındır. İşte en sık karşılaşılan sorunlar:
"Could not find resource [resource_name]"
- Kaynak klasörü
resources/dizininde mevcut değil veya yanlış konumda. - Klasör adı,
ensureiçinde kullanılan adla eşleşmiyor. Kaynak adları büyük/küçük harfe duyarlıdır. - Düzeltme: Kaynak klasörünün var olduğunu ve
server.cfg'deki adın tam olarak eşleştiğini doğrulayın. Kontrol etmek için GPanel dosya yöneticisini veya SFTP'yi kullanın.
"Failed to load resource [resource_name]: manifest error"
- Kaynağın
fxmanifest.luaveya__resource.luadosyasında bir söz dizimi hatası var. - Manifesto, kaynak klasöründe bulunmayan dosyalara referans veriyor.
- Düzeltme: Manifesto dosyasını açın ve yazım hataları, eksik virgüller veya var olmayan dosyalara yapılan referanslar olup olmadığını kontrol edin. Hatanın belirli satır numarası için sunucu konsolunu kontrol edin.
"Error loading script [filename]: [error details]"
- Kaynak içindeki bir Lua, C# veya JavaScript dosyasında bir söz dizimi veya çalışma zamanı hatası var.
- Düzeltme: Konsoldaki tam hata mesajını okuyun. Dosya adını ve satır numarasını içerecektir. Yaygın nedenler şunlardır:
- Eksik bağımlılıklar (önce yüklenmesi gereken başka bir kaynak)
- Mevcut RedM sunucu sürümüyle uyumlu olmayan güncel olmayan kaynak
- Kaynağın yapılandırma dosyasındaki hatalı yapılandırma değerleri
Kaynak Yükleme Sırası Sorunları
server.cfg içindeki kaynaklar, göründükleri sırayla yüklenir. Bir kaynak başka birine bağlıysa (ör. vorp_inventory, vorp_core'a bağlıdır), bağımlılık önce listelenmelidir:
# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores
# Wrong order - will cause errors
# ensure vorp_inventory <-- depends on vorp_core
# ensure vorp_core <-- loaded too late
Uyarı: Bir kaynak yüklenemezse, ona bağlı olan tüm kaynaklar da başarısız olur. Genellikle görünen ilk hata olan kök nedeni belirlemek için konsol çıktısını her zaman dikkatlice kontrol edin.
İstemci Bağlantı Sorunları
Oyuncular sunucunuza bağlanamadığında:
"Connection timed out" / "Failed to connect"
| Neden | Çözüm |
|---|---|
| Sunucu çalışmıyor | Sunucunun çevrimiçi olduğunu ve çökmediğini doğrulamak için GPanel konsolunu kontrol edin. |
| Yanlış IP veya port | Oyuncunun GPanel'den doğru IP ve portu kullandığını doğrulayın. Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz sayfasına bakın. |
| Uç nokta yanlış yapılandırması | server.cfg içindeki endpoint_add_tcp ve endpoint_add_udp'nin, PORT'un GPanel ile eşleştiği 0.0.0.0:PORT portunu kullandığından emin olun. |
| Sunucu dolu | sv_maxclients'a ulaşılıp ulaşılmadığını kontrol edin. Barındırma planınız izin veriyorsa değeri artırın. |
"Connection rejected by server"
- Sunucu şifresi:
sv_passwordayarlanmışsa, oyuncunun doğru şifreyi girmesi gerekir. - Beyaz liste/izin listesi kaynağı: Etkin bir beyaz liste kaynağınız varsa, oyuncunun bağlanmadan önce onaylanması gerekir.
- Yasaklama: Oyuncu yasaklanmış olabilir. Tanımlayıcıları için yasaklama listenizi veya veritabanınızı kontrol edin.
İstemci bağlanırken çöküyor
- Sunucudaki bir kaynak hatalı veri gönderiyor veya istemciyi çökerten bir istemci tarafı betik hatası var.
- Düzeltme: Sorunlu olanı belirlemek için yakın zamanda eklenen kaynakları teker teker devre dışı bırakın. İstemci bağlantısı sırasında hatalar için sunucu konsolunu kontrol edin.
- Oyuncunun RedM istemcisinin güncel olduğundan emin olun.
"Could not download file" hataları
- Sunucu, aktarım sınırlarını aşan büyük bir dosya (ör. bir akış varlığı) göndermeye çalışıyor veya bağlantı kararsız.
- Düzeltme: Akışlanan varlıkların boyutunu küçültün, destekleniyorsa büyük dosyalar için bir CDN/harici barındırma kullanın veya oyuncunun bağlantıyı yeniden denemesini sağlayın.
Veritabanı Sorunları (MySQL / oxmysql)
Çoğu RedM rol yapma çerçevesi, kalıcı veri depolama için MySQL kullanır. En yaygın veritabanı bağlayıcısı oxmysql'dir.
Bağlantı Başarısız Hataları
oxmysql (veya başka bir MySQL bağlayıcısı) bağlanamazsa, aşağıdakileri kontrol edin:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Hata | Çözüm |
|---|---|
ECONNREFUSED veya "Connection refused" |
MySQL sunucusu çalışmıyor, host/port yanlış veya MySQL sunucusu harici bağlantıları kabul etmiyor. Host'u, portu ve veritabanı sunucunuzun çevrimiçi olduğunu doğrulayın. |
ER_ACCESS_DENIED_ERROR |
Bağlantı dizesinde yanlış kullanıcı adı veya şifre. Veritabanı barındırma panelinizdeki kimlik bilgilerini iki kez kontrol edin. |
ER_BAD_DB_ERROR |
Veritabanı adı mevcut değil. Veritabanını önce veritabanı yönetim paneliniz (phpMyAdmin vb.) aracılığıyla oluşturun. |
ETIMEDOUT |
Veritabanı sunucusuna ulaşılamıyor. Bağlantıyı engelleyen güvenlik duvarı kuralları olup olmadığını veya veritabanı host'unun doğru olup olmadığını kontrol edin. |
| "Too many connections" | Veritabanı maksimum bağlantı sınırına ulaştı. Bu, kaynaklar bağlantıları düzgün şekilde kapatmazsa veya sınır çok düşükse olabilir. Sunucuyu yeniden başlatın ve MySQL max_connections ayarınızı kontrol edin. |
İpucu: RedM sunucunuz ve MySQL veritabanınız aynı makinedeyse, host olarak
localhost veya 127.0.0.1 kullanın. Farklı sunuculardaysalar, veritabanı sunucusunun IP adresini kullanın ve MySQL kullanıcısının uzaktan bağlantı ayrıcalıklarına sahip olduğundan emin olun.
Eksik Tablolar veya Şema Hataları
Rol yapma çerçeveleri genellikle çalışabilmeleri için veritabanı tablolarının kurulmasını gerektirir:
- SQL içe aktarma dosyaları (genellikle
database.sql,schema.sqlveya benzeri olarak adlandırılır) için çerçevenin belgelerini veya GitHub deposunu kontrol edin. - SQL dosyasını phpMyAdmin veya bir MySQL istemcisi kullanarak veritabanınıza içe aktarın.
- Bazı çerçeveler ilk başlatmada tabloları otomatik olarak oluşturur. Veritabanı kullanıcısının
CREATE TABLEayrıcalıklarına sahip olduğundan emin olun.
Performans Sorunları
RedM sunucunuz gecikme, düşük tick hızı veya genel olarak zayıf performans yaşıyorsa:
Performans Sorunlarını Belirleme
Performans uyarıları için sunucu konsolunu kontrol edin. RedM sunucuları saniyede yaklaşık 30-64 tick'lik bir tick hızını hedefler. Bunu şununla izleyebilirsiniz:
- txAdmin kontrol paneli: txAdmin mevcutsa, gerçek zamanlı sunucu performans metriklerini gösterir.
- Sunucu konsolu: "slow tick" veya "resource hitch" uyarılarını izleyin.
- resmon komutu: Kaynak başına CPU süresini gösteren kaynak monitörünü etkinleştirmek için sunucu konsolunda (veya F8 konsolunda)
resmon 1yazın.
Yaygın Performans Çözümleri
| Sorun | Çözüm |
|---|---|
| Belirli bir kaynaktan yüksek CPU kullanımı | Kaynağı belirlemek için resmon 1 kullanın. Onu daha optimize edilmiş bir alternatifle değiştirmeyi düşünün veya kaynak geliştiricisiyle iletişime geçin. |
| Çok fazla kaynak yüklenmiş | Her kaynak sunucu kaynaklarını tüketir. Kaynak listenizi denetleyin ve kullanılmayan veya gereksiz olanları kaldırın. |
| Veritabanı sorgu darboğazı | Yavaş veya dizinlenmemiş veritabanı sorguları sunucu takılmalarına neden olabilir. Konsolda oxmysql yavaş sorgu uyarılarını kontrol edin. Sık sorgulanan sütunlara dizinler ekleyin. |
| Yüksek oyuncu sayısı gecikmeye neden oluyor | sv_maxclients'ı sunucu donanımınızın kaldırabileceği bir seviyeye düşürün. Daha fazla kaynak için barındırma planınızı yükseltmeyi düşünün. |
| OneSync varlık sınırları | Çok fazla oluşturulan varlık (ped'ler, araçlar, nesneler) performansı düşürebilir. Kullanılmayan varlıkları temizleyen kaynaklar kullanın. |
| Bellek sızıntıları | Bazı kötü kodlanmış kaynaklar zaman içinde bellek sızdırır. GPanel'de sunucu RAM kullanımını izleyin. Düzenli sunucu yeniden başlatmaları (her 6-12 saatte bir) bunu hafifletebilir. |
Önerilen Uygulamalar
- Birikmiş bellek ve varlık sorunlarını temizlemek için GPanel'in zamanlama özelliğini veya txAdmin'i kullanarak her 6-12 saatte bir otomatik yeniden başlatmalar planlayın.
- Performans düzeltmelerinden ve optimizasyonlardan yararlanmak için kaynakları güncel tutun.
- Yinelenen işlevsellikten kaçının — aynı işi yapan iki kaynağı (ör. iki hava durumu sistemi) çalıştırmayın.
- Yeni kaynakları ana sunucunuza dağıtmadan önce bir hazırlama sunucusunda (veya düşük oyuncu sayısıyla) test edin.
- Sorunları erken yakalamak için sunucu metriklerini GPanel veya txAdmin aracılığıyla düzenli olarak izleyin.
Not: Optimizasyona rağmen sürekli olarak performans sorunları yaşıyorsanız, sunucunuzun daha fazla CPU ve RAM kaynağına sahip daha üst düzey bir barındırma planına ihtiyacı olabilir. Yükseltme seçeneklerini görüşmek için destek ekibimizle iletişime geçin.
Genel Sorun Giderme İpuçları
- Her zaman sunucu konsolu çıktısını okuyun. Neredeyse her hata, neyin ve nerede yanlış gittiğini size söyleyen bir mesaj içerir.
- Yapılandırma değişikliklerinden sonra sunucuyu yeniden başlatın.
server.cfg'deki çoğu değişikliğin etkili olması için tam bir sunucu yeniden başlatması gerekir. - Sorunları izole etmek için kaynakları teker teker devre dışı bırakın.
server.cfg'dekiensuresatırlarını#ile yorum satırı yapın. - Değişiklik yapmadan önce çalışan yapılandırmaların yedeklerini saklayın. Büyük güncellemelerden önce
server.cfgdosyanızı ve veritabanınızı indirin. - Hem FiveM hem de RedM için geçerli olan resmi belgeler için docs.fivem.net adresindeki Cfx.re forumlarını ve belgelerini kontrol edin.
- Sunucu sürümünüzle kaynak uyumluluğunu doğrulayın. Eski sürümler için oluşturulmuş kaynaklar, mevcut RedM yapılarıyla çalışmayabilir.
İlgili Makaleler
- RedM Sunucu Kurulum Kılavuzu — Lisans anahtarları, server.cfg yapılandırması, kaynak yönetimi ve bağlanma.
- Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz
- SFTP ile Dosyalar Nasıl Yüklenir
- Yeni Sunucunuza Başlarken
Yardıma mı İhtiyacınız Var?
RedM sunucunuzla hâlâ sorun mu yaşıyorsunuz? Bir destek talebi açın ve sunucu konsolunuzdaki tüm hata mesajlarını ekleyin. Ekibimiz sorunu teşhis edip çözmenize yardımcı olacaktır.
