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.
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
sudo apt update && sudo apt upgrade -yInstallazione delle dipendenze
sudo apt install -y ca-certificates curl tar bzip2 jq less cronCreazione di un utente dedicato
Il server non deve mai girare come root. Crea un utente dedicato:
sudo adduser --disabled-password --gecos "" teamspeakPorte 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
sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp
sudo ufw reloadCon iptables
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.v4Il 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.
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.confInstallazione 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:
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.bz2La 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):
less ~/teamspeak/LICENSESe la accetti, crea il file previsto a tale scopo:
touch ~/teamspeak/.ts3server_license_acceptedConfigurazione 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:
nano ~/teamspeak/ts3server.iniquery_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:
exitInstallare un file di licenza (facoltativo)
Se hai ottenuto una licenza, copia il file licensekey.dat in /home/teamspeak/teamspeak/, poi proteggilo:
sudo chown teamspeak:teamspeak /home/teamspeak/teamspeak/licensekey.dat
sudo chmod 600 /home/teamspeak/teamspeak/licensekey.datRiavvia il server se è già in esecuzione.
Configurazione come servizio systemd
Creare il file di servizio
sudo nano /etc/systemd/system/teamspeak.serviceContenuto del file:
[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.targetAttivare e avviare il servizio
sudo systemctl daemon-reload
sudo systemctl enable teamspeak.service
sudo systemctl start teamspeak.serviceComandi di gestione
# 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 -fRecuperare la chiave di amministrazione
Al primissimo avvio, il server genera la password dell'account serveradmin e una chiave di privilegio (token):
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
- Installa il client TeamSpeak e avvialo.
- Connettiti all'indirizzo
IP_DEL_SERVER(porta9987per impostazione predefinita). - 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:
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:
use sid=1
servergrouplist
tokenadd tokentype=0 tokenid1=6 tokenid2=0Amministrare da remoto
Passa di preferenza da un tunnel SSH dal tuo computer, senza aprire porte aggiuntive:
ssh -L 10022:127.0.0.1:10022 TUO_USER@IP_DEL_SERVERConnetti 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:
# 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 dropAggiornamento 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".
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-pagerLa 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
sudo nano /usr/local/sbin/teamspeak-backup.sh#!/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 $RESULTsudo chmod 700 /usr/local/sbin/teamspeak-backup.shPianificare il backup
sudo crontab -eAggiungi:
# Backup ogni giorno alle 5
0 5 * * * /usr/local/sbin/teamspeak-backup.shRipristinare un backup
Sostituisci il nome del file con quello del tuo backup:
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.serviceCopia 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:
sudo -u teamspeak touch /home/teamspeak/teamspeak/.ts3server_license_accepted
sudo systemctl restart teamspeak.serviceErrore 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/shmsia montato:df -h /dev/shm
Se non lo è, montalo poi aggiungi la riga tmpfs /dev/shm tmpfs defaults 0 0 in /etc/fstab:
sudo mount -t tmpfs tmpfs /dev/shmI 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:
sudo ss -ltnp | grep 30033Password serveradmin persa
Arresta il servizio, poi avvia una volta il server a mano con una nuova password:
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
cd ~/teamspeak
./ts3server_minimal_runscript.sh inifile=ts3server.ini serveradmin_password=NuovaPasswordQuando il server è partito, arrestalo con Ctrl+C, digita exit, poi rilancia il servizio:
sudo systemctl start teamspeak.serviceQuesta 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:
curl -I https://accounting2.teamspeak.comIl 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.