Como criar uma key grátis para servidor de FiveM
Passo a passo técnico para gerar uma license key gratuita no Cfx.re Keymaster e vincular ao seu servidor FiveM em produção.
Rodar um servidor FiveM exige uma license key emitida pelo Keymaster, o sistema oficial do Cfx.re. Sem ela, o FXServer recusa o boot com a mensagem invalid license key specified e o servidor não fica visível na lista pública. A boa notícia é que existe key gratuita. Você só precisa de uma conta no fórum Cfx.re e do IP do servidor onde o FXServer vai rodar.
Este tutorial é para quem está montando o primeiro servidor FiveM, seja em VPS, dedicado ou ambiente local de testes. Vamos cobrir o registro no Keymaster, a geração da key vinculada ao IP correto, a configuração no server.cfg e os erros mais comuns de validação que aparecem nos primeiros minutos de operação.
Pré-requisitos
Antes de gerar a key, garanta que você sabe qual IP vai hospedar o servidor. A license é vinculada a esse endereço — se você gerar com IP errado, vai precisar refazer o vínculo depois.
Você precisa de: conta de e-mail válida para registro no fórum Cfx.re, IP público do servidor onde o FXServer vai rodar (IPv4), acesso ao painel/SSH para editar o server.cfg, e o FXServer já instalado (ou prestes a ser instalado).
Se ainda não tem servidor, defina onde vai rodar antes de continuar. A key aceita três modos de vínculo:
Vincula a um IPv4 específico 127.0.0.1 — apenas testes locais Aceita qualquer IP, mas com limites Para produção, use IP fixo. Localhost serve para desenvolvimento na sua própria máquina. Wildcard funciona, mas o Cfx.re pode revogar keys wildcard usadas em servidores públicos com alto número de jogadores.
Criar conta no fórum Cfx.re
O Keymaster autentica via fórum oficial Cfx.re — você não cria conta direto no painel de keys, e sim no fórum, que serve como SSO para todo o ecossistema FiveM.
Acesse o endereço do fórum oficial:
https://forum.cfx.re/Clique em Sign Up no canto superior direito. Você pode registrar via Discord, Google, GitHub, ou e-mail tradicional. Recomendo Discord se você já participa de comunidades FiveM — facilita suporte futuro.
Preencha o cadastro com e-mail válido, username e senha. O fórum envia um link de confirmação por e-mail — clique nele antes de prosseguir, senão o Keymaster não reconhece a conta.
Após confirmar, faça login no fórum pelo menos uma vez para que a sessão seja inicializada.
Acesse o Keymaster pelo endereço:
https://keymaster.fivem.net/Clique em Log in with Cfx.re e autorize o acesso via OAuth. Você será redirecionado para o dashboard do Keymaster, que lista todas as suas license keys (zero, neste momento).
A conta do fórum dá acesso total às suas keys, ao tópico de suporte e ao gerenciamento de assets do Cfx.re. Use senha forte e habilite 2FA nas configurações do fórum (Preferences → Security).
Gerar a license key no Keymaster
Com a conta ativa, a geração da key leva menos de um minuto. O sistema permite até cerca de 9 keys por conta gratuitamente — suficiente para múltiplos servidores ou ambientes de staging.
No dashboard do Keymaster, clique no botão + ou em Generate a new server key no topo da página.
Você verá um formulário com três campos: server label (nome descritivo), IP address, e tipo de vínculo.
Preencha o Server Label com um nome que identifique o servidor — por exemplo roleplay-prod-01 ou dev-local. Esse nome é só para sua organização interna, não aparece para jogadores.
No campo IP address, insira o IPv4 público do servidor. Se você está em VPS, pegue o IP via:
curl -4 ifconfig.mePara desenvolvimento local, use 127.0.0.1. Para hospedagem com IP dinâmico, selecione a opção wildcard, mas esteja ciente das limitações.
Clique em Generate. A key será criada e exibida no formato:
cfxk_XXXXXXXXXXXXXXXXXXXXX_YYYYYYYCopie o valor completo. Trate essa string como senha — não publique em screenshots, repositórios públicos ou Discord.
O Cfx.re monitora ativamente keys expostas no GitHub e em pastebins. Se sua key vazar, ela é revogada automaticamente e o servidor cai. Adicione server.cfg ao .gitignore se versionar a configuração.
Configurar a key no server.cfg
A key precisa ser declarada no arquivo de configuração que o FXServer lê durante o boot. Por padrão, esse arquivo fica em ~/server-data/server.cfg na instalação Linux ou na pasta do servidor no Windows.
Abra o arquivo de configuração:
nano ~/server-data/server.cfgLocalize a linha que começa com sv_licenseKey — geralmente perto do final do arquivo, no template padrão do txAdmin ou do FXServer.
Substitua o valor placeholder pela sua key:
sv_licenseKey cfxk_XXXXXXXXXXXXXXXXXXXXX_YYYYYYYNão use aspas em volta da key. Não adicione espaços extras. O FXServer faz parsing por whitespace simples e qualquer caractere a mais quebra a validação.
Salve e feche o arquivo (Ctrl+O, Enter, Ctrl+X no nano).
Reinicie o FXServer. Se estiver usando txAdmin, basta clicar em Restart no painel web. Em execução manual:
cd ~/server-data
bash ~/fxserver/run.sh +exec server.cfgVerificação
Um servidor com key válida exibe mensagens específicas no console durante o boot. Você confirma o sucesso observando esses logs.
Procure no console por uma sequência semelhante a:
Authenticating with [Cfx.re]...
Server license key authentication succeeded.
Server is now available on the server list.Se a autenticação falhar, o FXServer encerra com mensagem Invalid license key specified, or RCON password not set. Nesse caso, revise a key e o IP vinculado.
Você também pode verificar via API pública do FiveM se o servidor aparece listado. Substitua IP:PORT pelo seu endpoint:
curl http://IP:PORT/info.jsonA resposta deve conter um JSON com vars, version e resources. Se retornar erro de conexão, o problema é firewall ou porta — não a key.
Resolução de problemas
Erro: invalid license key specified
A causa mais comum é IP errado no Keymaster. Volte ao dashboard, edite a key (ícone de lápis) e ajuste o IP. A alteração é instantânea, mas o FXServer precisa ser reiniciado para revalidar.
Segunda causa: copiou a key com caractere invisível (espaço, quebra de linha). Apague a linha inteira no server.cfg e digite novamente, ou use echo para garantir formato limpo:
echo 'sv_licenseKey cfxk_SUA_KEY_AQUI' >> server.cfgErro: license key has expired or been revoked
Keys do Keymaster não expiram por tempo, mas são revogadas em três cenários: vazamento público detectado pelo Cfx.re, violação dos termos de serviço (uso comercial sem licença adequada para servidores grandes), ou exclusão manual pelo dono da conta. Gere uma nova key no dashboard.
Servidor sobe mas não aparece na lista pública
Nesse caso, a key funcionou, mas há outro problema. Verifique se sv_endpoints está configurado corretamente e se a porta 30120 (UDP e TCP) está aberta no firewall:
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udpServidor pode levar até 2 minutos para aparecer na lista pública após o primeiro boot bem-sucedido.
Gere keys separadas para produção e staging — usar a mesma key em dois servidores simultâneos invalida ambos. Como o limite é cerca de 9 keys por conta, sobra margem para ambientes de teste sem conflito.
Próximos passos
Com a key configurada, o servidor está tecnicamente operacional. A partir daqui, vale aprofundar:
- Configurar txAdmin para gerenciar o servidor via web (start/stop, console remoto, backups)
- Implementar OneSync se planeja mais de 32 jogadores simultâneos
- Ajustar
sv_maxClientse parâmetros de performance noserver.cfg - Configurar resources essenciais: ESX ou QBCore para frameworks de roleplay
- Implementar backup automatizado do banco MySQL e da pasta
resources
Se você está colocando o servidor em produção com mais de 32 slots, uma VPS Hostini com NVMe e baixa latência para o backbone Cfx.re reduz tickrate drops em horários de pico — o gargalo típico de FiveM é I/O de banco e CPU single-thread, ambos cobertos pelos planos com vCPU dedicada.
Perguntas frequentes
A license key do FiveM é realmente gratuita?
Sim. O Keymaster do Cfx.re emite keys gratuitas sem limite de tempo para servidores até 48 slots. Servidores maiores podem precisar de Patreon Argentum ou superior, mas a key em si continua gratuita — o Patreon habilita slots adicionais, não desbloqueia a license.
Posso usar a mesma key em dois servidores ao mesmo tempo?
Não. O Cfx.re detecta uso simultâneo da mesma key em IPs diferentes e suspende ambas as instâncias. Para staging e produção, gere keys separadas — sua conta permite cerca de 9 keys ativas.
Preciso trocar a key se mudar o IP do servidor?
Não precisa gerar uma nova. Acesse o Keymaster, clique no ícone de edição da key existente e atualize o campo IP. A mudança propaga em segundos e basta reiniciar o FXServer para revalidar.
O que acontece se minha key vazar no GitHub?
O Cfx.re executa scans automáticos em repositórios públicos. Keys detectadas em commits públicos são revogadas em até 24 horas. Sempre adicione server.cfg ao .gitignore e use variáveis de ambiente ou arquivos separados para segredos.
Qual a diferença entre key wildcard e key com IP fixo?
Wildcard aceita conexão de qualquer IP, útil para hospedagem com IP dinâmico ou ambientes containerizados. IP fixo é mais seguro e estável para produção. Wildcard tem limitações implícitas de slots e pode ser sinalizada em servidores grandes.
Posso usar FiveM key em servidor RedM?
Não. RedM (port para Red Dead Redemption 2) usa keys do mesmo Keymaster, mas geradas em fluxo separado dentro do painel. Ao criar a key, o sistema pergunta o tipo de servidor — selecione RedM para esse caso.