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.
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
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
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:
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.
Reinicie o servidor com a consulta HTTP ligada e uma chave de API sua:
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.
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:
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=.
Usamos cookies para manter o site funcionando, entender como ele é usado e medir nosso marketing. Você pode aceitar tudo, aceitar apenas os cookies essenciais ou escolher por categoria.Usamos cookies para manter o site funcionando, entender como ele é usado e medir nosso marketing. Eles estão ativos por padrão. Você pode desativar o que não quiser.Leia nossa política de privacidade