NUOVO 📢 Black Friday: la nostra offerta di lancio termina il 30 nov. Fino al 70% di sconto sul tuo primo mese, per tutti i giochi!Vedi i piani
Black FridayFino al 70% di sconto sul primo mese, termina il 30 nov.Termina tra 9 g 02 h 49 minBlack FridayFino al 70% di sconto sul primo mese, termina il 30 nov.Termina tra 9 g 02 h 49 minBlack FridayFino al 70% di sconto sul primo mese, termina il 30 nov.Termina tra 9 g 02 h 49 min

Come ottenere una nuova privilege key admin per TeamSpeak

Mumble e server vocaliAggiornato 21 nov 20267 min di lettura

Risposta breve. Un nuovo server TeamSpeak stampa una ServerAdmin privilege key (una riga che inizia con token=) la prima volta che si avvia, nella console e nel log del server virtuale 1. Una chiave funziona una sola volta. Per crearne una nuova su TeamSpeak 3, accedi a ServerQuery come serveradmin ed esegui privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0; su TeamSpeak 6, invia lo stesso comando alla query HTTP con una chiave API. Hai perso anche la password di ServerQuery? Avvia TeamSpeak 3 una volta con serveradmin_password=, oppure TeamSpeak 6 con --query-http-enable e --query-admin-api-key. Abbiamo creato nuove chiavi così su TeamSpeak 3 server 3.13.8 e TeamSpeak 6 server v6.0.0-beta13.1 il 6 novembre 2026. TeamSpeak 6 server v6.0.0-beta14 è uscito il 17 novembre 2026; non abbiamo ripetuto questi passaggi su quella versione.

Cos'è la privilege key

La guida di TeamSpeak stessa (doc/privilegekey_guide.txt nel download di TeamSpeak 3) dice che un server TeamSpeak 3 non ha nomi utente né password: riconosce le persone da un ID univoco ricavato da una coppia di chiavi creata dal loro client. Quindi il primo admin ha bisogno di un biglietto: la privilege key. TeamSpeak 6 usa lo stesso tipo di chiave. Incollandola nel client TeamSpeak, quell'identità entra nel gruppo Server Admin del server virtuale per cui la chiave è stata creata. La stessa guida dice che una chiave si può usare una sola volta.

Trovare la chiave del primo avvio

Al primo avvio entrambe le versioni stampano le stesse due righe:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 su Linux: il server la scrive nel log del server virtuale 1, il file in logs/ il cui nome finisce con _1.log:
    grep token= logs/*_1.log
  • TeamSpeak 6 con Docker:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 senza Docker: lo stesso grep di TeamSpeak 3, nella cartella logs/ del server.

Il primo avvio stampa anche un login ServerQuery in un riquadro nella console: loginname= "serveradmin", password= "..." e una apikey. Conservali in un posto sicuro. Vengono stampati solo al primo avvio e sono ciò che usi per creare una nuova chiave.

Creare una nuova chiave su TeamSpeak 3

Esegui questo sulla macchina dove gira il server. ServerQuery è in ascolto sulla porta TCP 10011, che non dovrebbe essere aperta verso internet.

  1. Connettiti a ServerQuery con un semplice client TCP. Il manuale di ServerQuery di TeamSpeak cita Telnet (su Debian o Ubuntu, sudo apt install telnet se manca):
    telnet 127.0.0.1 10011
  2. Accedi, scegli il server virtuale 1 e crea la chiave:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. Il server risponde token=... seguito da error id=0 msg=ok. Incolla il token nel tuo client TeamSpeak. ServerQuery esegue l'escape di una barra come \/ nelle risposte, quindi se il token mostra \/, scrivilo come /.

tokenid1=6 è il gruppo Server Admin di un nuovo server virtuale: anche la chiave creata dal server al primo avvio punta al gruppo 6. Se hai rinominato o ricostruito i gruppi, esegui servergrouplist dopo use sid=1 e prendi l'sgid del gruppo admin con type=1. I gruppi con type=0 sono modelli e quelli con type=2 sono gruppi ServerQuery.

Password di ServerQuery persa

La guida rapida di TeamSpeak dice che l'unico modo per ottenere una nuova password è cancellare il database del server. Su 3.13.8 c'è un modo più delicato: avvia il server una volta con una nuova password come parametro di avvio. Lo script di avvio passa i parametri al server. Usa solo lettere e cifre, perché ServerQuery tratta spazi e alcuni simboli come caratteri speciali:

./ts3server_startscript.sh stop
./ts3server_startscript.sh start serveradmin_password=PICK_A_NEW_PASSWORD

Nel nostro test il log ha poi riportato updated server query admin password e la nuova password ha permesso l'accesso. Crea la nuova chiave come sopra mentre il server è in esecuzione, poi riavvialo normalmente.

Creare una nuova chiave su TeamSpeak 6

TeamSpeak 6 non ha un ServerQuery in chiaro sulla porta 10011: il suo CONFIG.md elenca interfacce di query SSH, HTTP e HTTPS, tutte disattivate per impostazione predefinita. La query HTTP usa una chiave API che imposti all'avvio.

  1. Riavvia il server con la query HTTP attiva e una chiave API tua:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    La query HTTP ascolta poi su TCP 10080 su tutti gli indirizzi (0.0.0.0), quindi assicurati che il firewall blocchi quella porta da internet.
  2. Sulla stessa macchina, chiedi una chiave per il gruppo 6:
    curl -H "x-api-key: PICK_A_LONG_RANDOM_KEY" "http://127.0.0.1:10080/1/privilegekeyadd?tokentype=0&tokenid1=6&tokenid2=0"
  3. La risposta è JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Incolla il token nel tuo client TeamSpeak. Il log del server aggiunge una riga che dice che serveradmin ha aggiunto una privilege key per il gruppo server Server Admin.
  4. Riavvia senza --query-http-enable se non ti serve la query HTTP.

Con Docker, ricrea il container con due variabili d'ambiente e la porta della query HTTP pubblicata solo su 127.0.0.1, così non è raggiungibile da internet. I tuoi dati restano nel volume:

docker rm -f teamspeak-server
docker run -d \
  --name teamspeak-server \
  -p 9987:9987/udp \
  -p 30033:30033 \
  -p 127.0.0.1:10080:10080 \
  -e TSSERVER_LICENSE_ACCEPTED=accept \
  -e TSSERVER_QUERY_HTTP_ENABLED=1 \
  -e TSSERVER_QUERY_ADMIN_API_KEY=PICK_A_LONG_RANDOM_KEY \
  -v teamspeak-data:/var/tsserver/ \
  teamspeaksystems/teamspeak6-server:latest

Poi esegui lo stesso curl del passaggio 2. Qui usa le variabili d'ambiente, non opzioni dopo il nome dell'immagine: il comando dell'immagine è tsserver, quindi qualsiasi cosa dopo il nome dell'immagine lo sostituisce, e nel nostro test la query HTTP non rispondeva quando l'abbiamo provato così. Ricrea il container senza le due variabili di query e senza la porta 10080 quando non ti serve più la query HTTP. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) imposta la password dell'account di query serveradmin; la query HTTP qui sopra non ne ha bisogno (il nostro test con Docker ha impostato solo la chiave API), e la query SSH resta disattivata finché non aggiungi --query-ssh-enable.

La chiave risulta non valida

  • È già stata usata. Ogni chiave funziona una volta. privilegekeylist (TeamSpeak 3) o /1/privilegekeylist (TeamSpeak 6) elenca le chiavi ancora disponibili.
  • È per un altro server virtuale. Una chiave funziona solo sul server virtuale per cui è stata creata.
  • La query HTTP risponde invalid apikey. L'header x-api-key non corrisponde alla chiave con cui il server è stato avviato.
  • Non è stata copiata per intero. Una chiave può contenere + e /. Copia tutto ciò che segue token=.

Ospitare TeamSpeak da soli

L'installazione completa, i limiti della licenza e quanta memoria serve al server: Come ospitare un server TeamSpeak. PlayNHost affitta server vocali Mumble, non TeamSpeak; su Mumble il primo admin usa una password SuperUser dal pannello invece di una chiave: Come diventare admin sul tuo server Mumble.

Lo ospiti già altrove? Sposta il tuo server da noi

ULTIMI ARTICOLI