FiveM não aparece na lista pública: como resolver passo a passo

Abra o server.cfg e procure por linhas que afetam visibilidade:

grep -E "sv_master1|sv_licenseKey|sv_hostname|sv_projectName" server.cfg

Você deve ver sv_licenseKey "cfxk_xxxxxxxxxxxxxx" e NÃO deve ver sv_master1 "" (string vazia). Se encontrar sv_master1 "", comente ou remova essa linha — ela desativa explicitamente o heartbeat.

Confirme que o sv_hostname está preenchido e que existe pelo menos um tag útil em sets tags:

sv_hostname "Meu Servidor FiveM | Roleplay BR"
sets tags "roleplay, brasil, serious"
sets locale "pt-BR"

Servidores sem hostname significativo ou tags muito genéricas ficam ranqueados extremamente baixo na busca, podendo parecer “invisíveis” mesmo quando estão tecnicamente listados.

Verifique se você não está com sv_endpointPrivacy true ativado:

grep "endpointPrivacy" server.cfg

Se essa linha existir e estiver true, seu IP fica oculto na lista pública — o que faz parecer que o servidor sumiu pra quem busca por região. Pra aparecer normalmente, remova ou ajuste pra false.

Acesse keymaster.fivem.net com a conta que registrou a key. Localize a key usada no server.cfg e confira:

• Status: deve estar “Active” (não “Suspended” ou “Revoked”)
• IP cadastrado: deve bater com o IP público atual do servidor
• Tipo: “ZAP” ou “Self-hosted” — ambos funcionam na lista

Se o IP mudou (migração de host, troca de provedor, mudança de IP estático), edite a key no keymaster e atualize o campo IP. Mudanças propagam em até 10 minutos.

curl -s https://api.ipify.org

Esse comando devolve o IP público real que o servidor está usando pra sair. Compare com o que está no keymaster — precisa ser idêntico.

Liste regras ativas pra confirmar o que está aberto:

sudo ufw status verbose

Procure por regras de saída restritivas. UFW padrão permite tudo outbound — mas alguns provedores BR aplicam policies extras. Se a política default for deny (outgoing), libere explicitamente:

sudo ufw allow out 443/tcp
sudo ufw allow out 30110/udp
sudo ufw allow out 53/udp

Teste conectividade direta pros endpoints do cfx.re:

curl -v https://servers-frontend.fivem.net/api/servers/single/yourkey 2>&1 | head -20

Você deve ver HTTP/2 200 ou HTTP/2 404 (404 é normal se a key não está ativa ainda — o que importa é o handshake TLS completar). Connection refused ou timeout indica firewall bloqueando.

Confirme resolução DNS dos endpoints essenciais:

dig +short servers-frontend.fivem.net
dig +short policy-live.fivem.net

Ambos devem retornar IPs. Servidor sem DNS funcional (resolv.conf quebrado, DNS interno restritivo) é causa comum de heartbeat silencioso.

Pare o servidor e suba de novo. Em instalações com painel gerenciado, use os botões de stop/start. Em instalações manuais via screen ou systemd:

sudo systemctl restart fivem
sudo journalctl -u fivem -f

Acompanhe o boot. Linhas importantes que devem aparecer nos primeiros 30 segundos:

License key authenticated successfully
Server is ready to accept incoming connections
Sending heartbeat to https://servers-frontend.fivem.net/api/servers/...

Se você ver Heartbeat failed: timeout ou Heartbeat failed: 403 Forbidden repetidamente, o problema persiste:

• timeout → firewall ainda bloqueando saída
• 403 Forbidden → license key inválida ou IP não bate com keymaster
• Heartbeat OK → sucesso; o servidor vai aparecer na lista em até 5 minutos

Use a API pública do cfx.re pra buscar seu servidor pelo IP:

curl -s "https://servers-frontend.fivem.net/api/servers/" | grep -i "SEU_IP_PUBLICO"

Se retornar pelo menos uma linha contendo o IP, o servidor está indexado e visível.

No próprio FiveM, abra a aba “Servidores” e use a busca pelo sv_hostname configurado. O resultado deve aparecer com ping medido e contagem de players atual.