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.
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
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
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:
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.
Starte den Server mit aktivierter HTTP-Query und einem eigenen API-Key neu:
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.
Fordere auf demselben Rechner einen Key für Gruppe 6 an:
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.
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:
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=.
Wir verwenden Cookies, damit die Website funktioniert, um ihre Nutzung zu verstehen und unser Marketing zu messen. Du kannst alles akzeptieren, nur essenzielle Cookies akzeptieren oder pro Kategorie wählen.Wir verwenden Cookies, damit die Website funktioniert, um ihre Nutzung zu verstehen und unser Marketing zu messen. Sie sind hier standardmäßig aktiv. Du kannst alles abschalten, was du nicht möchtest.Datenschutzerklärung lesen