Managed Applications - TeamSpeak¶

In dit artikel

• TeamSpeak. Belangrijkste functies
• 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
• Verbinden met de server
• Administratieve rechten bevestigen
• Toegang tot het Web Control Panel
• TeamSpeak bestellen via API

TeamSpeak. Belangrijkste functies¶

• 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)
      • Poorten: 9987 (UDP), 10011, 30033, 41144 (TCP)
    • TeamSpeak Manager (joni1802/ts3-manager image)
      • Poort: 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 u TeamSpeak heeft geïmplementeerd als een managed app, vindt u 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¶

Nadat u een bestelling heeft geplaatst, ontvangt u een melding op het e-mailadres dat tijdens de registratie is opgegeven, met de mededeling dat uw 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 en API — Invapi.

Om de service te gaan gebruiken, downloadt u de TeamSpeak client naar uw lokale apparaat en installeert u deze.

Ts3-Manager bijwerken¶

1. Maak een back-up van de huidige configuratie

   Sla informatie op over de huidige container. Om eventueel terug te draaien, voert u uit:

   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 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 de status Up hebben.
   • 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
     

Verbinden met de server¶

Om verbinding te maken met de server heeft u het volgende nodig:

• Kopieer in het control panel het Server IP Address van het tabblad Network — Server ID and IP Address.
• Optioneel - Registreer u bij uw persoonlijke TeamSpeak account. Dit vereenvoudigt het serverbeheer en de configuratie.

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

  

Nadat u de TeamSpeak client op uw lokale apparaat heeft gestart, voert u het IP-adres van de server in het veld in dat in de onderstaande schermafbeelding wordt aangegeven en klikt u op de Connect knop:

Administratieve rechten bevestigen¶

Om administratieve rechten te bevestigen, moet u 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 administratieve rechten te verkrijgen op de virtuele server.

Een voorbeeld van de output ziet er als volgt uit:

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

• Inloggen op de ServerQuery interface;
• Het verkrijgen van administratieve 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 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:

Nadat u de administratieve rechten heeft bevestigd, kunt u 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 u 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 u 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.

U 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://). U kunt het adres kopiëren uit het control panel in het tabblad Network - Server IP Address;
• Poort: 10011;
• Naam: serveradmin;
• Wachtwoord: Het serverbeheerder wachtwoord, ontvangen zoals eerder beschreven.

Na een succesvolle authenticatie heeft u 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 kunt u 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 heeft u 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 logingssysteem 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 gegevensveiligheid op de server. Hiermee kunt u 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 keys aan die gebruikers specifieke rechten en bevoegdheden op de server geven.
• API Keys. De sectie voor het beheren van sleutels voor software-interactie met de server via een API. Hiermee kunt u 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 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 verbindingsgeschiedenis, gebruikte bijnamen en technische gegevens.
• Server Groups. Een tool voor het beheren van gebruikersgroepen op serverniveau. Hiermee kunt u 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 kunt u de toegangsrechten voor verschillende gebruikersgroepen nauwkeurig afstemmen, waarbij u hun mogelijkheden op de server, in kanalen en bij interactie met andere gebruikers definieert.
• Logout. De functie om de sessie van de beheerder 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¶

Om deze software te installeren via de API, volgt u deze instructies.