Главная / Вики / Сервер
🖥️ Раздел 7

Сервер и развёртывание

Из чего собрана серверная часть.

Что стоит на сервере

Из данных сервер хранит минимум.

🖥️

Сигнальный сервер

Node.js в Docker.

📶

Mosquitto

Брокер MQTT.

🌐

nginx

Единая точка входа.

📁

Статические файлы

Отдаются nginx с диска.

Сигнальный сервер

Сервер ведёт реестр; телеметрия идёт через брокер.

Порт Кто слушает Назначение
80 / 443 nginx Публичный HTTPS
3100 сервер, только localhost API сигнального сервера
1883 Mosquitto MQTT для микроконтроллеров
9001 Mosquitto MQTT через веб-сокеты
9002 Mosquitto Для live-данных на сайте

Состояние и хранение

Данные лежат в JSON и переживают перезапуск.

Логины те же, что у MQTT.

⏱️

Офлайн после трёх минут молчания.

Брокер Mosquitto

Кто подключается Что читает Что пишет
Контроллер команды в своём топике значения метрик и статус
Приложение значения метрик и статус команды устройству
Страница сайта только значения метрик ничего

Топик строится из префикса и идентификатора устройства.

nginx и маршрутизация

Весь публичный трафик собирает nginx.

Путь Куда попадает запрос
/ Главная страница сайта
/panel/ Веб-панель управления
/app/ Собранное веб-приложение
/fw/ Каталог прошивок
/api/v1/ Прокси на сигнальный сервер

Сервер в Docker-сети, наружу не публикуется.

Развёртывание с нуля

Стек запускается в Docker.

Подготовьте хост

sudo apt update
sudo apt install -y docker.io docker-compose-plugin nginx certbot
sudo systemctl enable --now docker nginx

Настройте окружение

cd /opt/iot/deploy/docker
cp .env.example .env
# заполнить NGINX_DOMAIN, PANEL_PASSWORD, MQTT_*
docker compose up -d --build

Статика — в runtime/site.

Подключите host nginx

sudo cp /opt/iot/deploy/iot-site.conf /etc/nginx/sites-available/spe4naz.conf
sudo ln -sf /etc/nginx/sites-available/spe4naz.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

web слушает только 127.0.0.1:8080.

Выпустите сертификат

sudo mkdir -p /var/www/certbot
sudo certbot certonly --webroot -w /var/www/certbot -d spe4naz.online
sudo systemctl reload nginx

Продление — таймером certbot.

Проверьте

curl -s https://spe4naz.online/api/v1/health
curl -s -o /dev/null -w '%{http_code}
' https://spe4naz.online/panel/
curl -s -o /dev/null -w '%{http_code}
' https://spe4naz.online/app/

Переменные окружения

Переменная По умолчанию Назначение
PORT 3000 · 3100 в Docker Порт HTTP-сервера
HOST 127.0.0.1 · 0.0.0.0 в Docker Адрес привязки
API_PREFIX /api/v1 Префикс эндпоинтов
MQTT_USER / MQTT_DEVICE_USER app / device Логины приложения и устройств
PANEL_PASSWORD пусто Пароль панели
PANEL_SESSION_TTL_MS 86400000 Срок сессии панели
MQTT_ENABLED 0 · 1 в Docker MQTT-мост и хранилище
INGEST_DIR data/ingest Каталог метрик
STALE_MS 180000 Таймаут офлайна
CLEANUP_INTERVAL_MS 30000 Период проверки
MAX_DEVICES_PER_IP 20 Устройств с одного адреса
RATE_LIMIT_REGISTER 20 Регистраций в минуту
RATE_LIMIT_HEARTBEAT 120 Подтверждений в минуту
RATE_LIMIT_WRITE 60 Записей в минуту
RATE_LIMIT_READ 120 Чтений в минуту
REGISTRY_FILE data/devices.json Файл реестра
ALERTS_FILE data/alerts.json Файл аварий
RULES_FILE data/rules.json Файл правил
METRICS_FILE / STABILITY_FILE / SETTINGS_FILE data/*.json Служебные файлы
🧪

158 автотестов серверной части.

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

Сохранять нужно реестр, каталог прошивок и метрики.

# реестр, аварии, правила, метрики и сертификаты
sudo /opt/iot/deploy/docker/backup.sh

# архив: /var/backups/iot/iot-YYYY-MM-DD_HHMMSS.tar.gz
🔁

Восстановление сводится к распаковке на место.

Безопасность

  • Учётные данные — в файле окружения, не в репозитории.
  • Пароли MQTT и API обязательны.
  • Для сайта — отдельная учётная запись только на чтение.
  • Сертификат продлевается автоматически.
  • Панель закрыта паролем приложения.
  • Пароли не зашиты в приложение.
🚫

Секреты в конфигурации прошивки попадают в бинарник.