Oyun sunucuları

MariaDB kurulumu ve FiveM veritabanını bağlama (oxmysql)

QBCore, ESX ve Qbox'ın istediği veritabanı: Windows ve Linux'ta kurulum, ayrı bir kullanıcı, oxmysql bağlantı dizesi ve en sık görülen iki hata.

1 dakikalık okumaSon güncelleme: 19 Ekim 2026FiveM

QBCore, ESX ve Qbox; oyuncuları, envanterleri ve araçları bir MySQL/MariaDB veritabanında saklar. Veritabanını bir kez, aynı VPS'e kurarsınız ve FiveM ona localhost üzerinden bağlanır.

Windows

  1. MariaDB'nin MSI yükleyicisini (bir LTS sürümü) mariadb.org/download adresinden indirin.
  2. Kurun ve uzun bir root şifresi belirleyin. Windows ile birlikte başlaması için Install as service seçeneğini işaretli bırakın.
  3. Yükleyiciyle birlikte HeidiSQL de gelir: veritabanını pencereler üzerinden görüntülemenizi ve düzenlemenizi sağlayan bir program.

Linux (Ubuntu / Debian)

apt install -y mariadb-server
mariadb-secure-installation

Soruları yanıtlayın: anonim kullanıcıları ve test veritabanını kaldırın.

Veritabanını ve kullanıcısını oluşturun

FiveM için root kullanmayın. MariaDB'ye girin (Windows'ta HeidiSQL'den veya mysql -u root -p ile; Linux'ta mariadb ile) ve şunu çalıştırın:

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

txAdmin, recipe kurulumu sırasında sizden tam olarak bu bilgileri isteyecektir: veritabanı fivem, kullanıcı fivem ve şifresi.

Bağlantı dizesi (oxmysql)

txAdmin bunu server.cfg dosyanıza kendisi yazar. Elle eklerseniz şu biçimdedir:

set mysql_connection_string "mysql://fivem:UZUN_BIR_SIFRE@localhost/fivem?charset=utf8mb4"

Ayrıca yükleme sırasında ensure oxmysql satırı framework'ten önce gelmelidir. Şifrenizde @ veya # gibi semboller varsa onları içermeyen bir şifreyle değiştirin: bu semboller bağlantı dizesini bozar.

3306 portunu açmayın

Veritabanını yalnızca aynı makinedeki FiveM sunucusu kullanır. 3306 portunu internete açmak saldırıya davetiye çıkarmaktır. Bilgisayarınızdan yönetmek için HeidiSQL'i SSH tüneli seçeneğiyle kullanın (Linux'ta) ya da uzak masaüstüyle bağlanın (Windows'ta).

En sık görülen iki hata

Konsoldaki hataAnlamı
ECONNREFUSED 127.0.0.1:3306MariaDB çalışmıyor. Windows'ta hizmeti services.msc içinden kontrol edin; Linux'ta systemctl status mariadb komutunu kullanın.
Access denied for userBağlantı dizesinde kullanıcı adı, şifre veya veritabanı adı yanlış yazılmış.

Ve yedek alın: bir script envanterleri sildiğinde sizi kurtaracak olan, veritabanının günlük dökümüdür.

İlgili makaleler

Yardım merkezine dön

Aradığınızı bulamadınız mı?

Panelinizden bir destek talebi oluşturun, 5 dakikanın altında yanıt verelim.