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

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Новая страница: «= Установка TeamSpeak 3 server = == 1. Подготовка системы == * Войдите в систему под учетной записью…»
 
Статья переписана по результатам проверки на Ubuntu 24.04: исправлены ошибки, добавлены снимки экрана
 
(не показано 6 промежуточных версий 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 apt install -y curl jq bzip2 tar telnet
sudo useradd -m -s /bin/bash teamspeak
sudo useradd -m -s /bin/bash teamspeak
</code>
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
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>
./ts3server_minimal_runscript.sh</pre>
mv teamspeak3-server_linux_amd64 teamspeak3-server
cd teamspeak3-server
</code>


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


1. Установите правильные права:
Текст соглашения — в файле <code>LICENSE</code> в каталоге сервера. Прочитайте его и, если согласны, создайте файл-отметку:
<code>
chmod +x ts3server_startscript.sh
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]
Description=TeamSpeak 3 Server
After=network.target


[Service]
Своего файла настроек у сервера изначально нет — создайте его:
Type=forking
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak/teamspeak3-server
ExecStart=/home/teamspeak/teamspeak/teamspeak3-server/ts3server_startscript.sh start
ExecStop=/home/teamspeak/teamspeak/teamspeak3-server/ts3server_startscript.sh stop
ExecReload=/home/teamspeak/teamspeak/teamspeak3-server/ts3server_startscript.sh restart
PIDFile=/home/teamspeak/teamspeak/teamspeak3-server/ts3server.pid
Restart=on-failure
RestartSec=5


[Install]
<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
WantedBy=multi-user.target
cat ts3server.ini
</code>
exit</pre>


3. Перезагрузите systemd и включите автозапуск:
{| class="wikitable"
<code>
! style="width:34%;" | Строка !! Что означает
sudo systemctl daemon-reload
|-
sudo systemctl enable teamspeak
| <code>license_accepted=1</code> || Лицензия принята — служба запустится и без файла-отметки
sudo systemctl start teamspeak
|-
</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. Без этих строк порты управления открыты всему интернету
|}


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


=== Настройка UFW ===
{| class="wikitable"
! 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
|}


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


2. Проверьте статус:
Название сервера, пароль для входа и число мест в этом файле '''не задаются''' — они настраиваются в программе TeamSpeak или через ServerQuery. Строк <code>server_name</code>, <code>server_password</code>, <code>voice_port</code>, <code>server_max_clients</code> из старых инструкций у сервера нет.
<code>
sudo ufw status
</code>


=== Настройка iptables ===
== 6. Запуск как служба ==


1. Разрешите порты через iptables:
<pre>sudo nano /etc/systemd/system/teamspeak.service</pre>
<code>
sudo iptables -A INPUT -p udp --dport 9987 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 10011 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 30033 -j ACCEPT
</code>


2. Сохраните правила:
<pre>[Unit]
<code>
Description=TeamSpeak 3 server
sudo iptables-save > /etc/iptables/rules.v4
After=network-online.target
</code>
Wants=network-online.target


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


2. Настройте основные параметры:
<pre>sudo systemctl daemon-reload
<code>
sudo systemctl enable --now teamspeak
# Основные настройки
systemctl is-active teamspeak
server_name=My TeamSpeak Server
sudo ss -lntup | grep ts3server | awk '{print $1, $5}' | sort -u</pre>
server_password=
server_admin_password=your_admin_password
server_query_password=your_query_password


# Настройки портов
[[Файл:Linux-ts-service.png|800px]]
voice_ip=0.0.0.0
voice_port=9987
query_ip=0.0.0.0
query_port=10011
filetransfer_ip=0.0.0.0
filetransfer_port=30033


# Логирование
Служба работает. Голосовой порт 9987 и порт файлов 30033 слушают все адреса, порты управления 10011 и 10022 — только сам VDS (<code>127.0.0.1</code>). Проверено и снаружи: с другого компьютера порт 30033 открыт, порты управления закрыты. Служба поднимает сервер и после сбоя — это проверено принудительным завершением процесса.
log_level=3
log_commands=1
log_query_commands=1
</code>


=== Настройка виртуальных серверов ===
Если на VDS включён файрвол, откройте два порта:


1. Создайте дополнительный виртуальный сервер:
<pre>sudo ufw allow 9987/udp
<code>
sudo ufw allow 30033/tcp</pre>
# В ts3server.ini добавьте:
virtualserver_port=9988
virtualserver_name=My Second Server
</code>


2. Перезапустите сервер:
Порты 10011 и 10022 наружу не открывайте.
<code>
sudo systemctl restart teamspeak
</code>


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


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


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


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


* '''Перезапуск сервера''':
Ключ привилегий одноразовый. Новый создаётся через ServerQuery — следующий шаг.
<code>
sudo systemctl restart teamspeak
</code>


* '''Проверка статуса''':
== 8. Управление через ServerQuery ==
<code>
sudo systemctl status teamspeak
</code>


* '''Просмотр логов''':
ServerQuery — текстовое управление сервером. Подключитесь с самого VDS:
<code>
sudo journalctl -u teamspeak -f
</code>


=== Управление через TeamSpeak Query ===
<pre>telnet 127.0.0.1 10011</pre>


1. Подключитесь к серверу:
<pre>login serveradmin ВашПароль
<code>
use sid=1
telnet localhost 10011
serveredit virtualserver_name=My\sTeamSpeak\sserver
</code>
serveredit virtualserver_welcomemessage=Welcome!
tokenadd tokentype=0 tokenid1=6 tokenid2=0
clientlist
quit</pre>


2. Авторизуйтесь:
[[Файл:Linux-ts-query.png|800px]]
<code>
login serveradmin your_query_password
</code>


3. Основные команды:
На каждую команду сервер отвечает <code>error id=0 msg=ok</code> — это означает успех. Пробел в значениях записывается как <code>\s</code>.
<code>
# Просмотр информации о сервере
serverinfo


# Создание виртуального сервера
{| class="wikitable"
servercreate virtualserver_name=My Server virtualserver_port=9988
! style="width:46%;" | Команда !! Что делает
|-
| <code>login serveradmin пароль</code> || Вход. Пароль — из шага 4
|-
| <code>use sid=1</code> || Выбрать виртуальный сервер. Без этого остальные команды не работают
|-
| <code>serverinfo</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> — справка по одной
|}


# Остановка сервера
'''Если пароль serveradmin потерян,''' задайте новый: остановите службу и один раз запустите сервер с параметром.
serverstop sid=1


# Запуск сервера
<pre>sudo systemctl stop teamspeak
serverstart sid=1
sudo -iu teamspeak
</code>
cd ~/teamspeak3-server_linux_amd64
 
./ts3server_startscript.sh start inifile=ts3server.ini serveradmin_password=НовыйПароль
== 8. Настройка резервного копирования ===
./ts3server_startscript.sh stop
exit
sudo systemctl start teamspeak</pre>


=== Создание скрипта резервного копирования ===
== 9. Резервная копия ==


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


2. Добавьте содержимое:
<pre>sudo systemctl stop teamspeak
<code>
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
#!/bin/bash
 
BACKUP_DIR="/backup/teamspeak"
TEAMSPEAK_DIR="/home/teamspeak/teamspeak/teamspeak3-server"
DATE=$(date +%Y%m%d_%H%M%S)
 
# Создание директории для бэкапа
mkdir -p $BACKUP_DIR
 
# Остановка сервера
sudo systemctl stop teamspeak
 
# Создание архива
tar -czf $BACKUP_DIR/teamspeak_backup_$DATE.tar.gz -C $TEAMSPEAK_DIR .
 
# Запуск сервера
sudo systemctl start teamspeak
sudo systemctl start teamspeak
ls -lh /home/teamspeak/ts3-backup-*.tar.gz</pre>


# Удаление старых бэкапов (старше 7 дней)
[[Файл:Linux-ts-backup.png|800px]]
find $BACKUP_DIR -name "teamspeak_backup_*.tar.gz" -mtime +7 -delete
 
echo "Backup completed: teamspeak_backup_$DATE.tar.gz"
</code>
 
3. Сделайте скрипт исполняемым:
<code>
sudo chmod +x /usr/local/bin/teamspeak-backup.sh
</code>
 
=== Настройка автоматического бэкапа ===
 
1. Добавьте задачу в crontab:
<code>
sudo crontab -e
</code>
 
2. Добавьте строку для ежедневного бэкапа:
<code>
# Ежедневный бэкап в 3:00
0 3 * * * /usr/local/bin/teamspeak-backup.sh
</code>
 
== 9. Мониторинг TeamSpeak ===
 
=== Создание скрипта мониторинга ===
 
1. Создайте скрипт мониторинга:
<code>
nano /usr/local/bin/teamspeak-monitor.sh
</code>
 
2. Добавьте содержимое:
<code>
#!/bin/bash
 
# Проверка статуса сервера
if systemctl is-active --quiet teamspeak; then
    echo "TeamSpeak server is running"
   
    # Проверка подключений
    CONNECTIONS=$(netstat -an | grep :9987 | wc -l)
    echo "Active connections: $CONNECTIONS"
   
    # Проверка использования памяти
    MEMORY=$(ps aux | grep ts3server | grep -v grep | awk '{print $6}')
    echo "Memory usage: $MEMORY KB"
   
else
    echo "TeamSpeak server is not running"
    # Отправка уведомления
    echo "TeamSpeak server is down" | mail -s "TeamSpeak Alert" admin@example.com
fi
</code>
 
3. Сделайте скрипт исполняемым:
<code>
sudo chmod +x /usr/local/bin/teamspeak-monitor.sh
</code>
 
=== Настройка мониторинга ===
 
1. Добавьте задачу мониторинга в crontab:
<code>
# Проверка каждые 5 минут
*/5 * * * * /usr/local/bin/teamspeak-monitor.sh
</code>
 
== 10. Настройка SSL/TLS ===
 
=== Генерация SSL сертификата ===
 
1. Создайте приватный ключ:
<code>
openssl genrsa -out teamspeak.key 2048
</code>
 
2. Создайте запрос на сертификат:
<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:
<code>
cp teamspeak.crt ~/teamspeak/teamspeak3-server/
cp teamspeak.key ~/teamspeak/teamspeak3-server/
</code>
 
=== Настройка SSL в TeamSpeak ===
 
1. Отредактируйте конфигурацию:
<code>
nano ~/teamspeak/teamspeak3-server/ts3server.ini
</code>
 
2. Добавьте настройки SSL:
<code>
# SSL настройки
certificate_file=teamspeak.crt
private_key_file=teamspeak.key
</code>
 
3. Перезапустите сервер:
<code>
sudo systemctl restart teamspeak
</code>
 
== 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>logs</code>, для каждого запуска создаются новые файлы. Храните копии не только на самом VDS.
<code>
netstat -an | grep :9987
</code>


== 12. Оптимизация производительности ===
Восстановление: остановите службу, распакуйте архив обратно и запустите.


=== Настройки производительности ===
<pre>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</pre>


1. Отредактируйте конфигурацию:
== Обновление ==
<code>
nano ~/teamspeak/teamspeak3-server/ts3server.ini
</code>


2. Добавьте настройки производительности:
<pre>sudo systemctl stop teamspeak
<code>
sudo -iu teamspeak
# Настройки производительности
J=$(curl -s https://www.teamspeak.com/versions/server.json)
server_max_clients=1000
curl -sL --retry 5 -o ts3.tar.bz2 $(echo "$J" | jq -r '.linux.x86_64.mirrors[]' | head -n 1)
server_max_connections_per_ip=10
tar xjf ts3.tar.bz2 && rm ts3.tar.bz2
server_bandwidth_limit=0
exit
server_bandwidth_limit_per_user=0
sudo systemctl start teamspeak</pre>


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


=== Мониторинг производительности ===
== Чего у сервера TeamSpeak 3 нет ==


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


2. Добавьте содержимое:
У TeamSpeak есть и новое поколение сервера — TeamSpeak 6; на момент проверки оно находится в бета-версии и требует новой программы у участников.
<code>
#!/bin/bash


echo "=== TeamSpeak Server Statistics ==="
== Что не проверено ==
echo "Server Status: $(systemctl is-active teamspeak)"
echo "Uptime: $(systemctl show teamspeak --property=ActiveEnterTimestamp --value)"
echo "Memory Usage: $(ps aux | grep ts3server | grep -v grep | awk '{print $4"%"}')"
echo "CPU Usage: $(ps aux | grep ts3server | grep -v grep | awk '{print $3"%"}')"
echo "Active Connections: $(netstat -an | grep :9987 | wc -l)"
</code>


3. Сделайте скрипт исполняемым:
Подключение программой TeamSpeak и ввод ключа привилегий в рамках этой проверки не испытывались — шаг 7 описан по документации сервера. Проверены загрузка, лицензия, первый запуск, служба, порты снаружи, ServerQuery, смена пароля, резервная копия.
<code>
sudo chmod +x /usr/local/bin/teamspeak-stats.sh
</code>


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


TeamSpeak 3 сервер успешно установлен и настроен! Теперь вы можете создавать голосовые серверы для команд.
{| class="wikitable"
! Что видите !! Причина и решение
|-
| Сервер сразу завершается, просит <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>
|}


'''Для размещения ваших TeamSpeak серверов на надежном хостинге рекомендуем воспользоваться услугами [ARK-HOSTER.RU](https://ark-hoster.ru):'''
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:'''


* '''[Выделенные серверы](https://ark-hoster.ru/dedicated/)''' - для высоконагруженных TeamSpeak серверов
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
* '''[VPS/VDS серверы](https://ark-hoster.ru/vpsgame/)''' - для небольших и средних команд
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов


Наши специалисты помогут с настройкой 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: