TeamSpeak¶

Dans cet article

• TeamSpeak. Caractéristiques clés
• Fonctionnalités de déploiement
• Démarrage après le déploiement du serveur TeamSpeak
• Mise à jour de Ts3-Manager
• Connexion au serveur
• Confirmation des privilèges administrateur
• Accès au panneau de contrôle Web**
• Commander TeamSpeak via API

TeamSpeak. Caractéristiques 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 d'avoir des canaux séparés pour différentes équipes, jeux ou tâches.
• Gestion des droits : Les administrateurs du serveur peuvent attribuer différents droits aux utilisateurs, tels que la possibilité de créer des canaux, d'expulser des membres, etc.
• Support 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 ou un partage ultérieur.
• Cross-Platform : Disponible pour Windows, MacOS, Linux et appareils mobiles.

Fonctionnalités de déploiement¶

• Logiciels installés :
  • 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 jonasal/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 logs du conteneur :

   docker logs teamspeak
   

3. Vérifier la disponibilité des ports :

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

Démarrage après le déploiement du serveur TeamSpeak¶

Après avoir acheté 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 du 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érifier les données dans 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 en statut Up.
   • Dans les logs de docker logs ts3-manager, un message comme le suivant devrait apparaître :

   Server listening on http://127.0.0.1:8080
   

Connexion au serveur¶

Pour vous connecter au serveur, vous avez besoin :

• Dans le panneau de contrôle, copiez l’Server IP Address* depuis l’onglet Network — ID du serveur et adresse IP.
• Facultatif : inscrivez‑vous à votre compte TeamSpeak personnel. Cela simplifiera la gestion et la configuration du serveur.
• Facultatif : ajoutez le serveur à votre compte TeamSpeak personnel. Saisissez 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, saisissez l’adresse IP du serveur dans le champ indiqué sur la capture d’écran ci‑dessous et cliquez sur le bouton Connect :

Confirmation des privilèges administrateur¶

Pour confirmer les privilèges 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 Admin ServerQuery (fonction pour administrer un serveur TeamSpeak 3 à partir d’une interface en ligne de commande) :

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

2. Clé de privilège (jeton) 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 nécessaires pour :

• Se connecter à l’interface ServerQuery ;
• Obtenir les privilèges d’administrateur sur le serveur virtuel ;
• Gérer le serveur via l’API ;
• Gérer le 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? :

Saisissez la clé copiée :

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

• Ouvrez le menu contextuel en cliquant avec le bouton droit sur l'icône du serveur dans la fenêtre principale de TeamSpeak.
• Dans les paramètres du serveur, accédez à 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 pourrez choisir le groupe pour lequel la clé est créée. Les options suivantes sont disponibles :

  • Server Admin : Groupe avec les 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, saisissez une brève explication du but de la clé créée.
• Après avoir saisi 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 les privilèges appropriés aux utilisateurs ou aux administrateurs sur ce serveur TeamSpeak.

Accès au panneau de contrôle Web**¶

• Serveur : 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 - Adresse IP du serveur;
• Port : 10011;
• Nom : serveradmin;
• Mot de passe : Le mot de passe d'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 consulter les informations générales sur chaque serveur, y compris son état opérationnel, le nombre d'utilisateurs connectés, le temps de fonctionnement et les ports utilisés. La gestion de base du serveur se fait via cette interface : démarrer, arrêter, redémarrer et configurer les paramètres de base.
• Server Viewer. Outil interactif de 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éagir rapidement à diverses situations.
• Chat. Système de messagerie instantanée intégré qui facilite la communication entre les administrateurs et les utilisateurs du serveur. Il prend en charge les discussions personnelles et de groupe, permet le partage de fichiers et utilise la mise en forme du texte. Il conserve l'historique des discussions pour une analyse ultérieure.
• File Browser. Cet outil gère le système de fichiers du serveur TeamSpeak 3. Il permet d'accéder aux fichiers téléchargés, aux avatars des utilisateurs et à d'autres médias. 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. 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 changements de configuration, les événements système et les erreurs. Un outil essentiel pour le dépannage des problèmes et la surveillance de la sécurité du serveur.
• Backup/Restore. Cet outil complet garantit 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 d'échec.
• Server Query. Outil avancé pour l'interaction directe avec le serveur via une interface de commande. Il permet des opérations de gestion complexes du serveur à l'aide de commandes spéciales, récupère des informations détaillées sur l'état du serveur et permet d'ajuster finement les paramètres.
• Privilege Keys. Système de gestion des clés d'accès privilégiées. 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. Section de gestion des clés pour l'interaction logicielle avec le serveur via une API. Permet de créer et de configurer des clés d'accès pour intégrer TeamSpeak 3 à des applications et services externes.
• Ban List. Outil de gestion des blocages utilisateurs. Contient des informations sur les utilisateurs bloqués, les raisons et les durées de blocage. Contrôle efficacement l'accès des utilisateurs indésirables au serveur.
• Complaints List. Système de traitement des plaintes des utilisateurs. Les administrateurs peuvent consulter les plaintes soumises, suivre leur statut et prendre les mesures nécessaires pour résoudre les conflits.
• List All Clients. Liste complète de tous les utilisateurs qui se sont jamais connectés au serveur. Contient des informations détaillées sur chaque client, y compris l'historique des connexions, les pseudos utilisés et les données techniques.
• Server Groups. Outil de gestion des groupes d'utilisateurs au niveau du serveur. 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. Système de gestion des groupes au niveau du canal. Permet de configurer des droits et privilèges spécifiques pour les utilisateurs au sein de canaux spécifiques ou de leurs groupes.
• Permissions. Système complet de configuration des permissions. Permet d'ajuster finement les autorisations d'accès pour différents groupes d'utilisateurs, en définissant leurs capacités sur le serveur, dans les canaux et lors de l'interaction avec d'autres utilisateurs.
• Logout. Fonction de fermeture sécurisée de 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.

Commander TeamSpeak via API¶

Pour installer ce logiciel en utilisant l'API, suivez les instructions suivantes.