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 bestellen van TeamSpeak via de Marketplace
• Controleer de functionaliteit van de TeamSpeak-server
• Ts3-Manager bijwerken
• Verbinding maken met de server
• Bevestigen van administratorrechten
• Toegang tot het Web Control Panel
• TeamSpeak bestellen via de 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, 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 kicken, enz.
• 3D-geluidsondersteuning: 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¶

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

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

• een applicatielink;
• inloggegevens 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 bestellen 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 serverbeheerpaneel en API — Invapi.

Om de service te gaan gebruiken, downloadt u de TeamSpeak client naar uw lokale apparaat en installeert u 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'
   

Ts3-Manager bijwerken¶

1. Maak een back-up van de huidige configuratie

   Sla informatie over de huidige container op. 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 opstarting

   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 heeft u het volgende nodig:

• Kopieer in het controlepaneel 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 en het poortnummer (9987) van de server 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 aangegeven veld in de onderstaande schermafbeelding in en klikt u op de Connect knop:

Bevestigen van administratorrechten¶

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

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

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

Nadat u de administratorrechten heeft bevestigd, kunt u nieuwe sleutels aanmaken. Doe dit als volgt:

• 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 Create knop om een nieuwe privilege key te genereren:

• Er wordt een venster geopend waarin u 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 u een privilege key wilt aanmaken.

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

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

U kunt de aangemaakte sleutel 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 controlepaneel 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 over elke server bekijken, 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 kunt u 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 groepschats, maakt het delen van bestanden mogelijk en gebruikt 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 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 garandeert de gegevensveiligheid op de server. Hiermee kunt u 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 over de status van de server op 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 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 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 kunt u verschillende groepen met specifieke rechten en bevoegdheden maken en configureren, wat het beheer 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 het instellen van permissies. 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 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 de API¶

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