Promoção de Halloween 10% de desconto vitalício com o código

Configurando um banco de dados FiveM com a aba Configuração MySQL

Adicione sua chave de licença, crie um banco de dados MariaDB do seu plano sem custo extra, crie um usuário de banco de dados e escreva a string de conexão em server.cfg.

Last updated November 6, 2026

A maioria dos frameworks FiveM, como QBCore, Qbox e ESX, precisa de um banco de dados MySQL. No ServerPrism, a aba Configuração MySQL te guia por esse processo: ela define sua chave de licença, cria um servidor de banco de dados MariaDB a partir do seu plano atual, cria um usuário de banco de dados e escreve a string de conexão no seu server.cfg. Este guia segue a aba passo a passo.

Abra seu servidor FiveM e clique em Configuração MySQL na barra lateral (em FiveM). A parte superior da página mostra quantos passos faltam. Você pode Skip setup a qualquer momento e Resume setup mais tarde.

Passo 1: Chave de licença FiveM

FiveM precisa de uma chave de licença gratuita de keymaster.fivem.net. Faça login lá, crie uma chave de servidor, copie-a, cole-a em License key e clique em Save.

A chave é salva na configuração FxServer License Key na aba Inicialização, então você também pode alterá-la lá mais tarde.

Se você vir Server ports need attention, clique em Auto-fix ports. Um servidor FiveM com txAdmin precisa de três portas em sequência e a porta txAdmin precisa ser uma delas; a correção configura isso para você. Servidores sem txAdmin (veja o passo 5) pulam esta verificação.

Passo 2: Servidor de banco de dados

Seu banco de dados funciona como seu próprio pequeno servidor ao lado do seu servidor FiveM.

  1. A aba mostra como seu plano seria dividido, por exemplo, "FiveM (este servidor)" e "MariaDB (novo)", cada um com sua RAM. Não há custo extra: os recursos do seu plano são divididos entre os dois.
  2. Clique em Create MariaDB server e confirme.

Seu servidor FiveM reinicia brevemente enquanto a divisão é executada. O novo servidor de banco de dados então inicia por conta própria. Se ele aparecer como offline mais tarde, clique em Start database.

O proprietário também pode escolher Custom split para selecionar os tamanhos na aba Dividir servidor. Você também pode desfazer uma divisão lá.

Passo 3: Usuário do banco de dados

Clique em Provision database user. Criamos um usuário e um banco de dados chamado fivem_db com uma senha forte e aleatória, e salvamos os detalhes para que você só precise fazer isso uma vez.

Você então verá Database details for txAdmin setup: Host, Port, Database name, Username e Password, cada um com um botão de copiar. Copy all (txAdmin format) copia tudo de uma vez, pronto para colar na etapa de banco de dados do txAdmin. Em um servidor sem txAdmin, o cartão é chamado Database details e o botão Copy all; use os detalhes em seus recursos, ou deixe o passo 4 escrevê-los em server.cfg.

O mesmo cartão tem um botão Reset password para quando você precisar de uma nova senha de banco de dados (veja "Alterando a senha do banco de dados" abaixo).

Passo 4: Aplicar aos arquivos .cfg

Clique em Rescan, depois em Apply connection string. Procuramos em seus arquivos .cfg e escrevemos uma linha como esta no arquivo certo:

set mysql_connection_string "mysql://USER:PASSWORD@HOST:PORT/fivem_db?charset=utf8mb4"

Se nenhuma linha existir ainda, ela é adicionada ao server.cfg que seu servidor realmente carrega. O arquivo que o FXServer carrega é marcado como Active; outros arquivos server.cfg dentro de pastas de recursos ou modelos de receita são apenas exemplos.

Reinicie seu servidor após aplicar, para que recursos como oxmysql captem a nova conexão.

Passo 5: Iniciar o servidor (e abrir o txAdmin)

Quando todas as etapas estiverem concluídas (ou ignoradas), um último cartão aparece informando que está tudo pronto.

  1. Clique em Iniciar servidor. O FXServer leva de 30 a 60 segundos para ficar online.
  2. Clique em Open txAdmin. A txAdmin URL é mostrada no cartão com um botão de copiar.
  3. Na primeira vez, o txAdmin pede um PIN. Você o encontrará no Console.
  4. Crie sua conta de administrador do txAdmin e, em seguida, escolha uma receita (QBCore, ESX e assim por diante). Quando o txAdmin pedir os detalhes do banco de dados, cole o que você copiou no passo 3.

Depois que o txAdmin configurar sua receita, volte para Configuração MySQL e execute o passo 4 novamente. As receitas geralmente criam seu próprio server.cfg, e a aba mantém a string de conexão sincronizada com ele.

Sem txAdmin no FiveM Enhanced, ou com txAdmin desativado. Servidores FiveM Enhanced, e servidores FiveM onde Enable / Disable TxAdmin na Inicialização está definido como 0, iniciam diretamente do server.cfg e não executam o txAdmin. O último cartão então diz Your server starts straight from server.cfg. e não tem o botão Open txAdmin. Apenas o passo 1 acima se aplica: adicione seus recursos no Gerenciador de arquivos, liste-os em server.cfg e reinicie.

Gerenciando o banco de dados

Abra o servidor MariaDB na sua lista de serviços e use o Gerenciador de BD para tabelas, consultas, importações e exportações. Open Database Manager o abre em uma nova aba; o link de acesso expira após 5 minutos. Para mover um banco de dados de outro host, consulte Fazendo backup, importando e exportando um banco de dados.

Alterando a senha do banco de dados

Se outra pessoa viu a senha, dê uma nova senha ao usuário do banco de dados você mesmo:

  1. Inicie o servidor de banco de dados se ele não estiver em execução. O botão só funciona enquanto ele estiver online.
  2. Em Configuração MySQL, clique em Reset password no cartão Database details.
  3. Em Reset database password?, clique em Reset password. A senha antiga para de funcionar imediatamente.
  4. A janela New password mostra a nova senha uma vez. Clique em Copy e guarde-a em um local seguro: para sua segurança, a mostramos apenas lá e nunca a enviamos por e-mail.
  5. Clique em Apply connection string (passo 4) para que server.cfg receba a nova senha e, em seguida, reinicie seu servidor FiveM. Até que você faça isso, o servidor continuará tentando a senha antiga.

Atualize também qualquer outro aplicativo que se conecte com este usuário do banco de dados. Você também pode redefini-lo no Gerenciador de BD no servidor MariaDB.

Problemas comuns

O que você vê O que fazer
Scripts não conseguem se conectar ao banco de dados (por exemplo, ECONNREFUSED) Verifique se o servidor MariaDB está em execução, depois vá para o passo 4 e Apply connection string ao arquivo marcado como Active. Reinicie o FiveM.
Database fivem_db is missing Clique em Create fivem_db e, em seguida, reinicie seu servidor FiveM.
MariaDB server must be running to provision a user Inicie o servidor de banco de dados primeiro (Start database), espere até que ele esteja online e tente novamente.
Pay your pending invoice before splitting A divisão é bloqueada enquanto uma fatura estiver em aberto. Pague-a e volte.
Splitting is not available on trial servers A etapa do banco de dados precisa de um plano pago.
A URL do txAdmin não está disponível Inicie o servidor primeiro; o txAdmin só responde quando está em execução. FiveM Enhanced, e FiveM com txAdmin desativado, não possuem txAdmin.
Scripts perderam o banco de dados após uma redefinição de senha Clique em Apply connection string em Configuração MySQL e reinicie o servidor.

Para configuração geral do FiveM, consulte Começando com GTA V: FiveM. Se algo nesta página não corresponder ao que você vê, abra um ticket de suporte e nós o ajudaremos.