NOVO 📢 Black Friday: a oferta de lançamento termina em 30/11. Até 70% de desconto no seu primeiro mês!Ver planos
Black FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 minBlack FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 minBlack FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 min

Como conseguir uma nova privilege key de admin no TeamSpeak

Mumble e servidores de vozAtualizado 21/11/20267 min de leitura

Resposta curta. Um servidor de TeamSpeak novo imprime uma ServerAdmin privilege key (uma linha que começa com token=) na primeira vez que inicia, no console e no log do servidor virtual 1. Uma chave só funciona uma vez. Para criar uma nova no TeamSpeak 3, entre no ServerQuery como serveradmin e execute privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0; no TeamSpeak 6, envie o mesmo comando para a consulta HTTP com uma chave de API. Perdeu também a senha do ServerQuery? Inicie o TeamSpeak 3 uma vez com serveradmin_password=, ou o TeamSpeak 6 com --query-http-enable e --query-admin-api-key. Criamos chaves novas assim no TeamSpeak 3 server 3.13.8 e no TeamSpeak 6 server v6.0.0-beta13.1 em 6 de novembro de 2026. O TeamSpeak 6 server v6.0.0-beta14 foi lançado em 17 de novembro de 2026; não repetimos estes passos nele.

O que é a privilege key

O guia da própria TeamSpeak (doc/privilegekey_guide.txt no download do TeamSpeak 3) diz que um servidor TeamSpeak 3 não tem nomes de usuário nem senhas: ele reconhece as pessoas por um ID único gerado a partir de um par de chaves que o cliente delas cria. Por isso o primeiro admin precisa de um ingresso: a privilege key. O TeamSpeak 6 usa o mesmo tipo de chave. Colá-la no cliente TeamSpeak coloca essa identidade no grupo Server Admin do servidor virtual para o qual a chave foi criada. O mesmo guia diz que uma chave só pode ser usada uma vez.

Encontre a chave da primeira inicialização

Na primeira inicialização, as duas versões imprimem as mesmas duas linhas:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 no Linux: o servidor a grava no log do servidor virtual 1, o arquivo em logs/ cujo nome termina em _1.log:
    grep token= logs/*_1.log
  • TeamSpeak 6 com Docker:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 sem Docker: o mesmo grep do TeamSpeak 3, na pasta logs/ do servidor.

A primeira inicialização também imprime um login do ServerQuery em uma caixa no console: loginname= "serveradmin", password= "..." e uma apikey. Guarde-os em um lugar seguro. Eles são impressos só na primeira inicialização, e são o que você usa para criar uma nova chave.

Crie uma nova chave no TeamSpeak 3

Execute isto na máquina onde o servidor roda. O ServerQuery escuta na porta TCP 10011, que não deve ficar aberta para a internet.

  1. Conecte-se ao ServerQuery com um cliente TCP simples. O manual do ServerQuery da TeamSpeak cita o Telnet (no Debian ou Ubuntu, sudo apt install telnet se ele estiver faltando):
    telnet 127.0.0.1 10011
  2. Faça login, escolha o servidor virtual 1 e crie a chave:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. O servidor responde token=... seguido de error id=0 msg=ok. Cole o token no seu cliente TeamSpeak. O ServerQuery escapa uma barra como \/ nas respostas, então, se o token mostrar \/, digite como /.

tokenid1=6 é o grupo Server Admin de um servidor virtual novo: a chave que o servidor cria na primeira inicialização também aponta para o grupo 6. Se você renomeou ou refez seus grupos, execute servergrouplist depois de use sid=1 e pegue o sgid do grupo de admin com type=1. Grupos com type=0 são modelos e os com type=2 são grupos do ServerQuery.

Perdeu a senha do ServerQuery

O guia de início rápido da TeamSpeak diz que a única forma de obter uma nova senha é apagar o banco de dados do servidor. Na 3.13.8 há um jeito mais suave: inicie o servidor uma vez com uma nova senha como parâmetro de inicialização. O script de inicialização repassa os parâmetros ao servidor. Use só letras e dígitos, porque o ServerQuery trata espaços e alguns símbolos como caracteres especiais:

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

No nosso teste, o log disse então updated server query admin password e a nova senha funcionou no login. Crie sua nova chave como acima enquanto o servidor está rodando e depois reinicie-o do jeito normal.

Crie uma nova chave no TeamSpeak 6

O TeamSpeak 6 não tem ServerQuery em texto puro na porta 10011: o CONFIG.md dele lista interfaces de consulta SSH, HTTP e HTTPS, todas desligadas por padrão. A consulta HTTP usa uma chave de API que você define ao iniciar.

  1. Reinicie o servidor com a consulta HTTP ligada e uma chave de API sua:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    A consulta HTTP passa a escutar em TCP 10080 em todos os endereços (0.0.0.0), então garanta que seu firewall bloqueie essa porta para a internet.
  2. Na mesma máquina, peça uma chave para o grupo 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. A resposta é JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Cole o token no seu cliente TeamSpeak. O log do servidor acrescenta uma linha dizendo que serveradmin adicionou uma privilege key para o grupo de servidor Server Admin.
  4. Reinicie sem --query-http-enable se você não precisar da consulta HTTP.

Com Docker, recrie o contêiner com duas variáveis de ambiente e a porta da consulta HTTP publicada só em 127.0.0.1, para que ela não fique acessível pela internet. Seus dados continuam no 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

Depois execute o mesmo curl do passo 2. Use variáveis de ambiente aqui, não opções depois do nome da imagem: o comando da imagem é tsserver, então tudo o que vem depois do nome da imagem o substitui, e no nosso teste a consulta HTTP não respondeu quando tentamos desse jeito. Recrie o contêiner sem as duas variáveis de consulta e sem a porta 10080 quando você não precisar mais da consulta HTTP. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) define a senha da conta de consulta serveradmin; a consulta HTTP acima não precisa dela (nosso teste com Docker definiu só a chave de API), e a consulta SSH fica desligada até você adicionar --query-ssh-enable.

A chave diz que é inválida

  • Ela já foi usada. Cada chave funciona uma vez. privilegekeylist (TeamSpeak 3) ou /1/privilegekeylist (TeamSpeak 6) lista as chaves que ainda estão disponíveis.
  • Ela é de outro servidor virtual. Uma chave só funciona no servidor virtual para o qual foi criada.
  • A consulta HTTP responde invalid apikey. O cabeçalho x-api-key não corresponde à chave com a qual o servidor iniciou.
  • Parte dela não foi copiada. Uma chave pode conter + e /. Copie tudo depois de token=.

Hospedando o TeamSpeak você mesmo

A configuração completa, os limites da licença e a memória que o servidor precisa: Como hospedar um servidor de TeamSpeak. A PlayNHost aluga servidores de voz Mumble, não TeamSpeak; no Mumble o primeiro admin usa uma senha de SuperUser do painel em vez de uma chave: Como virar admin no seu servidor Mumble.

Já tem um em outro lugar? Traga seu servidor para nós

NOSSOS ÚLTIMOS ARTIGOS