Applications gérées - TeamSpeak¶

Dans cet article

• TeamSpeak. Fonctionnalités clés
• Fonctionnalités de déploiement
• Prise en main après le déploiement de TeamSpeak en tant que Managed App
• Prise en main après le déploiement de TeamSpeak depuis la Marketplace
• Mise à jour de Ts3-Manager
• Connexion au serveur
• Confirmation des privilèges administrateur
• Accès au panneau de contrôle Web
• Commander TeamSpeak via l'API

TeamSpeak. Fonctionnalités clés¶

• Chat vocal de haute qualité : TeamSpeak assure 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 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 ainsi la navigation pendant le jeu.
• Enregistrement du chat vocal : Possibilité d'enregistrer les conversations vocales pour une écoute ou un partage ultérieur.
• Multiplateforme : Disponible pour Windows, MacOS, Linux et les 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 jonasal/nginx-certbot)
  • Plugin Docker Compose

Pour vérifier le fonctionnement du serveur TeamSpeak :

1. Vérifier l'état des conteneurs :

   docker ps | grep teamspeak
   

2. Consulter les logs du conteneur :

   docker logs teamspeak
   

3. Vérifier la disponibilité des ports :

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

Prise en main après le déploiement de TeamSpeak en tant que Managed App¶

Après avoir déployé TeamSpeak en tant que managed app, vous trouverez les éléments suivants dans l'onglet My Apps du panneau de contrôle du serveur :

• un lien vers l'application ;
• l'identifiant et le mot de passe pour l'accès ;
• des informations concernant l'utilisation et la gestion du service.

Pour plus de détails sur l'utilisation des managed apps, consultez les instructions.

Prise en main après le déploiement de TeamSpeak depuis la Marketplace¶

Après avoir effectué un achat, 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 concernant le conteneur actuel. Pour restaurer si nécessaire, exécutez :

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

   Vérifiez 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 au 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 de :

• Dans le panneau de contrôle, copier la Server IP Address depuis l'onglet Network — Server ID and IP Address.
• Optionnel - S'inscrire sur votre compte TeamSpeak personnel. Cela simplifiera la gestion et la configuration du serveur.

• Optionnel - Ajouter 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 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 via une interface en ligne de commande) :

   • Login : serveradmin;
   • Password (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 enregistrer 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 ;
• La gestion du serveur via l'interface Web de 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 changé 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 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 sur 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 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, saisissez une brève explication de l'utilité 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 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 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, la disponibilité (uptime) et les ports utilisés. La gestion de base du serveur s'effectue via cette interface : démarrer, arrêter, redémarrer et configuration des paramètres de base.
• Server Viewer. Un outil interactif pour une 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é. Permet d'observer les mouvements 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. Prend en charge les chats personnels et de groupe, permet le partage de fichiers et utilise le formatage de texte. Il stocke 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 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 permissions 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 changements de configuration, les événements système et les erreurs. Un outil essentiel pour le dépannage et la surveillance de la sécurité du serveur.
• Backup/Restore. Cet outil complet assure la sécurité des données sur le serveur. Permet de créer des sauvegardes de tous les paramètres, bases de données et données utilisateur. Comprend 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. 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 un réglage précis des paramètres.
• Privilege Keys. Un 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. La section pour la gestion des clés permettant 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 avec des applications et services externes.
• Ban List. Un outil de gestion des blocages d'utilisateurs. Contient des informations sur les utilisateurs bloqués, les raisons et la durée du blocage. Contrôle efficacement l'accès au serveur par les utilisateurs indésirables.
• Complaints List. Un 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. Une liste complète de tous les utilisateurs ayant déjà été connectés au serveur. Comprend 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 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. Un système de gestion des groupes au niveau des canaux. Permet de configurer des droits et privilèges spécifiques pour les utilisateurs dans des canaux ou leurs groupes spécifiques.
• Permissions. Un système complet de paramétrage des permissions. 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 des interactions avec d'autres utilisateurs.
• Logout. La fonction permettant de mettre fin en toute sécurité à la session de l'administrateur. À la sortie, toutes les connexions actives sont correctement fermées et tous les changements apportés aux paramètres sont enregistrés.

Commander TeamSpeak via l'API¶

Pour installer ce logiciel via l'API, suivez ces instructions.