RU

Игровые серверы

Как создать сервер TeamSpeak

Полное руководство по установке голосового сервера TeamSpeak на VPS или выделенном сервере Linux: лицензия, ключ администратора, порты, сервис systemd, обновления, резервное копирование и устранение неполадок.

7 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить голосовой сервер TeamSpeak на ваш VPS или выделенный Linux-сервер с отдельным пользователем и сервисом systemd, затем получить ключ администратора и поддерживать сервер в актуальном состоянии.

Заказать сервер

TeamSpeak потребляет очень мало ресурсов. HostMyServers предлагает несколько подходящих вариантов:

  • NVMe VPS - Достаточно для большинства голосовых серверов
  • Performance VPS - Выделенные ресурсы, для размещения TeamSpeak вместе с другими службами
  • Эко выделенные серверы - Для крупных сообществ с подходящей лицензией

Предварительные требования

  • SSH-доступ как root или пользователь с правами sudo
  • 64-разрядная система Linux: Debian 12/13 или Ubuntu 22.04/24.04
  • Активный брандмауэр: nftables (рекомендуется), iptables или ufw (используйте только один инструмент брандмауэра одновременно)
  • Порты 9987 UDP и 30033 TCP доступны
  • Клиент TeamSpeak на компьютере каждого пользователя

Требуемая конфигурация

TeamSpeak не публикует минимальную конфигурацию в числах. Следующие значения дают порядок величин для сервера на 32 места:

Компонент Рекомендуется
RAM 512 МБ свободно
CPU 1 ядро
Хранилище 2 ГБ плюс место для файлов, которыми делятся пользователи
Сеть Стабильное соединение, задержка важнее пропускной способности

Выбор лицензии

Без файла лицензии сервер работает бесплатно с одним виртуальным сервером и 32 местами для некоммерческого использования. Сверх этого, а также для коммерческого использования, нужна лицензия.

Лицензия Ограничения, указанные в договоре TeamSpeak Использование
Без лицензии 1 виртуальный сервер, 32 места Частные лица и некоммерческие группы
Non-Profit (NPL) 2 виртуальных сервера, 512 мест, срок 6 месяцев Некоммерческие группы
Annual Activation (AAL) От 1 сервера и 32 мест до 2 серверов и 1024 мест, срок один год Платная лицензия

Предложения и их доступность меняются: проверяйте их на сайте продаж TeamSpeak. Полный текст договора находится в файле LICENSE, поставляемом с сервером.

Обновление системы

Терминал
sudo apt update && sudo apt upgrade -y

Установка зависимостей

Терминал
sudo apt install -y ca-certificates curl tar bzip2 jq less cron

Создание выделенного пользователя

Сервер никогда не должен работать от root. Создайте выделенного пользователя:

Терминал
sudo adduser --disabled-password --gecos "" teamspeak

Используемые порты

Порт Протокол Назначение Доступность
9987 UDP Голос Публичный, обязательный
30033 TCP Передача файлов Публичный, обязательный
10022 TCP ServerQuery по SSH Локальный в этом руководстве
10011 TCP Незашифрованный ServerQuery Отключён в этом руководстве
10080 TCP WebQuery по HTTP Отключён по умолчанию
41144 TCP TSDNS, необязательно Не используется в этом руководстве

Серверу также нужен исходящий доступ к службам TeamSpeak, в частности к accounting2.teamspeak.com по TCP-порту 443. Не блокируйте этот трафик.

Настройка брандмауэра

С UFW

Терминал
sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp
sudo ufw reload

С iptables

Терминал
sudo iptables -A INPUT -p udp --dport 9987 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 30033 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Сохранение правил после перезагрузки требует пакета iptables-persistent.

С nftables

Эти команды используют таблицу inet filter и цепочку input, присутствующие по умолчанию в /etc/nftables.conf в Debian.

Терминал
sudo nft add rule inet filter input udp dport 9987 accept
sudo nft add rule inet filter input tcp dport 30033 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Установка сервера

Войдите как пользователь teamspeak. Следующие команды загружают последнюю версию, опубликованную TeamSpeak, проверяют её контрольную сумму SHA-256, затем распаковывают архив:

Терминал
sudo -iu teamspeak
mkdir -p ~/teamspeak ~/backups
chmod 700 ~/backups
INFO=$(curl -fsSL https://www.teamspeak.com/versions/server.json)
URL=$(echo "$INFO" | jq -r '.linux.x86_64.mirrors["teamspeak.com"]')
SUM=$(echo "$INFO" | jq -r '.linux.x86_64.checksum')
echo "$URL"
curl -fL -o ~/ts3.tar.bz2 "$URL"
echo "$SUM  $HOME/ts3.tar.bz2" | sha256sum -c - && tar -xjf ~/ts3.tar.bz2 --strip-components=1 -C ~/teamspeak
rm ~/ts3.tar.bz2

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

Принятие лицензии

Сервер отказывается запускаться, пока вы не примете его лицензию. Прочитайте её (клавиша q для выхода):

Терминал
less ~/teamspeak/LICENSE

Если вы согласны, создайте предназначенный для этого файл:

Терминал
touch ~/teamspeak/.ts3server_license_accepted

Настройка сервера

По умолчанию интерфейс администрирования ServerQuery слушает на всех адресах, в том числе в открытом виде на порту 10011. Ограничьте его протоколом SSH и локальной машиной:

Терминал
nano ~/teamspeak/ts3server.ini
Конфигурация
query_protocols=ssh
query_ssh_ip=127.0.0.1
query_ssh_port=10022
Параметр Описание
query_protocols Активные протоколы ServerQuery: raw, ssh и http
query_ssh_ip Адрес, на котором ServerQuery слушает по SSH
query_ssh_port Порт ServerQuery по SSH

Затем выйдите из сессии пользователя teamspeak:

Терминал
exit

Установка файла лицензии (необязательно)

Если вы получили лицензию, скопируйте файл licensekey.dat в /home/teamspeak/teamspeak/, затем защитите его:

Терминал
sudo chown teamspeak:teamspeak /home/teamspeak/teamspeak/licensekey.dat
sudo chmod 600 /home/teamspeak/teamspeak/licensekey.dat

Перезапустите сервер, если он уже работает.

Настройка как сервис systemd

Создание файла сервиса

Терминал
sudo nano /etc/systemd/system/teamspeak.service

Содержимое файла:

Конфигурация
[Unit]
Description=TeamSpeak 3 Server
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak
ExecStart=/home/teamspeak/teamspeak/ts3server_minimal_runscript.sh inifile=ts3server.ini
Restart=on-failure
RestartSec=15
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target

Активация и запуск сервиса

Терминал
sudo systemctl daemon-reload
sudo systemctl enable teamspeak.service
sudo systemctl start teamspeak.service

Команды управления

Терминал
# Проверить статус
sudo systemctl status teamspeak.service

# Остановить сервер
sudo systemctl stop teamspeak.service

# Перезапустить сервер
sudo systemctl restart teamspeak.service

# Просмотр логов
sudo journalctl -u teamspeak.service -f

Получение ключа администратора

При самом первом запуске сервер генерирует пароль учётной записи serveradmin и ключ привилегий (token):

Терминал
sudo journalctl -u teamspeak.service --no-pager | grep -E 'loginname=|apikey=|token='
Элемент Назначение
token Одноразовый ключ для получения прав Server Admin в клиенте
loginname и password Подключение к ServerQuery
apikey Доступ к WebQuery, если вы его включите

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

  1. Установите клиент TeamSpeak и запустите его.
  2. Подключитесь по адресу IP_СЕРВЕРА (порт 9987 по умолчанию).
  3. При первом подключении клиент запросит ключ привилегий: вставьте token. Если окно не появилось, найдите Use Privilege Key в меню Permissions или Tools, в зависимости от вашего клиента.

После этого вы войдёте в группу Server Admin и сможете настраивать сервер, его каналы и разрешения из клиента.

Администрирование через ServerQuery

На сервере подключитесь с паролем serveradmin:

Терминал
ssh -p 10022 serveradmin@127.0.0.1
Команда Описание
help Показывает список команд
use sid=1 Выбирает первый виртуальный сервер
serverinfo Показывает информацию о виртуальном сервере
clientlist Показывает список подключённых клиентов
servergrouplist Показывает список групп и их идентификаторов
tokenadd tokentype=0 tokenid1=<группа> tokenid2=0 Создаёт ключ привилегий для серверной группы
quit Закрывает сессию

Создание нового ключа администратора

Если ключ был использован или утерян, найдите группу Server Admin командой servergrouplist. Используйте её sgid, здесь 6 в качестве примера:

Текст
use sid=1
servergrouplist
tokenadd tokentype=0 tokenid1=6 tokenid2=0

Удалённое администрирование

Лучше использовать SSH-туннель со своего компьютера, не открывая дополнительных портов:

Терминал
ssh -L 10022:127.0.0.1:10022 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_СЕРВЕРА

Затем подключите свой инструмент ServerQuery к 127.0.0.1:10022.

Если вам действительно нужно открыть ServerQuery, замените query_ssh_ip=127.0.0.1 на query_ssh_ip=0.0.0.0 в ts3server.ini, перезапустите сервис и ограничьте порт вашим фиксированным IP-адресом:

Терминал
# UFW
sudo ufw allow from ВАШ_IP to any port 10022 proto tcp

# iptables
sudo iptables -A INPUT -p tcp -s ВАШ_IP --dport 10022 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 10022 -j DROP

# nftables
sudo nft add rule inet filter input ip saddr ВАШ_IP tcp dport 10022 accept
sudo nft add rule inet filter input tcp dport 10022 drop

Обновление сервера

Устанавливайте обновления без промедления: версии 3.13.8 и 3.13.9 устраняют уязвимости безопасности, в том числе сбой сервера, который можно вызвать удалённо без аутентификации. Ваши данные сохраняются, но сначала сделайте резервную копию: предварительно создайте скрипт, описанный в разделе «Автоматическое резервное копирование».

Терминал
sudo /usr/local/sbin/teamspeak-backup.sh
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
INFO=$(curl -fsSL https://www.teamspeak.com/versions/server.json)
URL=$(echo "$INFO" | jq -r '.linux.x86_64.mirrors["teamspeak.com"]')
SUM=$(echo "$INFO" | jq -r '.linux.x86_64.checksum')
curl -fL -o ~/ts3.tar.bz2 "$URL"
echo "$SUM  $HOME/ts3.tar.bz2" | sha256sum -c - && tar -xjf ~/ts3.tar.bz2 --strip-components=1 -C ~/teamspeak
rm ~/ts3.tar.bz2
exit
sudo systemctl start teamspeak.service
sudo journalctl -u teamspeak.service -n 30 --no-pager

Установленная версия отображается в начале логов, в строке TeamSpeak 3 Server.

Автоматическое резервное копирование

Скрипт ненадолго останавливает сервер, чтобы получить согласованную копию базы данных, затем запускает его снова.

Скрипт резервного копирования

Терминал
sudo nano /usr/local/sbin/teamspeak-backup.sh
Терминал
#!/bin/bash
SERVER_DIR="/home/teamspeak/teamspeak"
BACKUP_DIR="/home/teamspeak/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/teamspeak_$DATE.tar.gz"

# Элементы для сохранения, если они существуют
ITEMS=()
for ITEM in ts3server.sqlitedb ts3server.sqlitedb-wal ts3server.sqlitedb-shm ts3server.ini \
    .ts3server_license_accepted licensekey.dat ssh_host_rsa_key query_ip_allowlist.txt \
    query_ip_denylist.txt files; do
    [ -e "$SERVER_DIR/$ITEM" ] && ITEMS+=("$ITEM")
done

install -d -m 700 -o teamspeak -g teamspeak "$BACKUP_DIR"

systemctl stop teamspeak.service
tar -czf "$ARCHIVE" -C "$SERVER_DIR" "${ITEMS[@]}"
RESULT=$?
systemctl start teamspeak.service

chown teamspeak:teamspeak "$ARCHIVE"
chmod 600 "$ARCHIVE"

# Удаление резервных копий старше 7 дней
find "$BACKUP_DIR" -name "teamspeak_*.tar.gz" -mtime +7 -delete

exit $RESULT
Терминал
sudo chmod 700 /usr/local/sbin/teamspeak-backup.sh

Планирование резервного копирования

Терминал
sudo crontab -e

Добавьте:

Текст
# Резервное копирование каждый день в 5 часов
0 5 * * * /usr/local/sbin/teamspeak-backup.sh

Восстановление из резервной копии

Замените имя файла на имя вашей резервной копии:

Терминал
sudo systemctl stop teamspeak.service
sudo -u teamspeak tar -xzf /home/teamspeak/backups/teamspeak_2026-01-01_05-00-00.tar.gz -C /home/teamspeak/teamspeak
sudo systemctl start teamspeak.service

Регулярно копируйте эти архивы за пределы сервера: они содержат базу данных и вашу лицензию, если она есть.

При возникновении проблем

Сервер просит принять лицензию

Сообщение Please set the environment variable TS3SERVER_LICENSE to "accept" означает, что файл принятия лицензии отсутствует:

Терминал
sudo -u teamspeak touch /home/teamspeak/teamspeak/.ts3server_license_accepted
sudo systemctl restart teamspeak.service

Ошибка instance check error

Без лицензии сервер проверяет с помощью /dev/shm, что не запущен другой экземпляр.

  • Найдите другой экземпляр: pgrep -a ts3server
  • Проверьте, что /dev/shm смонтирован: df -h /dev/shm

Если он не смонтирован, смонтируйте его, затем добавьте строку tmpfs /dev/shm tmpfs defaults 0 0 в /etc/fstab:

Терминал
sudo mount -t tmpfs tmpfs /dev/shm

Клиенты не могут подключиться

  • Проверьте, что порт 9987 открыт по UDP: sudo ufw status
  • Проверьте, что сервер слушает: sudo ss -ulnp | grep 9987
  • Проверьте, что сервис работает: sudo systemctl status teamspeak.service

Не работает передача файлов или аватары

Вероятно, заблокирован порт 30033 по TCP. Проверьте брандмауэр и то, что сервер слушает порт:

Терминал
sudo ss -ltnp | grep 30033

Утерян пароль serveradmin

Остановите сервис, затем один раз запустите сервер вручную с новым паролем:

Терминал
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
cd ~/teamspeak
./ts3server_minimal_runscript.sh inifile=ts3server.ini serveradmin_password=NewPassword

Когда сервер запустится, остановите его сочетанием Ctrl+C, введите exit, затем снова запустите сервис:

Терминал
sudo systemctl start teamspeak.service

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

Подключение к ServerQuery отклонено или заблокировано

После нескольких неудачных попыток ServerQuery временно блокирует соответствующий адрес. Подождите несколько минут и проверьте пароль. Чтобы исключить доверенный адрес из блокировки, добавьте его в query_ip_allowlist.txt, затем перезапустите сервис.

Ошибка unable to connect to accounting server

Серверу не удаётся связаться с лицензионными службами TeamSpeak. Проверьте DNS и исходящий трафик машины:

Терминал
curl -I https://accounting2.teamspeak.com

Неважно, какой HTTP-код будет возвращён: главное, чтобы пришёл ответ.

Предупреждение The system locale is set to "C"

Это сообщение не опасно. Оно означает, что сервис работает без заданного языка. Его можно игнорировать.