🖥️ Раздел 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 обязательны.
- Для сайта — отдельная учётная запись только на чтение.
- Сертификат продлевается автоматически.
- Панель закрыта паролем приложения.
- Пароли не зашиты в приложение.
🚫
Секреты в конфигурации прошивки попадают в бинарник.