FiveM sv_licenseKey: correção do erro 'no license key was specified'

Seu servidor FiveM para com 'no license key was specified' ou falha de autenticação de chave de licença. Como obter uma chave em portal.cfx.re, defini-la e corrigir a vinculação de IP.

Seu servidor inicia, depois para com uma linha como esta no console:

text
no license key was specified

Você também pode ver uma variante que diz que a autenticação de chave de licença falhou. O FiveM se recusa a executar um servidor sem uma chave válida, então a correção está sempre na chave: obtenha uma, coloque-a no lugar certo e certifique-se de que corresponda à máquina.

Por que acontece

Cada FXServer precisa de uma chave de licença registrada em uma conta Cfx.re. A chave prova que o servidor pertence a alguém e o vincula a um endereço IP. O erro significa um desses:

  • sv_licenseKey está faltando do server.cfg, ou a linha está comentada com um #.
  • A chave tem um erro de digitação, um caractere faltando ou espaços ou aspas extras.
  • A chave foi criada para um IP diferente de onde seu servidor é executado.
  • A chave foi deletada ou regenerada no portal, e o servidor ainda usa a antiga.

Obtenha uma chave em portal.cfx.re

  1. Vá para portal.cfx.re e entre com sua conta Cfx.re.
  2. Abra a seção Servidor e escolha Chaves de Registro.
  3. Crie uma nova chave. Dê um rótulo e insira o endereço IP público da máquina que executará o servidor.
  4. Copie a chave. Parece com cfxk_ seguido por uma longa sequência de caracteres.

Dica: o IP que você insere é o IP público do seu servidor, não um endereço local como 192.168.x.x. Em um VPS hospedado ou servidor dedicado, use o IP que seu provedor forneceu.

Coloque a chave em server.cfg

Abra server.cfg e adicione a linha, com a chave entre aspas duplas:

cfg
sv_licenseKey "cfxk_your_key_here"

Regras a seguir:

  • Uma linha, com aspas duplas retas (não aspas tipográficas copiadas de um chat ou página web).
  • Sem espaços antes ou depois da chave dentro das aspas.
  • A linha não deve começar com #.
  • Salve o arquivo e reinicie o servidor completamente. Uma reinicialização de recurso não o recarrega.

Se você usar txAdmin

O txAdmin pergunta pela chave quando você executa a configuração do servidor, e o deployment de receita a escreve no server.cfg que cria. Se você configurou o txAdmin à mão, ou colou uma chave errada durante a configuração, abra o server.cfg que o txAdmin executa (o Editor CFG no painel txAdmin) e verifique a linha sv_licenseKey lá.

Duas coisas pegam as pessoas aqui:

  • Você tem vários perfis txData ou pastas de servidor e editou o server.cfg errado. Verifique o caminho mostrado no topo do console do txAdmin.
  • A chave está correta no arquivo, mas o txAdmin executa uma config diferente. Olhe para o caminho do arquivo de config nas configurações do txAdmin.

Vinculação de IP: chave válida, ainda falhando

Uma chave funciona apenas para o IP com o qual foi registrada. Se a chave está correta e a autenticação ainda falha, compare dois valores:

  1. O IP na chave no portal, em Chaves de Registro.
  2. O IP público da máquina. Do próprio servidor você pode verificar com:
bash
curl ifconfig.me
powershell
(Invoke-WebRequest -UseBasicParsing https://ifconfig.me/ip).Content

Se eles diferirem, edite o IP na chave no portal, ou crie uma nova chave para o novo IP. Isso acontece muito depois de se mudar para outro host, depois que um provedor de internet doméstico muda seu IP, ou quando você testa em um PC em casa e depois carrega o mesmo server.cfg para um VPS.

Regenerando uma chave

Se uma chave vazar (foi postada em uma captura de tela, mensagem do Discord ou repositório público do GitHub), regenere-a do portal. A chave antiga para de funcionar imediatamente, então atualize server.cfg logo depois e reinicie.

cfg
# old key, revoked
# sv_licenseKey "cfxk_old_key"

sv_licenseKey "cfxk_new_key"

Mantenha a chave fora de repositórios públicos. Se seu server.cfg está no Git, armazene a chave em um arquivo separado que não é commitado e carregue-o com exec:

cfg
exec secrets.cfg
cfg
# secrets.cfg (not committed)
sv_licenseKey "cfxk_your_key_here"

Vários servidores

Você precisa de uma chave por servidor. Se você executar um servidor de teste ao lado do seu servidor ao vivo, crie duas chaves, cada uma com seu próprio IP, e rotule-as para não misturá-las. Usar a mesma chave em dois servidores faz um deles falhar na autenticação.

Ainda preso depois da chave

Depois que a chave é aceita, a próxima coisa que as pessoas encontram é que ninguém consegue entrar. Isso é um problema de rede, coberto em Servidor FiveM não aparece: encaminhamento de porta e firewall. Se você está instalando em um VPS fresco, executar um servidor FiveM no Linux percorre toda a configuração.

Lista de verificação

Sintoma Solução
no license key was specified Adicione sv_licenseKey "cfxk_..." ao server.cfg que o servidor realmente executa
license key authentication failed A chave tem um erro de digitação, foi deletada ou regenerada: copie-a novamente de portal.cfx.re
Chave correta, mas rejeitada O IP na chave não corresponde ao IP público do servidor: edite-o em Chaves de Registro
Funciona em casa, falha no VPS Crie uma chave para o IP do VPS
Chave vazar Regenere-a e atualize server.cfg
Dois servidores, um falha Use uma chave por servidor

Respostas rápidas

Onde obtenho uma chave de licença do servidor FiveM?

Entre em portal.cfx.re com sua conta Cfx.re, abra a seção Servidor e escolha Chaves de Registro, e crie uma chave para seu servidor. Copie-a assim que for exibida, ela começa com cfxk_.

Posso usar uma chave de licença em vários servidores?

Não. Uma chave é registrada para um servidor e um endereço IP. Crie uma chave separada para cada servidor que você executar.

Minha chave está correta, mas a autenticação ainda falha. E agora?

Verifique se o IP registrado na chave é o IP público da máquina que executa o servidor. Se você mudou de host ou seu IP mudou, edite o IP da chave ou regenere-a, então coloque a nova chave em server.cfg.

Scripts sem esse problema

Advanced BoostingBoosting de veículos pelo tablet: contratos da classe D à S+, crews e fila ao vivo.Ver script →Mic PhoneUm celular dobrável que abre em tablet e chega ao celular de verdade do jogador.Ver script →

Continue lendo