YENİ 📢 Black Friday: Lansman teklifimiz 30 Kasım'da sona eriyor. Tüm oyunlarda ilk aya %70'e varan indirim!Paketleri görün
Black Fridayİlk aya %70'e varan indirim, 30 Kasım'a kadarBitimine 9 gün 02 sa 49 dkBlack Fridayİlk aya %70'e varan indirim, 30 Kasım'a kadarBitimine 9 gün 02 sa 49 dkBlack Fridayİlk aya %70'e varan indirim, 30 Kasım'a kadarBitimine 9 gün 02 sa 49 dk

Yeni bir TeamSpeak sunucu yöneticisi privilege key'i nasıl alınır

Mumble ve ses sunucularıGüncellendi 21 Kas 20266 dk okuma

Kısa cevap. Yeni bir TeamSpeak sunucusu ilk başladığında konsola ve sanal sunucu 1'in günlüğüne bir ServerAdmin privilege key (token= ile başlayan bir satır) yazdırır. Bir anahtar yalnızca bir kez çalışır. TeamSpeak 3'te yenisini oluşturmak için ServerQuery'ye serveradmin olarak giriş yapın ve privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0 komutunu çalıştırın; TeamSpeak 6'da aynı komutu bir API anahtarıyla HTTP sorgusuna gönderin. ServerQuery parolasını da mı kaybettiniz? TeamSpeak 3'ü bir kez serveradmin_password= ile, TeamSpeak 6'yı ise --query-http-enable ve --query-admin-api-key ile başlatın. 6 Kasım 2026'da TeamSpeak 3 server 3.13.8 ve TeamSpeak 6 server v6.0.0-beta13.1 üzerinde yeni anahtarları bu şekilde oluşturduk. TeamSpeak 6 server v6.0.0-beta14 17 Kasım 2026'da yayımlandı; bu adımları onda tekrarlamadık.

Privilege key nedir

TeamSpeak'in kendi kılavuzu (TeamSpeak 3 indirmesindeki doc/privilegekey_guide.txt), bir TeamSpeak 3 sunucusunda kullanıcı adı veya parola olmadığını söyler: kişileri, istemcilerinin oluşturduğu bir anahtar çiftinden üretilen benzersiz bir kimlikle tanır. Bu yüzden ilk yöneticinin bir biletle başlaması gerekir: privilege key. TeamSpeak 6 da aynı türde bir anahtar kullanır. Anahtarı TeamSpeak istemcisine yapıştırmak, bu kimliği anahtarın oluşturulduğu sanal sunucunun Server Admin grubuna koyar. Aynı kılavuz, bir anahtarın yalnızca bir kez kullanılabileceğini söyler.

İlk başlatmadaki anahtarı bulun

İlk başlatmada her iki sürüm de aynı iki satırı yazdırır:

ServerAdmin privilege key created, please use the line below
token=...
  • Linux'ta TeamSpeak 3: sunucu bunu sanal sunucu 1'in günlüğüne, yani logs/ içinde adı _1.log ile biten dosyaya yazar:
    grep token= logs/*_1.log
  • Docker ile TeamSpeak 6:
    docker logs teamspeak-server 2>&1 | grep token=
  • Docker olmadan TeamSpeak 6: TeamSpeak 3'teki grep komutunun aynısı, sunucunun logs/ klasöründe.

İlk başlatma ayrıca konsolda bir kutu içinde bir ServerQuery girişi yazdırır: loginname= "serveradmin", password= "..." ve bir apikey. Bunları güvenli bir yerde saklayın. Yalnızca ilk başlatmada yazdırılırlar ve yeni bir anahtar oluşturmak için bunları kullanırsınız.

TeamSpeak 3'te yeni anahtar oluşturun

Bunu sunucunun çalıştığı makinede yapın. ServerQuery TCP 10011 portunu dinler; bu port internete açık olmamalıdır.

  1. ServerQuery'ye düz bir TCP istemcisiyle bağlanın. TeamSpeak'in ServerQuery kılavuzu Telnet'i anar (Debian veya Ubuntu'da eksikse sudo apt install telnet):
    telnet 127.0.0.1 10011
  2. Giriş yapın, sanal sunucu 1'i seçin ve anahtarı oluşturun:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. Sunucu token=... ve ardından error id=0 msg=ok ile yanıt verir. Token'ı TeamSpeak istemcinize yapıştırın. ServerQuery yanıtlarında bölü çizgisini \/ olarak kaçırır; bu yüzden token \/ gösteriyorsa onu / olarak yazın.

tokenid1=6, yeni bir sanal sunucunun Server Admin grubudur: sunucunun ilk başlatmada oluşturduğu anahtar da 6. gruba işaret eder. Gruplarınızı yeniden adlandırdıysanız veya yeniden kurduysanız, servergrouplist komutunu çalıştırın (use sid=1 komutundan sonra) ve yönetici grubunun sgid değerini type=1 olanlar arasından alın. type=0 olan gruplar şablondur, type=2 olanlar ise ServerQuery gruplarıdır.

ServerQuery parolası kayboldu

TeamSpeak'in hızlı başlangıç kılavuzu, yeni bir parola almanın tek yolunun sunucu veritabanını silmek olduğunu söyler. 3.13.8'de daha yumuşak bir yol var: sunucuyu bir kez, yeni bir parolayı başlatma parametresi olarak vererek başlatın. Başlatma betiği parametreleri sunucuya iletir. Yalnızca harf ve rakam kullanın, çünkü ServerQuery boşlukları ve bazı sembolleri özel karakter olarak ele alır:

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

Testimizde günlükte ardından updated server query admin password yazdı ve yeni parola ile giriş yapılabildi. Sunucu çalışırken yeni anahtarınızı yukarıdaki gibi oluşturun, sonra sunucuyu normal şekilde yeniden başlatın.

TeamSpeak 6'da yeni anahtar oluşturun

TeamSpeak 6'da 10011 portunda düz metin ServerQuery yoktur: CONFIG.md dosyası SSH, HTTP ve HTTPS sorgu arayüzlerini listeler ve hepsi varsayılan olarak kapalıdır. HTTP sorgusu, başlatırken belirlediğiniz bir API anahtarı kullanır.

  1. Sunucuyu HTTP sorgusu açık ve kendi API anahtarınızla yeniden başlatın:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    HTTP sorgusu bundan sonra tüm adreslerde (0.0.0.0) TCP 10080 üzerinde dinler; bu yüzden güvenlik duvarınızın bu portu internetten engellediğinden emin olun.
  2. Aynı makinede 6. grup için bir anahtar isteyin:
    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. Yanıt JSON'dur: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Token'ı TeamSpeak istemcinize yapıştırın. Sunucu günlüğü, serveradmin kullanıcısının Server Admin sunucu grubu için bir privilege key eklediğini söyleyen bir satır ekler.
  4. HTTP sorgusuna ihtiyacınız yoksa --query-http-enable olmadan yeniden başlatın.

Docker ile kapsayıcıyı iki ortam değişkeniyle ve HTTP sorgu portu yalnızca 127.0.0.1 üzerinde yayımlanacak şekilde yeniden oluşturun; böylece internetten erişilemez. Verileriniz birimde kalır:

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

Sonra 2. adımdaki curl komutunun aynısını çalıştırın. Burada imaj adından sonra seçenek değil, ortam değişkenleri kullanın: imajın komutu tsserver, yani imaj adından sonra gelen her şey onun yerine geçer ve testimizde böyle denediğimizde HTTP sorgusu yanıt vermedi. HTTP sorgusuna artık ihtiyacınız kalmadığında kapsayıcıyı iki sorgu değişkeni ve 10080 portu olmadan yeniden oluşturun. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD), serveradmin sorgu hesabının parolasını belirler; yukarıdaki HTTP sorgusu buna ihtiyaç duymaz (Docker testimizde yalnızca API anahtarı verildi) ve SSH sorgusu siz --query-ssh-enable ekleyene kadar kapalıdır.

Anahtar geçersiz diyor

  • Zaten kullanıldı. Her anahtar bir kez çalışır. privilegekeylist (TeamSpeak 3) veya /1/privilegekeylist (TeamSpeak 6) hâlâ kullanılabilir anahtarları listeler.
  • Başka bir sanal sunucuya ait. Bir anahtar yalnızca oluşturulduğu sanal sunucuda çalışır.
  • HTTP sorgusu invalid apikey yanıtı veriyor. x-api-key başlığı, sunucunun başlatıldığı anahtarla eşleşmiyor.
  • Bir kısmı kopyalanmadı. Bir anahtar + ve / içerebilir. token= sonrasındaki her şeyi kopyalayın.

TeamSpeak'i kendiniz barındırma

Tam kurulum, lisans sınırları ve sunucunun ne kadar belleğe ihtiyaç duyduğu: TeamSpeak sunucusu nasıl kurulur. PlayNHost Mumble ses sunucuları kiralar, TeamSpeak değil; Mumble'da ilk yönetici anahtar yerine panelden alınan bir SuperUser parolası kullanır: Mumble sunucunuzda nasıl yönetici olursunuz.

Sunucunuz başka bir yerde mi? Bize taşıyın

EN YENİ BLOG YAZILARIMIZ