IT

Server di gioco

Come creare il tuo server TeamSpeak

Guida completa per installare un server vocale TeamSpeak su un VPS o server dedicato Linux: licenza, chiave di amministrazione, porte, servizio systemd, aggiornamenti, backup e risoluzione dei problemi.

8 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Questa guida spiega come installare un server vocale TeamSpeak sul tuo VPS o server dedicato Linux, con un utente dedicato e un servizio systemd, poi recuperare la tua chiave di amministrazione e mantenere il server aggiornato.

Ordina un Server

TeamSpeak consuma pochissime risorse. HostMyServers offre diverse soluzioni adatte:

  • VPS NVMe - Sufficiente per la maggior parte dei server vocali
  • VPS Performance - Risorse dedicate, per ospitare TeamSpeak insieme ad altri servizi
  • Server Dedicati Eco - Per le grandi community con una licenza adeguata

Prerequisiti

  • Accesso SSH come root o utente con sudo
  • Sistema Linux a 64 bit: Debian 12/13 o Ubuntu 22.04/24.04
  • Firewall attivo: nftables (consigliato), iptables o ufw (usa un solo strumento firewall alla volta)
  • Porte 9987 UDP e 30033 TCP accessibili
  • Il client TeamSpeak sul PC di ogni utente

Configurazione richiesta

TeamSpeak non pubblica una configurazione minima quantificata. I valori seguenti sono un ordine di grandezza per un server da 32 slot:

Componente Consigliato
RAM 512 MB disponibili
CPU 1 core
Archiviazione 2 GB, più lo spazio dei file condivisi dagli utenti
Rete Connessione stabile, la latenza conta più della banda

Scegliere la licenza

Senza file di licenza, il server funziona gratuitamente con un server virtuale e 32 slot, per un uso non commerciale. Oltre questi limiti, o per un uso commerciale, serve una licenza.

Licenza Limiti indicati nel contratto TeamSpeak Utilizzo
Senza licenza 1 server virtuale, 32 slot Privati e gruppi non commerciali
Non-Profit (NPL) 2 server virtuali, 512 slot, durata di 6 mesi Gruppi non commerciali
Annual Activation (AAL) Da 1 server e 32 slot a 2 server e 1024 slot, durata di un anno Licenza a pagamento

Le offerte e la loro disponibilità cambiano: verificale sul sito di vendita TeamSpeak. Il contratto completo si trova nel file LICENSE fornito con il server.

Aggiornamento del sistema

Terminale
sudo apt update && sudo apt upgrade -y

Installazione delle dipendenze

Terminale
sudo apt install -y ca-certificates curl tar bzip2 jq less cron

Creazione di un utente dedicato

Il server non deve mai girare come root. Crea un utente dedicato:

Terminale
sudo adduser --disabled-password --gecos "" teamspeak

Porte utilizzate

Porta Protocollo Utilizzo Esposizione
9987 UDP Voce Pubblica, obbligatoria
30033 TCP Trasferimento di file Pubblica, obbligatoria
10022 TCP ServerQuery via SSH Locale in questa guida
10011 TCP ServerQuery non cifrato Disattivato in questa guida
10080 TCP WebQuery in HTTP Disattivato per impostazione predefinita
41144 TCP TSDNS, facoltativo Non usato in questa guida

Il server deve inoltre poter raggiungere in uscita i servizi di TeamSpeak, in particolare accounting2.teamspeak.com sulla porta TCP 443. Non bloccare questo traffico.

Configurazione del firewall

Con UFW

Terminale
sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp
sudo ufw reload

Con iptables

Terminale
sudo iptables -A INPUT -p udp --dport 9987 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 30033 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Il salvataggio delle regole al riavvio richiede il pacchetto iptables-persistent.

Con nftables

Questi comandi usano la tabella inet filter e la catena input, presenti per impostazione predefinita in /etc/nftables.conf su Debian.

Terminale
sudo nft add rule inet filter input udp dport 9987 accept
sudo nft add rule inet filter input tcp dport 30033 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Installazione del server

Apri una sessione con l'utente teamspeak. I comandi seguenti recuperano l'ultima versione pubblicata da TeamSpeak, ne controllano l'impronta SHA-256, poi estraggono l'archivio:

Terminale
sudo -iu teamspeak
mkdir -p ~/teamspeak ~/backups
chmod 700 ~/backups
INFO=$(curl -fsSL https://www.teamspeak.com/versions/server.json)
URL=$(echo "$INFO" | jq -r '.linux.x86_64.mirrors["teamspeak.com"]')
SUM=$(echo "$INFO" | jq -r '.linux.x86_64.checksum')
echo "$URL"
curl -fL -o ~/ts3.tar.bz2 "$URL"
echo "$SUM  $HOME/ts3.tar.bz2" | sha256sum -c - && tar -xjf ~/ts3.tar.bz2 --strip-components=1 -C ~/teamspeak
rm ~/ts3.tar.bz2

La verifica deve mostrare OK. In caso contrario l'archivio non viene estratto: rilancia questi comandi per scaricarlo di nuovo.

Accettare la licenza

Il server rifiuta di avviarsi finché non hai accettato la sua licenza. Leggila (tasto q per uscire):

Terminale
less ~/teamspeak/LICENSE

Se la accetti, crea il file previsto a tale scopo:

Terminale
touch ~/teamspeak/.ts3server_license_accepted

Configurazione del server

Per impostazione predefinita, l'interfaccia di amministrazione ServerQuery è in ascolto su tutti gli indirizzi, compreso quello in chiaro sulla porta 10011. Limitala al protocollo SSH e alla macchina locale:

Terminale
nano ~/teamspeak/ts3server.ini
Configurazione
query_protocols=ssh
query_ssh_ip=127.0.0.1
query_ssh_port=10022
Parametro Descrizione
query_protocols Protocolli ServerQuery attivi: raw, ssh e http
query_ssh_ip Indirizzo di ascolto di ServerQuery via SSH
query_ssh_port Porta di ServerQuery via SSH

Esci poi dalla sessione dell'utente teamspeak:

Terminale
exit

Installare un file di licenza (facoltativo)

Se hai ottenuto una licenza, copia il file licensekey.dat in /home/teamspeak/teamspeak/, poi proteggilo:

Terminale
sudo chown teamspeak:teamspeak /home/teamspeak/teamspeak/licensekey.dat
sudo chmod 600 /home/teamspeak/teamspeak/licensekey.dat

Riavvia il server se è già in esecuzione.

Configurazione come servizio systemd

Creare il file di servizio

Terminale
sudo nano /etc/systemd/system/teamspeak.service

Contenuto del file:

Configurazione
[Unit]
Description=TeamSpeak 3 Server
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak
ExecStart=/home/teamspeak/teamspeak/ts3server_minimal_runscript.sh inifile=ts3server.ini
Restart=on-failure
RestartSec=15
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target

Attivare e avviare il servizio

Terminale
sudo systemctl daemon-reload
sudo systemctl enable teamspeak.service
sudo systemctl start teamspeak.service

Comandi di gestione

Terminale
# Verificare lo stato
sudo systemctl status teamspeak.service

# Fermare il server
sudo systemctl stop teamspeak.service

# Riavviare il server
sudo systemctl restart teamspeak.service

# Vedere i log
sudo journalctl -u teamspeak.service -f

Recuperare la chiave di amministrazione

Al primissimo avvio, il server genera la password dell'account serveradmin e una chiave di privilegio (token):

Terminale
sudo journalctl -u teamspeak.service --no-pager | grep -E 'loginname=|apikey=|token='
Elemento Utilità
token Chiave monouso per ottenere i diritti Server Admin nel client
loginname e password Connessione a ServerQuery
apikey Accesso a WebQuery, se lo attivi

Connessione al server

  1. Installa il client TeamSpeak e avvialo.
  2. Connettiti all'indirizzo IP_DEL_SERVER (porta 9987 per impostazione predefinita).
  3. Alla prima connessione, il client ti chiede una chiave di privilegio: incolla il token. Se la finestra non compare, cerca Use Privilege Key nel menu Permissions o Tools, a seconda del tuo client.

Fai così parte del gruppo Server Admin e puoi configurare il server, i suoi canali e i suoi permessi dal client.

Amministrazione con ServerQuery

Dal server, connettiti con la password serveradmin:

Terminale
ssh -p 10022 serveradmin@127.0.0.1
Comando Descrizione
help Elenca i comandi
use sid=1 Seleziona il primo server virtuale
serverinfo Mostra le informazioni del server virtuale
clientlist Elenca i client connessi
servergrouplist Elenca i gruppi e i loro ID
tokenadd tokentype=0 tokenid1=<gruppo> tokenid2=0 Crea una chiave di privilegio per un gruppo di server
quit Chiude la sessione

Creare una nuova chiave di amministrazione

Se la chiave è stata usata o persa, individua il gruppo Server Admin con servergrouplist. Usa il suo sgid, qui 6 a titolo di esempio:

Testo
use sid=1
servergrouplist
tokenadd tokentype=0 tokenid1=6 tokenid2=0

Amministrare da remoto

Passa di preferenza da un tunnel SSH dal tuo computer, senza aprire porte aggiuntive:

Terminale
ssh -L 10022:127.0.0.1:10022 TUO_USER@IP_DEL_SERVER

Connetti poi il tuo strumento ServerQuery a 127.0.0.1:10022.

Se devi davvero esporre ServerQuery, sostituisci query_ssh_ip=127.0.0.1 con query_ssh_ip=0.0.0.0 in ts3server.ini, riavvia il servizio e limita la porta al tuo indirizzo IP fisso:

Terminale
# UFW
sudo ufw allow from TUO_IP to any port 10022 proto tcp

# iptables
sudo iptables -A INPUT -p tcp -s TUO_IP --dport 10022 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 10022 -j DROP

# nftables
sudo nft add rule inet filter input ip saddr TUO_IP tcp dport 10022 accept
sudo nft add rule inet filter input tcp dport 10022 drop

Aggiornamento del server

Installa gli aggiornamenti rapidamente: le versioni 3.13.8 e 3.13.9 correggono vulnerabilità di sicurezza, tra cui un crash del server attivabile da remoto senza autenticazione. I tuoi dati vengono conservati, ma fai prima un backup: crea in anticipo lo script descritto nella sezione "Backup automatico".

Terminale
sudo /usr/local/sbin/teamspeak-backup.sh
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
INFO=$(curl -fsSL https://www.teamspeak.com/versions/server.json)
URL=$(echo "$INFO" | jq -r '.linux.x86_64.mirrors["teamspeak.com"]')
SUM=$(echo "$INFO" | jq -r '.linux.x86_64.checksum')
curl -fL -o ~/ts3.tar.bz2 "$URL"
echo "$SUM  $HOME/ts3.tar.bz2" | sha256sum -c - && tar -xjf ~/ts3.tar.bz2 --strip-components=1 -C ~/teamspeak
rm ~/ts3.tar.bz2
exit
sudo systemctl start teamspeak.service
sudo journalctl -u teamspeak.service -n 30 --no-pager

La versione installata compare all'inizio dei log, sulla riga TeamSpeak 3 Server.

Backup automatico

Lo script arresta brevemente il server per ottenere una copia coerente del database, poi lo riavvia.

Script di backup

Terminale
sudo nano /usr/local/sbin/teamspeak-backup.sh
Terminale
#!/bin/bash
SERVER_DIR="/home/teamspeak/teamspeak"
BACKUP_DIR="/home/teamspeak/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/teamspeak_$DATE.tar.gz"

# Elementi da conservare, se esistono
ITEMS=()
for ITEM in ts3server.sqlitedb ts3server.sqlitedb-wal ts3server.sqlitedb-shm ts3server.ini \
    .ts3server_license_accepted licensekey.dat ssh_host_rsa_key query_ip_allowlist.txt \
    query_ip_denylist.txt files; do
    [ -e "$SERVER_DIR/$ITEM" ] && ITEMS+=("$ITEM")
done

install -d -m 700 -o teamspeak -g teamspeak "$BACKUP_DIR"

systemctl stop teamspeak.service
tar -czf "$ARCHIVE" -C "$SERVER_DIR" "${ITEMS[@]}"
RESULT=$?
systemctl start teamspeak.service

chown teamspeak:teamspeak "$ARCHIVE"
chmod 600 "$ARCHIVE"

# Eliminare i backup più vecchi di 7 giorni
find "$BACKUP_DIR" -name "teamspeak_*.tar.gz" -mtime +7 -delete

exit $RESULT
Terminale
sudo chmod 700 /usr/local/sbin/teamspeak-backup.sh

Pianificare il backup

Terminale
sudo crontab -e

Aggiungi:

Testo
# Backup ogni giorno alle 5
0 5 * * * /usr/local/sbin/teamspeak-backup.sh

Ripristinare un backup

Sostituisci il nome del file con quello del tuo backup:

Terminale
sudo systemctl stop teamspeak.service
sudo -u teamspeak tar -xzf /home/teamspeak/backups/teamspeak_2026-01-01_05-00-00.tar.gz -C /home/teamspeak/teamspeak
sudo systemctl start teamspeak.service

Copia regolarmente questi archivi fuori dal server: contengono il database e l'eventuale licenza.

In caso di problemi

Il server chiede di accettare la licenza

Il messaggio Please set the environment variable TS3SERVER_LICENSE to "accept" significa che il file di accettazione è assente:

Terminale
sudo -u teamspeak touch /home/teamspeak/teamspeak/.ts3server_license_accepted
sudo systemctl restart teamspeak.service

Errore instance check error

Senza licenza, il server verifica che nessun'altra istanza sia in esecuzione, tramite /dev/shm.

  • Cerca un'altra istanza: pgrep -a ts3server
  • Verifica che /dev/shm sia montato: df -h /dev/shm

Se non lo è, montalo poi aggiungi la riga tmpfs /dev/shm tmpfs defaults 0 0 in /etc/fstab:

Terminale
sudo mount -t tmpfs tmpfs /dev/shm

I client non riescono a connettersi

  • Verifica che la porta 9987 sia aperta in UDP: sudo ufw status
  • Verifica che il server sia in ascolto: sudo ss -ulnp | grep 9987
  • Verifica che il servizio sia in esecuzione: sudo systemctl status teamspeak.service

I trasferimenti di file o gli avatar falliscono

Probabilmente la porta 30033 in TCP è bloccata. Verifica il firewall e l'ascolto del server:

Terminale
sudo ss -ltnp | grep 30033

Password serveradmin persa

Arresta il servizio, poi avvia una volta il server a mano con una nuova password:

Terminale
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
cd ~/teamspeak
./ts3server_minimal_runscript.sh inifile=ts3server.ini serveradmin_password=NuovaPassword

Quando il server è partito, arrestalo con Ctrl+C, digita exit, poi rilancia il servizio:

Terminale
sudo systemctl start teamspeak.service

Questa password può restare visibile nella cronologia della shell: cambiala in seguito oppure svuota la cronologia.

Connessione ServerQuery rifiutata o bannata

Dopo diversi tentativi falliti, ServerQuery blocca temporaneamente l'indirizzo interessato. Attendi qualche minuto e verifica la tua password. Per esentare un indirizzo fidato, aggiungilo in query_ip_allowlist.txt, poi riavvia il servizio.

Errore unable to connect to accounting server

Il server non riesce a raggiungere i servizi di licenza di TeamSpeak. Verifica il DNS e il traffico in uscita della macchina:

Terminale
curl -I https://accounting2.teamspeak.com

Il codice HTTP restituito non importa: l'importante è ottenere una risposta.

Avviso The system locale is set to "C"

Questo messaggio è innocuo. Indica che il servizio gira senza una lingua definita. Puoi ignorarlo.