Справочник портов, контейнеров и переменных

Единый источник правды по сетевым портам, Docker-контейнерам и переменным окружения серверных ролей LSUS и AI-стека. Остальные страницы ссылаются сюда и не дублируют эти данные.

Пошаговая установка — в разделе Развёртывание серверов. Требования к хосту и firewall — в Требованиях и подготовке. Подробно про AI-стек — в разделе AI-стек.

Сетевая модель#

Все контейнеры используют общий лимит файловых дескрипторов:

ulimits:
  nofile:
    soft: 65536
    hard: 65536

Это защита от EMFILE (Too many open files) при тысячах одновременно подключённых клиентов.

Порты#

Внешние порты (публикуются на интерфейсах хоста)#

Внутренние порты (только 127.0.0.1, loopback)#

Дефолтные порты ролей (для клиентов)#

Значения по умолчанию — из .env.example (ручное развёртывание) и из .env, создаваемого пакетами ОС при первой установке:

TLS и nginx#

• Протоколы: только TLS 1.2 и 1.3 (ssl_protocols TLSv1.2 TLSv1.3;).
• HTTP/2: включён (http2 on;).
• Сертификаты: при первом запуске при отсутствии сертификатов генерируются самоподписанные. Пути в контейнере — /app/data/certs/server.crt и server.key.
• listen backlog: 4096 (LSUS_NGINX_LISTEN_BACKLOG).
• worker_connections: 16384, worker_rlimit_nofile 65536.
• Ограничение частоты API: limit_req zone=api rate=50r/s burst=100.

Контейнеры по ролям#

Карта образов#

Все образы имеют тег ${LSUS_VERSION} и pull_policy: never (берутся из загруженных локально, не из registry). AI-образы тегируются отдельной версией ${AI_VERSION} и запускаются через профили compose (--profile ollama, --profile openclaw). Состав пакетов внутри образов — см. Docker и образы.

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

Переменные задаются в файле .env (каталог /opt/lsus-docker/). При обновлении пакетов существующий .env не перезаписывается — значения сохраняются.

Базовые переменные (все роли)#

Redis (общий кеш)#

Redis работает на каждой серверной роли (Master/Site/Edge) в контейнере lsus-redis, слушает только 127.0.0.1:6379 — без пароля и без персистентности (данные — только кеш, восстанавливать нечего). При недоступности Redis приложение продолжает работу с кешем внутри процесса.

PostgreSQL — автотюнинг#

Параметры PostgreSQL настраиваются автоматически при старте контейнера (режим auto) на основе объёма RAM хоста. Значение auto для большинства параметров означает расчёт по эмпирическим формулам. Чтобы зафиксировать значение вручную, задайте конкретное число вместо auto.

Проверить применённые значения:

sudo bash /opt/lsus-docker/scripts/check-postgres-tuning.sh

Master — порты и URL#

Раздатчик репозиториев#

Включён по умолчанию на всех ролях: nginx отдаёт /repos в контейнер раздатчика. Существующий .env при обновлении не перезаписывается — если LSUS_REPOS_BACKEND в нём не задана, работает дефолт compose (раздатчик).

Кеш nginx /repos и карточка «Кеш раздачи репозиториев» в настройках сервера не зависят от раздатчика и работают как раньше. Админка и опрос агентов обслуживаются другими пулами — раздатчик их не заменяет.

Master — backpressure#

Master — опрос клиентов#

Master — приоритетный хост пользователя#

Параметры страницы «Параметры» (Администрирование → Настройки), переопределяются
окружением. Технические интервалы — только окружение.

Master — обслуживание БД#

Site#

Edge#

Файловый шаттл (закрытый контур)#

Когда интернет-Edge нельзя стыковать с Master по IP, данные едут каталогом-бандлом (флешка, SMB или SFTP). Контейнеры сами ничего не монтируют: флешку или шару на хосте указывает администратор. Master не ходит на Edge ни по одному протоколу.

Новые исходящие порты внутри контура Master (не до Edge): SMB 445/tcp и SFTP 22/tcp — только если источник шаттла на файловом перекладчике. Site и PXE не участвуют.

PXE#

Роль exclusive: свой хост, без PostgreSQL. ISO только на точке. Secure Boot в MVP выключен (iPXE).

AI-стек (Ollama)#

Переменные задаются в файле ollama.env (каталог /opt/lsus-docker/).

Модели загружаются через UI Master (импорт .tar.gz) или docker exec lsus-ollama ollama pull <tag>. Для GPU добавьте override docker-compose.gpu.yml (требуется nvidia-container-toolkit).

AI-стек (OpenClaw)#

Переменные задаются в файле openclaw.env (каталог /opt/lsus-docker/).

Базы данных по ролям#

При установке нескольких ролей на разные хосты каждая использует свою БД. При совмещении (не рекомендуется) — разные БД/пользователи в одном PostgreSQL:

Пароли БД генерируются случайным образом при первой установке и сохраняются в файл credentials-<роль>.txt рядом с .env.

Health-эндпоинты#

Для проверки работоспособности роли используется HTTPS-запрос (примеры ниже — для дефолтного порта 443; при нестандартном порте добавьте :<порт> после хоста):

Master и Site#

curl -k https://master.example.com/api/v1/health

Ожидаемый ответ (HTTP 200):

{"status": "ok", "role": "master"}

Для Site — "role": "site" (или "standalone", если роль не задана явно).

Edge#

curl -k https://edge.example.com/api/v1/health

Ожидаемый ответ (HTTP 200):

{"status": "ok", "role": "edge"}

PXE#

curl -k https://pxe.example.com/api/v1/health

Ожидаемый ответ (HTTP 200):

{"status": "ok", "role": "pxe"}

Boot-плоскость (без TLS):

curl -s http://pxe.example.com/pxe/boot.ipxe | head

Диагностический эндпоинт (с версией сервера)#

Отдельный эндпоинт для клиентской диагностики, без аутентификации:

curl -k https://master.example.com/api/v1/clients/health

Ответ (HTTP 200):

{
  "status": "ok",
  "server_version": "1.0.67",
  "time": "2026-06-16T12:00:00.000Z"
}

Структура каталогов данных#

При установке через пакеты ОС DATA_DIR=/opt/lsus-docker/data. Дерево по ролям:

/opt/lsus-docker/data/
├── postgres/              # данные PostgreSQL (все роли)
├── master/
│   ├── repos/             # зеркала репозиториев
│   ├── kb-cache/          # кеш баз KB Windows
│   ├── kb-storages/       # KB-хранилища (MSU) + артефакты агента
│   ├── config-files/      # файлы для политик «Файл» конфигураций
│   ├── patches/           # каталоги патчей (staged/enabled/backup)
│   ├── data/              # app-data (сертификаты, server_settings.env)
│   └── log/               # журналы приложения и nginx
├── site/
│   ├── repos/
│   ├── data/
│   └── log/
└── edge/
    ├── storage/           # хранилище файлов/зеркала
    ├── data/
    └── log/
└── ai/
    ├── ollama/            # модели и состояние Ollama
    └── openclaw/          # конфигурация и workspace OpenClaw

DATA_DIR — корень всех данных роли, включая postgres/, сертификаты и журналы. Чтобы вынести только repos/kb-cache/storage на отдельный диск, смонтируйте его в соответствующий подкаталог DATA_DIR; смена всего DATA_DIR переносит и базу данных — оба сценария и порядок шагов описаны в разделе Вынос данных на отдельный диск.

Раздача с сайта (1.0.122)#