FR

Serveurs de jeux

Comment créer un serveur TeamSpeak

Guide complet pour installer un serveur vocal TeamSpeak sur un VPS ou serveur dédié Linux : licence, clé d'administration, ports, service systemd, mises à jour, sauvegarde et dépannage.

9 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment installer un serveur vocal TeamSpeak sur votre VPS ou serveur dédié Linux, avec un utilisateur dédié et un service systemd, puis récupérer votre clé d'administration et maintenir le serveur à jour.

Commander un serveur

TeamSpeak consomme très peu de ressources. HostMyServers propose plusieurs offres adaptées :

  • VPS NVMe - Suffisant pour la plupart des serveurs vocaux
  • VPS Performance - Ressources dédiées, pour héberger TeamSpeak avec d'autres services
  • Serveurs dédiés Eco - Pour les grandes communautés disposant d'une licence adaptée

Prérequis

  • Accès SSH root ou utilisateur avec sudo
  • Système Linux 64 bits : Debian 12/13 ou Ubuntu 22.04/24.04
  • Pare-feu actif : nftables (recommandé), iptables ou ufw (n'utilisez qu'un seul outil de pare-feu à la fois)
  • Ports 9987 UDP et 30033 TCP accessibles
  • Le client TeamSpeak sur le poste de chaque utilisateur

Configuration requise

TeamSpeak ne publie pas de configuration minimale chiffrée. Les valeurs suivantes sont un ordre de grandeur pour un serveur de 32 places :

Composant Conseillé
RAM 512 Mo disponibles
CPU 1 cœur
Stockage 2 Go, plus l'espace des fichiers partagés par les utilisateurs
Réseau Connexion stable, la latence compte plus que le débit

Choisir sa licence

Sans fichier de licence, le serveur fonctionne gratuitement avec un serveur virtuel et 32 places, pour un usage non commercial. Au-delà, ou pour un usage commercial, il vous faut une licence.

Licence Limites indiquées dans le contrat TeamSpeak Usage
Sans licence 1 serveur virtuel, 32 places Particuliers et groupes non commerciaux
Non-Profit (NPL) 2 serveurs virtuels, 512 places, durée de 6 mois Groupes non commerciaux
Annual Activation (AAL) De 1 serveur et 32 places à 2 serveurs et 1024 places, durée d'un an Licence payante

Les offres et leur disponibilité évoluent : vérifiez-les sur le site de vente TeamSpeak. Le contrat complet se trouve dans le fichier LICENSE fourni avec le serveur.

Mise à jour du système

Terminal
sudo apt update && sudo apt upgrade -y

Installation des dépendances

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

Création d'un utilisateur dédié

Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :

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

Ports utilisés

Port Protocole Utilisation Exposition
9987 UDP Voix Public, obligatoire
30033 TCP Transfert de fichiers Public, obligatoire
10022 TCP ServerQuery par SSH Local dans ce guide
10011 TCP ServerQuery non chiffré Désactivé dans ce guide
10080 TCP WebQuery en HTTP Désactivé par défaut
41144 TCP TSDNS, optionnel Non utilisé dans ce guide

Le serveur doit aussi pouvoir joindre les services de TeamSpeak en sortie, notamment accounting2.teamspeak.com sur le port TCP 443. Ne bloquez pas ce trafic.

Configuration du pare-feu

Avec UFW

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

Avec iptables

Terminal
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

La sauvegarde des règles au redémarrage nécessite le paquet iptables-persistent.

Avec nftables

Ces commandes utilisent la table inet filter et la chaîne input, présentes par défaut dans /etc/nftables.conf sous Debian.

Terminal
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

Installation du serveur

Ouvrez une session avec l'utilisateur teamspeak. Les commandes suivantes récupèrent la dernière version publiée par TeamSpeak, contrôlent son empreinte SHA-256, puis extraient l'archive :

Terminal
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 vérification doit afficher OK. Dans le cas contraire, l'archive n'est pas extraite : relancez ces commandes pour la télécharger de nouveau.

Accepter la licence

Le serveur refuse de démarrer tant que vous n'avez pas accepté sa licence. Lisez-la (touche q pour quitter) :

Terminal
less ~/teamspeak/LICENSE

Si vous l'acceptez, créez le fichier prévu à cet effet :

Terminal
touch ~/teamspeak/.ts3server_license_accepted

Configuration du serveur

Par défaut, l'interface d'administration ServerQuery écoute sur toutes les adresses, y compris en clair sur le port 10011. Limitez-la au protocole SSH et à la machine locale :

Terminal
nano ~/teamspeak/ts3server.ini
Configuration
query_protocols=ssh
query_ssh_ip=127.0.0.1
query_ssh_port=10022
Paramètre Description
query_protocols Protocoles ServerQuery actifs : raw, ssh et http
query_ssh_ip Adresse d'écoute de ServerQuery en SSH
query_ssh_port Port de ServerQuery en SSH

Quittez ensuite la session de l'utilisateur teamspeak :

Terminal
exit

Installer un fichier de licence (optionnel)

Si vous avez obtenu une licence, copiez le fichier licensekey.dat dans /home/teamspeak/teamspeak/, puis protégez-le :

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

Redémarrez le serveur si celui-ci tourne déjà.

Configuration en tant que service systemd

Créer le fichier de service

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

Contenu du fichier :

Configuration
[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

Activer et démarrer le service

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

Commandes de gestion

Terminal
# Vérifier le statut
sudo systemctl status teamspeak.service

# Arrêter le serveur
sudo systemctl stop teamspeak.service

# Redémarrer le serveur
sudo systemctl restart teamspeak.service

# Voir les logs
sudo journalctl -u teamspeak.service -f

Récupérer la clé d'administration

Au tout premier démarrage, le serveur génère le mot de passe du compte serveradmin et une clé de privilège (token) :

Terminal
sudo journalctl -u teamspeak.service --no-pager | grep -E 'loginname=|apikey=|token='
Élément Utilité
token Clé à usage unique pour obtenir les droits Server Admin dans le client
loginname et password Connexion à ServerQuery
apikey Accès à WebQuery, si vous l'activez

Connexion au serveur

  1. Installez le client TeamSpeak et lancez-le.
  2. Connectez-vous à l'adresse IP_DU_SERVEUR (port 9987 par défaut).
  3. À la première connexion, le client vous demande une clé de privilège : collez le token. Si la fenêtre n'apparaît pas, cherchez Use Privilege Key dans le menu Permissions ou Tools, selon votre client.

Vous faites alors partie du groupe Server Admin et pouvez configurer le serveur, ses salons et ses permissions depuis le client.

Administration avec ServerQuery

Depuis le serveur, connectez-vous avec le mot de passe serveradmin :

Terminal
ssh -p 10022 serveradmin@127.0.0.1
Commande Description
help Liste les commandes
use sid=1 Sélectionne le premier serveur virtuel
serverinfo Affiche les informations du serveur virtuel
clientlist Liste les clients connectés
servergrouplist Liste les groupes et leurs identifiants
tokenadd tokentype=0 tokenid1=<groupe> tokenid2=0 Crée une clé de privilège pour un groupe de serveur
quit Ferme la session

Créer une nouvelle clé d'administration

Si la clé a été utilisée ou perdue, repérez le groupe Server Admin avec servergrouplist. Utilisez son sgid, ici 6 à titre d'exemple :

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

Administrer à distance

Passez de préférence par un tunnel SSH depuis votre ordinateur, sans ouvrir de port supplémentaire :

Terminal
ssh -L 10022:127.0.0.1:10022 VOTRE_USER@IP_DU_SERVEUR

Connectez ensuite votre outil ServerQuery à 127.0.0.1:10022.

Si vous devez vraiment exposer ServerQuery, remplacez query_ssh_ip=127.0.0.1 par query_ssh_ip=0.0.0.0 dans ts3server.ini, redémarrez le service, et limitez le port à votre adresse IP fixe :

Terminal
# UFW
sudo ufw allow from VOTRE_IP to any port 10022 proto tcp

# iptables
sudo iptables -A INPUT -p tcp -s VOTRE_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 VOTRE_IP tcp dport 10022 accept
sudo nft add rule inet filter input tcp dport 10022 drop

Mise à jour du serveur

Installez les mises à jour rapidement : les versions 3.13.8 et 3.13.9 corrigent des failles de sécurité, dont un plantage du serveur déclenchable à distance sans authentification. Vos données sont conservées, mais faites d'abord une sauvegarde : créez au préalable le script décrit dans la section « Sauvegarde automatique ».

Terminal
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 version installée apparaît au début des logs, sur la ligne TeamSpeak 3 Server.

Sauvegarde automatique

Le script arrête brièvement le serveur pour obtenir une copie cohérente de la base de données, puis le relance.

Script de sauvegarde

Terminal
sudo nano /usr/local/sbin/teamspeak-backup.sh
Terminal
#!/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"

# Éléments à conserver, s'ils existent
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"

# Supprimer les sauvegardes de plus de 7 jours
find "$BACKUP_DIR" -name "teamspeak_*.tar.gz" -mtime +7 -delete

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

Planifier la sauvegarde

Terminal
sudo crontab -e

Ajoutez :

Texte
# Sauvegarde tous les jours à 5 h
0 5 * * * /usr/local/sbin/teamspeak-backup.sh

Restaurer une sauvegarde

Remplacez le nom du fichier par celui de votre sauvegarde :

Terminal
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

Copiez régulièrement ces archives hors du serveur : elles contiennent la base de données et votre éventuelle licence.

En cas de problème

Le serveur demande d'accepter la licence

Le message Please set the environment variable TS3SERVER_LICENSE to "accept" signifie que le fichier d'acceptation est absent :

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

Erreur instance check error

Sans licence, le serveur vérifie qu'aucune autre instance ne tourne, à l'aide de /dev/shm.

  • Cherchez une autre instance : pgrep -a ts3server
  • Vérifiez que /dev/shm est monté : df -h /dev/shm

S'il ne l'est pas, montez-le puis ajoutez la ligne tmpfs /dev/shm tmpfs defaults 0 0 dans /etc/fstab :

Terminal
sudo mount -t tmpfs tmpfs /dev/shm

Les clients ne peuvent pas se connecter

  • Vérifiez que le port 9987 est ouvert en UDP : sudo ufw status
  • Vérifiez que le serveur écoute : sudo ss -ulnp | grep 9987
  • Vérifiez que le service tourne : sudo systemctl status teamspeak.service

Les transferts de fichiers ou les avatars échouent

Le port 30033 en TCP est probablement bloqué. Vérifiez le pare-feu et l'écoute du serveur :

Terminal
sudo ss -ltnp | grep 30033

Mot de passe serveradmin perdu

Arrêtez le service, puis lancez une fois le serveur à la main avec un nouveau mot de passe :

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

Quand le serveur a démarré, arrêtez-le avec Ctrl+C, tapez exit, puis relancez le service :

Terminal
sudo systemctl start teamspeak.service

Ce mot de passe peut rester visible dans l'historique du shell : changez-le ensuite ou videz cet historique.

Connexion ServerQuery refusée ou bannie

Après plusieurs échecs, ServerQuery bloque temporairement l'adresse concernée. Attendez quelques minutes et vérifiez votre mot de passe. Pour exempter une adresse de confiance, ajoutez-la dans query_ip_allowlist.txt, puis redémarrez le service.

Erreur unable to connect to accounting server

Le serveur n'arrive pas à joindre les services de licence de TeamSpeak. Vérifiez le DNS et le trafic sortant de la machine :

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

Peu importe le code HTTP renvoyé : l'important est d'obtenir une réponse.

Avertissement The system locale is set to "C"

Ce message est sans gravité. Il indique que le service tourne sans langue définie. Vous pouvez l'ignorer.