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.
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
sudo apt update && sudo apt upgrade -yInstallation des dépendances
sudo apt install -y ca-certificates curl tar bzip2 jq less cronCréation d'un utilisateur dédié
Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :
sudo adduser --disabled-password --gecos "" teamspeakPorts 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
sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp
sudo ufw reloadAvec 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.v4La 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.
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.confInstallation 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 :
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 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) :
less ~/teamspeak/LICENSESi vous l'acceptez, créez le fichier prévu à cet effet :
touch ~/teamspeak/.ts3server_license_acceptedConfiguration 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 :
nano ~/teamspeak/ts3server.iniquery_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 :
exitInstaller un fichier de licence (optionnel)
Si vous avez obtenu une licence, copiez le fichier licensekey.dat dans /home/teamspeak/teamspeak/, puis protégez-le :
sudo chown teamspeak:teamspeak /home/teamspeak/teamspeak/licensekey.dat
sudo chmod 600 /home/teamspeak/teamspeak/licensekey.datRedémarrez le serveur si celui-ci tourne déjà.
Configuration en tant que service systemd
Créer le fichier de service
sudo nano /etc/systemd/system/teamspeak.serviceContenu du fichier :
[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.targetActiver et démarrer le service
sudo systemctl daemon-reload
sudo systemctl enable teamspeak.service
sudo systemctl start teamspeak.serviceCommandes de gestion
# 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 -fRé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) :
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
- Installez le client TeamSpeak et lancez-le.
- Connectez-vous à l'adresse
IP_DU_SERVEUR(port9987par défaut). - À 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 :
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 :
use sid=1
servergrouplist
tokenadd tokentype=0 tokenid1=6 tokenid2=0Administrer à distance
Passez de préférence par un tunnel SSH depuis votre ordinateur, sans ouvrir de port supplémentaire :
ssh -L 10022:127.0.0.1:10022 VOTRE_USER@IP_DU_SERVEURConnectez 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 :
# 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 dropMise à 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 ».
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 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
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"
# É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 $RESULTsudo chmod 700 /usr/local/sbin/teamspeak-backup.shPlanifier la sauvegarde
sudo crontab -eAjoutez :
# Sauvegarde tous les jours à 5 h
0 5 * * * /usr/local/sbin/teamspeak-backup.shRestaurer une sauvegarde
Remplacez le nom du fichier par celui de votre sauvegarde :
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.serviceCopiez 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 :
sudo -u teamspeak touch /home/teamspeak/teamspeak/.ts3server_license_accepted
sudo systemctl restart teamspeak.serviceErreur 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/shmest 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 :
sudo mount -t tmpfs tmpfs /dev/shmLes 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 :
sudo ss -ltnp | grep 30033Mot de passe serveradmin perdu
Arrêtez le service, puis lancez une fois le serveur à la main avec un nouveau mot de passe :
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
cd ~/teamspeak
./ts3server_minimal_runscript.sh inifile=ts3server.ini serveradmin_password=NouveauMotDePasseQuand le serveur a démarré, arrêtez-le avec Ctrl+C, tapez exit, puis relancez le service :
sudo systemctl start teamspeak.serviceCe 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 :
curl -I https://accounting2.teamspeak.comPeu 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.