Réponse courte. Un nouveau serveur TeamSpeak affiche une ServerAdmin privilege key (une ligne qui commence par token=) à son tout premier démarrage, dans la console et dans le journal du serveur virtuel 1. Une clé ne marche qu'une fois. Pour en créer une nouvelle sur TeamSpeak 3, connectez-vous à ServerQuery en tant que serveradmin et exécutez privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0 ; sur TeamSpeak 6, envoyez la même commande à la requête HTTP avec une clé d'API. Mot de passe ServerQuery perdu aussi ? Démarrez TeamSpeak 3 une fois avec serveradmin_password=, ou TeamSpeak 6 avec --query-http-enable et --query-admin-api-key. Nous avons créé de nouvelles clés ainsi sur TeamSpeak 3 server 3.13.8 et TeamSpeak 6 server v6.0.0-beta13.1 le 6 novembre 2026. TeamSpeak 6 server v6.0.0-beta14 est sorti le 17 novembre 2026 ; nous n'avons pas refait ces étapes dessus.
Ce qu'est le privilege key
Le guide de TeamSpeak lui-même (doc/privilegekey_guide.txt dans le téléchargement de TeamSpeak 3) indique qu'un serveur TeamSpeak 3 n'a ni identifiants ni mots de passe d'utilisateur : il reconnaît les personnes à un ID unique issu d'une paire de clés que leur client crée. Le premier admin a donc besoin d'un ticket : le privilege key. TeamSpeak 6 utilise le même type de clé. Le coller dans le client TeamSpeak place cette identité dans le groupe Server Admin du serveur virtuel pour lequel la clé a été créée. Le même guide précise qu'une clé ne peut servir qu'une seule fois.
Retrouver la clé du premier démarrage
Au premier démarrage, les deux versions affichent les deux mêmes lignes :
ServerAdmin privilege key created, please use the line below
token=...
TeamSpeak 3 sous Linux : le serveur l'écrit dans le journal du serveur virtuel 1, le fichier de logs/ dont le nom se termine par _1.log :
grep token= logs/*_1.log
TeamSpeak 6 avec Docker :
docker logs teamspeak-server 2>&1 | grep token=
TeamSpeak 6 sans Docker : le même grep que pour TeamSpeak 3, dans le dossier logs/ du serveur.
Le premier démarrage affiche aussi un identifiant ServerQuery dans un encadré de la console : loginname= "serveradmin", password= "..." et une apikey. Gardez-les en lieu sûr. Ils ne sont affichés qu'au premier démarrage, et ce sont eux qui servent à créer une nouvelle clé.
Créer une nouvelle clé sur TeamSpeak 3
Faites-le sur la machine où tourne le serveur. ServerQuery écoute sur le port TCP 10011, qui ne doit pas être ouvert sur internet.
Connectez-vous à ServerQuery avec un simple client TCP. Le manuel ServerQuery de TeamSpeak cite Telnet (sous Debian ou Ubuntu, sudo apt install telnet s'il manque) :
telnet 127.0.0.1 10011
Connectez-vous, choisissez le serveur virtuel 1 et créez la clé :
login serveradmin YOUR_QUERY_PASSWORD
use sid=1
privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
quit
Le serveur répond token=... suivi de error id=0 msg=ok. Collez le token dans votre client TeamSpeak. ServerQuery échappe une barre oblique en \/ dans ses réponses : si le token affiche \/, saisissez-le avec /.
tokenid1=6 correspond au groupe Server Admin d'un nouveau serveur virtuel : la clé que le serveur crée à son premier démarrage pointe elle aussi sur le groupe 6. Si vous avez renommé ou reconstruit vos groupes, exécutez servergrouplist après use sid=1 et prenez le sgid du groupe admin avec type=1. Les groupes avec type=0 sont des modèles et ceux avec type=2 sont des groupes ServerQuery.
Mot de passe ServerQuery perdu
Le guide de démarrage rapide de TeamSpeak dit que le seul moyen d'obtenir un nouveau mot de passe est de supprimer la base de données du serveur. Sur 3.13.8, il existe une méthode plus douce : démarrer le serveur une fois avec un nouveau mot de passe comme paramètre de démarrage. Le script de démarrage transmet les paramètres au serveur. N'utilisez que des lettres et des chiffres, car ServerQuery traite les espaces et certains symboles comme des caractères spéciaux :
Dans notre test, le journal a alors indiqué updated server query admin password et le nouveau mot de passe a permis de se connecter. Créez votre nouvelle clé comme ci-dessus pendant que le serveur tourne, puis redémarrez-le normalement.
Créer une nouvelle clé sur TeamSpeak 6
TeamSpeak 6 n'a pas de ServerQuery en texte brut sur le port 10011 : son CONFIG.md liste des interfaces de requête SSH, HTTP et HTTPS, toutes désactivées par défaut. La requête HTTP utilise une clé d'API que vous définissez au démarrage.
Redémarrez le serveur avec la requête HTTP activée et une clé d'API de votre choix :
La réponse est du JSON : {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Collez le token dans votre client TeamSpeak. Le journal du serveur ajoute une ligne indiquant que serveradmin a ajouté un privilege key pour le groupe de serveur Server Admin.
Redémarrez sans --query-http-enable si vous n'avez pas besoin de la requête HTTP.
Avec Docker, recréez le conteneur avec deux variables d'environnement et le port de la requête HTTP publié uniquement sur 127.0.0.1, pour qu'il ne soit pas joignable depuis internet. Vos données restent dans le volume :
Exécutez ensuite le même curl qu'à l'étape 2. Utilisez ici des variables d'environnement, pas des options après le nom de l'image : la commande de l'image est tsserver, donc tout ce qui suit le nom de l'image la remplace, et lors de notre test la requête HTTP n'a pas répondu quand nous avons essayé de cette façon. Recréez le conteneur sans les deux variables de requête et sans le port 10080 quand vous n'avez plus besoin de la requête HTTP. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) définit le mot de passe du compte de requête serveradmin ; la requête HTTP ci-dessus n'en a pas besoin (notre test Docker n'a défini que la clé d'API), et la requête SSH reste désactivée tant que vous n'ajoutez pas --query-ssh-enable.
La clé est déclarée invalide
Elle a déjà été utilisée. Chaque clé ne marche qu'une fois. privilegekeylist (TeamSpeak 3) ou /1/privilegekeylist (TeamSpeak 6) liste les clés encore disponibles.
Elle est pour un autre serveur virtuel. Une clé ne marche que sur le serveur virtuel pour lequel elle a été créée.
La requête HTTP répond invalid apikey. L'en-tête x-api-key ne correspond pas à la clé avec laquelle le serveur a démarré.
Une partie n'a pas été copiée. Une clé peut contenir + et /. Copiez tout ce qui suit token=.
Héberger TeamSpeak vous-même
L'installation complète, les limites de licence et la mémoire dont le serveur a besoin : Comment héberger un serveur TeamSpeak. PlayNHost loue des serveurs vocaux Mumble, pas TeamSpeak ; sur Mumble, le premier admin utilise un mot de passe SuperUser fourni par le panel plutôt qu'une clé : Comment devenir admin sur votre serveur Mumble.
Nous utilisons des cookies pour faire fonctionner le site, comprendre son utilisation et mesurer notre marketing. Vous pouvez tout accepter, accepter uniquement les cookies essentiels ou choisir par catégorie.Nous utilisons des cookies pour faire fonctionner le site, comprendre son utilisation et mesurer notre marketing. Ils sont activés par défaut ici. Vous pouvez désactiver ce que vous ne souhaitez pas.Lire notre politique de confidentialité