Vorbereitung¶

Zuerst wird ein Benutzer teamspeak mit adduser ^[5] für den Betrieb des Servers mit eigenem Home-Verzeichnis erstellt. Die gewünschte Systemarchitektur (i386/amd64) ist anzupassen:

• 32-Bit:

  sudo adduser teamspeak --system --home /usr/local/bin/teamspeak3-server_linux_x86 --disabled-login 

• 64-Bit:

  sudo adduser teamspeak --system --home /usr/local/bin/teamspeak3-server_linux_amd64 --disabled-login 

Herunterladen und Entpacken¶

Für das weitere Vorgehen wechselt man zum Benutzer teamspeak:

sudo su teamspeak --shell /bin/bash 

Jetzt muss der TeamSpeak3-Server von der offiziellen Downloadseite des Herstellers heruntergeladen und in das Homeverzeichnis /usr/local/bin/teamspeak3-server_linux_SYSTEMARCHITEKTUR des Benutzers teamspeak entpackt werden ^[7].

Auf einem Server ohne grafische Benutzeroberfläche kann das Archiv alternativ auch direkt von der 4Player Mirror Site heruntergeladen werden. Die Versionsnummer 3.x.y.z und amd64/x86 sind an die gewünschte Version anzupassen:

cd /tmp
wget http://dl.4players.de/ts/releases/3.x.y.z/teamspeak3-server_linux_SYSTEMARCHITEKTUR-3.x.y.z.tar.bz2
tar -xjf teamspeak3-server_linux_SYSTEMARCHITEKTUR-3.x.y.z.tar.bz2 -C /usr/local/bin/
rm teamspeak3-server_linux_SYSTEMARCHITEKTUR-3.x.y.z.tar.bz2
cd ~ 

Einrichten der Konfiguration¶

Vor dem erstem Serverstart sollte man noch folgende Dateien von Hand anlegen bzw. bearbeiten: ts3server.ini, query_ip_whitelist.txt und query_ip_blacklist.txt. Die ts3server.ini lässt sich automatisch mit diesem Befehl erstellen (als Benutzer teamspeak ausführen):

./ts3server createinifile=1
touch query_ip_blacklist.txt query_ip_whitelist.txt 

Die angezeigten Fehlermeldungen können ignoriert werden. Der Inhalt der ts3server.ini sieht danach folgendermaßen aus:

machine_id=
default_voice_port=9987
voice_ip=0.0.0.0
licensepath=
filetransfer_port=30033
filetransfer_ip=0.0.0.0
query_port=10011
query_ip=0.0.0.0
query_ip_whitelist=query_ip_whitelist.txt
query_ip_blacklist=query_ip_blacklist.txt
dbplugin=ts3db_sqlite3
dbpluginparameter=
dbsqlpath=sql/
dbsqlcreatepath=create_sqlite/
dbconnections=10
logpath=logs
logquerycommands=0
dbclientkeepdays=30
logappend=0
query_skipbruteforcecheck=0

Der erste Serverstart¶

Für den ersten Start des Servers (als Benutzer teamspeak ausführen).

./ts3server_startscript.sh start inifile=ts3server.ini 

Nun erscheinen nun zwei Warnhinweise.

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


------------------------------------------------------------------
                      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=bgOEcvBZun5AP5bJEmHoYP0pdO7YwEIqGBbYMHN2
------------------------------------------------------------------

Das Password für serveradmin sollte notiert werden, denn es ermöglicht den vollständigen Zugriff auf das Serverquery des TeamSpeak3-Servers über alle Einstellungen, inklusive alle virtuellen Server. Damit man auch im TeamSpeak3-Client den Server Admin erlangt, sollte man sich mit diesem einloggen und den "token" eingeben. Im Logfile ts3server_1.log findet man diesen Token, um diesen mittels Kopieren und Einfügen zu übertragen.

2014-01-10 20:04:46.842555|WARNING |VirtualServer |  1| --------------------------------------------------------
2014-01-10 20:04:46.842590|WARNING |VirtualServer |  1| ServerAdmin privilege key created, please use the line below
2014-01-10 20:04:46.842621|WARNING |VirtualServer |  1| token=bgOEcvBZun5AP5bJEmHoYP0pdO7YwEIqGBbYMHN2
2014-01-10 20:04:46.842651|WARNING |VirtualServer |  1| --------------------------------------------------------

Server als Dienst starten¶

Damit man den Server nicht nach jedem Systemneustart von Hand starten muss, kann man den Server beim Booten als Dienst ^[6] gleich mitstarten lassen. Im Grunde wäre es auch möglich, das ./ts3server_startscript.sh anzupassen und entsprechend zu verlinken. Leider wird das Script bei jedem Update überschrieben und der direkte Aufruf erzeugt eine Fehlermeldung, dass der TeamSpeak 3 Server als Benutzer root gestartet wird.

WARNING ! For security reasons we advise: DO NOT RUN THE SERVER AS ROOT

Hier ein SysV-Init-Skript, das mit Root-Rechten als /etc/init.d/ts3server erstellt wird:

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101

#! /bin/sh
### BEGIN INIT INFO
# Provides:          ts3server
# Required-Start:    $remote_fs $syslog
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: TeamSpeak 3 Server
# Description:       Startup Init-Script for TeamSpeak 3 Server
### END INIT INFO

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="TeamSpeak 3 Server"
NAME=ts3server
USER=teamspeak
BINARY=ts3server
BINARY_BIN=/usr/local/bin/teamspeak3-server_linux_amd64
DAEMON=ts3server_startscript.sh
DAEMON_ARGS=inifile=ts3server.ini
PIDFILE=$BINARY_BIN/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Exit if the package is not installed
[ -x "$BINARY_BIN/$DAEMON" ] || exit 0

# Define LSB log_* functions.
# Depend on lsb-base (>= 3.2-14) to ensure that this file is present
# and status_of_proc is working.
. /lib/lsb/init-functions

#
# Function that starts the daemon/service
#
do_start()
{
  su $USER -s /bin/sh -c "$BINARY_BIN/$DAEMON start $DAEMON_ARGS"
}

#
# Function that stops the daemon/service
#
do_stop()
{
  su $USER -s /bin/sh -c "$BINARY_BIN/$DAEMON stop $DAEMON_ARGS"
}

#
# Function that shows the status of to the daemon/service
#
do_status()
{
  su $USER -s /bin/sh -c "$BINARY_BIN/$DAEMON status $DAEMON_ARGS"
}

case "$1" in
  start)
    log_daemon_msg "Starting $DESC" ""
    do_start
    case "$?" in
      0|1) log_end_msg 0 ;;
      2) log_end_msg 1 ;;
    esac
    ;;
  stop)
    log_daemon_msg "Stopping $DESC" ""
    do_stop
    case "$?" in
      0|1) log_end_msg 0 ;;
      2) log_end_msg 1 ;;
    esac
    ;;
  status)
    do_status
    status_of_proc "$BINARY" "$DESC" && exit 0 || exit $?
    ;;
  restart)
	log_daemon_msg "Restarting $DESC" ""
    do_stop
	case "$?" in
	  0|1)
        do_start
        case "$?" in
          0) log_end_msg 0 ;;
          1) log_end_msg 1 ;; # Old process is still running
          *) log_end_msg 1 ;; # Failed to start
        esac
        ;;
      *)
        # Failed to stop
        log_end_msg 1
		;;
	esac
	;;
  *)
    echo "Usage: $SCRIPTNAME {start|stop|status|restart}"
    exit 3
    ;;
esac

:

Die gewünschte Version amd64/x86 oben im Script ist anzupassen und in die Datei ts3server zu übertragen ^[8]. Danach die Dateirechte ^[4] als ausführbar anpassen und als Init-Script im System einrichten:

sudo chmod +x ts3server
sudo update-rc.d ts3server defaults 80 10 

Bei erfolgreich Aufruf erhält man diese Ausgabemeldungen:

 Adding system startup for /etc/init.d/ts3server ...
   /etc/rc0.d/K10ts3server -> ../init.d/ts3server
   /etc/rc1.d/K10ts3server -> ../init.d/ts3server
   /etc/rc6.d/K10ts3server -> ../init.d/ts3server
   /etc/rc2.d/S80ts3server -> ../init.d/ts3server
   /etc/rc3.d/S80ts3server -> ../init.d/ts3server
   /etc/rc4.d/S80ts3server -> ../init.d/ts3server
   /etc/rc5.d/S80ts3server -> ../init.d/ts3server

Nun lässt sich der TeamSpeak3-Server bequem ohne den umständlichen Umweg über ein sudo-Kommando starten/stoppen bzw. der Status ermitteln.

Lizenzdatei¶

Solange sich keine licensekey.dat im Programmverzeichnis des TeamSpeak3-Servers befindet, wird im ts3server_0.log immer wieder folgende Zeile nach dem Serverstart auftauchen:

2014-01-10 20:04:28.877559|WARNING |Accounting    |   | Unable to find valid license key, falling back to limited functionality

Für den privaten Gebrauch kann diese Meldung ignoriert werden, allerdings bleibt der TeamSpeak3-Server auf 1 virtuellen Server mit maximal 32 Slots beschränkt. Eine Non Profit License (NLP) kann man auf der TeamSpeak Webseite beantragen. Diese ermöglicht dann den Betrieb von zwei virtuellen Servern mit maximal 512 Slots. Mittlerweile ist diese aber an diverse Bedingungen geknüpft:

• eine online verfügbare, funktionierende Webseite mit einer eigenen Domain (Bsp. www.meints3server.org)

• eine gültige E-Mail-Adresse verknüpft mit der eigenen Domain (Bsp. serveradmin@meints3server.org)

• der NPL lizensierte Server muss an einer statischen IP-Adresse betrieben werden

• wenn eine NPL bereits auf die IP-Adresse ausgestellt wurde, wird der Antrag abgelehnt

• beim Überprüfen der Webseite darf keine Werbung oder Spenden-Buttons vorhanden sein

Sobald man eine E-Mail mit dem Betreff "TeamSpeak 3 Non-Profit License Issued" erhalten hat, kann man die angehängte Datei licensekey.dat in den Programmordner des TeamSpeak3-Servers kopieren und den Serverdienst neu starten.