--- content ---

TeamSpeak¶

En este artículo

• TeamSpeak. Funcionalidades clave
• Funcionalidades de implementación
• Primeros pasos tras desplegar TeamSpeak como una Managed App
• Primeros pasos tras desplegar TeamSpeak desde el Marketplace
• Actualización de Ts3-Manager
• Conexión al servidor
• Confirmación de privilegios de administrador
• Acceso al panel de control web
• Pedir TeamSpeak mediante API

TeamSpeak. Funcionalidades clave¶

• Chat de voz de alta calidad: TeamSpeak proporciona una transmisión de voz clara y nítida entre usuarios, lo cual es crucial para la coordinación durante el juego.
• Sistema de canales: Los usuarios pueden crear un número ilimitado de canales y organizarlos en grupos jerárquicos, permitiendo canales separados para diferentes equipos, juegos o tareas.
• Gestión de permisos: Los administradores del servidor pueden asignar diferentes derechos a los usuarios, como la capacidad de crear canales, expulsar miembros, etc.
• Soporte de sonido 3D: TeamSpeak posiciona la voz de cada usuario en la sala virtual, lo que facilita la navegación durante el juego.
• Grabación de chat de voz: Capacidad para grabar conversaciones de voz para escucharlas o compartirlas más tarde.
• Multiplataforma: Disponible para Windows, MacOS, Linux y dispositivos móviles.

Funcionalidades de implementación¶

• Software instalado:
  • Docker con los siguientes contenedores:
    • TeamSpeak Server (imagen mbentley/teamspeak:latest)
      • Puertos: 9987 (UDP), 10011, 30033, 41144 (TCP)
    • TeamSpeak Manager (imagen joni1802/ts3-manager)
      • Puerto: 8080
    • Nginx con Let's Encrypt (imagen jonasal/nginx-certbot)
  • Docker Compose Plugin

Para comprobar la funcionalidad del servidor TeamSpeak:

1. Comprobar el estado de los contenedores:

   docker ps | grep teamspeak
   

2. Ver los logs del contenedor:

   docker logs teamspeak
   

3. Comprobar la disponibilidad de los puertos:

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

Primeros pasos tras desplegar TeamSpeak como una Managed App¶

Después de desplegar TeamSpeak como una Managed App, puedes encontrar lo siguiente en la pestaña My Apps del panel de control del servidor:

• un enlace a la aplicación;
• login y contraseña para el acceso;
• información relativa al uso y gestión del servicio.

Para más detalles sobre cómo trabajar con Managed Apps, consulta las instrucciones.

Primeros pasos tras desplegar TeamSpeak desde el Marketplace¶

Tras realizar una compra, recibirás una notificación en la dirección de correo electrónico proporcionada durante el registro, indicando que tu servidor está listo para usar. Esta notificación incluirá la dirección IP del VPS y las credenciales de acceso para la conexión. Los clientes de nuestra empresa gestionan el equipo a través del server management panel and API — Invapi.

Para empezar a utilizar el servicio, descarga e instala el cliente TeamSpeak en tu dispositivo local.

Actualización de Ts3-Manager¶

1. Realizar una copia de seguridad de la configuración actual

   Guarda la información sobre el contenedor actual. Para revertir si es necesario, ejecuta:

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

   Comprueba los datos en volume:

   ls -l /opt/tsi-web
   

2. Detener y eliminar el contenedor antiguo

   Si el contenedor ts3-manager existe (incluso si docker ps no lo muestra), ejecuta:

   docker stop ts3-manager
   

   docker rm ts3-manager
   

3. Iniciar un nuevo contenedor 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. Verificar el inicio

   Asegúrate de que el contenedor se haya iniciado correctamente:

   docker ps | grep ts3-manager
   

   docker logs ts3-manager
   

   Si la actualización fue exitosa, entonces:
   • En la salida de docker ps, el contenedor ts3-manager debería estar en estado Up.
   • En los logs de docker logs ts3-manager, debería aparecer un mensaje como el siguiente:

     Server listening on http://127.0.0.1:8080
     

Conexión al servidor¶

Para conectarte al servidor, necesitas:

• En el panel de control, copiar la Server IP Address desde la pestaña Network — Server ID and IP Address.
• Opcional - Registrarte en tu cuenta personal de TeamSpeak. Esto simplificará la gestión y configuración del servidor.

• Opcional - Añadir el servidor a tu cuenta personal de TeamSpeak. Introduce la dirección IP del servidor y el número de puerto (9987), así como el nombre del servidor.

  

Tras lanzar el cliente TeamSpeak en tu dispositivo local, introduce la dirección IP del servidor en el campo indicado en la captura de pantalla de abajo y haz clic en el botón Connect:

Confirmación de privilegios de administrador¶

Para confirmar los privilegios de administrador, debes conectarte al servidor vía SSH y ejecutar el siguiente comando:

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

La ejecución de este comando mostrará los siguientes datos importantes:

1. Credenciales de la cuenta ServerQuery Admin (función para administrar un servidor TeamSpeak 3 mediante una interfaz de línea de comandos):

   • Login: serveradmin;
   • Password (generada por el sistema);
   • API key.

2. Clave de privilegio (token) para obtener privilegios de administrador en el servidor virtual.

Un ejemplo de salida será similar a este:

Debes guardar estos datos, ya que serán necesarios para:

• Iniciar sesión en la interfaz ServerQuery;
• Obtener privilegios de administrador en el servidor virtual;
• Gestionar el servidor a través de la API;
• Gestión del servidor mediante la interfaz web de TS3 Manager.

Es importante tener en cuenta que la clave de privilegio solo puede utilizarse una vez, y la contraseña de ServerQuery debe cambiarse inmediatamente después del primer inicio de sesión.

En el cliente TeamSpeak, haz clic en el nombre del servidor y responde "Yes" a la pregunta Is this your TeamSpeak server?:

Introduce la clave copiada:

Tras confirmar los privilegios de administrador, puedes crear nuevas claves. Para ello:

• Abre el menú contextual haciendo clic derecho sobre el icono del servidor en la ventana principal de TeamSpeak.
• En la configuración del servidor, ve a la pestaña Show Privilege Keys:

• Haz clic en el botón Create para generar una nueva clave de privilegio:

• Se abrirá una ventana donde podrás elegir el grupo para el cual se está creando la clave. Las siguientes opciones están disponibles:

  • Server Admin: Grupo con privilegios máximos, que tiene control administrativo total sobre el servidor.
  • Normal: Grupo con derechos limitados, destinado a usuarios regulares.
  • Guest: Grupo con derechos mínimos para acceso de invitados.

• Selecciona el grupo para el cual necesitas crear una clave de privilegio.

• En el campo Description, introduce una breve explicación del propósito de la clave creada.
• Tras introducir la descripción, haz clic en el botón Create:

La nueva clave de privilegio se generará y aparecerá en la lista de claves.

Puedes utilizar la clave creada para otorgar los privilegios adecuados a usuarios o administradores en este servidor TeamSpeak.

Acceso al panel de control web¶

• Server: Dirección IP del servidor o nombre de dominio del servidor (sin https://). Puedes copiar la dirección desde el panel de control en la pestaña Network - Server IP Address;
• Port: 10011;
• Name: serveradmin;
• Password: La contraseña del administrador del servidor, recibida como se describió anteriormente.

Tras una autenticación correcta, tendrás acceso a la siguiente funcionalidad:

• Server List. Este elemento de gestión central muestra todos los servidores TeamSpeak 3 registrados en el sistema. Los administradores pueden ver información general sobre cada servidor, incluyendo su estado operativo, número de usuarios conectados, tiempo de actividad y puertos utilizados. La gestión básica del servidor se realiza a través de esta interfaz: iniciar, detener, reiniciar y configuración de parámetros básicos.
• Server Viewer. Una herramienta interactiva para el monitoreo visual en tiempo real del servidor. Muestra una estructura de árbol de los canales del servidor, mostrando todos los usuarios conectados y su actividad. Permite observar los movimientos de los usuarios entre canales, monitorizar la actividad de voz y responder rápidamente a diversas situaciones.
• Chat. Un sistema de mensajería instantánea integrado que facilita la comunicación entre administradores y usuarios en el servidor. Admite chats tanto personales como grupales, permite compartir archivos y utiliza formato de texto. Almacena el historial del chat para su análisis posterior.
• File Browser. Esta herramienta gestiona el sistema de archivos del servidor TeamSpeak 3. A través de ella se accede a los archivos subidos, avatares de usuario y otros medios. Los administradores pueden gestionar el contenido del servidor, controlar el uso del espacio en disco y establecer permisos de acceso a los archivos.
• Server Log. Un sistema de registro que registra todos los eventos que ocurren en el servidor. Registra información sobre las conexiones de usuarios, cambios de configuración, eventos del sistema y errores. Una herramienta esencial para la resolución de problemas y el monitoreo de la seguridad del servidor.
• Backup/Restore. Esta herramienta integral garantiza la seguridad de los datos en el servidor. Permite crear copias de seguridad de todos los ajustes, bases de datos y datos de usuario. Incluye funciones de copia de seguridad automática y restauración de datos en caso de fallos.
• Server Query. Una herramienta avanzada para la interacción directa con el servidor mediante una interfaz de comandos. Permite operaciones complejas de gestión del servidor utilizando comandos especiales, recupera información detallada sobre el estado del servidor y permite el ajuste fino de los parámetros.
• Privilege Keys. Un sistema para gestionar claves de acceso privilegiado. Esta interfaz crea y distribuye claves especiales que otorgan a los usuarios derechos y privilegios específicos en el servidor.
• API Keys. La sección para la gestión de claves para la interacción del software con el servidor a través de una API. Permite crear y configurar claves de acceso para integrar TeamSpeak 3 con aplicaciones y servicios externos.
• Ban List. Una herramienta para gestionar bloqueos de usuarios. Contiene información sobre los usuarios bloqueados, motivos y duraciones del bloqueo. Controla eficazmente el acceso de usuarios no deseados al servidor.
• Complaints List. Un sistema para procesar las quejas de los usuarios. Los administradores pueden ver las quejas enviadas, realizar un seguimiento de su estado y tomar las medidas necesarias para resolver conflictos.
• List All Clients. Una lista completa de todos los usuarios que se han conectado alguna vez al servidor. Incluye información detallada de cada cliente, incluyendo el historial de conexión, apodos utilizados y datos técnicos.
• Server Groups. Una herramienta para gestionar grupos de usuarios a nivel de servidor. Permite crear y configurar varios grupos con derechos y privilegios específicos, simplificando la administración de un gran número de usuarios.
• Channel Groups. Un sistema para gestionar grupos a nivel de canal. Permite configurar derechos y privilegios específicos para los usuarios dentro de canales o sus grupos específicos.
• Permissions. Un sistema integral de configuración de permisos. Permite ajustar con precisión los permisos de acceso para diferentes grupos de usuarios, definiendo sus capacidades en el servidor, en los canales y al interactuar con otros usuarios.
• Logout. La función para finalizar la sesión del administrador de forma segura. Al salir, todas las conexiones activas se cierran correctamente y cualquier cambio realizado en los ajustes se guarda.

Pedir TeamSpeak mediante API¶