FiveM sv_licenseKey: correzione dell'errore 'no license key was specified'

Il tuo server FiveM si arresta con l'errore 'no license key was specified' o un errore di autenticazione della chiave di licenza. Come ottenere una chiave su portal.cfx.re, impostarla e correggere il binding IP.

Il tuo server si avvia, quindi si arresta con una riga come questa nella console:

text
no license key was specified

Potresti anche vedere una variante che dice che l'autenticazione della chiave di licenza è fallita. FiveM rifiuta di eseguire un server senza una chiave valida, quindi la correzione è sempre sulla chiave: ottenine una, mettila nel posto giusto e assicurati che corrisponda alla macchina.

Perché accade

Ogni FXServer ha bisogno di una chiave di licenza registrata su un account Cfx.re. La chiave dimostra che il server appartiene a qualcuno e la lega a un indirizzo IP. L'errore significa uno di questi:

  • sv_licenseKey manca da server.cfg, o la riga è commentata con #.
  • La chiave ha un errore di digitazione, un carattere mancante, o spazi o virgolette strane.
  • La chiave è stata creata per un IP diverso da quello su cui gira il tuo server.
  • La chiave è stata eliminata o rigenerata sul portale, e il server usa ancora quella vecchia.

Ottieni una chiave su portal.cfx.re

  1. Vai a portal.cfx.re e accedi con il tuo account Cfx.re.
  2. Apri la sezione Server e scegli Registration Keys.
  3. Crea una nuova chiave. Dagli un'etichetta e inserisci l'indirizzo IP pubblico della macchina che eseguirà il server.
  4. Copia la chiave. Sembra cfxk_ seguito da una lunga stringa.

Suggerimento: l'IP che inserisci è l'IP pubblico del tuo server, non un indirizzo locale come 192.168.x.x. Su un VPS ospitato o un server dedicato, usa l'IP che il tuo provider ti ha dato.

Metti la chiave in server.cfg

Apri server.cfg e aggiungi la riga, con la chiave tra virgolette doppie:

cfg
sv_licenseKey "cfxk_your_key_here"

Regole da seguire:

  • Una riga, con virgolette doppie diritte (non virgolette tipografiche copiate da una chat o una pagina web).
  • Nessuno spazio prima o dopo la chiave all'interno delle virgolette.
  • La riga non deve iniziare con #.
  • Salva il file e riavvia completamente il server. Un riavvio della risorsa non lo ricarica.

Se usi txAdmin

txAdmin chiede la chiave quando esegui la configurazione del server, e il deployer della ricetta la scrive nel server.cfg che crea. Se hai configurato txAdmin a mano, o hai incollato una chiave sbagliata durante la configurazione, apri il server.cfg che txAdmin esegue (l'Editor CFG nel pannello txAdmin) e controlla la riga sv_licenseKey lì.

Due cose catturano le persone qui:

  • Hai diversi profili txData o cartelle di server e hai modificato il server.cfg sbagliato. Controlla il percorso mostrato nella parte superiore della console txAdmin.
  • La chiave è corretta nel file ma txAdmin esegue una config diversa. Guarda il percorso del file di config nelle impostazioni di txAdmin.

Binding IP: chiave valida, ancora fallendo

Una chiave funziona solo per l'IP per cui è stata registrata. Se la chiave è corretta e l'autenticazione continua a fallire, confronta due valori:

  1. L'IP sulla chiave nel portale, in Registration Keys.
  2. L'IP pubblico della macchina. Dal server stesso puoi controllarlo con:
bash
curl ifconfig.me
powershell
(Invoke-WebRequest -UseBasicParsing https://ifconfig.me/ip).Content

Se differiscono, modifica l'IP sulla chiave nel portale, o crea una nuova chiave per il nuovo IP. Questo accade molto spesso dopo il trasferimento a un altro host, dopo che un provider Internet domestico cambia il tuo IP, o quando provi su un PC a casa e poi carichi lo stesso server.cfg su un VPS.

Rigenerare una chiave

Se una chiave è trapelata (è stata pubblicata in uno screenshot, un messaggio Discord o un repository GitHub pubblico), rigenerala dal portale. La vecchia chiave smette di funzionare all'istante, quindi aggiorna server.cfg subito dopo e riavvia.

cfg
# old key, revoked
# sv_licenseKey "cfxk_old_key"

sv_licenseKey "cfxk_new_key"

Mantieni la chiave fuori dai repository pubblici. Se il tuo server.cfg è in Git, archivia la chiave in un file separato che non è impegnato e caricalo con exec:

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

Diversi server

Hai bisogno di una chiave per server. Se esegui un server di test accanto a uno live, crea due chiavi, ognuna con il suo IP, e etichettale in modo da non mischiarle. Usare la stessa chiave su due server fa fallire l'autenticazione di uno di loro.

Ancora bloccato dopo la chiave

Una volta che la chiave è accettata, la prossima cosa che le persone riscontrano è che nessuno può unirsi. È un problema di rete, coperto in server FiveM non visualizzato: port forwarding e firewall. Se stai installando su un VPS nuovo, esecuzione di un server FiveM su Linux ti guida attraverso l'intera configurazione.

Checklist

Sintomo Soluzione
no license key was specified Aggiungi sv_licenseKey "cfxk_..." al server.cfg che il server esegue realmente
license key authentication failed La chiave ha un errore di digitazione, è stata eliminata, o è stata rigenerata: copiala di nuovo da portal.cfx.re
La chiave è corretta ma rifiutata L'IP sulla chiave non corrisponde all'IP pubblico del server: modificalo in Registration Keys
Funziona a casa, fallisce sul VPS Crea una chiave per l'IP del VPS
La chiave è trapelata Rigenerala e aggiorna server.cfg
Due server, uno fallisce Usa una chiave per server

Risposte rapide

Dove posso ottenere una chiave di licenza del server FiveM?

Accedi su portal.cfx.re con il tuo account Cfx.re, apri la sezione Server, quindi Registration Keys, e crea una chiave per il tuo server. Copiala una volta mostrata, inizia con cfxk_.

Posso usare una chiave di licenza su diversi server?

No. Una chiave è registrata per un server e un indirizzo IP. Crea una chiave separata per ogni server che esegui.

La mia chiave è corretta ma l'autenticazione fallisce ancora. E adesso?

Controlla che l'IP registrato sulla chiave sia l'IP pubblico della macchina che esegue il server. Se hai cambiato host o il tuo IP è cambiato, modifica l'IP della chiave o rigenerala, poi metti la nuova chiave in server.cfg.

Script senza questo problema

Advanced BoostingBoosting di veicoli dal tablet: contratti dalla classe D alla S+, crew e coda in tempo reale.Vedi script →Mic PhoneUn telefono pieghevole che si apre in un tablet e arriva sul telefono vero del giocatore.Vedi script →

Continua a leggere