SERVER GUIDE

Установка VoxNest Server

Чистая Ubuntu 22.04/24.04, два домена и один сценарий установки. Все каналы, группы, права и блокировки останутся в локальной базе вашей VDS.

01

Подготовьте DNS

Создайте две A-записи. Например, voice.example.com для API и media.voice.example.com для WebRTC. Обе должны указывать на публичный IPv4 сервера. Дождитесь, пока команды вернут адрес вашей VDS:

getent ahostsv4 voice.example.com
getent ahostsv4 media.voice.example.com
02

Скачайте и распакуйте сервер

mkdir -p /opt/voxnest
cd /opt/voxnest
unzip VoxNest-Server-0.17.0.zip
cd VoxNest-Server-0.17.0

Перейдите в каталог, где лежат install.sh и docker-compose.yml.

03

Запустите установку

sudo sh install.sh

Сценарий проверит Docker, при необходимости установит его, запросит два домена и название сервера, создаст закрытый .env, соберёт API и запустит Caddy с автоматическим TLS.

04

Активируйте администратора

После первого успешного запуска сценарий покажет одноразовый ключ вида VNPK-…. Войдите в клиент, подключитесь к адресу API и вставьте ключ в окно «Ключ привилегий». Ключ срабатывает один раз.

docker compose exec -T api cat /app/data/initial-admin-key.txt
05

Управляйте сервером

sudo sh start.sh
sudo sh start.sh --logs
sudo sh stop.sh
docker compose ps

start.sh ждёт готовности API и при ошибке сам выводит диагностический журнал. Повторный install.sh не перезаписывает существующий .env.

06

Резервное копирование

Остановите сервисы, сохраните файл .env и Docker volume voxnest-server-data. В нём находятся локальная база сервера, каналы, права, значки и история.

sudo sh stop.sh
docker run --rm -v voxnest-community-server_voxnest-server-data:/data -v "$PWD":/backup alpine tar czf /backup/voxnest-data.tgz -C /data .

Если голос или демонстрация не подключаются

Сначала проверьте DNS и firewall. Сигнал идёт по WSS/443, а медиатрафик предпочитает UDP. Закрытый диапазон UDP заставляет WebRTC долго искать запасной маршрут.

docker compose logs --tail=150 livekit api gateway
ss -lntup | grep -E '(:80|:443|:7881|:3478|:50000)'
Скачать сервер