TeamSpeak¶

Dans cet article

• TeamSpeak. Fonctionnalités clés
• Fonctionnalités de déploiement
• Premiers pas après le déploiement du serveur TeamSpeak
• Mise à jour de Ts3-Manager
• Connexion au serveur
• Confirmation des privilèges d'administrateur
• Accès au panneau de contrôle web
• Commande de TeamSpeak via l'API

TeamSpeak. Fonctionnalités clés¶

• Chat vocal de haute qualité : TeamSpeak fournit une transmission vocale claire et nette entre les utilisateurs, ce qui est crucial pour la coordination pendant le jeu.
• Système de canaux : Les utilisateurs peuvent créer un nombre illimité de canaux et les organiser en groupes hiérarchiques, permettant des canaux séparés pour différentes équipes, jeux ou tâches.
• Gestion des droits : Les administrateurs de serveur peuvent attribuer différents droits aux utilisateurs, tels que la capacité de créer des canaux, d'expulser des membres, etc.
• Prise en charge du son 3D : TeamSpeak positionne la voix de chaque utilisateur dans la salle virtuelle, facilitant la navigation pendant le jeu.
• Enregistrement de chat vocal : Possibilité d'enregistrer les conversations vocales pour une écoute ultérieure ou un partage.
• Multiplateforme : Disponible pour Windows, MacOS, Linux et appareils mobiles.

Fonctionnalités de déploiement¶

• Logiciel installé :
  • Docker avec les conteneurs suivants :
    • TeamSpeak Server (image mbentley/teamspeak:latest)
      • Ports : 9987 (UDP), 10011, 30033, 41144 (TCP)
    • TeamSpeak Manager (image joni1802/ts3-manager)
      • Port : 8080
    • Nginx avec Let's Encrypt (image jonsal/nginx-certbot)
  • Plugin Docker Compose

Pour vérifier le fonctionnement du serveur TeamSpeak :

1. Vérifier l'état du conteneur :

   docker ps | grep teamspeak
   

2. Afficher les journaux du conteneur :

   docker logs teamspeak
   

3. Vérifier la disponibilité des ports :

   netstat -tulpn | grep -E '9987|10011|30033|41144'
   

Premiers pas après le déploiement du serveur TeamSpeak¶

Après l'achat d'une commande, vous recevrez une notification à l'adresse e-mail fournie lors de l'inscription, indiquant que votre serveur est prêt à être utilisé. Cette notification inclura l'adresse IP du VPS et les identifiants de connexion. Les clients de notre entreprise gèrent l'équipement via le panneau de gestion de serveur et l'API — Invapi.

Pour commencer à utiliser le service, téléchargez le client TeamSpeak sur votre appareil local et installez-le.

Mise à jour de Ts3-Manager¶

1. Sauvegarder la configuration actuelle

   Enregistrez les informations sur le conteneur actuel. Pour revenir en arrière si nécessaire, exécutez :

   docker inspect ts3-manager > /opt/ts3-manager-backup.json
   

   Vérifiez les données dans le volume :

   ls -l /opt/tsi-web
   

2. Arrêter et supprimer l'ancien conteneur

   Si le conteneur ts3-manager existe (même si docker ps ne l'affiche pas), exécutez :

   docker stop ts3-manager
   

   docker rm ts3-manager
   

3. Démarrer un nouveau conteneur Ts3-Manager v2.2.3

   docker run -d \
     --name ts3-manager \
     -p 8080:8080 \
     -v /opt/tsi-web:/app/data \
     -e PORT=8080 \
     -e JWT_SECRET=$(openssl rand -hex 32) \
     -e WHITELIST=teamspeak \
     --network bridge \
     --restart unless-stopped \
     joni1802/ts3-manager:v2.2.3
   

4. Vérifier le démarrage

   Assurez-vous que le conteneur a démarré avec succès :

   docker ps | grep ts3-manager
   

   docker logs ts3-manager
   

   Si la mise à jour a réussi, alors :
   • Dans la sortie de docker ps, le conteneur ts3-manager doit être dans l'état Up.
   • Dans les journaux de docker logs ts3-manager, un message comme celui-ci doit apparaître :

     Server listening on http://127.0.0.1:8080
     

   Connexion au serveur¶

Pour vous connecter au serveur, vous avez besoin de :

• Dans le panneau de contrôle, copiez l'Server IP Address de l'onglet Network — Server ID and IP Address.
• Facultatif - Inscrivez-vous sur votre compte TeamSpeak personnel. Cela simplifiera la gestion et la configuration du serveur.

• Facultatif - Ajoutez le serveur à votre compte TeamSpeak personnel. Entrez l'adresse IP du serveur et le numéro de port (9987), ainsi que le nom du serveur.

  

Après avoir lancé le client TeamSpeak sur votre appareil local, entrez l'adresse IP du serveur dans le champ indiqué dans la capture d'écran ci-dessous et cliquez sur le bouton Connect :

Confirmation des privilèges d'administrateur¶

Pour confirmer les privilèges d'administrateur, vous devez vous connecter au serveur via SSH et exécuter la commande suivante :

docker logs teamspeak | tail -n 50 | grep "password"

L'exécution de cette commande affichera les données importantes suivantes :

1. Identifiants du compte ServerQuery Admin (fonction pour administrer un serveur TeamSpeak 3 basée sur une interface en ligne de commande) :

   • Identifiant : serveradmin ;
   • Mot de passe (généré par le système) ;
   • Clé API.

2. Clé de privilège (token) pour obtenir les privilèges d'administrateur sur le serveur virtuel.

Un exemple de sortie ressemblera à ceci :

Vous devez sauvegarder ces données, car elles seront requises pour :

• Se connecter à l'interface ServerQuery ;
• Obtenir les privilèges d'administrateur sur le serveur virtuel ;
• Gérer le serveur via l'API ;
• Gestion du serveur via l'interface web TS3 Manager.

Il est important de noter que la clé de privilège ne peut être utilisée qu'une seule fois, et que le mot de passe ServerQuery doit être modifié immédiatement après la première connexion.

Dans le client TeamSpeak, cliquez sur le nom du serveur et répondez "Yes" à la question Is this your TeamSpeak server? :

Entrez la clé copiée :

Après avoir confirmé les privilèges d'administrateur, vous pouvez créer de nouvelles clés. Pour ce faire :

• Ouvrez le menu contextuel en faisant un clic droit sur l'icône du serveur dans la fenêtre principale de TeamSpeak.
• Dans les paramètres du serveur, allez à l'onglet Show Privilege Keys :

• Cliquez sur le bouton Create pour générer une nouvelle clé de privilège :

• Une fenêtre s'ouvrira où vous pouvez choisir le groupe pour lequel la clé est créée. Les options suivantes sont disponibles :

  • Server Admin : Groupe avec des privilèges maximaux, ayant un contrôle administratif complet sur le serveur.
  • Normal : Groupe avec des droits limités, destiné aux utilisateurs réguliers.
  • Guest : Groupe avec des droits minimaux pour l'accès invité.

• Sélectionnez le groupe pour lequel vous devez créer une clé de privilège.

• Dans le champ Description, entrez une brève explication de l'objectif de la clé créée.
• Après avoir entré la description, cliquez sur le bouton Create :

La nouvelle clé de privilège sera générée et affichée dans la liste des clés.

Vous pouvez utiliser la clé créée pour accorder des privilèges appropriés aux utilisateurs ou administrateurs sur ce serveur TeamSpeak.

Accès au panneau de contrôle web¶

• Server : Adresse IP du serveur ou nom de domaine du serveur (sans https://). Vous pouvez copier l'adresse depuis le panneau de contrôle dans l'onglet Network - Server IP Address ;
• Port : 10011 ;
• Name : serveradmin ;
• Password : Le mot de passe de l'administrateur du serveur, reçu comme décrit précédemment.

Après une authentification réussie, vous aurez accès aux fonctionnalités suivantes :

• Server List. Cet élément de gestion central affiche tous les serveurs TeamSpeak 3 enregistrés dans le système. Les administrateurs peuvent afficher des informations générales sur chaque serveur, y compris son statut opérationnel, le nombre d'utilisateurs connectés, le temps de fonctionnement et les ports utilisés. La gestion de base du serveur est effectuée via cette interface : démarrage, arrêt, redémarrage et configuration des paramètres de base.
• Server Viewer. Un outil interactif pour la surveillance visuelle en temps réel du serveur. Il affiche une structure arborescente des canaux du serveur, montrant tous les utilisateurs connectés et leur activité. Il permet d'observer les déplacements des utilisateurs entre les canaux, de surveiller l'activité vocale et de répondre rapidement à diverses situations.
• Chat. Un système de messagerie instantanée intégré qui facilite la communication entre les administrateurs et les utilisateurs sur le serveur. Il prend en charge les chats personnels et de groupe, permet le partage de fichiers et utilise le formatage de texte. Il conserve l'historique du chat pour une analyse ultérieure.
• File Browser. Cet outil gère le système de fichiers du serveur TeamSpeak 3. Accédez aux fichiers téléchargés, aux avatars des utilisateurs et à d'autres médias via celui-ci. Les administrateurs peuvent gérer le contenu du serveur, contrôler l'utilisation de l'espace disque et définir les autorisations d'accès aux fichiers.
• Server Log. Un système de journalisation qui enregistre tous les événements se produisant sur le serveur. Il consigne les informations sur les connexions des utilisateurs, les modifications de configuration, les événements système et les erreurs. Un outil essentiel pour résoudre les problèmes et surveiller la sécurité du serveur.
• Backup/Restore. Cet outil complet assure la sécurité des données sur le serveur. Il permet de créer des sauvegardes de tous les paramètres, bases de données et données utilisateur. Il inclut des fonctionnalités de sauvegarde automatique et de restauration des données en cas de défaillance.
• Server Query. Un outil avancé pour l'interaction directe avec le serveur via une interface de commande. Il permet des opérations de gestion de serveur complexes à l'aide de commandes spéciales, récupère des informations détaillées sur l'état du serveur et permet l'ajustement fin des paramètres.
• Privilege Keys. Un système de gestion des clés d'accès privilégié. Cette interface crée et distribue des clés spéciales qui accordent aux utilisateurs des droits et privilèges spécifiques sur le serveur.
• API Keys. La section pour gérer les clés pour l'interaction logicielle avec le serveur via une API. Elle permet de créer et de configurer des clés d'accès pour l'intégration de TeamSpeak 3 avec des applications et services externes.
• Ban List. Un outil pour gérer les blocages d'utilisateurs. Il contient des informations sur les utilisateurs bloqués, les raisons et la durée des blocages. Il contrôle efficacement l'accès des utilisateurs indésirables au serveur.
• Complaints List. Un système de traitement des plaintes des utilisateurs. Les administrateurs peuvent afficher les plaintes soumises, suivre leur statut et prendre les mesures nécessaires pour résoudre les conflits.
• List All Clients. Une liste complète de tous les utilisateurs qui se sont connectés au serveur. Elle inclut des informations détaillées sur chaque client, y compris l'historique des connexions, les pseudonymes utilisés et les données techniques.
• Server Groups. Un outil pour gérer les groupes d'utilisateurs au niveau du serveur. Il permet de créer et de configurer divers groupes avec des droits et privilèges spécifiques, simplifiant l'administration d'un grand nombre d'utilisateurs.
• Channel Groups. Un système de gestion des groupes au niveau du canal. Il permet de configurer des droits et privilèges spécifiques pour les utilisateurs au sein de canaux spécifiques ou de leurs groupes.
• Permissions. Un système complet de configuration des autorisations. Il permet d'ajuster finement les autorisations d'accès pour différents groupes d'utilisateurs, définissant leurs capacités sur le serveur, dans les canaux et lors de l'interaction avec d'autres utilisateurs.
• Logout. La fonction pour terminer en toute sécurité la session de l'administrateur. À la sortie, toutes les connexions actives sont correctement fermées et toutes les modifications apportées aux paramètres sont enregistrées.

Commande de TeamSpeak via l'API¶