TeamSpeak Server installieren

In diesem Artikel erklären wir dir, wie du einen TeamSpeak Server auf deinem KVM-Server installierst und grundlegend einrichtest.

TeamSpeak ist ein Voice-Server, über den sich Nutzer in Sprachkanälen verbinden können. Die Installation erfolgt direkt auf deinem Server. Du benötigst dafür Zugriff per SSH und ein Linux-Betriebssystem.

Voraussetzungen

Für diese Anleitung benötigst du:

• einen KVM-Server mit Linux

• SSH-Zugriff auf den Server

• Root-Zugriff oder einen Benutzer mit sudo-Rechten

• eine öffentliche IPv4-Adresse

• grundlegende Kenntnisse im Umgang mit der Linux-Konsole

Diese Anleitung verwendet Debian oder Ubuntu als Beispiel.

Verbindung per SSH herstellen

Verbinde dich zuerst per SSH mit deinem Server.

Beispiel:

ssh root@SERVER-IP

Ersetze SERVER-IP durch die IP-Adresse deines KVM-Servers.

Wenn du einen anderen SSH-Port verwendest, gib den Port zusätzlich an.

Beispiel:

ssh root@SERVER-IP -p 2222

System aktualisieren

Bevor du TeamSpeak installierst, solltest du dein System aktualisieren.

Führe dazu aus:

apt update

Danach installierst du verfügbare Updates:

apt upgrade

Falls wichtige Systemupdates installiert wurden, kann ein Neustart sinnvoll sein.

Befehl:

reboot

Verbinde dich danach erneut per SSH.

Benötigte Pakete installieren

Installiere einige grundlegende Pakete, die für Download, Entpacken und Verwaltung benötigt werden.

Befehl:

apt install wget bzip2 tar

Eigenen Benutzer für TeamSpeak erstellen

TeamSpeak sollte nicht dauerhaft als Root-Benutzer laufen.

Erstelle deshalb einen eigenen Benutzer.

Befehl:

adduser --disabled-login teamspeak

Der Benutzer teamspeak wird ohne normalen Login erstellt. Das ist für einen Serverdienst sinnvoll.

Wechsle danach zu diesem Benutzer:

su - teamspeak

TeamSpeak Server herunterladen

Öffne die offizielle TeamSpeak Downloadseite und kopiere den aktuellen Downloadlink für den Linux Server.

Die Downloadseite findest du unter:

https://www.teamspeak.com/en/downloads/#server

Lade anschließend die Serverdateien herunter.

Beispiel:

wget https://files.teamspeak-services.com/releases/server/VERSION/teamspeak3-server_linux_amd64-VERSION.tar.bz2

Ersetze VERSION durch die aktuelle TeamSpeak-Version.

Da sich die Versionen ändern können, solltest du den Link immer von der offiziellen TeamSpeak-Seite übernehmen.

TeamSpeak Server entpacken

Entpacke das heruntergeladene Archiv.

Beispiel:

tar xjf teamspeak3-server_linux_amd64-VERSION.tar.bz2

Wechsle anschließend in den entpackten Ordner.

Beispiel:

cd teamspeak3-server_linux_amd64

Lizenzbedingungen akzeptieren

TeamSpeak benötigt eine Bestätigung der Lizenzbedingungen.

Erstelle dafür die Datei .ts3server_license_accepted.

Befehl:

touch .ts3server_license_accepted

Ohne diese Datei startet der Server nicht.

TeamSpeak Server einmal starten

Starte den TeamSpeak Server testweise.

Befehl:

./ts3server_startscript.sh start

Beim ersten Start werden wichtige Zugangsdaten ausgegeben.

Dazu gehören:

• Server Admin Token

• ServerQuery Admin Benutzername

• ServerQuery Admin Passwort

Diese Daten werden nur beim ersten Start angezeigt.

Notiere sie sofort und speichere sie sicher.

Wichtig: Ohne den Server Admin Token kannst du dich später nicht als Serveradministrator im TeamSpeak Client berechtigen.

TeamSpeak Server stoppen

Stoppe den Server nach dem ersten Start wieder.

Befehl:

./ts3server_startscript.sh stop

Danach richtest du den Server als Systemdienst ein.

Zurück zum Root-Benutzer wechseln

Verlasse den TeamSpeak-Benutzer.

Befehl:

exit

Du solltest nun wieder als Root oder als sudo-Benutzer angemeldet sein.

TeamSpeak als systemd-Dienst einrichten

Damit TeamSpeak automatisch gestartet und sauber verwaltet werden kann, richtest du einen systemd-Dienst ein.

Erstelle eine neue Service-Datei:

nano /etc/systemd/system/teamspeak.service

Füge folgenden Inhalt ein:

[Unit] Description=TeamSpeak 3 Server After=network.target

[Service] WorkingDirectory=/home/teamspeak/teamspeak3-server_linux_amd64 User=teamspeak Group=teamspeak Type=forking ExecStart=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh start ExecStop=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh stop PIDFile=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server.pid Restart=always RestartSec=15

[Install] WantedBy=multi-user.target

Speichere die Datei.

Bei nano geht das mit STRG + O, danach Enter und anschließend STRG + X.

systemd neu laden

Lade systemd neu, damit der neue Dienst erkannt wird.

Befehl:

systemctl daemon-reload

Aktiviere TeamSpeak für den automatischen Start beim Booten.

Befehl:

systemctl enable teamspeak

Starte den Dienst.

Befehl:

systemctl start teamspeak

Prüfe den Status.

Befehl:

systemctl status teamspeak

Wenn dort active (running) angezeigt wird, läuft der TeamSpeak Server.

Benötigte Ports öffnen

Damit sich Nutzer mit deinem TeamSpeak Server verbinden können, müssen die benötigten Ports erreichbar sein.

Standardports von TeamSpeak:

Port	Protokoll	Zweck
9987	UDP	Sprachverbindung
10011	TCP	ServerQuery
30033	TCP	Dateiübertragung

Der wichtigste Port für normale Nutzer ist 9987/udp.

Ports mit UFW öffnen

Wenn du UFW nutzt, öffne die benötigten Ports.

Befehle:

ufw allow 9987/udp

ufw allow 10011/tcp

ufw allow 30033/tcp

Prüfe danach den Status:

ufw status

Wichtig: Öffne nur Ports, die du wirklich benötigst. Wenn du ServerQuery oder Dateiübertragung nicht verwendest, solltest du prüfen, ob diese Ports öffentlich erreichbar sein müssen.

Mit TeamSpeak verbinden

Installiere den TeamSpeak Client auf deinem Computer.

Öffne den Client und verbinde dich mit der IP-Adresse deines Servers.

Beispiel:

123.123.123.123

Wenn dein TeamSpeak Server den Standardport 9987 nutzt, musst du den Port meistens nicht zusätzlich angeben.

Falls du einen anderen Port verwendest, gib ihn mit an.

Beispiel:

123.123.123.123:9987

Server Admin Token verwenden

Beim ersten Start hat TeamSpeak einen Server Admin Token ausgegeben.

Diesen Token benötigst du, um dich im TeamSpeak Client als Administrator zu berechtigen.

Nach dem Verbinden erscheint häufig automatisch ein Fenster zur Eingabe des Tokens.

Falls nicht:

1. Öffne im TeamSpeak Client den Bereich Rechte.

2. Wähle Berechtigungsschlüssel verwenden.

3. Füge den Server Admin Token ein.

4. Bestätige die Eingabe.

Danach solltest du Serveradministrator-Rechte besitzen.

TeamSpeak Dienst verwalten

Wenn TeamSpeak als systemd-Dienst eingerichtet wurde, kannst du ihn mit folgenden Befehlen verwalten.

Server starten:

systemctl start teamspeak

Server stoppen:

systemctl stop teamspeak

Server neustarten:

systemctl restart teamspeak

Status prüfen:

systemctl status teamspeak

Automatischen Start aktivieren:

systemctl enable teamspeak

Automatischen Start deaktivieren:

systemctl disable teamspeak

Logs prüfen

Wenn der TeamSpeak Server nicht startet oder Verbindungsprobleme auftreten, solltest du die Logs prüfen.

systemd-Logs anzeigen:

journalctl -u teamspeak

Live-Logs anzeigen:

journalctl -u teamspeak -f

Zusätzlich legt TeamSpeak eigene Logdateien im Serververzeichnis ab.

Beispiel:

/home/teamspeak/teamspeak3-server_linux_amd64/logs

TeamSpeak aktualisieren

TeamSpeak sollte regelmäßig aktualisiert werden.

Vor einem Update solltest du ein Backup erstellen.

Stoppe zuerst den Dienst:

systemctl stop teamspeak

Sichere anschließend das TeamSpeak-Verzeichnis.

Beispiel:

cp -a /home/teamspeak/teamspeak3-server_linux_amd64 /home/teamspeak/teamspeak3-server_backup

Lade danach die neue Version von der offiziellen TeamSpeak-Webseite herunter, entpacke sie und ersetze die Serverdateien vorsichtig.

Achte darauf, wichtige Dateien nicht zu löschen.

Besonders wichtig sind:

• Datenbankdateien

• Konfigurationsdateien

• Lizenzdateien

• Logdateien, falls benötigt

Starte den Dienst danach wieder:

systemctl start teamspeak

Prüfe anschließend den Status:

systemctl status teamspeak

Backup erstellen

Ein Backup ist wichtig, bevor du Änderungen am TeamSpeak Server vornimmst.

Sichere mindestens:

• das TeamSpeak Serververzeichnis

• die Datenbankdatei

• Konfigurationsdateien

• Lizenzdateien

Ein einfaches Backup kannst du so erstellen:

systemctl stop teamspeak

cp -a /home/teamspeak/teamspeak3-server_linux_amd64 /home/teamspeak/teamspeak3-server_backup

systemctl start teamspeak

Für regelmäßige Backups solltest du die Sicherung auf einem externen Speicher ablegen. Ein Backup auf demselben Server schützt nicht vor Datenverlust, wenn der Server beschädigt oder kompromittiert wird.

Häufige Probleme

TeamSpeak Server startet nicht

Prüfe zuerst den Dienststatus:

systemctl status teamspeak

Prüfe danach die Logs:

journalctl -u teamspeak

Häufige Ursachen:

• Lizenzbedingungen wurden nicht akzeptiert

• falscher Pfad in der systemd-Datei

• Dateien gehören dem falschen Benutzer

• benötigte Dateien fehlen

• Port ist bereits belegt

• Archiv wurde nicht korrekt entpackt

Lizenz wurde nicht akzeptiert

Wenn die Lizenz nicht akzeptiert wurde, startet TeamSpeak nicht.

Prüfe, ob im TeamSpeak-Verzeichnis folgende Datei vorhanden ist:

.ts3server_license_accepted

Falls nicht, wechsle in das TeamSpeak-Verzeichnis und erstelle sie:

touch .ts3server_license_accepted

Starte den Dienst danach neu:

systemctl restart teamspeak

Verbindung zum Server funktioniert nicht

Prüfe:

• läuft der TeamSpeak Dienst?

• ist Port 9987/udp geöffnet?

• verwendest du die richtige IP-Adresse?

• blockiert eine Firewall die Verbindung?

• wurde TeamSpeak auf einem anderen Port gestartet?

• ist der Server über das Internet erreichbar?

Status prüfen:

systemctl status teamspeak

Firewall prüfen:

ufw status

Server Admin Token verloren

Der Server Admin Token wird beim ersten Start angezeigt.

Wenn du ihn nicht gespeichert hast, kannst du über ServerQuery oder die Datenbank einen neuen Token erstellen. Das ist technischer und hängt von deiner Installation ab.

Einfacher ist es, den Token direkt beim ersten Start sicher zu speichern.

ServerQuery funktioniert nicht

Prüfe:

• ist Port 10011/tcp geöffnet?

• läuft der TeamSpeak Server?

• nutzt du die richtigen ServerQuery-Zugangsdaten?

• blockiert eine Firewall den Zugriff?

• wurde ServerQuery in der Konfiguration geändert?

Dateiübertragung funktioniert nicht

Für Dateiübertragungen wird standardmäßig Port 30033/tcp verwendet.

Prüfe:

• ist Port 30033/tcp geöffnet?

• blockiert eine Firewall die Verbindung?

• sind die Rechte im TeamSpeak Server korrekt gesetzt?

• ist genug Speicherplatz vorhanden?

Port ist bereits belegt

Wenn TeamSpeak nicht startet, weil ein Port bereits genutzt wird, prüfe offene Ports.

Befehl:

ss -tulpen

Beende den anderen Dienst oder ändere den TeamSpeak-Port.

Sicherheit

Ein TeamSpeak Server sollte nicht ungeschützt betrieben werden.

Empfehlungen:

• starkes ServerQuery-Passwort verwenden

• Server Admin Token sicher speichern

• unnötige Ports nicht öffentlich öffnen

• TeamSpeak regelmäßig aktualisieren

• Backups erstellen

• Rechte im TeamSpeak Client sauber vergeben

• keine unbekannten Personen als Server Admin eintragen

• ServerQuery-Zugang nicht weitergeben

Sicherheit: Sende niemals ServerQuery-Passwörter, Admin Tokens oder private Zugangsdaten an andere Personen.

Support kontaktieren

Wenn du TeamSpeak nicht starten oder erreichen kannst, kontaktiere den Support.

Gib dabei bitte folgende Informationen an:

• Betriebssystem

• IP-Adresse des Servers

• verwendete TeamSpeak-Version

• genaue Fehlermeldung

• Ausgabe von systemctl status teamspeak

• ob Port 9987/udp geöffnet ist

• was du bereits versucht hast

Sende keine Passwörter, Admin Tokens oder privaten Zugangsdaten.