TeamSpeak¶

En este artículo

• TeamSpeak. Características principales
• Funcionalidades de implementación
• Primeros pasos después del despliegue del servidor TeamSpeak
• Actualización de Ts3-Manager
• Conexión al servidor
• Confirmación de privilegios de administrador
• Acceso al panel de control web
• Pedido de TeamSpeak mediante API

TeamSpeak. Características principales¶

• 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 derechos: 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, facilitando 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)
  • Complemento Docker Compose

Para comprobar la funcionalidad del servidor TeamSpeak:

1. Compruebe el estado del contenedor:

   docker ps | grep teamspeak
   

2. Visualice los registros del contenedor:

   docker logs teamspeak
   

3. Compruebe la disponibilidad de los puertos:

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

Primeros pasos después del despliegue del servidor TeamSpeak¶

Tras realizar un pedido, recibirá una notificación en la dirección de correo electrónico proporcionada durante el registro, indicando que su servidor está listo para usar. Esta notificación incluirá la dirección IP del VPS y las credenciales de inicio de sesión para la conexión. Los clientes de nuestra empresa gestionan el equipo a través del panel de gestión de servidores y API — Invapi.

Para comenzar a utilizar el servicio, descargue el cliente TeamSpeak en su dispositivo local e instálelo.

Actualización de Ts3-Manager¶

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

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

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

   Compruebe los datos en volume:

   ls -l /opt/tsi-web
   

2. Detenga y elimine el contenedor antiguo

   Si el contenedor ts3-manager existe (aunque docker ps no lo muestre), ejecute:

   docker stop ts3-manager
   

   docker rm ts3-manager
   

3. Inicie 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. Verifique el inicio

   Asegúrese 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 debe estar en estado Up.
   • En los registros 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 conectarse al servidor, necesita:

• En el panel de control, copie la Server IP Address de la pestaña Network — Server ID and IP Address.
• Opcional - Regístrese en su personal TeamSpeak account. Esto simplificará la gestión y configuración del servidor.

• Opcional - Agregue el servidor a su personal TeamSpeak account. Ingrese la dirección IP del servidor y el número de puerto (9987), así como el nombre del servidor.

  

Tras iniciar el cliente TeamSpeak en su dispositivo local, introduzca la dirección IP del servidor en el campo indicado en la captura de pantalla a continuación y haga clic en el botón Connect:

Confirmación de privilegios de administrador¶

Para confirmar los privilegios de administrador, debe conectarse al servidor mediante 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 basada en una interfaz de línea de comandos):

   • Inicio de sesión: serveradmin;
   • Contraseña (generada por el sistema);
   • Clave API.

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

Un ejemplo de salida se verá así:

Debe 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 a través de la interfaz web de TS3 Manager.

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

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

Introduzca la clave copiada:

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

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

• Haga clic en el botón Create para generar una nueva clave de privilegios:

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

  • Server Admin: Grupo con privilegios máximos, con 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.

• Seleccione el grupo para el que necesita crear una clave de privilegios.

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

La nueva clave de privilegios se generará y se mostrará en la lista de claves.

Puede 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://). Puede 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 exitosa, tendrá acceso a la siguiente funcionalidad:

• Server List. Este elemento central de gestión muestra todos los servidores TeamSpeak 3 registrados en el sistema. Los administradores pueden ver información general sobre cada servidor, incluido 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 básica de parámetros.
• Server Viewer. Una herramienta interactiva para la monitorización visual en tiempo real del servidor. Muestra una estructura en forma de árbol de los canales del servidor, mostrando todos los usuarios conectados y su actividad. Le 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 personales y grupales, permite compartir archivos y utiliza formato de texto. Almacena el historial de chat para su análisis posterior.
• File Browser. Esta herramienta gestiona el sistema de archivos del servidor TeamSpeak 3. Acceda a archivos cargados, avatares de usuario y otros medios a través de ella. Los administradores pueden gestionar el contenido del servidor, controlar el uso del espacio en disco y establecer permisos de acceso a archivos.
• Server Log. Un sistema de registro que registra todos los eventos que ocurren en el servidor. Registra información sobre conexiones de usuarios, cambios de configuración, eventos del sistema y errores. Una herramienta esencial para solucionar problemas y monitorizar la seguridad del servidor.
• Backup/Restore. Esta herramienta integral garantiza la seguridad de los datos en el servidor. Le permite crear copias de seguridad de todas las configuraciones, 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 a través de una interfaz de comandos. Permite operaciones complejas de gestión del servidor utilizando comandos especiales, obtiene información detallada sobre el estado del servidor y permite el ajuste fino de 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 gestionar claves para la interacción de software con el servidor a través de una API. Le 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 usuarios bloqueados, razones y duración de los bloqueos. Controla eficazmente el acceso de usuarios no deseados al servidor.
• Complaints List. Un sistema para procesar quejas de usuarios. Los administradores pueden ver las quejas presentadas, rastrear 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 sobre cada cliente, incluido el historial de conexión, apodos utilizados y datos técnicos.
• Server Groups. Una herramienta para gestionar grupos de usuarios a nivel de servidor. Le 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 usuarios dentro de canales específicos o sus grupos.
• Permissions. Un sistema integral de configuración de permisos. Le permite ajustar finamente 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 de forma segura la sesión del administrador. Al salir, todas las conexiones activas se cierran correctamente y cualquier cambio realizado en la configuración se guarda.

Pedido de TeamSpeak mediante API¶

Para instalar este software mediante la API, siga estas instrucciones.

Parte del contenido de esta página fue creado o traducido utilizando IA.