TeamSpeak¶

В этой статье

• TeamSpeak. Основные возможности
• Особенности сборки
• Начало работы после развертывания сервера TeamSpeak
• Обновлению Ts3-Manager
• Подключение к серверу
• Подтверждение прав администратора
• Доступ к веб-панели управления
• Заказ TeamSpeak с помощью API

TeamSpeak. Основные возможности¶

• Голосовой чат высокого качества: Teamspeak обеспечивает четкую и чистую передачу голоса между пользователями, что крайне важно для координации действий во время игры.
• Система каналов: Пользователи могут создавать неограниченное количество каналов и распределять их по иерархическим группам, что позволяет организовывать отдельные каналы для разных команд, игр или задач.
• Управление правами: Администраторы сервера могут назначать разные права пользователям, такие как возможность создавать каналы, выгонять участников и т.д.
• Поддержка 3D-звука: Teamspeak позиционирует голос каждого пользователя в виртуальном пространстве, что помогает ориентироваться во время игры.
• Запись голосового чата: Возможность записывать голосовые беседы для последующего прослушивания или обмена записями.
• Кроссплатформенность: Доступен на Windows, macOS, Linux и мобильных устройствах.

Особенности сборки¶

Начало работы после развертывания сервера TeamSpeak¶

После оплаты заказа на указанную при регистрации электронную почту придет уведомление о готовности сервера к работе. В нем будет указан IP-адрес VPS, а также логин и пароль для подключения. Управление оборудованием клиенты нашей компании осуществляют в панели управления серверами и API — Invapi.

Для начала работы с сервисом необходимо скачать клиент TeamSpeak на локальное устройство и установить его.

Обновлению Ts3-Manager¶

1. Резервное копирование текущей конфигурации

   Сохраните информацию о текущем контейнере. На случай отката выполните:

   docker inspect ts3-manager > /opt/ts3-manager-backup.json
   

   Проверьте наличие данных в volume:

   ls -l /opt/tsi-web
   

2. Остановите и удалите старый контейнер

   Если контейнер ts3-manager существует (даже если docker ps его не показывает), выполните:

   docker stop ts3-manager
   

   docker rm ts3-manager
   

3. Запустите новый контейнер Ts3-Manager v2.2.3

   docker run -d \
     --name ts3-manager \
     -p 8080:8080 \
     -v /opt/tsi-web:/app/data \
     -e PORT=8080 \
     -e JWT_SECRET=$(openssl rand -hex 32) \
     -e WHITELIST=teamspeak \
     --network bridge \
     --restart unless-stopped \
     joni1802/ts3-manager:v2.2.3
   

4. Проверьте запуск

   Убедитесь, что контейнер успешно запущен:

   docker ps | grep ts3-manager
   

   docker logs ts3-manager
   

   Если обновление прошло успешно, то:
   • В выводе docker ps контейнер ts3-manager должен быть в статусе Up.
   • В логах docker logs ts3-manager должно появиться сообщение вида:

   Server listening on http://127.0.0.1:8080
   

Подключение к серверу¶

Для подключения к серверу необходимо:

• В панели управления во вкладке Сеть скопировать IP-адрес сервера.
• Опционально - зарегистрироваться в личном кабинете TeamSpeak. Это позволит упростить управление сервером и его настройку.

• Опционально - добавить сервер в личный кабинет TeamSpeak. Необходимо указать IP-адрес сервера и номер порта (9987), а также указать название сервера.

  

После запуска клиента TeamSpeak на локальном устройстве ввести IP-адрес сервера в поле, указанном на скриншоте ниже и нажать кнопку Соединение:

Подтверждение прав администратора¶

Для подтверждения прав администратора необходимо подключиться к серверу по SSH и выполнить следующую команду:

docker logs teamspeak | tail -n 50 | grep "password"

1. Учетные данные ServerQuery Admin Account (функция администрирования сервера TeamSpeak 3 на основе командной строки):

   • Логин: serveradmin;
   • Пароль (сгенерированный системой);
   • API ключ.

2. Privilege key (token) для получения прав администратора на виртуальном сервере.

Пример вывода будет выглядеть следующим образом:

Эти данные необходимо сохранить, так как они потребуются для:

• Входа в систему через ServerQuery интерфейс;
• Получения прав администратора на виртуальном сервере;
• Управления сервером через API;
• Управление сервером через веб-панель TS3 Manager.

Важно отметить, что privilege key можно использовать только один раз, а пароль ServerQuery рекомендуется изменить сразу после первого входа в систему.

В клиенте TeamSpeak кликнуть по названию сервера и ответить утвердительно на вопрос Это ваш сервер TeamSpeak?:

Ввести скопированный ключ:

После подтверждения прав администратора можно создать новые ключи. Для этого необходимо:

• Открыть контекстное меню, нажав правую кнопку мыши на иконке сервера в главном окне TeamSpeak.
• В настройках сервера перейти во вкладку Показать ключи привилегий:

• Нажать на кнопку Создать для генерации нового ключа привилегий:

• В открывшемся окне будет предложено выбрать группу, для которой создается ключ. Доступны следующие варианты:
  • Server Admin: группа с максимальным уровнем привилегий, обладающая полным административным контролем над сервером.
  • Normal: группа с ограниченными правами, предназначенная для обычных пользователей.
  • Guest: группа с минимальными правами для гостевого доступа.
• Выбрать нужную группу, для которой требуется создать ключ привилегий.
• В поле Описание ввести краткое пояснение назначения создаваемого ключа.
• После ввода описания нажать на кнопку Создать:

• Новый ключ привилегий будет сгенерирован и отобразится в списке ключей.

Созданный ключ можно использовать для предоставления соответствующих привилегий пользователям или администраторам на данном сервере TeamSpeak.

Доступ к веб-панели управления¶

Перейдите по ссылке webpanel для доступа к панели управления TS3 Manager. Для входа потребуется:

• Server: IP-адрес сервера или его доменное имя (без https://). Адрес можно скопировать в панели управления во вкладке Сеть - IP-адрес сервера.
• Port: 10011;
• Name: serveradmin;
• Password: Пароль администратора сервера, полученный как описано ранее.

После успешной авторизации будет доступен следующий функционал:

• Server List. Центральный элемент управления, отображающий все зарегистрированные TeamSpeak 3 серверы в системе. Здесь администратор может видеть общую информацию о каждом сервере, включая статус работы, количество подключенных пользователей, время работы и используемые порты. Через этот интерфейс осуществляется базовое управление серверами: запуск, остановка, перезагрузка и базовая настройка параметров.
• Server Viewer. Интерактивный инструмент для визуального мониторинга сервера в реальном времени. Отображает древовидную структуру каналов сервера, показывает всех подключенных пользователей и их активность. Позволяет наблюдать за перемещениями пользователей между каналами, контролировать голосовую активность и оперативно реагировать на различные ситуации.
• Chat. Встроенная система мгновенного обмена сообщениями, обеспечивающая коммуникацию между администраторами и пользователями сервера. Поддерживает как личные, так и групповые беседы, позволяет обмениваться файлами и использовать форматирование текста. Сохраняет историю переписки для последующего анализа.
• File Browser. Инструмент для управления файловой системой сервера TeamSpeak 3. Через него осуществляется доступ к загруженным файлам, аватарам пользователей и другим медиаматериалам. Администратор может управлять содержимым сервера, контролировать объем занимаемого пространства и устанавливать права доступа к файлам.
• Server Log. Система журналирования всех событий, происходящих на сервере. Записывает информацию о подключениях пользователей, изменениях настроек, системных событиях и ошибках. Важный инструмент для диагностики проблем и мониторинга безопасности сервера.
• Backup/Restore. Комплексный инструмент для обеспечения сохранности данных сервера. Позволяет создавать резервные копии всех настроек, базы данных и пользовательских данных. Включает функции автоматического резервного копирования и восстановления данных в случае сбоев.
• Server Query. Продвинутый инструмент для прямого взаимодействия с сервером через командный интерфейс. Позволяет выполнять сложные операции управления сервером с помощью специальных команд, получать детальную информацию о состоянии сервера и производить тонкую настройку параметров.
• Privilege Keys. Система управления привилегированными ключами доступа. Через этот интерфейс создаются и распределяются специальные ключи, предоставляющие пользователям определенные права и привилегии на сервере.
• Ключи API и панель управления. Раздел управления ключами для программного взаимодействия с сервером через API. Позволяет создавать и настраивать ключи доступа для интеграции TeamSpeak 3 с внешними приложениями и сервисами.
• Ban List. Инструмент управления блокировками пользователей. Содержит информацию о заблокированных пользователях, причинах и сроках блокировок. Позволяет эффективно контролировать доступ нежелательных пользователей к серверу.
• Complaints List. Система обработки жалоб от пользователей. Здесь администраторы могут просматривать поступившие жалобы, отслеживать их статус и принимать необходимые меры для разрешения конфликтных ситуаций.
• List All Clients. Полный список всех пользователей, когда-либо подключавшихся к серверу. Содержит детальную информацию о каждом клиенте, включая историю подключений, использованные никнеймы и технические данные.
• Server Groups. Инструмент управления группами пользователей на уровне сервера. Позволяет создавать и настраивать различные группы с определенными правами и привилегиями, что упрощает администрирование большого количества пользователей.
• Channel Groups. Система управления группами на уровне отдельных каналов. Позволяет настраивать специфические права и привилегии для пользователей в рамках конкретных каналов или их групп.
• Permissions. Комплексная система настройки прав доступа. Позволяет тонко настраивать разрешения для различных групп пользователей, определяя их возможности на сервере, в каналах и при взаимодействии с другими пользователями.
• Logout.Функция безопасного завершения сессии администратора. При выходе происходит корректное закрытие всех активных соединений и сохранение внесенных изменений в настройках.

Заказ TeamSpeak с помощью API¶

Установка данного ПО с использованием API описана в данном руководстве.