Como configurar o txAdmin em um servidor FiveM no Ubuntu 24.04

O txAdmin é o painel oficial de gerenciamento do FXServer — o runtime que roda servidores de FiveM e RedM. Ele agrupa em uma interface web tarefas que historicamente exigiam SSH e edição manual: console ao vivo, reinicialização agendada, backup do banco, gestão de admins, monitor de recursos e instalador guiado de templates de servidor.

Este tutorial é para quem está subindo o primeiro servidor FiveM em uma VPS Linux e quer evitar os atalhos arriscados (executar como root, abrir todas as portas, painel exposto sem senha). A execução leva entre 20 e 30 minutos, dependendo da velocidade do link da VPS para baixar os artifacts.

O foco é Ubuntu 24.04 LTS porque é a versão atual com suporte de longo prazo e bibliotecas compatíveis com os builds recentes do FXServer. Distribuições mais antigas (Ubuntu 20.04, Debian 11) ainda funcionam, mas exigem ajustes em libssl e glibc que não vamos cobrir aqui.

Pré-requisitos

Dados que você vai usar ao longo do procedimento:

Rodar o FXServer como root é um vetor de invasão clássico. Vamos criar um usuário dedicado sem privilégios administrativos.

Preparação do sistema

A primeira etapa é deixar o sistema atualizado e instalar as dependências que o FXServer usa em runtime — principalmente libssl e xz-utils, este último necessário pra descompactar o tarball dos artifacts.

sudo apt update && sudo apt upgrade -y

sudo apt install -y curl wget xz-utils screen libssl-dev ca-certificates ufw

sudo adduser --disabled-password --gecos "" fivem
sudo usermod -aG sudo fivem

Download dos artifacts do FXServer

Os artifacts são os binários oficiais do FXServer mantidos pela Cfx.re. Você sempre deve usar a versão recommended ou uma latest recente — versões antigas têm bugs de segurança conhecidos.

sudo su - fivem
mkdir -p ~/server ~/server-data
cd ~/server

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/12913-d4e6759b1c8fa1bdee75e0f87b6e7e2e7b78cd5a/fx.tar.xz

tar xf fx.tar.xz
rm fx.tar.xz

Configuração do firewall

Antes de iniciar o servidor, libere apenas as portas necessárias. Deixar tudo aberto facilita ataques.

exit  # sai do usuário fivem
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow 40120/tcp
sudo ufw enable

Inicialização do txAdmin

Agora chegamos ao ponto crucial: o run.sh do FXServer já inicia o txAdmin automaticamente na primeira execução, sem precisar instalar nada separado. O painel web aparece na porta 40120 e gera um PIN único pra primeira configuração.

sudo su - fivem
screen -S fivem
cd ~/server
bash run.sh +set serverProfile default

[txAdmin] PIN code is: 1234
[txAdmin] Please open http://your-ip:40120/ on your browser

Verificação

O servidor está funcionando se três coisas acontecem simultaneamente.

Primeiro, no painel txAdmin, a aba “Live Console” mostra logs ativos sem erros vermelhos críticos. Mensagens em amarelo (warning) são normais.

Segundo, o servidor aparece como online na lista pública do FiveM em https://servers.fivem.net/ — busque pelo nome configurado no server.cfg. Pode demorar até 5 minutos pra propagar.

Terceiro, você consegue conectar pelo cliente FiveM usando o IP direto: pressione F8 no jogo e digite connect SEU_IP:30120.

# No SSH, confirme que as portas estão escutando:
sudo ss -tulpn | grep -E '30120|40120'

A saída esperada mostra LISTEN em ambas as portas com o processo FXServer ou node como dono.

Resolução de problemas

txAdmin não responde no navegador

Provavelmente o UFW está bloqueando ou o serviço caiu. Confirme com sudo ufw status se 40120/tcp está liberada. Reentre no screen com screen -r fivem e veja se o processo terminou com erro. Se não há screen ativo, o servidor não está rodando — reinicie com bash run.sh.

Erro “Could not load citizen:/scripting/…”

Geralmente significa que os artifacts estão corrompidos ou incompletos. Baixe novamente do site oficial — não use mirrors de terceiros. Apague o diretório ~/server antes de extrair de novo pra evitar arquivos antigos misturados.

Servidor não aparece na lista pública

Verifique se a chave de licença em server.cfg está correta (linha sv_licenseKey). Cada chave funciona em um IP por vez — se você reutilizou uma chave de outro servidor, gere uma nova no keymaster.

Próximos passos

Com o txAdmin operacional, vale aprofundar nos próximos pontos:

• Configurar MySQL/MariaDB local pra suportar frameworks como ESX e QBCore — sem banco, esses scripts não persistem dados de jogadores.
• Adicionar admins adicionais pelo painel (aba “Players” → “Admin Manager”) com permissões granulares.
• Configurar backup automático do server-data em armazenamento externo. O txAdmin tem snapshot interno, mas snapshot local não protege contra falha de disco.
• Estudar o server.cfg linha a linha — entender sv_maxClients, onesync, sv_scriptHookAllowed evita configurações inseguras herdadas de templates.

Se você está colocando o servidor em produção com jogadores reais, uma VPS Hostini já vem com proteção DDoS no nível de rede e disco NVMe — relevante pra FiveM porque o FXServer faz muita escrita aleatória em cache de recursos.