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 implementeren van TeamSpeak via de Marketplace
• Ts3-Manager bijwerken
• Verbinding maken met de server
• Administratorrechten bevestigen
• Toegang tot het Web Control Panel
• TeamSpeak bestellen via API

TeamSpeak. Belangrijkste kenmerken¶

• Hoogwaardige voice chat: 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, waardoor er aparte kanalen beschikbaar zijn voor verschillende teams, games of taken.
• Rechtenbeheer: Serverbeheerders kunnen verschillende rechten toewijzen aan gebruikers, zoals de mogelijkheid om kanalen te creëren, leden te verwijderen (kick), enzovoort.
• 3D Sound Support: TeamSpeak positioneert de stem van elke gebruiker in de virtuele ruimte, waardoor het navigeren tijdens het spel gemakkelijker wordt.
• Voice Chat Opname: 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¶

• Geïnstalleerde software:
  • Docker met de volgende containers:
    • TeamSpeak Server (mbentley/teamspeak:latest image)
      • Ports: 9987 (UDP), 10011, 30033, 41144 (TCP)
    • TeamSpeak Manager (joni1802/ts3-manager image)
      • Port: 8080
    • Nginx met Let's Encrypt (jonasal/nginx-certbot image)
  • Docker Compose Plugin

Om de functionaliteit van de TeamSpeak-server te controleren:

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'
   

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

Nadat je TeamSpeak hebt geïmplementeerd als een managed app, vind je het volgende in het tabblad My Apps van het server control panel:

• 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 implementeren van TeamSpeak via de Marketplace¶

Na aankoop 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 verbinding. De klanten van ons bedrijf beheren de apparatuur via het server management panel and API — Invapi.

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

Ts3-Manager bijwerken¶

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 gestart:

   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 in status Up staan.
   • In de logs van docker logs ts3-manager zou een bericht als het volgende moeten verschijnen:

     Server listening on http://127.0.0.1:8080
     

Verbinding maken met de server¶

Om verbinding te maken met de server heb je nodig:

• Kopieer in het control panel het Server IP Address van het tabblad Network — Server ID and IP Address.
• Optioneel - Registreer bij 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 van de server en het poortnummer (9987) in, evenals de servernaam.

  

Nadat je de TeamSpeak client op je lokale apparaat hebt gestart, voer je het IP-adres van de server in het aangegeven veld in de onderstaande schermafbeelding in en klik je op de Connect knop:

Administratorrechten bevestigen¶

Om administratorrechten 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 inloggegevens (functie voor het administreren van een TeamSpeak 3 server via een command line interface):

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

2. Privilege key (token) om administratorrechten 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 administratorrechten 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 eenmaal 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 key in:

Na het bevestigen van de administratorrechten kun je nieuwe keys aanmaken. Doe dit als volgt:

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

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

• Er wordt een venster geopend waarin je de groep kunt kiezen waarvoor de key 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 key.
• Klik na het invoeren van de beschrijving op de Create knop:

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

Je kunt de aangemaakte key gebruiken om gebruikers of beheerders de juiste rechten 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 control panel in het tabblad Network - Server IP Address;
• Port: 10011;
• Name: serveradmin;
• Password: Het wachtwoord van de serverbeheerder, 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, uptime en 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 bewegingen tussen kanalen observeren, 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 groepsessies, staat het delen van bestanden toe en maakt 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 serverinhoud beheren, het gebruik van schijfruimte controleren en toegangsrechten voor bestanden instellen.
• Server Log. Een loggingsysteem 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-up en gegevensherstel bij defecten.
• Server Query. Een geavanceerde tool voor directe interactie met de server via een command interface. Maakt complexe beheeroperaties mogelijk met speciale commando's, haalt gedetailleerde informatie op over de status van de server en maakt het fijnmazig instellen van parameters mogelijk.
• Privilege Keys. Een systeem voor het beheren van geprivilegieerde toegangssleutels. Deze interface maakt speciale sleutels aan die gebruikers specifieke rechten en bevoegdheden op de server geven.
• API Keys. De sectie voor het beheren van sleutels voor softwarematige interactie met de server via een API. Hiermee kun je toegangssleutels maken en configureren om TeamSpeak 3 te integreren 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 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 verbindingsgeschiedenis, gebruikte bijnamen en technische gegevens.
• Server Groups. Een tool voor het beheren van gebruikersgroepen op serverniveau. Hiermee kun je verschillende groepen configureren met specifieke rechten en bevoegdheden, wat de administratie van een groot aantal gebruikers vereenvoudigt.
• Channel Groups. Een systeem voor het beheren van groepen op kanaalniveau. Maakt het mogelijk om specifieke rechten en bevoegdheden in te stellen voor gebruikers binnen specifieke kanalen of hun groepen.
• Permissions. Een uitgebreid systeem voor permissie-instellingen. 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 om de sessie van de administrator veilig te beëindigen. Bij het afsluiten worden alle actieve verbindingen correct gesloten en worden alle wijzigingen in de instellingen opgeslagen.

TeamSpeak bestellen via API¶