Como criar um servidor FiveM do zero no Ubuntu Linux

Subir um servidor FiveM no Linux é mais barato em recursos que no Windows e ganha estabilidade em uptimes longos, mas exige conhecer alguns detalhes específicos da plataforma: os artifacts oficiais são entregues como tarball, a CFX exige license key amarrada ao IP, e a porta padrão precisa estar liberada em TCP e UDP — esquecer um dos dois é a causa número um de “servidor não aparece na lista”.

Este tutorial cobre a instalação do zero numa VPS Ubuntu 24.04 LTS, do usuário dedicado até o servidor aceitando conexões. A persona é dono de servidor novo que vai migrar de host gerenciado para uma VPS Linux e precisa entender o que cada peça faz.

Tempo estimado: 20 a 30 minutos numa VPS razoável, contando download dos artifacts.

Pré-requisitos

Antes de começar, anote os dados de acesso que você vai usar ao longo do tutorial. Em uma VPS Hostini recém-provisionada, eles vêm no e-mail de boas-vindas:

Confirme a versão do sistema antes de prosseguir:

lsb_release -a

A saída deve mostrar Description: Ubuntu 24.04 LTS ou similar. Se estiver em uma versão antiga (20.04, 22.04), o tutorial ainda funciona — só os comandos de pacote podem variar levemente.

Criar usuário dedicado para o servidor

Rodar o FiveM como root é prática insegura: qualquer falha em um resource mal escrito vira acesso administrativo total à máquina. Criar um usuário separado leva 30 segundos e isola o impacto.

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

sudo su - fivem

Instalar dependências do sistema

FiveM no Linux exige algumas libs do sistema que não vêm por padrão no Ubuntu Server. Faltar qualquer uma delas resulta em erro genérico “segmentation fault” no startup, que é difícil de diagnosticar.

sudo apt update
sudo apt install -y xz-utils curl screen libssl3 ca-certificates

Baixar os artifacts oficiais

A CFX publica builds linux do servidor em runtime.fivem.net. Cada build tem um hash único e é incremental. Para produção, use sempre a branch recommended.

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

curl -sLo fx.tar.xz https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/15601-COMMIT_HASH/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Gerar a license key

Desde 2018 a CFX exige license key para qualquer servidor — sem ela o servidor sobe mas recusa todas as conexões com erro de autenticação. A key é gratuita e amarrada ao IP público da máquina.

Configurar o server.cfg

O arquivo server.cfg define nome, slots, license key, recursos carregados e portas. Vamos partir do template oficial e ajustar o mínimo para o servidor subir.

cd ~/server-data
git clone https://github.com/citizenfx/cfx-server-data.git .

nano server.cfg

sv_hostname "Meu Servidor FiveM"
sv_maxclients 32
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Abrir as portas no firewall

Ubuntu 24.04 vem com ufw instalado mas inativo. Antes de ativar o firewall, libere SSH para não se trancar fora, depois abra a porta do FiveM.

sudo ufw allow OpenSSH
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw enable

Subir o servidor

Com config pronta e firewall liberado, é hora do primeiro boot.

sudo su - fivem
screen -S fivem
cd ~/server-data
bash ~/server/run.sh +exec server.cfg

Verificação

Confirme que o servidor está respondendo na porta e visível externamente.

Da própria VPS, teste localmente:

curl -s http://localhost:30120/info.json

A resposta deve ser um JSON com vars, enhancedHostSupport e resources. Se vier vazio ou der Connection refused, o servidor não terminou de subir ou crashou — volte ao screen e veja o log.

De outra máquina, abra o cliente FiveM e conecte por IP direto:

IP_DA_SUA_VPS:30120

Se conectar, o servidor está operacional e visível para a CFX. Em até 5 minutos ele também aparece na lista pública filtrando pelo nome.

Resolução de problemas

Servidor sobe mas não aparece na lista pública

Quase sempre é UDP bloqueado. Confirme com sudo ufw status que a regra 30120/udp está ativa. Em alguns provedores, há um firewall na borda da rede além do UFW da máquina — verifique o painel do provedor.

Erro “Server license key invalid”

A key está amarrada a um IP diferente do atual. Vá ao keymaster, edite a key existente e atualize o IP para o da VPS.

Servidor mata o processo após alguns minutos

Falta de RAM. Rode free -h e veja se a VPS está com swap esgotado. FiveM vanilla precisa de pelo menos 2 GB livres; com framework roleplay, planeje 8 GB.

Próximos passos

Com o servidor base operacional, considere:

• Migrar de screen para systemd: cria um service unit que reinicia o servidor após crash e sobrevive a reboot do host.
• Configurar backup automatizado do server-data/ para um storage externo — perder a database do framework é caro.
• Instalar framework (ESX, QBCore, vRP) por cima do servidor vanilla, dependendo do tipo de gameplay.
• Adicionar reverse proxy com nginx ou caddy para servir o painel de status do servidor em HTTPS.
• Monitorar CPU e RAM com ferramentas básicas como htop ou um agente de métricas dedicado.

Se você está colocando isso em produção, vale considerar uma VPS otimizada para servidores de jogos — máquinas com CPU de alto clock single-thread, IP estático e proteção contra ataques de saturação, que é o ponto fraco típico de servidores FiveM expostos.