NOWOŚĆ 📢 Black Friday: nasza oferta na start kończy się 30 listopada. Do 70% zniżki na pierwszy miesiąc, na każdą grę!Zobacz plany
Black FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 minBlack FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 minBlack FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 min

Jak zdobyć nowy privilege key admina serwera TeamSpeak

Mumble i serwery głosoweZaktualizowano 21 lis 20266 min czytania

Krótka odpowiedź. Nowy serwer TeamSpeak wypisuje ServerAdmin privilege key (linię zaczynającą się od token=) przy pierwszym uruchomieniu, w konsoli i w logu serwera wirtualnego 1. Klucz działa tylko raz. Aby utworzyć nowy w TeamSpeak 3, zaloguj się do ServerQuery jako serveradmin i wykonaj privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0; w TeamSpeak 6 wyślij to samo polecenie do zapytania HTTP z kluczem API. Zgubiłeś też hasło ServerQuery? Uruchom TeamSpeak 3 raz z serveradmin_password= albo TeamSpeak 6 z --query-http-enable i --query-admin-api-key. Nowe klucze utworzyliśmy tak 6 listopada 2026 na TeamSpeak 3 server 3.13.8 i TeamSpeak 6 server v6.0.0-beta13.1. TeamSpeak 6 server v6.0.0-beta14 ukazał się 17 listopada 2026; nie powtarzaliśmy tych kroków na nim.

Czym jest privilege key

Przewodnik samego TeamSpeak (doc/privilegekey_guide.txt w pakiecie TeamSpeak 3) mówi, że serwer TeamSpeak 3 nie ma loginów ani haseł użytkowników: rozpoznaje osoby po unikalnym ID utworzonym z pary kluczy, którą tworzy ich klient. Dlatego pierwszy admin potrzebuje biletu: privilege key. TeamSpeak 6 używa tego samego rodzaju klucza. Wklejenie go w kliencie TeamSpeak umieszcza tę tożsamość w grupie Server Admin serwera wirtualnego, dla którego klucz utworzono. Ten sam przewodnik mówi, że klucza można użyć tylko raz.

Znajdź klucz z pierwszego uruchomienia

Przy pierwszym uruchomieniu obie wersje wypisują te same dwie linie:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 na Linuksie: serwer zapisuje go w logu serwera wirtualnego 1, czyli w pliku w logs/, którego nazwa kończy się na _1.log:
    grep token= logs/*_1.log
  • TeamSpeak 6 z Dockerem:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 bez Dockera: to samo grep co w TeamSpeak 3, w folderze logs/ serwera.

Pierwsze uruchomienie wypisuje też dane logowania do ServerQuery w ramce w konsoli: loginname= "serveradmin", password= "..." i apikey. Trzymaj je w bezpiecznym miejscu. Są wypisywane tylko przy pierwszym uruchomieniu i to ich używasz do utworzenia nowego klucza.

Utwórz nowy klucz w TeamSpeak 3

Wykonaj to na maszynie, na której działa serwer. ServerQuery nasłuchuje na porcie TCP 10011, który nie powinien być otwarty na internet.

  1. Połącz się z ServerQuery zwykłym klientem TCP. Podręcznik ServerQuery TeamSpeak wymienia Telnet (w Debianie lub Ubuntu sudo apt install telnet, jeśli go brakuje):
    telnet 127.0.0.1 10011
  2. Zaloguj się, wybierz serwer wirtualny 1 i utwórz klucz:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. Serwer odpowiada token=..., a po tym error id=0 msg=ok. Wklej token w kliencie TeamSpeak. ServerQuery zapisuje ukośnik w odpowiedziach jako \/, więc jeśli token pokazuje \/, wpisz go jako /.

tokenid1=6 to grupa Server Admin nowego serwera wirtualnego: klucz tworzony przez serwer przy pierwszym uruchomieniu też wskazuje grupę 6. Jeśli zmieniłeś nazwy lub przebudowałeś grupy, wykonaj servergrouplist po use sid=1 i weź sgid grupy admina z type=1. Grupy z type=0 to szablony, a z type=2 to grupy ServerQuery.

Zgubione hasło ServerQuery

Przewodnik szybkiego startu TeamSpeak mówi, że jedynym sposobem na nowe hasło jest usunięcie bazy danych serwera. W 3.13.8 jest łagodniejszy sposób: uruchom serwer raz z nowym hasłem jako parametrem startowym. Skrypt startowy przekazuje parametry do serwera. Używaj tylko liter i cyfr, bo ServerQuery traktuje spacje i niektóre symbole jako znaki specjalne:

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

W naszym teście log zapisał wtedy updated server query admin password, a nowe hasło pozwoliło się zalogować. Utwórz nowy klucz jak wyżej, gdy serwer działa, a potem uruchom go ponownie w zwykły sposób.

Utwórz nowy klucz w TeamSpeak 6

TeamSpeak 6 nie ma tekstowego ServerQuery na porcie 10011: jego CONFIG.md wymienia interfejsy zapytań SSH, HTTP i HTTPS, wszystkie domyślnie wyłączone. Zapytanie HTTP przyjmuje klucz API, który ustawiasz przy starcie.

  1. Uruchom serwer ponownie z włączonym zapytaniem HTTP i własnym kluczem API:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    Zapytanie HTTP nasłuchuje wtedy na TCP 10080 na wszystkich adresach (0.0.0.0), więc upewnij się, że Twoja zapora blokuje ten port z internetu.
  2. Na tej samej maszynie poproś o klucz dla grupy 6:
    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. Odpowiedź to JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Wklej token w kliencie TeamSpeak. Log serwera dodaje linię mówiącą, że serveradmin dodał privilege key dla grupy serwera Server Admin.
  4. Uruchom ponownie bez --query-http-enable, jeśli nie potrzebujesz zapytania HTTP.

W Dockerze utwórz kontener od nowa z dwiema zmiennymi środowiskowymi i portem zapytania HTTP opublikowanym tylko na 127.0.0.1, żeby nie był dostępny z internetu. Twoje dane zostają w woluminie:

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

Potem wykonaj to samo curl co w kroku 2. Użyj tu zmiennych środowiskowych, a nie opcji po nazwie obrazu: polecenie obrazu to tsserver, więc wszystko po nazwie obrazu je zastępuje, a w naszym teście zapytanie HTTP nie odpowiadało, gdy spróbowaliśmy tak. Utwórz kontener od nowa bez dwóch zmiennych zapytania i bez portu 10080, gdy zapytanie HTTP nie będzie już potrzebne. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) ustawia hasło konta zapytań serveradmin; powyższe zapytanie HTTP go nie potrzebuje (nasz test z Dockerem ustawił tylko klucz API), a zapytanie SSH jest wyłączone, dopóki nie dodasz --query-ssh-enable.

Klucz jest nieprawidłowy

  • Został już użyty. Każdy klucz działa raz. privilegekeylist (TeamSpeak 3) lub /1/privilegekeylist (TeamSpeak 6) wyświetla klucze, które są jeszcze dostępne.
  • Jest dla innego serwera wirtualnego. Klucz działa tylko na serwerze wirtualnym, dla którego go utworzono.
  • Zapytanie HTTP odpowiada invalid apikey. Nagłówek x-api-key nie pasuje do klucza, z którym serwer wystartował.
  • Nie skopiowano całości. Klucz może zawierać + i /. Skopiuj wszystko po token=.

Własny hosting TeamSpeak

Pełna konfiguracja, limity licencji i ilość pamięci, jakiej potrzebuje serwer: Jak założyć serwer TeamSpeak. PlayNHost wynajmuje serwery głosowe Mumble, nie TeamSpeak; w Mumble pierwszy admin używa hasła SuperUser z panelu zamiast klucza: Jak zostać adminem na serwerze Mumble.

Masz już serwer gdzie indziej? Przenieś go do nas

NASZE OSTATNIE WPISY