PDF

Este artículo trata sobre cómo configurar un servidor TeamSpeak 3 en Linux. Gracias a los desarrolladores de TeamSpeak 3, este proceso es bastante fácil y debería tener un servidor TeamSpeak 3 en cuestión de minutos.

TeamSpeak 3 es una solución muy utilizada (si no la más utilizada) para hacer chat de voz de baja latencia mientras juegas. Además de TeamSpeak 3, existen otras soluciones de baja latencia basadas en juegos como Discord (que utiliza servidores centrales sin la posibilidad de configurar su propia instancia) y Mumble.

Datos

Versiones del sistema y paquetes para el servidor:

• Sistema Operativo del servidor: debian-9.5.0-amd64
• TeamSpeak: 3.0.13.6
• TS3Video Server: 0.8

Versiones de los paquetes necesarios para los hosts Windows:

• TeamSpeak Client: 3.1.10
• Conference_Client-0.13_Setup.exe

Datos de red:

• ts-debian9: 192.168.9.41 / ts.nodo.local
• Puertos a tener en cuenta para su Firewall:

         (10011) por el protocolo (TCP), “ServerQuery” para TeamSpeak y debe estar abierto.

         (9987) por el protocolo (UDP), “virtual voice server” para TeamSpeak y debe estar abierto.

         (30033) por el protocolo (TCP), “file transfers” para TeamSpeak y debe estar abierto.

         (13370) por el protocolo (TCP/UDP), para TS3VIDEO y deben estar abierto.

         (13375) por el protocolo (TCP/UDP), para TS3VIDEO y deben estar abierto.

         (2008) por el protocolo (TCP), para TeamSpeak y debe estar abierto para conexiones locales y cerrado para entrada de datos de otras fuentes.

1.  ¿Qué es lo que se quiere?

Se desea un servidor TeamSpeak3 que permita la comunicación ininterrumpida de su servicio entre los usuarios que hagan uso de él, para chatear y establecer comunicaciones a través VoIP y la posibilidad de hacer videollamadas.

1.1.      ¿Qué es TeamSpeak?

TeamSpeak es un servidor de chat y mensajería instantánea, con VoIP entre usuarios que comparten el mismo canal. Da la posibilidad de agregar un servidor de videoconferencia con el TS3VIDEO. Es un software propietario y requiere de activación. Por su popularidad entre los jugadores y usuarios de otros géneros, como los que gustan de hacer de este servicio un tipo de “radio emisora sobre IP”, se decide hacer este tutorial para implementar dicho servicio en Linux, con emulador para burlar la activación original del mismo.

2.  Implementación y configuración de un servidor TeamSpeak3

2.1.      Prerrequisitos

Lo primero será preparar el firewall iptables para permitir y bloquear los puertos necesarios para el funcionamiento del servidor. Se tendrán en cuenta otros puertos para gestión y comunicación con el servidor FTP. Ustedes podrán adaptar su cortafuegos a su propia red, pero han de respetar las reglas referentes al servicio de teamspeak.

Creamos el directorio que albergará los scripts:

mkdir -p /config/scripts/

Agregamos lo siguiente (adaptando a su red):

#!/bin/bash

FECHA="$(date +%d-%b-%Y)"
AUT="Ing. Franco Diaz"
VER="v1.0 Sep-24"
IPTABLES_VER="1.4.x"

# Para las nuevas versiones del TS3 es necesario editar el iptables para poder crackearlo

echo ""
echo "===================================================================="
echo "Script de arranque del fw (Netfilter/Iptables) de $HOSTNAME $VER"
echo "Copyright (c) 2019 $AUT"
echo "Version de Iptables $IPTABLES_VER"
echo "Ejecutado por usuario: root"
echo "===================================================================="

###################
# FLUJOS IPTABLES #
###################

#
# 1 --> tabla raw    (PREROUTING ----------------------------------------------------------------> OUTPUT ------------------------------>)
#
# 2 --> tabla mangle (PREROUTING ------------> FORWARD ----------------> INPUT ------------------> OUTPUT ------------------> POSTROUTING)
#
# 3 --> tabla nat    (PREROUTING ----------------------------------------------------------------> OUTPUT ------------------> POSTROUTING)
#
# 4 --> tabla filter (-----------------------> FORWARD ----------------> INPUT ------------------> OUTPUT ------------------------------>)

##########
# INDICE #
##########

#---------------------------------------------------------------------
# 0. DEFINICION DE VARIABLES
#---------------------------------------------------------------------
# 1. CONFIGURACION INICIAL
#---------------------------------------------------------------------
# 2. filter INPUT (LOCALHOST DE DESTINO)
#---------------------------------------------------------------------

##############################
# 0. DEFINICION DE VARIABLES #
##############################

# Variables de IP
#---------------------------------------------------------------------
LOCALHOST="127.0.0.1"
#
# IP del SYSADMIN o Servidor desde donde se tendra acceso a todo
PVE_IP="192.168.100.2"
#FTP
FTP_IP="192.168.13.81"
#---------------------------------------------------------------------

############################
# 1. CONFIGURACION INICIAL #
############################

#---------------------------------------------------------------------
echo ""
echo "=========================================================="
echo "Iniciando Script de Arranque de Reglas del FW de $HOSTNAME"
echo "=========================================================="
echo "Iniciando Script de Arranque de Reglas del FW de $HOSTNAME $FECHA" >> /var/log/iptabes.log
#---------------------------------------------------------------------

#---------------------------------------------------------------------
echo ""
echo "Desactivando IP forwarding"
echo 0 > /proc/sys/net/ipv4/ip_forward

#---------------------------------------------------------------------
# Vaciado de reglas.
#---------------------------------------------------------------------
echo ""
echo "Borrando reglas actuales"
iptables -F
#---------------------------------------------------------------------

##########################################
# 2. filter INPUT (LOCALHOST DE DESTINO) #
##########################################

#Para los paquetes con localhost como destino, se hace uso de la cadena INPUT.

#---------------------------------------------------------------------
echo ""
echo "Cargando reglas de filter INPUT (LOCALHOST DE DESTINO)"
#---------------------------------------------------------------------

# Rechazando paquetes invalidos
#---------------------------------------------------------------------
#iptables -t mangle -A INPUT -m state --state INVALID -j DROP
#---------------------------------------------------------------------

# Permitiendo paquetes con estados relacionados (RELATED) o establecidos (ESTABLISHED)
#---------------------------------------------------------------------
#iptables -t mangle -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
#---------------------------------------------------------------------

# Para servicios de ts+vidoconferencia:
#---------------------------------------------------------------------
iptables -t filter -A INPUT -s $LOCALHOST -p tcp --dport 2008 -j ACCEPT
iptables -t filter -A INPUT -p tcp --dport 2008 -j DROP
iptables -t filter -A INPUT -p tcp -m multiport --dport 10011,30033,13370,13375 -j ACCEPT
iptables -t filter -A INPUT -p udp -m multiport --dport 9987,13370,13375 -j ACCEPT
#---------------------------------------------------------------------

# Para servicio de: http, https
#---------------------------------------------------------------------
iptables -t filter -A INPUT -p tcp -m multiport --dport 80,443 -j ACCEPT
#---------------------------------------------------------------------

# Para gestion: ssh, telnet, snmpm snmp-trap, telnets
#---------------------------------------------------------------------
iptables -t filter -A INPUT -s $PVE_IP -j ACCEPT
iptables -t filter -A INPUT -p tcp -m multiport --dport 22,23,161,162,992 -j ACCEPT
iptables -t filter -A INPUT -p udp -m multiport --dport 22,23,161,162,992 -j ACCEPT
#---------------------------------------------------------------------

# Para servicio de: ftp-data, ftp-control
#---------------------------------------------------------------------
#iptables -t filter -A INPUT -p tcp -m multiport --dport 20,21 -j ACCEPT
#iptables -t filter -A INPUT -p udp -m multiport --dport 20,21 -j ACCEPT
iptables -t filter -A INPUT -s $FTP_IP -j ACCEPT
#---------------------------------------------------------------------

# Permitiendo icmp echo-reply (PONG)
#---------------------------------------------------------------------
iptables -t filter -A INPUT -p icmp --icmp-type echo-reply -j ACCEPT
#---------------------------------------------------------------------

# Todos los paquetes con localhost de destino que no coincidan con las reglas anteriores son desechados
#por la politica por defecto (DROP) de filter INPUT
#-------------------------------------------------------------------------------------
iptables -t filter -P INPUT DROP
#---------------------------------------------------------------------

#---------------------------------------------------------------------
echo ""
echo "========================"
echo "FW de $HOSTNAME LISTO!!!"
echo "========================"
echo ""
#---------------------------------------------------------------------

Damos los permisos de ejecución:

chmod +x /config/scripts/iptables.sh

Creamos el siguiente fichero:

nano /lib/systemd/system/iptables.myrules.service

Agregamos lo siguiente:

[Unit]
Description=Iptables rules
After=network.target

[Service]
Type=forking
ExecStart=/config/scripts/iptables.sh start
ExecStop=/config/scripts/iptables.sh stop

[Install]
WantedBy=multi-user.target

Creamos el siguiente fichero:

nano /config/scripts/startiptables.sh

Agregamos lo siguiente:

#!/bin/bash

systemctl start iptables.myrules.service

Damos los permisos de ejecución:

chmod +x /config/scripts/startiptables.sh

A continuación, se configuran algunos nombres en el fichero hosts, que el propio localhost deberá resolver para que funcione el servicio de teamspeak de manera local:

nano /etc/hosts

Borramos todo, y agregamos lo siguiente, adaptando a nuestra red:

127.0.0.1       localhost

127.0.0.1       accounting.teamspeak.com
127.0.0.1       backupaccounting.teamspeak.com
127.0.0.1       ipcheck.teamspeak.com
127.0.0.1       weblist.teamspeak.com
192.168.9.41    ts.nodo.local                   ts

# The following lines are desirable for IPv6 capable hosts
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Reiniciando la interface de red:

/etc/init.d/networking restart

2.2.      Implementando TeamSpeak

Creamos un directorio para teamspeak:

mkdir -p /opt/instaladores/teamspeak

Accedemos al directorio y descargamos el servidor de teamspeak del sitio indicado:

cd /opt/instaladores/teamspeak
wget -c https://github.com/Franco-Sparrow/franco-repos/blob/master/teamspeak3-server_linux_amd64-3.0.13.6.zip

Descomprimimos el fichero comprimido que contiene al servidor:

unzip teamspeak3-server_linux_amd64-3.0.13.6.zip

Iniciando su servidor TeamSpeak por primera vez, en este inicio lo que va a obtener es la “clave de administración” y el valor del “token”, datos que debe salvar puesto que posteriormente van a servir para configurar su TeamSpeak y poder unir el servicio de videoconferencia a TeamSpeak

Primero debe asignarle los permisos correctos, de antemano recomiendo que este permiso sea asignado al directorio que contiene todo lo referente a TeamSpeak, por tanto:

chmod -R 755 /opt/instaladores/teamspeak/teamspeak3-server_linux_amd64

Accedemos al directorio donde se encuentra el servidor:

cd /opt/instaladores/teamspeak/teamspeak3-server_linux_amd64

Posteriormente ejecute los siguientes pasos tal y como aparecen descritos a continuación:

./AccountingServerEmulator-Linux

¡ESPERE 10 SEGUNDOS, ESTE PASO ES IMPORTANTE! y luego ejecute el archivo que levanta el teamspeak:

./ts3server_startscript.sh start

Al ejecutar el último comando debe devolver algo similar a esto (OJO el proceso para devolver el valor del “token” demora un poco, debe esperar a que termine todo el proceso):

------------------------------------------------------------------
                      I M P O R T A N T                          
------------------------------------------------------------------
               Server Query Admin Account created                
         loginname= "serveradmin", password= "sjiUj9TS"
------------------------------------------------------------------

TeamSpeak 3 server started, for details please view the log file

------------------------------------------------------------------
                      I M P O R T A N T                          
------------------------------------------------------------------
      ServerAdmin privilege key created, please use it to gain
      serveradmin rights for your virtualserver. please
      also check the doc/privilegekey_guide.txt for details.

       token=9151urJUCNb01ERWplY75p8rMgZzwwxQjNqEfu24
------------------------------------------------------------------

De los datos anteriores, copie los siguientes, adaptando a los resultados que obtuvieron:

echo "loginname=serveradmin, password=sjiUj9TS" > /opt/instaladores/teamspeak/credentials

Lo propio para el token:

echo "token=9151urJUCNb01ERWplY75p8rMgZzwwxQjNqEfu24" > /opt/instaladores/teamspeak/token

2.3.      Arreglos en el servidor TeamSpeak

Creamos el script ts3anticrash.sh:

nano /config/scripts/ts3anticrash.sh

Agregamos lo siguiente:

#!/bin/bash

PATH=/opt/instaladores/teamspeak/teamspeak3-server_linux_amd64

case $1 in
        ts3server)
                t3server=`ps ax | grep ts3server | grep -v grep | wc -l`
                if [ $t3server -eq 1 ];
                        then
                                exit
                        else
                                cd $PATH
                                ./ts3server_startscript.sh start
                fi
        ;;
        ts3accounting)
                t3accounting=`ps ax | grep AccountingServer | grep -v grep | wc -l`
                if [ $t3accounting -eq 1 ];
                        then
                                exit
                        else
                                cd $PATH
                                ./AccountingServerEmulator-Linux
                fi
        ;;
        ts3tsdns)
                t3tsdns=`ps ax | grep tsdnsserver | grep -v grep | wc -l`
                if [ $t3tsdns -eq 2 ];
                        then
                                exit
                        else
                cd $PATH
                screen -AmdS tsdnsserver ./tsdnsserver
        fi
        ;;
esac

Damos permisos de ejecución:

chmod +x /config/scripts/ts3anticrash.sh

Creamos el script de inicio:

nano /config/scripts/start.sh

Agregamos lo siguiente:

#!/bin/bash
rm -f /opt/instaladores/teamspeak/teamspeak3-server_linux_amd64/ts3server.pid
/opt/instaladores/teamspeak/teamspeak3-server_linux_amd64/AccountingServerEmulator-Linux
sleep 15s;
/opt/instaladores/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh start

Damos permisos de ejecución:

chmod +x /config/scripts/start.sh

Automatizamos la ejecución del script para iptables, el inicio del servidor y el anticrash, mediante el cron:

crontab -e

Agregamos lo siguiente:

######
# TS #
######

@reboot sh /config/scripts/startiptables.sh
@reboot sh /config/scripts/start.sh
*/1 * * * * /config/scripts/ts3anticrash.sh ts3server
*/25 * * * * /config/scripts/ts3anticrash.sh ts3accounting
*/1 * * * * /config/scripts/ts3anticrash.sh ts3tsdns

Reiniciamos el sistema:

reboot

#==========================================

NOTA:

Una vez iniciado el sistema, el tiempo que demoró el servidor de teamspeak en encender usando este procedimiento fue de unos 5min (con 1 vcore y 512MB RAM de recursos hardware).

#==========================================

Verificamos si las reglas que creamos para iptables fueron aplicadas correctamente:

iptables -L

Debe devolver algo como lo siguiente:

Pasado este tiempo, desde otro terminal Linux, accedido por ssh, podemos encuestar por telnet, el servicio de TeamSpeak:

telnet ts.nodo.local 10011

Debe devolver lo siguiente:

Trying 192.168.9.41...
Connected to 192.168.9.41.
Escape character is '^]'.
TS3
Welcome to the TeamSpeak 3 ServerQuery interface, type "help" for a list of commands and "help " for information on a specific command.

Para salir ponemos lo siguiente:

^]

Ó, mediante la siguiente línea:

quit

Una vez cerrado con éxito, devolverá lo siguiente:

error id=0 msg=ok
Connection closed by foreign host.

2.4.      Gestionando el TS desde el cliente en Windows

Instalamos el cliente “TeamSpeak3-Client-win64-3.1.10.exe”, el cual puede bajarse del sitio oficial:

En esta ocasión se instaló el TS3-v3.1.10:

Intentamos acceder a nuestro servidor, especificando el hostname, y nuestro alias a utilizarse en él. Una vez autenticados nos pedirá una clave de privilegio, al ser el primer registroi en el servidor. Le pondremos aquella clave que nos fue devuelta durante el proceso de instalación, la misma que guardamos em el fichero “/opt/instaladores/teamspeak/token”. Una vez introducida, nos devolverá lo siguiente:

Ya contamos con los permisos de “Server Admin” de nuestro TS y podremos comenzar a editarlo desde el cliente. También es posible gestionar nuestro TS desde otra API, llamada “YaTQA-Setup [Controler Admin TS].exe”, pero ésta no se tratará en el presente tutorial:

Sobre las 2 horas y 15 minutos el servidor crashea cuando el procedimiento no se hizo correctamente. A continuación, se muestra una imagen donde se sobrepasó dicho tiempo sin crashear el servidor:

2.5.      Implementando TS3VIDEO

El servidor de videoconferencia para TS no es obligatorio, es un agregado a nuestro servidor que su implementación dependerá de quien lo administre. En este apartado se explica cómo implementarlo al servidor de TS anteriormente implementado.

Accedemos al siguiente directorio:

cd /opt/instaladores/teamspeak

Descargamos el servidor del siguiente enlace:

wget -c https://github.com/Franco-Sparrow/franco-repos/blob/master/video.zip

Descomprimimos el fichero:

unzip video.zip

Editamos el fichero de configuración del servidor:

nano /opt/instaladores/teamspeak/video/default.ini

Modificamos las siguientes líneas, según los resultados que obtuvimos de la instalación del servidor, como la contraseña del usuario “serveradmin”, que guardamos en “/opt/instaladores/teamspeak/credentials”, así como el fichero de los logs, la máxima resolución permitida y la contraseña que pedirá para hacer uso del TS3VIDEO:

[...]
maxresolution=640x480
[...]
adminpassword=password_que_quiera
[...]
loginpassword=sjiUj9TS
[...]
FilePath=/var/log/video/serverapp.log

Creamos el directorio que contendrá a los logs del TS3VIDEO:

mkdir /var/log/video

Damos los permisos necesarios:

chmod +x /opt/instaladores/teamspeak/video/videoserver.sh
chmod +x /opt/instaladores/teamspeak/video/ld.so
chmod +x /opt/instaladores/teamspeak/video/videoserver

Ejecutamos el servidor de video:

/opt/instaladores/teamspeak/video/videoserver.sh start

Deberá devolvernos lo siguiente:

Starting the Conference Server

Revisamos los logs:

tail -n 12 /var/log/video/serverapp.log

Si levantó bien el servicio, saldrá algo como lo siguiente:

2019-09-24 04:13:57     info    pid=792 tid=792 ----- Server startup ----
2019-09-24 04:13:57     info    pid=792 tid=792 Version: 0.8
2019-09-24 04:13:57     info    pid=792 tid=792 Organization: mfreiholz
2019-09-24 04:13:57     info    pid=792 tid=792 Organization domain: https://mfreiholz.de
2019-09-24 04:13:57     info    pid=792 tid=792 ----- Limits ------------
2019-09-24 04:13:57     info    pid=792 tid=792 Connection limit: 2147483647
2019-09-24 04:13:57     info    pid=792 tid=792 Bandwidth read limit: 16.00 EB/s
2019-09-24 04:13:57     info    pid=792 tid=792 Bandwidth write limit: 16.00 EB/s
2019-09-24 04:13:57     info    pid=792 tid=792 -------------------------
2019-09-24 04:13:57     info    pid=792 tid=792 Listening for client connections (protocol=TCP; address=0.0.0.0; port=13370)
2019-09-24 04:13:57     info    pid=792 tid=792 Listening for media data (protocol=UDP; address=0.0.0.0; port=13370)
2019-09-24 04:13:57     info    pid=792 tid=792 Listening for web-socket status connections (protocol=TCP; address=0.0.0.0; port=13375)

Automatizamos el inicio de este servicio con el cron:

crontab -e

Agregamos al final lo siguiente:

@reboot /opt/instaladores/teamspeak/video/videoserver.sh start

2.6.      Instalando Plugin para TS3VIDEO en Windows

Nos bajamos del siguiente enlace un comprimido con los programas necesarios para este plugin:

https://github.com/Franco-Sparrow/franco-repos/blob/master/TS3-VIDEO-PLUGIN.part1.rar

https://github.com/Franco-Sparrow/franco-repos/blob/master/TS3-VIDEO-PLUGIN.part2.rar

https://github.com/Franco-Sparrow/franco-repos/blob/master/TS3-VIDEO-PLUGIN.part3.rar

Instalamos lo siguientes paquetes:

• vcredist_x64.exe
• vcredist_x86.exe
• Conference_Client-0.13_Setup.exe

Durante la instalación del plugin “Conference_Client-0.13_Setup.exe”, seguimos los pasos descritos en las imágenes:

Confirmamos la instalación, seleccionando “Yes”:

Si tenemos nuestro cliente online, deberemos reiniciarlo para aplicar los cambios:

Accedemos al cliente y siga la siguiente trayectoria:

“Herramientas > Opciones > Complementos”

A continuación, se muestra cómo saldría el plugin habilitado:

Nos ubicamos encima de cualquier canal con permisos del TS para uso del plugin, “click” derecho encima y seleccionamos:

“TS3VIDEO > join now”

Definimos la cámara que se usará y las resoluciones permitidas.

Nos perdirá la contraseña que definimos en el fichero de configuración del servidor de video (adminpassword):

Seleccionamos el ícono de la cámara y hacemos uso del servicio:

2.7.      Implementando estadísticas para TS3VIDEO

Necesitamos un servidor web totalmente funcional.

Instalando Apache2:

apt install apache2

Instalando PHP 7:

apt install php7.0 libapache2-mod-php7.0

Agregando extensiones más comunes para PHP:

apt install php7.0-mysql php7.0-gd php7.0-intl php-pear php-imagick php7.0-imap php7.0-mcrypt php-memcache php7.0-pspell php7.0-recode php7.0-sqlite3 php7.0-tidy php7.0-xmlrpc php7.0-xsl php7.0-mbstring php-gettext php7.0-ldap php7.0-mysqli php-apcu

Reiniciando Apache 2:

/etc/init.d/apache2 restart

Comprobando las funcionabilidades de PHP:

nano /var/www/html/info.php

Agregue el siguiente contenido:

<?php
phpinfo();
?>

Damos los permisos necesarios:

chown www-data:www-data /var/www/html/info.php

Usted puede visualizar el contenido accediendo a:

http://DIRECCIÓN.IP/info.php

Hasta este punto ya usted dispone de un servidor web con soporta para páginas estáticas y dinámicas. Ahora continuamos con la implementación de las estadísticas para TS3VIDEO:

mkdir /var/www/html/video
mv /opt/instaladores/teamspeak/video/server-status /var/www/html/video
chown -R www-data:www-data /var/www/html/video
chmod -R 775 /var/www/html/video

Creando un alias y virtualhost para apache2:

nano /etc/apache2/sites-available/video.conf

Agregue el siguiente contenido:

#########
# ALIAS #
#########

Alias /video /var/www/html/video/server-status
;
Options Indexes FollowSymLinks Includes
AllowOverride All


###############
# VIRTUALHOST #
###############


 ServerAdmin [email protected]
 ServerName ts3video.nodo.local
 DocumentRoot /var/www/html/video/server-status/
 ErrorLog /var/log/apache2/ts3video.nodo.local.error.log
 LogLevel warn
 CustomLog /var/log/apache2/ts3video.nodo.local.access.log combined
 ServerSignature Off

#=============================================

NOTA:

Para usar el virtualhost es necesario crear una entrada en el DNS con el nombre al cual responde el mismo.

#=============================================

Creando un enlace simbólico:

ln -s /etc/apache2/sites-available/video.conf /etc/apache2/sites-enabled/video.conf

Instalamos el siguiente paquete necesario, para que se muestren las estadísticas en la web:

apt-get install libssl1.0-dev

Reiniciando apache2:

/etc/init.d/apache2 restart

Accediendo a la página de estadísticas:

http://dirección.ip.servidorTS/video

A continuación, se muestran el “dashboard” del sitio:

Las conexiones del plugin con el servidor:

Referencias bibliográficas

• Blog Debian Paso a Paso: “teamspeak 3-0.13-6 más video conferencia (Debian 8 y 9)”, por Ariel Álvarez Gutiérrez, 2018
• Artículo web “Setup a TeamSpeak 3 Server on Linux (Ubuntu / Debian)”, 2017, https://unixblogger.com/2017/11/08/setup-a-teamspeak-3-server-on-linux-ubuntu-debian/