Managed Applications - TeamSpeak¶

In dit artikel

• TeamSpeak. Belangrijkste kenmerken
• Implementatiefuncties
• Aan de slag na het implementeren van TeamSpeak als een Managed App
• Aan de slag na het kopen van TeamSpeak via de Marketplace
• Controleer de functionaliteit van de TeamSpeak-server
• Updaten van Ts3-Manager
• Verbinding maken met de server
• Bevestigen van Administrator-rechten
• Toegang tot het Web Control Panel
• TeamSpeak bestellen via API

TeamSpeak. Belangrijkste kenmerken¶

• Voice chat van hoge kwaliteit: TeamSpeak biedt heldere en scherpe stemoverdracht tussen gebruikers, wat cruciaal is voor coördinatie tijdens het spelen.
• Kanaalsysteem: Gebruikers kunnen een onbeperkt aantal kanalen aanmaken en deze organiseren in hiërarchische groepen, wat aparte kanalen mogelijk maakt voor verschillende teams, games of taken.
• Rechtenbeheer: Serverbeheerders kunnen verschillende rechten toewijzen aan gebruikers, zoals de mogelijkheid om kanalen aan te maken, leden te verwijderen (kick), enz.
• 3D-geluidsondersteuning: TeamSpeak positioneert de stem van elke gebruiker in de virtuele ruimte, waardoor het navigeren tijdens het spel gemakkelijker wordt.
• Opname van voice chat: De mogelijkheid om spraakgesprekken op te nemen om ze later terug te luisteren of te delen.
• Cross-platform: Beschikbaar voor Windows, MacOS, Linux en mobiele apparaten.

Implementatiefuncties¶

Aan de slag na het implementeren van TeamSpeak als een Managed App¶

Nadat je TeamSpeak hebt geïmplementeerd als een managed app, kun je het volgende vinden in het tabblad My Apps van het serverbeheerpaneel:

• een applicatielink;
• login en wachtwoord voor toegang;
• informatie met betrekking tot het gebruik en beheer van de service.

Voor meer details over het werken met managed apps, zie de instructies.

Aan de slag na het kopen van TeamSpeak via de Marketplace¶

Nadat je een bestelling hebt geplaatst, ontvang je een melding op het e-mailadres dat tijdens de registratie is opgegeven, met de mededeling dat je server klaar is voor gebruik. Deze melding bevat het VPS IP-adres en de inloggegevens voor de verbinding. De klanten van ons bedrijf beheren de apparatuur via het server management panel en API — Invapi.

Om de service te gaan gebruiken, download je de TeamSpeak client naar je lokale apparaat en installeer je deze.

Controleer de functionaliteit van de TeamSpeak-server¶

1. Controleer de containerstatus:

   docker ps | grep teamspeak
   

2. Bekijk de containerlogs:

   docker logs teamspeak
   

3. Controleer de beschikbaarheid van poorten:

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

Updaten van Ts3-Manager¶

1. Maak een back-up van de huidige configuratie

   Sla informatie op over de huidige container. Voer het volgende uit om eventueel terug te draaien:

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

   Controleer op gegevens in volume:

   ls -l /opt/tsi-web
   

2. Stop en verwijder de oude container

   Als de container ts3-manager bestaat (zelfs als docker ps deze niet laat zien), voer dan het volgende uit:

   docker stop ts3-manager
   

   docker rm ts3-manager
   

3. Start een nieuwe Ts3-Manager v2.2.3 container

   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. Verifieer de opstartbeurt

   Zorg ervoor dat de container succesvol is opgestart:

   docker ps | grep ts3-manager
   

   docker logs ts3-manager
   

   Als de update succesvol was, dan:
   • In de output van docker ps moet de container ts3-manager de status Up hebben.
   • In de logs van docker logs ts3-manager moet een bericht verschijnen zoals het volgende:

     Server listening on http://127.0.0.1:8080
     

   Verbinding maken met de server¶

Om verbinding te maken met de server heb je het volgende nodig:

• Kopieer in het controlepaneel het Server IP Address van het tabblad Network — Server ID and IP Address.
• Optioneel - Registreer je in je persoonlijke TeamSpeak-account. Dit vereenvoudigt het serverbeheer en de configuratie.

• Optioneel - Voeg de server toe aan je persoonlijke TeamSpeak-account. Voer het IP-adres en het poortnummer (9987) van de server in, evenals de servernaam.

  

Voer na het starten van de TeamSpeak-client op je lokale apparaat het IP-adres van de server in het aangegeven veld in de onderstaande schermafbeelding in en klik op de knop Connect:

Bevestigen van Administrator-rechten¶

Om administrator-rechten te bevestigen, moet je via SSH verbinding maken met de server en het volgende commando uitvoeren:

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

Het uitvoeren van dit commando toont de volgende belangrijke gegevens:

1. ServerQuery Admin Account-gegevens (functie voor het administreren van een TeamSpeak 3-server via een command-line interface):

   • Login: serveradmin;
   • Wachtwoord (gegenereerd door het systeem);
   • API-sleutel.

2. Privilege key (token) om administrator-rechten te verkrijgen op de virtuele server.

Een voorbeeld van de output ziet er als volgt uit:

Je moet deze gegevens opslaan, aangezien ze nodig zijn voor:

• Inloggen op de ServerQuery-interface;
• Het verkrijgen van administrator-rechten op de virtuele server;
• Het beheren van de server via de API;
• Serverbeheer via de TS3 Manager Web Interface.

Het is belangrijk om te weten dat de privilege key slechts één keer gebruikt kan worden en dat het ServerQuery-wachtwoord onmiddellijk na de eerste login gewijzigd moet worden.

Klik in de TeamSpeak-client op de servernaam en beantwoord "Yes" op de vraag Is this your TeamSpeak server?:

Voer de gekopieerde sleutel in:

Na het bevestigen van de administrator-rechten kun je nieuwe sleutels aanmaken. Hiervoor:

• Open het contextmenu door met de rechtermuisknop op het servericoon in het hoofdvenster van TeamSpeak te klikken.
• Ga in de serverinstellingen naar het tabblad Show Privilege Keys:

• Klik op de knop Create om een nieuwe privilege key te genereren:

• Er wordt een venster geopend waarin je de groep kunt kiezen waarvoor de sleutel wordt aangemaakt. De volgende opties zijn beschikbaar:

  • Server Admin: Groep met maximale rechten, met volledige administratieve controle over de server.
  • Normal: Groep met beperkte rechten, bedoeld voor reguliere gebruikers.
  • Guest: Groep met minimale rechten voor gasttoegang.

• Selecteer de groep waarvoor je een privilege key moet aanmaken.

• Voer in het veld Description een korte uitleg in over het doel van de aangemaakte sleutel.
• Klik na het invoeren van de beschrijving op de knop Create:

De nieuwe privilege key wordt gegenereerd en weergegeven in de lijst met sleutels.

Je kunt de aangemaakte sleutel gebruiken om gebruikers of beheerders de juiste rechten en privileges te geven op deze TeamSpeak-server.

Toegang tot het Web Control Panel¶

• Server: Server IP-adres of Server Domain naam (zonder https://). Je kunt het adres kopiëren uit het controlepaneel in het tabblad Network - Server IP Address;
• Poort: 10011;
• Naam: serveradmin;
• Wachtwoord: Het serverbeheerder-wachtwoord, ontvangen zoals eerder beschreven.

Na een succesvolle authenticatie heb je toegang tot de volgende functionaliteiten:

• Server List. Dit centrale beheerelement toont alle geregistreerde TeamSpeak 3-servers in het systeem. Beheerders kunnen algemene informatie bekijken over elke server, inclusief de operationele status, het aantal verbonden gebruikers, de uptime en de gebruikte poorten. Basis serverbeheer wordt uitgevoerd via deze interface: starten, stoppen, herstarten en basisconfiguratie van parameters.
• Server Viewer. Een interactieve tool voor real-time visuele monitoring van de server. Het toont een boomstructuur van de kanalen van de server, inclusief alle verbonden gebruikers en hun activiteit. Hiermee kun je gebruikersbewegingen tussen kanalen observeren, de spraakactiviteit monitoren en snel reageren op verschillende situaties.
• Chat. Een ingebouwd instant messaging-systeem dat communicatie tussen beheerders en gebruikers op de server vergemakkelijkt. Ondersteunt zowel persoonlijke als groepsgesprekken, staat het delen van bestanden toe en maakt het gebruik van tekstformattering. Het slaat chatgeschiedenis op voor latere analyse.
• File Browser. Deze tool beheert het bestandssysteem van de TeamSpeak 3-server. Hiermee heb je toegang tot geüploade bestanden, gebruikersavatars en andere media. Beheerders kunnen de serverinhoud beheren, het gebruik van schijfruimte controleren en de toegangsrechten voor bestanden instellen.
• Server Log. Een logingsysteem dat alle gebeurtenissen op de server registreert. Het logt informatie over gebruikersverbindingen, configuratiewijzigingen, systeemgebeurtenissen en fouten. Een essentieel hulpmiddel voor het oplossen van problemen en het monitoren van de serversbeveiliging.
• Backup/Restore. Deze uitgebreide tool zorgt voor de gegevensveiligheid op de server. Hiermee kun je back-ups maken van alle instellingen, databases en gebruikersgegevens. Inclusief functies voor automatische back-ups en gegevensherstel bij storingen.
• Server Query. Een geavanceerde tool voor directe interactie met de server via een command-interface. Maakt complexe serverbeheeroperaties mogelijk met speciale commando's, haalt gedetailleerde informatie op over de status van de server en maakt het mogelijk om parameters fijn af te stellen.
• Privilege Keys. Een systeem voor het beheren van bevoorrechte toegangssleutels. Deze interface maakt speciale sleutels aan en verspreidt deze, die gebruikers specifieke rechten en privileges op de server geven.
• API Keys. De sectie voor het beheren van sleutels voor software-interactie met de server via een API. Hiermee kun je toegangssleutels maken en configureren voor de integratie van TeamSpeak 3 met externe applicaties en services.
• Ban List. Een tool voor het beheren van gebruikersblokkades. Bevat informatie over geblokkeerde gebruikers, redenen en de duur van de blokkade. Controleert effectief de toegang van ongewenste gebruikers tot de server.
• Complaints List. Een systeem voor het verwerken van gebruikersklachten. Beheerders kunnen ingediende klachten bekijken, de status ervan volgen en de nodige acties ondernemen om conflicten op te lossen.
• List All Clients. Een volledige lijst van alle gebruikers die ooit verbinding hebben gemaakt met de server. Bevat gedetailleerde informatie over elke client, inclusief de verbindingsgeschiedenis, gebruikte bijnamen en technische gegevens.
• Server Groups. Een tool voor het beheren van gebruikersgroepen op serverniveau. Hiermee kun je verschillende groepen met specifieke rechten en privileges aanmaken en configureren, wat het beheer van een groot aantal gebruikers vereenvoudigt.
• Channel Groups. Een systeem voor het beheren van groepen op kanaalniveau. Hiermee kun je specifieke rechten en privileges configureren voor gebruikers binnen specifieke kanalen of hun groepen.
• Permissions. Een uitgebreid systeem voor het instellen van permissies. Hiermee kun je de toegangsrechten voor verschillende gebruikersgroepen nauwkeurig afstemmen, waarbij je hun mogelijkheden op de server, in kanalen en bij interactie met andere gebruikers definieert.
• Logout. De functie voor het veilig beëindigen van de sessie van de beheerder. Bij het afsluiten worden alle actieve verbindingen correct gesloten en worden alle wijzigingen in de instellingen opgeslagen.

TeamSpeak bestellen via API¶

Om deze software te installeren met behulp van de API, volg deze instructies.