Как создать сервер TeamSpeak
Полное руководство по установке голосового сервера TeamSpeak на VPS или выделенном сервере Linux: лицензия, ключ администратора, порты, сервис systemd, обновления, резервное копирование и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить голосовой сервер 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.iniquery_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, если вы его включите |
Подключение к серверу
- Установите клиент TeamSpeak и запустите его.
- Подключитесь по адресу
IP_СЕРВЕРА(порт9987по умолчанию). - При первом подключении клиент запросит ключ привилегий: вставьте
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 $RESULTsudo 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"
Это сообщение не опасно. Оно означает, что сервис работает без заданного языка. Его можно игнорировать.