NEU 📢 Black Friday: Unser Startangebot endet am 30. Nov. Bis zu 70 % Rabatt auf deinen ersten Monat, für jedes Spiel!Tarife ansehen
Black FridayBis zu 70 % Rabatt auf deinen ersten Monat, endet am 30. Nov.Endet in 9 T. 02 Std. 49 Min.Black FridayBis zu 70 % Rabatt auf deinen ersten Monat, endet am 30. Nov.Endet in 9 T. 02 Std. 49 Min.Black FridayBis zu 70 % Rabatt auf deinen ersten Monat, endet am 30. Nov.Endet in 9 T. 02 Std. 49 Min.

Neuen TeamSpeak Server-Admin privilege key erzeugen

Mumble und Voice-ServerAktualisiert 21. Nov. 20267 Min. Lesezeit

Kurz gesagt. Ein neuer TeamSpeak Server gibt beim allerersten Start einen ServerAdmin privilege key aus (eine Zeile, die mit token= beginnt), in der Konsole und im Log des virtuellen Servers 1. Ein Key funktioniert nur einmal. Um bei TeamSpeak 3 einen neuen zu erzeugen, melde dich bei ServerQuery als serveradmin an und führe privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0 aus; bei TeamSpeak 6 schickst du denselben Befehl mit einem API-Key an die HTTP-Query. Auch das ServerQuery-Passwort verloren? Starte TeamSpeak 3 einmal mit serveradmin_password= oder TeamSpeak 6 mit --query-http-enable und --query-admin-api-key. So haben wir am 6. November 2026 neue Keys auf TeamSpeak 3 Server 3.13.8 und TeamSpeak 6 Server v6.0.0-beta13.1 erzeugt. TeamSpeak 6 Server v6.0.0-beta14 ist am 17. November 2026 erschienen; wir haben diese Schritte darauf nicht wiederholt.

Was der privilege key ist

TeamSpeaks eigene Anleitung (doc/privilegekey_guide.txt im TeamSpeak 3 Download) sagt, dass ein TeamSpeak 3 Server keine Benutzernamen oder Passwörter kennt: Er erkennt Personen an einer eindeutigen ID, die aus einem Schlüsselpaar entsteht, das ihr Client erzeugt. Der erste Admin braucht also ein Ticket: den privilege key. TeamSpeak 6 nutzt dieselbe Art von Key. Fügst du ihn in den TeamSpeak Client ein, landet diese Identität in der Gruppe Server Admin des virtuellen Servers, für den der Key erstellt wurde. Laut derselben Anleitung kann ein Key nur einmal verwendet werden.

Den Key vom ersten Start finden

Beim ersten Start geben beide Versionen dieselben zwei Zeilen aus:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 unter Linux: Der Server schreibt ihn ins Log des virtuellen Servers 1, die Datei in logs/, deren Name auf _1.log endet:
    grep token= logs/*_1.log
  • TeamSpeak 6 mit Docker:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 ohne Docker: dasselbe grep wie bei TeamSpeak 3, im Ordner logs/ des Servers.

Beim ersten Start wird außerdem ein ServerQuery-Login in einem Kasten in der Konsole ausgegeben: loginname= "serveradmin", password= "..." und ein apikey. Bewahre sie sicher auf. Sie werden nur beim ersten Start ausgegeben, und mit ihnen erzeugst du einen neuen Key.

Neuen Key bei TeamSpeak 3 erzeugen

Führe das auf dem Rechner aus, auf dem der Server läuft. ServerQuery lauscht auf TCP-Port 10011, der nicht zum Internet offen sein sollte.

  1. Verbinde dich mit einem einfachen TCP-Client mit ServerQuery. TeamSpeaks ServerQuery-Handbuch nennt Telnet (unter Debian oder Ubuntu sudo apt install telnet, falls es fehlt):
    telnet 127.0.0.1 10011
  2. Melde dich an, wähle den virtuellen Server 1 und erzeuge den Key:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. Der Server antwortet mit token=..., gefolgt von error id=0 msg=ok. Füge den Token in deinen TeamSpeak Client ein. ServerQuery maskiert einen Schrägstrich in seinen Antworten als \/. Zeigt der Token also \/, tippe stattdessen /.

tokenid1=6 ist die Gruppe Server Admin eines neuen virtuellen Servers: Der Key, den der Server beim ersten Start erzeugt, zeigt ebenfalls auf Gruppe 6. Wenn du Gruppen umbenannt oder neu aufgebaut hast, führe servergrouplist aus, nachdem du use sid=1 gesetzt hast, und nimm die sgid der Admin-Gruppe mit type=1. Gruppen mit type=0 sind Vorlagen und mit type=2 ServerQuery-Gruppen.

ServerQuery-Passwort verloren

TeamSpeaks Quickstart-Anleitung sagt, dass man ein neues Passwort nur bekommt, indem man die Server-Datenbank löscht. Bei 3.13.8 gibt es einen schonenderen Weg: Starte den Server einmal mit einem neuen Passwort als Startparameter. Das Startskript reicht Parameter an den Server weiter. Nimm nur Buchstaben und Ziffern, weil ServerQuery Leerzeichen und einige Symbole als Sonderzeichen behandelt:

./ts3server_startscript.sh stop
./ts3server_startscript.sh start serveradmin_password=PICK_A_NEW_PASSWORD

In unserem Test stand danach updated server query admin password im Log, und das neue Passwort funktionierte beim Login. Erzeuge deinen neuen Key wie oben, während der Server läuft, und starte ihn danach ganz normal neu.

Neuen Key bei TeamSpeak 6 erzeugen

TeamSpeak 6 hat keine Klartext-ServerQuery auf Port 10011: Die CONFIG.md nennt SSH-, HTTP- und HTTPS-Query-Schnittstellen, alle standardmäßig aus. Die HTTP-Query nimmt einen API-Key, den du beim Start festlegst.

  1. Starte den Server mit aktivierter HTTP-Query und einem eigenen API-Key neu:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    Die HTTP-Query lauscht dann auf TCP 10080 an allen Adressen (0.0.0.0). Stelle also sicher, dass deine Firewall diesen Port gegenüber dem Internet sperrt.
  2. Fordere auf demselben Rechner einen Key für Gruppe 6 an:
    curl -H "x-api-key: PICK_A_LONG_RANDOM_KEY" "http://127.0.0.1:10080/1/privilegekeyadd?tokentype=0&tokenid1=6&tokenid2=0"
  3. Die Antwort ist JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Füge den Token in deinen TeamSpeak Client ein. Im Server-Log steht zusätzlich eine Zeile, dass serveradmin einen privilege key für die Servergruppe Server Admin hinzugefügt hat.
  4. Starte ohne --query-http-enable neu, wenn du die HTTP-Query nicht brauchst.

Mit Docker erstellst du den Container neu, mit zwei Umgebungsvariablen und dem HTTP-Query-Port nur auf 127.0.0.1 veröffentlicht, damit er nicht aus dem Internet erreichbar ist. Deine Daten bleiben im Volume:

docker rm -f teamspeak-server
docker run -d \
  --name teamspeak-server \
  -p 9987:9987/udp \
  -p 30033:30033 \
  -p 127.0.0.1:10080:10080 \
  -e TSSERVER_LICENSE_ACCEPTED=accept \
  -e TSSERVER_QUERY_HTTP_ENABLED=1 \
  -e TSSERVER_QUERY_ADMIN_API_KEY=PICK_A_LONG_RANDOM_KEY \
  -v teamspeak-data:/var/tsserver/ \
  teamspeaksystems/teamspeak6-server:latest

Führe dann dasselbe curl wie in Schritt 2 aus. Nimm hier Umgebungsvariablen und keine Optionen hinter dem Image-Namen: Der Befehl des Images ist tsserver, alles hinter dem Image-Namen ersetzt ihn, und in unserem Test antwortete die HTTP-Query nicht, als wir es so versucht haben. Erstelle den Container ohne die zwei Query-Variablen und ohne den Port 10080 neu, sobald du die HTTP-Query nicht mehr brauchst. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) setzt das Passwort des Query-Kontos serveradmin; die HTTP-Query oben braucht es nicht (unser Docker-Test setzte nur den API-Key), und die SSH-Query bleibt aus, bis du --query-ssh-enable hinzufügst.

Der Key gilt als ungültig

  • Er wurde schon benutzt. Jeder Key funktioniert einmal. privilegekeylist (TeamSpeak 3) oder /1/privilegekeylist (TeamSpeak 6) listet die Keys auf, die noch verfügbar sind.
  • Er gehört zu einem anderen virtuellen Server. Ein Key funktioniert nur auf dem virtuellen Server, für den er erstellt wurde.
  • Die HTTP-Query antwortet invalid apikey. Der Header x-api-key passt nicht zum Key, mit dem der Server gestartet wurde.
  • Er wurde nicht vollständig kopiert. Ein Key kann + und / enthalten. Kopiere alles nach token=.

TeamSpeak selbst hosten

Die komplette Einrichtung, die Lizenzgrenzen und der Speicherbedarf des Servers: So hostest du einen TeamSpeak Server. PlayNHost vermietet Mumble Sprachserver, kein TeamSpeak; bei Mumble nutzt der erste Admin statt eines Keys ein SuperUser-Passwort aus dem Panel: So wirst du Admin auf deinem Mumble-Server.

Läuft dein Server schon woanders? Zieh ihn zu uns um

UNSERE NEUESTEN BLOGS