Установка TeamSpeak 3 server на VDS

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 05:37, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Статья переписана по результатам проверки на Ubuntu 24.04: исправлены ошибки, добавлены снимки экрана)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

TeamSpeak 3 — голосовая связь для игровых команд и сообществ: низкая задержка, каналы, права участников. Свой сервер на VDS работает круглосуточно и не зависит от чужих площадок. В статье — установка сервера TeamSpeak 3 на Ubuntu 24.04, принятие лицензии, первый запуск, служба, управление и резервные копии. Все команды проверены 17 ноября 2026 года на Ubuntu 24.04.4 с сервером версии 3.13.9, снимки экрана сняты с настоящего сервера.

Что понадобится

  • VDS с Ubuntu 24.04: 1 ядро, 1 ГБ памяти, 1 ГБ диска. Подойдёт младший тариф VDS.
  • Участникам — бесплатная программа TeamSpeak 3.

Бесплатная лицензия позволяет один виртуальный сервер на 32 места — этого хватает клану или небольшому сообществу. Больше мест и несколько виртуальных серверов дают платные лицензии TeamSpeak.

1. Подготовка

sudo apt update
sudo apt install -y curl jq bzip2 tar telnet
sudo useradd -m -s /bin/bash teamspeak
sudo -iu teamspeak

Сервер будет работать от имени отдельного пользователя teamspeak; дальнейшие команды — в его сеансе.

2. Загрузка сервера

J=$(curl -s https://www.teamspeak.com/versions/server.json); echo "$J" | jq -r '.linux.x86_64 | .version, .mirrors[]'
curl -sL --retry 5 -o ts3.tar.bz2 $(echo "$J" | jq -r '.linux.x86_64.mirrors[]' | head -n 1)
echo "$(echo "$J" | jq -r .linux.x86_64.checksum)  ts3.tar.bz2" | sha256sum -c -
tar xjf ts3.tar.bz2 && rm ts3.tar.bz2
ls teamspeak3-server_linux_amd64

Первая команда спрашивает у TeamSpeak номер последней версии и адрес архива, вторая скачивает его, третья сверяет контрольную сумму — ответ «OK» означает, что файл скачан без повреждений. Ссылки с номером версии из старых инструкций устаревают с каждым выпуском.

3. Лицензия

Сервер не запускается, пока не принято лицензионное соглашение:

cd ~/teamspeak3-server_linux_amd64
./ts3server_minimal_runscript.sh

Текст соглашения — в файле LICENSE в каталоге сервера. Прочитайте его и, если согласны, создайте файл-отметку:

touch .ts3server_license_accepted

Без этого шага сервер и служба завершаются сразу после запуска — это главная причина, по которой установка «по старой инструкции» не работает.

4. Первый запуск

./ts3server_minimal_runscript.sh

При первом запуске сервер создаёт базу данных и один раз показывает три вещи. Сохраните их:

Что показано Зачем нужно
loginname и password Имя и пароль для управления сервером через ServerQuery — шаг 8
apikey Ключ для программного управления сервером
token Ключ привилегий: кто введёт его в программе TeamSpeak, станет администратором сервера — шаг 7

На снимке из вывода убраны служебные строки с датой, а сами значения скрыты. Остановите сервер сочетанием Ctrl+C.

5. Файл настроек

Своего файла настроек у сервера изначально нет — создайте его:

printf 'license_accepted=1\nquery_protocols=raw,ssh\nquery_ip=127.0.0.1\nquery_ssh_ip=127.0.0.1\n' > ts3server.ini
cat ts3server.ini
exit
Строка Что означает
license_accepted=1 Лицензия принята — служба запустится и без файла-отметки
query_protocols=raw,ssh Какими способами доступно управление ServerQuery
query_ip=127.0.0.1, query_ssh_ip=127.0.0.1 Принимать управляющие подключения только с самого VDS. Без этих строк порты управления открыты всему интернету

Другие настройки, которые понимает этот файл:

Строка Изначально Что означает
default_voice_port 9987 Порт голосовой связи (UDP)
filetransfer_port 30033 Порт передачи файлов и значков (TCP)
query_port, query_ssh_port 10011, 10022 Порты управления ServerQuery
logpath logs Каталог журналов
dbplugin ts3db_sqlite3 База данных: встроенная SQLite либо MariaDB или PostgreSQL

Полный файл со всеми строками сервер создаёт сам, если один раз запустить его с параметром createinifile=1.

Название сервера, пароль для входа и число мест в этом файле не задаются — они настраиваются в программе TeamSpeak или через ServerQuery. Строк server_name, server_password, voice_port, server_max_clients из старых инструкций у сервера нет.

6. Запуск как служба

sudo nano /etc/systemd/system/teamspeak.service
[Unit]
Description=TeamSpeak 3 server
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
User=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak3-server_linux_amd64
ExecStart=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh start inifile=ts3server.ini
ExecStop=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh stop
PIDFile=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server.pid
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now teamspeak
systemctl is-active teamspeak
sudo ss -lntup | grep ts3server | awk '{print $1, $5}' | sort -u

Служба работает. Голосовой порт 9987 и порт файлов 30033 слушают все адреса, порты управления 10011 и 10022 — только сам VDS (127.0.0.1). Проверено и снаружи: с другого компьютера порт 30033 открыт, порты управления закрыты. Служба поднимает сервер и после сбоя — это проверено принудительным завершением процесса.

Если на VDS включён файрвол, откройте два порта:

sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp

Порты 10011 и 10022 наружу не открывайте.

7. Подключение и права администратора

1. В программе TeamSpeak 3 выберите «Подключения» → «Подключиться», введите адрес VDS — например, 203.0.113.10 — и своё имя.

2. При первом входе на новый сервер программа спросит ключ привилегий. Вставьте token из шага 4 — вы станете администратором сервера. Если окно не появилось: меню «Права» → «Использовать ключ привилегий».

3. Название сервера, пароль, приветствие и число мест меняются в программе: правой кнопкой по названию сервера → «Редактировать виртуальный сервер».

Ключ привилегий одноразовый. Новый создаётся через ServerQuery — следующий шаг.

8. Управление через ServerQuery

ServerQuery — текстовое управление сервером. Подключитесь с самого VDS:

telnet 127.0.0.1 10011
login serveradmin ВашПароль
use sid=1
serveredit virtualserver_name=My\sTeamSpeak\sserver
serveredit virtualserver_welcomemessage=Welcome!
tokenadd tokentype=0 tokenid1=6 tokenid2=0
clientlist
quit

На каждую команду сервер отвечает error id=0 msg=ok — это означает успех. Пробел в значениях записывается как \s.

Команда Что делает
login serveradmin пароль Вход. Пароль — из шага 4
use sid=1 Выбрать виртуальный сервер. Без этого остальные команды не работают
serverinfo Все сведения и настройки сервера
serveredit virtualserver_name=Имя Название сервера
serveredit virtualserver_password=пароль Пароль для входа; пустое значение — снять пароль
serveredit virtualserver_welcomemessage=Текст Приветствие
tokenadd tokentype=0 tokenid1=6 tokenid2=0 Создать новый ключ привилегий администратора
tokenlist Ещё не использованные ключи
clientlist Кто сейчас на сервере
help Список всех команд; help команда — справка по одной

Если пароль serveradmin потерян, задайте новый: остановите службу и один раз запустите сервер с параметром.

sudo systemctl stop teamspeak
sudo -iu teamspeak
cd ~/teamspeak3-server_linux_amd64
./ts3server_startscript.sh start inifile=ts3server.ini serveradmin_password=НовыйПароль
./ts3server_startscript.sh stop
exit
sudo systemctl start teamspeak

9. Резервная копия

Всё, что отличает ваш сервер от только что установленного, — это база данных, загруженные файлы и настройки:

sudo systemctl stop teamspeak
sudo -u teamspeak tar czf /home/teamspeak/ts3-backup-$(date +%F).tar.gz -C /home/teamspeak/teamspeak3-server_linux_amd64 ts3server.sqlitedb files ts3server.ini query_ip_allowlist.txt query_ip_denylist.txt ssh_host_rsa_key
sudo systemctl start teamspeak
ls -lh /home/teamspeak/ts3-backup-*.tar.gz

Копия делается при остановленном сервере — так база данных гарантированно цела. Журналы сервера лежат в каталоге logs, для каждого запуска создаются новые файлы. Храните копии не только на самом VDS.

Восстановление: остановите службу, распакуйте архив обратно и запустите.

sudo systemctl stop teamspeak
sudo -u teamspeak tar xzf /home/teamspeak/ts3-backup-2026-11-17.tar.gz -C /home/teamspeak/teamspeak3-server_linux_amd64
sudo systemctl start teamspeak

Обновление

sudo systemctl stop teamspeak
sudo -iu teamspeak
J=$(curl -s https://www.teamspeak.com/versions/server.json)
curl -sL --retry 5 -o ts3.tar.bz2 $(echo "$J" | jq -r '.linux.x86_64.mirrors[]' | head -n 1)
tar xjf ts3.tar.bz2 && rm ts3.tar.bz2
exit
sudo systemctl start teamspeak

Архив распаковывается поверх прежнего каталога и заменяет только файлы программы: базы данных, загруженных файлов и ts3server.ini в нём нет. Перед обновлением всё равно сделайте копию — шаг 9.

Чего у сервера TeamSpeak 3 нет

Из старых инструкций Как на самом деле
Раздел «Настройка SSL», строки certificate_file и private_key_file Таких настроек нет. Голос шифруется собственными средствами TeamSpeak, сертификат для этого не нужен
server_max_clients=1000 и другие «настройки производительности» Выдуманы. Число мест задаётся лицензией: бесплатно — 32
Второй виртуальный сервер строками в файле настроек На бесплатной лицензии виртуальный сервер один
Открыть порт 10011 в файрволе Это управление сервером без шифрования — наружу его не открывают

У TeamSpeak есть и новое поколение сервера — TeamSpeak 6; на момент проверки оно находится в бета-версии и требует новой программы у участников.

Что не проверено

Подключение программой TeamSpeak и ввод ключа привилегий в рамках этой проверки не испытывались — шаг 7 описан по документации сервера. Проверены загрузка, лицензия, первый запуск, служба, порты снаружи, ServerQuery, смена пароля, резервная копия.

Если что-то пошло не так

Что видите Причина и решение
Сервер сразу завершается, просит TS3SERVER_LICENSE Не принята лицензия — шаг 3 или строка license_accepted=1 в файле настроек
Служба не запускается Причина — в journalctl -u teamspeak -n 20 и в последнем файле каталога logs
Не удаётся подключиться программой Закрыт порт 9987/udp в файрволе
Не загружаются значки и файлы Закрыт порт 30033/tcp
Ключ привилегий не принят Он уже использован. Создайте новый командой tokenadd — шаг 8
telnet: «Connection refused» Подключайтесь с самого VDS по адресу 127.0.0.1; снаружи управление закрыто намеренно
ServerQuery отвечает ошибкой на любую команду Не выполнены login и use sid=1

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: