НОВОЕ 📢 Чёрная пятница: стартовая акция заканчивается 30 ноября. Скидка до 70% на первый месяц!Посмотреть тарифы
Чёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 минЧёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 минЧёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 мин

Как получить новый privilege key админа сервера TeamSpeak

Mumble и голосовые серверыОбновлено 21 нояб. 2026 г.6 мин чтения

Коротко. Новый сервер TeamSpeak при первом запуске выводит ServerAdmin privilege key (строку, которая начинается с token=) в консоль и в лог виртуального сервера 1. Ключ срабатывает только один раз. Чтобы создать новый в TeamSpeak 3, войдите в ServerQuery как serveradmin и выполните privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0; в TeamSpeak 6 отправьте ту же команду в HTTP-запрос с ключом API. Потеряли ещё и пароль ServerQuery? Запустите TeamSpeak 3 один раз с serveradmin_password= или TeamSpeak 6 с --query-http-enable и --query-admin-api-key. Новые ключи мы создали так 6 ноября 2026 года на TeamSpeak 3 server 3.13.8 и TeamSpeak 6 server v6.0.0-beta13.1. TeamSpeak 6 server v6.0.0-beta14 вышел 17 ноября 2026 года; на нём мы эти шаги не повторяли.

Что такое privilege key

В собственном руководстве TeamSpeak (doc/privilegekey_guide.txt в загрузке TeamSpeak 3) сказано, что у сервера TeamSpeak 3 нет логинов и паролей пользователей: он узнаёт людей по уникальному ID, созданному из пары ключей, которую генерирует их клиент. Поэтому первому админу нужен пропуск: privilege key. TeamSpeak 6 использует такой же ключ. Если вставить его в клиент TeamSpeak, эта личность попадёт в группу Server Admin того виртуального сервера, для которого создан ключ. В том же руководстве сказано, что ключ можно использовать только один раз.

Найдите ключ первого запуска

При первом запуске обе версии выводят одни и те же две строки:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 в Linux: сервер записывает его в лог виртуального сервера 1, то есть в файл в logs/, имя которого заканчивается на _1.log:
    grep token= logs/*_1.log
  • TeamSpeak 6 в Docker:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 без Docker: тот же grep, что и для TeamSpeak 3, в папке logs/ сервера.

При первом запуске в консоли также выводятся данные для входа в ServerQuery в рамке: loginname= "serveradmin", password= "..." и apikey. Храните их в надёжном месте. Они выводятся только при первом запуске, и именно ими вы создаёте новый ключ.

Создайте новый ключ в TeamSpeak 3

Выполняйте это на компьютере, где работает сервер. ServerQuery слушает TCP-порт 10011, который не должен быть открыт для интернета.

  1. Подключитесь к ServerQuery обычным TCP-клиентом. В руководстве по ServerQuery от TeamSpeak упомянут Telnet (в Debian или Ubuntu: sudo apt install telnet, если его нет):
    telnet 127.0.0.1 10011
  2. Войдите, выберите виртуальный сервер 1 и создайте ключ:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. Сервер отвечает token=..., затем error id=0 msg=ok. Вставьте токен в клиент TeamSpeak. ServerQuery экранирует косую черту в ответах как \/, поэтому если токен показывает \/, вводите его как /.

tokenid1=6 соответствует группе Server Admin нового виртуального сервера: ключ, который сервер создаёт при первом запуске, тоже указывает на группу 6. Если вы переименовали или пересоздали группы, выполните servergrouplist после use sid=1 и возьмите sgid группы админа с type=1. Группы с type=0 являются шаблонами, а с type=2 это группы ServerQuery.

Потерян пароль ServerQuery

В кратком руководстве TeamSpeak сказано, что новый пароль можно получить только удалением базы данных сервера. В 3.13.8 есть более мягкий способ: один раз запустите сервер с новым паролем в качестве параметра запуска. Стартовый скрипт передаёт параметры серверу. Используйте только буквы и цифры, потому что ServerQuery считает пробелы и некоторые символы специальными:

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

В нашем тесте в логе после этого появилось updated server query admin password, и вход с новым паролем сработал. Создайте новый ключ, как описано выше, пока сервер работает, а затем перезапустите его обычным способом.

Создайте новый ключ в TeamSpeak 6

В TeamSpeak 6 нет текстового ServerQuery на порту 10011: в его CONFIG.md перечислены интерфейсы запросов SSH, HTTP и HTTPS, все по умолчанию выключены. HTTP-запрос принимает ключ API, который вы задаёте при запуске.

  1. Перезапустите сервер с включённым HTTP-запросом и собственным ключом API:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    После этого HTTP-запрос слушает TCP 10080 на всех адресах (0.0.0.0), поэтому убедитесь, что ваш брандмауэр блокирует этот порт из интернета.
  2. На том же компьютере запросите ключ для группы 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. Ответ приходит в JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Вставьте токен в клиент TeamSpeak. В логе сервера появится строка о том, что serveradmin добавил privilege key для группы сервера Server Admin.
  4. Перезапустите без --query-http-enable, если HTTP-запрос вам не нужен.

В Docker пересоздайте контейнер с двумя переменными окружения и портом HTTP-запроса, опубликованным только на 127.0.0.1, чтобы он не был доступен из интернета. Ваши данные остаются в томе:

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

Затем выполните тот же curl, что и на шаге 2. Здесь используйте переменные окружения, а не параметры после имени образа: команда образа tsserver, поэтому всё, что идёт после имени образа, заменяет её, и в нашем тесте HTTP-запрос не отвечал, когда мы попробовали так. Пересоздайте контейнер без двух переменных запроса и без порта 10080, когда HTTP-запрос больше не нужен. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) задаёт пароль учётной записи запросов serveradmin; HTTP-запросу выше он не нужен (в нашем тесте с Docker был задан только ключ API), а SSH-запрос выключен, пока вы не добавите --query-ssh-enable.

Ключ считается недействительным

  • Он уже использован. Каждый ключ срабатывает один раз. privilegekeylist (TeamSpeak 3) или /1/privilegekeylist (TeamSpeak 6) показывает ключи, которые ещё доступны.
  • Он для другого виртуального сервера. Ключ работает только на том виртуальном сервере, для которого он создан.
  • HTTP-запрос отвечает invalid apikey. Заголовок x-api-key не совпадает с ключом, с которым запущен сервер.
  • Скопирована не вся строка. Ключ может содержать + и /. Скопируйте всё после token=.

Свой хостинг TeamSpeak

Полная настройка, ограничения лицензии и объём памяти, который нужен серверу: Как создать сервер TeamSpeak. PlayNHost сдаёт в аренду голосовые серверы Mumble, а не TeamSpeak; в Mumble первый админ использует пароль SuperUser из панели вместо ключа: Как стать администратором на сервере Mumble.

Ваш сервер уже у другого хостинга? Перенесите его к нам

ПОСЛЕДНИЕ БЛОГИ