Установка TeamSpeak 3 server на VDS: различия между версиями

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Нет описания правки
Статья переписана по результатам проверки на Ubuntu 24.04: исправлены ошибки, добавлены снимки экрана
 
(не показано 5 промежуточных версий 3 участников)
Строка 1: Строка 1:
= Установка TeamSpeak 3 server =
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]]</div>
TeamSpeak 3 — голосовая связь для игровых команд и сообществ: низкая задержка, каналы, права участников. Свой сервер на VDS работает круглосуточно и не зависит от чужих площадок. В статье — установка сервера TeamSpeak 3 на Ubuntu 24.04, принятие лицензии, первый запуск, служба, управление и резервные копии. Все команды проверены 17 ноября 2026 года на Ubuntu 24.04.4 с сервером версии 3.13.9, снимки экрана сняты с настоящего сервера.


== 1. Подготовка системы ==
== Что понадобится ==


* Войдите в систему под учетной записью с правами '''root''' или пользователя с правами '''sudo'''.
* VDS с Ubuntu 24.04: 1 ядро, 1 ГБ памяти, 1 ГБ диска. Подойдёт [https://ark-hoster.ru/vpsgame/ младший тариф VDS].
* Убедитесь, что у вас есть доступ к серверу через SSH или консоль.
* Участникам — бесплатная программа TeamSpeak 3.


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


=== Создание пользователя ===
== 1. Подготовка ==


1. Создайте пользователя для TeamSpeak:
<pre>sudo apt update
<code>sudo useradd -m -s /bin/bash teamspeak</code>
sudo apt install -y curl jq bzip2 tar telnet
sudo useradd -m -s /bin/bash teamspeak
sudo -iu teamspeak</pre>


2. Установите пароль для пользователя:
Сервер будет работать от имени отдельного пользователя <code>teamspeak</code>; дальнейшие команды — в его сеансе.
<code>sudo passwd teamspeak</code>


3. Переключитесь на пользователя teamspeak:
== 2. Загрузка сервера ==
<code>sudo su - teamspeak</code>


== 3. Установка TeamSpeak 3 Server ===
<pre>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</pre>


=== Скачивание TeamSpeak ===
[[Файл:Linux-ts-download.png|800px]]


1. Создайте директорию для TeamSpeak:
Первая команда спрашивает у TeamSpeak номер последней версии и адрес архива, вторая скачивает его, третья сверяет контрольную сумму — ответ «OK» означает, что файл скачан без повреждений. Ссылки с номером версии из старых инструкций устаревают с каждым выпуском.
<code>mkdir -p ~/teamspeak</code>
<code>cd ~/teamspeak</code>


2. Скачайте последнюю версию TeamSpeak 3 Server:
== 3. Лицензия ==
<code>wget https://files.teamspeak-services.com/releases/server/3.13.7/teamspeak3-server_linux_amd64-3.13.7.tar.bz2</code>


3. Распакуйте архив:
Сервер не запускается, пока не принято лицензионное соглашение:
<code>tar -xjf teamspeak3-server_linux_amd64-3.13.7.tar.bz2</code>


4. Переименуйте директорию:
<pre>cd ~/teamspeak3-server_linux_amd64
<code>mv teamspeak3-server_linux_amd64 teamspeak3-server</code>
./ts3server_minimal_runscript.sh</pre>
<code>cd teamspeak3-server</code>


=== Настройка прав доступа ===
[[Файл:Linux-ts-license.png|800px]]


1. Установите правильные права:
Текст соглашения — в файле <code>LICENSE</code> в каталоге сервера. Прочитайте его и, если согласны, создайте файл-отметку:
<code>chmod +x ts3server_startscript.sh</code>
<code>chmod +x ts3server</code>


2. Создайте директорию для логов:
<pre>touch .ts3server_license_accepted</pre>
<code>mkdir -p logs</code>


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


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


1. Запустите TeamSpeak сервер:
<pre>./ts3server_minimal_runscript.sh</pre>
<code>./ts3server_startscript.sh start</code>


2. При первом запуске вы получите:
[[Файл:Linux-ts-first.png|800px]]
* '''ServerAdmin privilege key''' - сохраните его!
* '''ServerQuery Admin login''' - логин и пароль для администрирования


3. Остановите сервер:
При первом запуске сервер создаёт базу данных и '''один раз''' показывает три вещи. Сохраните их:
<code>./ts3server_startscript.sh stop</code>


=== Настройка автозапуска ===
{| class="wikitable"
! style="width:28%;" | Что показано !! Зачем нужно
|-
| <code>loginname</code> и <code>password</code> || Имя и пароль для управления сервером через ServerQuery — шаг 8
|-
| <code>apikey</code> || Ключ для программного управления сервером
|-
| <code>token</code> || Ключ привилегий: кто введёт его в программе TeamSpeak, станет администратором сервера — шаг 7
|}


1. Создайте systemd сервис:
На снимке из вывода убраны служебные строки с датой, а сами значения скрыты. Остановите сервер сочетанием '''Ctrl+C'''.
<code>sudo nano /etc/systemd/system/teamspeak.service</code>


2. Добавьте конфигурацию:
== 5. Файл настроек ==
<code>[Unit]</code>
<code>Description=TeamSpeak 3 Server</code>
<code>After=network.target</code>
<code>[Service]</code>
<code>Type=forking</code>
<code>User=teamspeak</code>
<code>Group=teamspeak</code>
<code>WorkingDirectory=/home/teamspeak/teamspeak/teamspeak3-server</code>
<code>ExecStart=/home/teamspeak/teamspeak/teamspeak3-server/ts3server_startscript.sh start</code>
<code>ExecStop=/home/teamspeak/teamspeak/teamspeak3-server/ts3server_startscript.sh stop</code>
<code>ExecReload=/home/teamspeak/teamspeak/teamspeak3-server/ts3server_startscript.sh restart</code>
<code>PIDFile=/home/teamspeak/teamspeak/teamspeak3-server/ts3server.pid</code>
<code>Restart=on-failure</code>
<code>RestartSec=5</code>
<code>[Install]</code>
<code>WantedBy=multi-user.target</code>


3. Перезагрузите systemd и включите автозапуск:
Своего файла настроек у сервера изначально нет — создайте его:
<code>sudo systemctl daemon-reload</code>
<code>sudo systemctl enable teamspeak</code>
<code>sudo systemctl start teamspeak</code>


== 5. Настройка файрвола ===
<pre>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</pre>


=== Настройка UFW ===
{| class="wikitable"
! style="width:34%;" | Строка !! Что означает
|-
| <code>license_accepted=1</code> || Лицензия принята — служба запустится и без файла-отметки
|-
| <code>query_protocols=raw,ssh</code> || Какими способами доступно управление ServerQuery
|-
| <code>query_ip=127.0.0.1</code>, <code>query_ssh_ip=127.0.0.1</code> || Принимать управляющие подключения только с самого VDS. Без этих строк порты управления открыты всему интернету
|}


1. Разрешите порты TeamSpeak:
Другие настройки, которые понимает этот файл:
<code>sudo ufw allow 9987/udp</code>
<code>sudo ufw allow 10011/tcp</code>
<code>sudo ufw allow 30033/tcp</code>


2. Проверьте статус:
{| class="wikitable"
<code>sudo ufw status</code>
! style="width:34%;" | Строка !! Изначально !! Что означает
|-
| <code>default_voice_port</code> || 9987 || Порт голосовой связи (UDP)
|-
| <code>filetransfer_port</code> || 30033 || Порт передачи файлов и значков (TCP)
|-
| <code>query_port</code>, <code>query_ssh_port</code> || 10011, 10022 || Порты управления ServerQuery
|-
| <code>logpath</code> || logs || Каталог журналов
|-
| <code>dbplugin</code> || ts3db_sqlite3 || База данных: встроенная SQLite либо MariaDB или PostgreSQL
|}


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


1. Разрешите порты через iptables:
Название сервера, пароль для входа и число мест в этом файле '''не задаются''' — они настраиваются в программе TeamSpeak или через ServerQuery. Строк <code>server_name</code>, <code>server_password</code>, <code>voice_port</code>, <code>server_max_clients</code> из старых инструкций у сервера нет.
<code>sudo iptables -A INPUT -p udp --dport 9987 -j ACCEPT</code>
<code>sudo iptables -A INPUT -p tcp --dport 10011 -j ACCEPT</code>
<code>sudo iptables -A INPUT -p tcp --dport 30033 -j ACCEPT</code>


2. Сохраните правила:
== 6. Запуск как служба ==
<code>sudo iptables-save > /etc/iptables/rules.v4</code>


== 6. Настройка TeamSpeak ===
<pre>sudo nano /etc/systemd/system/teamspeak.service</pre>


=== Основные настройки ===
<pre>[Unit]
Description=TeamSpeak 3 server
After=network-online.target
Wants=network-online.target


1. Отредактируйте файл конфигурации:
[Service]
<code>nano ~/teamspeak/teamspeak3-server/ts3server.ini</code>
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


2. Настройте основные параметры:
[Install]
<code>server_name=My TeamSpeak Server</code>
WantedBy=multi-user.target</pre>
<code>server_password=</code>
<code>server_admin_password=your_admin_password</code>
<code>server_query_password=your_query_password</code>
<code>voice_ip=0.0.0.0</code>
<code>voice_port=9987</code>
<code>query_ip=0.0.0.0</code>
<code>query_port=10011</code>
<code>filetransfer_ip=0.0.0.0</code>
<code>filetransfer_port=30033</code>
<code>log_level=3</code>
<code>log_commands=1</code>
<code>log_query_commands=1</code>


=== Настройка виртуальных серверов ===
<pre>sudo systemctl daemon-reload
sudo systemctl enable --now teamspeak
systemctl is-active teamspeak
sudo ss -lntup | grep ts3server | awk '{print $1, $5}' | sort -u</pre>


1. Создайте дополнительный виртуальный сервер:
[[Файл:Linux-ts-service.png|800px]]
<code>virtualserver_port=9988</code>
<code>virtualserver_name=My Second Server</code>


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


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


=== Основные команды управления ===
<pre>sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp</pre>


* '''Запуск сервера''':
Порты 10011 и 10022 наружу не открывайте.
<code>sudo systemctl start teamspeak</code>


* '''Остановка сервера''':
== 7. Подключение и права администратора ==
<code>sudo systemctl stop teamspeak</code>


* '''Перезапуск сервера''':
'''1.''' В программе TeamSpeak 3 выберите «Подключения» → «Подключиться», введите адрес VDS — например, <code>203.0.113.10</code> — и своё имя.
<code>sudo systemctl restart teamspeak</code>


* '''Проверка статуса''':
'''2.''' При первом входе на новый сервер программа спросит ключ привилегий. Вставьте <code>token</code> из шага 4 — вы станете администратором сервера. Если окно не появилось: меню «Права» → «Использовать ключ привилегий».
<code>sudo systemctl status teamspeak</code>


* '''Просмотр логов''':
'''3.''' Название сервера, пароль, приветствие и число мест меняются в программе: правой кнопкой по названию сервера → «Редактировать виртуальный сервер».
<code>sudo journalctl -u teamspeak -f</code>


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


1. Подключитесь к серверу:
== 8. Управление через ServerQuery ==
<code>telnet localhost 10011</code>


2. Авторизуйтесь:
ServerQuery — текстовое управление сервером. Подключитесь с самого VDS:
<code>login serveradmin your_query_password</code>


3. Основные команды:
<pre>telnet 127.0.0.1 10011</pre>
<code>serverinfo</code>
<code>servercreate virtualserver_name=My Server virtualserver_port=9988</code>
<code>serverstop sid=1</code>
<code>serverstart sid=1</code>


== 8. Настройка резервного копирования ===
<pre>login serveradmin ВашПароль
use sid=1
serveredit virtualserver_name=My\sTeamSpeak\sserver
serveredit virtualserver_welcomemessage=Welcome!
tokenadd tokentype=0 tokenid1=6 tokenid2=0
clientlist
quit</pre>


=== Создание скрипта резервного копирования ===
[[Файл:Linux-ts-query.png|800px]]


1. Создайте скрипт бэкапа:
На каждую команду сервер отвечает <code>error id=0 msg=ok</code> — это означает успех. Пробел в значениях записывается как <code>\s</code>.
<code>nano /usr/local/bin/teamspeak-backup.sh</code>


2. Добавьте содержимое:
{| class="wikitable"
<code>BACKUP_DIR="/backup/teamspeak"</code>
! style="width:46%;" | Команда !! Что делает
<code>TEAMSPEAK_DIR="/home/teamspeak/teamspeak/teamspeak3-server"</code>
|-
<code>DATE=$(date +%Y%m%d_%H%M%S)</code>
| <code>login serveradmin пароль</code> || Вход. Пароль — из шага 4
<code>mkdir -p $BACKUP_DIR</code>
|-
<code>sudo systemctl stop teamspeak</code>
| <code>use sid=1</code> || Выбрать виртуальный сервер. Без этого остальные команды не работают
<code>tar -czf $BACKUP_DIR/teamspeak_backup_$DATE.tar.gz -C $TEAMSPEAK_DIR .</code>
|-
<code>sudo systemctl start teamspeak</code>
| <code>serverinfo</code> || Все сведения и настройки сервера
<code>find $BACKUP_DIR -name "teamspeak_backup_*.tar.gz" -mtime +7 -delete</code>
|-
<code>echo "Backup completed: teamspeak_backup_$DATE.tar.gz"</code>
| <code>serveredit virtualserver_name=Имя</code> || Название сервера
|-
| <code>serveredit virtualserver_password=пароль</code> || Пароль для входа; пустое значение — снять пароль
|-
| <code>serveredit virtualserver_welcomemessage=Текст</code> || Приветствие
|-
| <code>tokenadd tokentype=0 tokenid1=6 tokenid2=0</code> || Создать новый ключ привилегий администратора
|-
| <code>tokenlist</code> || Ещё не использованные ключи
|-
| <code>clientlist</code> || Кто сейчас на сервере
|-
| <code>help</code> || Список всех команд; <code>help команда</code> — справка по одной
|}


3. Сделайте скрипт исполняемым:
'''Если пароль serveradmin потерян,''' задайте новый: остановите службу и один раз запустите сервер с параметром.
<code>sudo chmod +x /usr/local/bin/teamspeak-backup.sh</code>


=== Настройка автоматического бэкапа ===
<pre>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</pre>


1. Добавьте задачу в crontab:
== 9. Резервная копия ==
<code>sudo crontab -e</code>


2. Добавьте строку для ежедневного бэкапа:
Всё, что отличает ваш сервер от только что установленного, — это база данных, загруженные файлы и настройки:
<code>0 3 * * * /usr/local/bin/teamspeak-backup.sh</code>


== 9. Мониторинг TeamSpeak ===
<pre>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</pre>


=== Создание скрипта мониторинга ===
[[Файл:Linux-ts-backup.png|800px]]


1. Создайте скрипт мониторинга:
Копия делается при остановленном сервере — так база данных гарантированно цела. Журналы сервера лежат в каталоге <code>logs</code>, для каждого запуска создаются новые файлы. Храните копии не только на самом VDS.
<code>nano /usr/local/bin/teamspeak-monitor.sh</code>


2. Добавьте содержимое:
Восстановление: остановите службу, распакуйте архив обратно и запустите.
<code>if systemctl is-active --quiet teamspeak; then</code>
<code>echo "TeamSpeak server is running"</code>
<code>CONNECTIONS=$(netstat -an | grep :9987 | wc -l)</code>
<code>echo "Active connections: $CONNECTIONS"</code>
<code>MEMORY=$(ps aux | grep ts3server | grep -v grep | awk '{print $6}')</code>
<code>echo "Memory usage: $MEMORY KB"</code>
<code>else</code>
<code>echo "TeamSpeak server is not running"</code>
<code>echo "TeamSpeak server is down" | mail -s "TeamSpeak Alert" admin@example.com</code>
<code>fi</code>


3. Сделайте скрипт исполняемым:
<pre>sudo systemctl stop teamspeak
<code>sudo chmod +x /usr/local/bin/teamspeak-monitor.sh</code>
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</pre>


=== Настройка мониторинга ===
== Обновление ==


1. Добавьте задачу мониторинга в crontab:
<pre>sudo systemctl stop teamspeak
<code>*/5 * * * * /usr/local/bin/teamspeak-monitor.sh</code>
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</pre>


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


=== Генерация SSL сертификата ===
== Чего у сервера TeamSpeak 3 нет ==


1. Создайте приватный ключ:
{| class="wikitable"
<code>openssl genrsa -out teamspeak.key 2048</code>
! style="width:40%;" | Из старых инструкций !! Как на самом деле
|-
| Раздел «Настройка SSL», строки <code>certificate_file</code> и <code>private_key_file</code> || Таких настроек нет. Голос шифруется собственными средствами TeamSpeak, сертификат для этого не нужен
|-
| <code>server_max_clients=1000</code> и другие «настройки производительности» || Выдуманы. Число мест задаётся лицензией: бесплатно — 32
|-
| Второй виртуальный сервер строками в файле настроек || На бесплатной лицензии виртуальный сервер один
|-
| Открыть порт 10011 в файрволе || Это управление сервером без шифрования — наружу его не открывают
|}


2. Создайте запрос на сертификат:
У TeamSpeak есть и новое поколение сервера — TeamSpeak 6; на момент проверки оно находится в бета-версии и требует новой программы у участников.
<code>openssl req -new -key teamspeak.key -out teamspeak.csr</code>


3. Создайте самоподписанный сертификат:
== Что не проверено ==
<code>openssl x509 -req -days 365 -in teamspeak.csr -signkey teamspeak.key -out teamspeak.crt</code>


4. Скопируйте сертификаты в директорию TeamSpeak:
Подключение программой TeamSpeak и ввод ключа привилегий в рамках этой проверки не испытывались — шаг 7 описан по документации сервера. Проверены загрузка, лицензия, первый запуск, служба, порты снаружи, ServerQuery, смена пароля, резервная копия.
<code>cp teamspeak.crt ~/teamspeak/teamspeak3-server/</code>
<code>cp teamspeak.key ~/teamspeak/teamspeak3-server/</code>


=== Настройка SSL в TeamSpeak ===
== Если что-то пошло не так ==


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


2. Добавьте настройки SSL:
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:'''
<code>certificate_file=teamspeak.crt</code>
<code>private_key_file=teamspeak.key</code>


3. Перезапустите сервер:
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
<code>sudo systemctl restart teamspeak</code>
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов


== 11. Устранение неполадок ===
{{Телеграм}}
 
=== Частые проблемы ===
 
1. '''Сервер не запускается''':
* Проверьте логи: <code>sudo journalctl -u teamspeak -f</code>
* Проверьте права доступа: <code>ls -la ~/teamspeak/teamspeak3-server/</code>
* Проверьте порты: <code>netstat -tlnp | grep 9987</code>
 
2. '''Клиенты не могут подключиться''':
* Проверьте файрвол: <code>sudo ufw status</code>
* Проверьте порты: <code>sudo netstat -tlnp | grep 9987</code>
* Проверьте настройки сети
 
3. '''Высокое использование CPU/памяти''':
* Проверьте количество подключений
* Оптимизируйте настройки сервера
* Рассмотрите возможность масштабирования
 
=== Диагностика ===
 
1. Проверьте статус сервера:
<code>sudo systemctl status teamspeak</code>
 
2. Проверьте логи:
<code>sudo journalctl -u teamspeak --since "1 hour ago"</code>
 
3. Проверьте подключения:
<code>netstat -an | grep :9987</code>
 
== 12. Оптимизация производительности ===
 
=== Настройки производительности ===
 
1. Отредактируйте конфигурацию:
<code>nano ~/teamspeak/teamspeak3-server/ts3server.ini</code>
 
2. Добавьте настройки производительности:
<code>server_max_clients=1000</code>
<code>server_max_connections_per_ip=10</code>
<code>server_bandwidth_limit=0</code>
<code>server_bandwidth_limit_per_user=0</code>
<code>server_cache_size=100</code>
<code>server_cache_time=300</code>
 
=== Мониторинг производительности ===
 
1. Создайте скрипт мониторинга:
<code>nano /usr/local/bin/teamspeak-stats.sh</code>
 
2. Добавьте содержимое:
<code>echo "=== TeamSpeak Server Statistics ==="</code>
<code>echo "Server Status: $(systemctl is-active teamspeak)"</code>
<code>echo "Uptime: $(systemctl show teamspeak --property=ActiveEnterTimestamp --value)"</code>
<code>echo "Memory Usage: $(ps aux | grep ts3server | grep -v grep | awk '{print $4"%"}')"</code>
<code>echo "CPU Usage: $(ps aux | grep ts3server | grep -v grep | awk '{print $3"%"}')"</code>
<code>echo "Active Connections: $(netstat -an | grep :9987 | wc -l)"</code>
 
3. Сделайте скрипт исполняемым:
<code>sudo chmod +x /usr/local/bin/teamspeak-stats.sh</code>
 
== Заключение ==
 
TeamSpeak 3 сервер успешно установлен и настроен! Теперь вы можете создавать голосовые серверы для команд.
 
'''Для размещения ваших TeamSpeak серверов на надежном хостинге рекомендуем воспользоваться услугами [ARK-HOSTER.RU](https://ark-hoster.ru):'''
 
* '''[Выделенные серверы](https://ark-hoster.ru/dedicated/)''' - для высоконагруженных TeamSpeak серверов
* '''[VPS/VDS серверы](https://ark-hoster.ru/vpsgame/)''' - для небольших и средних команд
 
Наши специалисты помогут с настройкой TeamSpeak и оптимизацией производительности вашего сервера!

Текущая версия от 05:37, 17 ноября 2026

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: