O que eu coloco nas configurações de banco de dados do txAdmin?

Primeiro clique em Mostrar/Ocultar opções de banco de dados (avançado) na tela de Parâmetros de entrada, abaixo da chave de registro, porque os campos ficam ocultos até que você faça isso. Depois substitua os valores preenchidos por host operator, porta 3307, usuário root, banco fivem e a MYSQL_ROOT_PASSWORD que você escolheu ao implantar. O txAdmin não encontra o operador sozinho. A senha é revelada e copiada das Configurações de implantação no painel de gerenciamento.

Por que meu servidor FiveM fica offline logo após a implantação?

Porque ainda não foi configurado, e isso é intencional. A implantação roda sem configuração padrão e sem chave de licença, então o txAdmin fica disponível no próprio endereço e a porta do jogo permanece em silêncio até você reivindicar a conta de admin, adicionar sua chave cfx.re e implantar uma build do servidor. Ele fica online alguns minutos após o fim do assistente.

A receita não termina com “Duplicate entry '1' for key 'PRIMARY'”

O banco já está populado de uma instalação anterior, então os dados iniciais da receita colidem com o que já existe. O “Delete Database” do txAdmin muitas vezes não o limpa, porque ele não toca no operador de sincronização. Abra o servidor no seu painel e use o botão Redefinir banco de dados no cabeçalho do painel: ele esvazia o banco em todos os seus nós, mantendo os arquivos do servidor e a configuração do txAdmin, para que você possa executar a receita novamente de forma limpa. Ele apaga todos os dados do jogo: normalmente essa é uma instalação que ainda não armazenou nada, mas se você tiver dados, faça antes um dump SQL (o próprio backup do operador de sincronização), porque o backup de volume não consegue restaurar um banco ativo.

Como configurar o txAdmin no seu servidor FiveM

Seu servidor é implantado com o txAdmin rodando e o servidor de jogo deliberadamente retido. Cinco passos no assistente o colocam online, e um deles, a conexão com o banco de dados, é onde quase todos param, porque os campos ficam escondidos atrás de um botão. O botão e os valores estão nesta página.

Primeiro: um servidor offline é normal aqui

Uma implantação nova do FiveM inicia o txAdmin e nada além disso. A porta do jogo permanece em silêncio de propósito até que você reivindique a conta de administrador, forneça uma chave de licença e escolha uma build do servidor, porque um servidor FiveM sem nenhuma dessas coisas não pode iniciar. Então, nos primeiros minutos após a implantação, seu painel mostrando o servidor como ainda não aceitando jogadores é o estado esperado, e não uma falha.

O painel diz isso: o cartão do servidor fica âmbar com Ação necessária: conclua a configuração no txAdmin, e abri-lo fornece o link do txAdmin e o PIN descrito abaixo. Nada nesta página exige um ticket de suporte.

Os cinco passos

1. Abra o txAdmin

Você não precisa encontrar um endereço. No seu painel, o banner âmbar no cartão do servidor abre um painel com um botão Abrir txAdmin, e o mesmo botão aparece na aba Jogadores assim que você clica em Gerenciar. Ele aponta para o domínio do txAdmin do seu próprio servidor, que continua funcionando após um failover porque sempre resolve para a instância que estiver primária no momento. Por isso o linkamos em vez de imprimir um IP de nó: um IP está correto até o dia em que não está.

2. Reivindique a conta de administrador com o PIN

Na primeira execução, o txAdmin pede um PIN que imprime apenas no console do servidor e depois pede que você crie um nome de usuário e senha de administrador master para o próprio painel. Em um servidor gerenciado, esse console normalmente não é algo que você veria, então o painel lê o PIN do log do contêiner e o mostra no mesmo painel do botão do txAdmin, pronto para copiar.

O login de administrador master não é sua conta Flux, nem sua conta Cfx.re, nem a senha do banco de dados. É uma terceira credencial, é o caminho de volta ao seu painel, e ninguém pode redefini-la para você. Guarde-a antes de seguir. Se o PIN tiver expirado quando você for usá-lo, reinicie o servidor no painel e um novo será impresso.

3. Escolha uma build do servidor

O assistente então oferece uma receita ou um servidor existente. Uma receita como qbcore, qbox ou ESX baixa o framework, seus resources e seu schema SQL, e importa o schema para o seu banco de dados, que é o caminho mais rápido para um servidor de roleplay funcionando. Escolha uma e o txAdmin a mostra em uma tela chamada Passo 1: Revisar receita. Continue e você chega a Passo 2: Parâmetros de entrada, onde acontecem os próximos dois passos.

4. Adicione sua chave de licença cfx.re

O primeiro campo em Parâmetros de entrada é Chave de registro do servidor. Gere uma gratuitamente em portal.cfx.re e cole o valor cfxk_. A chave é emitida para a sua conta e não para a nossa, e é por isso que o servidor é seu para mover; a implantação define NO_LICENSE_KEY=1 para que ela seja fornecida aqui e não embutida no app. Se você algum dia regenerar a chave, pode alterá-la depois sem refazer o assistente: ela é um campo na aba Configurações do Servidor do painel de gerenciamento.

5. Abra as opções do banco de dados e conecte o banco

Este é o passo que gera mais tickets de suporte, porque os campos do banco de dados estão ocultos. Logo abaixo da chave há um botão cinza, Mostrar/Ocultar opções de banco de dados (avançado). Clique nele. Só então aparecem os campos Host, Porta, Usuário, Senha e Nome do banco de dados. Se você pular o botão, a receita roda com os padrões do txAdmin e a conexão com o banco falha.

Os campos vêm pré-preenchidos, com localhost como host e 3306 como porta. Esses padrões estão errados neste servidor. Substitua o conteúdo de cada campo por estes valores:

Campo	Valor	Por quê
Host	operator	O operador de sincronização, não o container do banco de dados
Port	3307	Em que o operador escuta dentro do seu app
Username	root	Definido pela especificação, não editável
Password	MYSQL_ROOT_PASSWORD	O que você escolheu na implantação. Revele em Configurações de implantação
Database	fivem	Criado vazio para você antes do servidor iniciar

O host é o operador de sincronização e não o contêiner do banco de dados, a senha é a que você escolheu na implantação, e o próprio banco é criado vazio para você antes de o servidor iniciar.

A senha fica no painel de gerenciamento em Configurações de implantação, como MYSQL_ROOT_PASSWORD, com um botão de revelar e um botão de copiar. O painel também imprime estes quatro valores fixos em um cartão ao lado, para que você possa copiá-los diretamente para o txAdmin sem voltar aqui.

Vale nomear dois palpites porque ambos estão errados e ambos parecem certos. Host não é localhost: o txAdmin e o banco são contêineres separados. Host também não é mariadb, mesmo havendo um componente com esse nome. Tudo passa pelo operador, que é o que replica cada escrita para as outras instâncias; escrever direto em um MariaDB único dessincronizaria sua cidade e a perderia em um failover.

Depois execute a receita. O txAdmin baixa o artifact do FiveM, importa o schema, grava o server.cfg e inicia o servidor, e seu painel fica verde em alguns minutos. Se você escolheu um servidor existente em vez de uma receita, não há campos de banco de dados para preencher: defina a conexão no seu server.cfg, como mostrado nas perguntas abaixo.

Se o txAdmin disser que não consegue conectar

Confira primeiro o host e a porta, porque localhost e mariadb são os palpites comuns e nenhum dos dois funciona. Se esses estiverem certos, é uma senha incompatível. O banco é provisionado com MYSQL_ROOT_PASSWORD e o operador se autentica com DB_INIT_PASS, e os dois precisam ser idênticos para o banco sequer inicializar. O painel mantém os dois vinculados exatamente por isso: editar um reescreve o outro, e o campo é marcado como vinculado para que o comportamento não pareça um formulário recusando sua entrada. O que você digita no txAdmin precisa ser esse mesmo valor.

Voltando mais tarde

Depois do assistente, o txAdmin é o painel do dia a dia: console ao vivo, resources, banimentos, o editor de CFG e reinicializações agendadas. O mesmo botão Abrir txAdmin leva até lá, e você entra com a conta de administrador master do passo 2. O painel mantém a camada por baixo: reinicializações e reimplantações, o navegador de arquivos, o hardware, a saúde do banco de dados entre os nós e os backups.

Ainda não implantou?

txAdmin no próprio endereço, o banco criado e conectado antes de o primeiro resource carregar, e ambas as portas publicadas sem firewall para mexer. Primeira semana grátis se sua conta na Flux for nova.

Perguntas frequentes

O que devo digitar nas configurações de banco de dados do txAdmin?

Primeiro clique em Mostrar/Ocultar opções de banco de dados (avançado) na tela de Parâmetros de entrada, abaixo da chave de registro, porque os campos ficam ocultos até você fazer isso. Depois substitua os valores pré-preenchidos por: host operator, porta 3307, usuário root, banco fivem e o MYSQL_ROOT_PASSWORD que você escolheu ao implantar. O txAdmin não encontra o operador sozinho. A senha é revelada e copiada em Configurações de implantação no painel de gerenciamento.

Por que meu servidor FiveM está offline logo após a implantação?

Porque ainda não foi configurado, e isso é intencional. A implantação roda sem configuração padrão e sem chave de licença, então o txAdmin sobe no próprio endereço e a porta do jogo fica em silêncio até que você reivindique a conta de administrador, adicione sua chave cfx.re e implante uma build do servidor. Ele fica online alguns minutos depois de o assistente terminar.

Onde encontro o PIN do txAdmin?

No seu painel. O txAdmin imprime o PIN apenas no console do servidor, então o painel o lê do log do contêiner e o mostra, pronto para copiar, ao lado do botão Abrir txAdmin. Se ele tiver expirado, reinicie o servidor e um novo será impresso.

Posso me conectar ao MariaDB diretamente?

Não, e vale saber o motivo. Toda escrita precisa passar pelo operador na porta 3307, que a replica para suas outras instâncias. Apontar qualquer coisa diretamente para um contêiner MariaDB escreve em uma única máquina, e esses dados são o que você perde na próxima vez que o primário mudar.

Preciso usar uma receita como qbcore ou ESX?

Não. Uma receita é o caminho mais rápido porque importa para o seu banco de dados o schema SQL do framework, mas a opção em branco existe para quem traz uma build existente. Você pode enviar resources pelo navegador de arquivos e importar um dump SQL depois de qualquer forma.

Nenhum resource consegue alcançar o banco de dados: "mysql_connection_string structure was invalid"

Sua senha do banco de dados contém um caractere que precisa ser codificado em percentual em uma URL, como @, % ou ^, então a string mysql:// que o oxmysql monta não é um URI válido e nada conecta. Você não precisa mudar a senha nem reconstruir nada: coloque a forma com ponto e vírgula no server.cfg, porque ela é lida literalmente e não interpretada como URL. Use set mysql_connection_string "server=operator;port=3307;user=root;password=YOUR_PASSWORD;database=fivem" com a senha de Configurações de implantação, e reinicie. Servidores implantados a partir de agora já recebem uma senha segura em URL, então isso afeta apenas os mais antigos, e o painel os sinaliza no cartão do servidor com as duas correções: esta, e uma regeneração e reconstrução guiadas para uma instalação que não tenha dados que valham a pena manter.

A receita não termina: "Duplicate entry '1' for key 'PRIMARY'"

O banco de dados já está populado de uma instalação anterior, então os dados de seed da receita colidem com o que já existe. O "Delete Database" do txAdmin muitas vezes não limpa isso, porque não toca no operador de sincronização. Abra o servidor no seu painel e use o botão Reset database no cabeçalho do painel: ele esvazia o banco em todos os seus nós, mantendo seus arquivos do servidor e a configuração do txAdmin, para que você possa executar a receita de novo com limpeza. Ele apaga todos os dados do jogo: normalmente isso é uma instalação que ainda não armazenou nada, mas se houver dados, faça um dump SQL antes (o backup do próprio operador de sincronização), porque o backup de volume não consegue restaurar um banco ativo.

Esqueci a senha de administrador master do txAdmin. Você pode redefini-la?

Não é do nosso lado: essa conta fica dentro do txAdmin no seu servidor, e não no nosso faturamento ou painel, então não temos o que redefinir. Ela é recuperável a partir do próprio servidor, e o painel de gerenciamento oferece o console e o navegador de arquivos de que você precisa. Abra um ticket de suporte e vamos guiá-lo, porque isso não é motivo para reimplantar e perder a cidade.