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

Единый источник правды по сетевым портам, 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¶

Master — backpressure¶

Site¶

Edge¶

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) + артефакты агента
│   ├── data/              # app-data (сертификаты, server_settings.env)
│   └── log/               # журналы приложения и nginx
├── site/
│   ├── repos/
│   ├── data/
│   └── log/
└── edge/
    ├── storage/           # хранилище файлов/зеркала
    ├── data/
    └── log/
└── ai/
    ├── ollama/            # модели и состояние Ollama
    └── openclaw/          # конфигурация и workspace OpenClaw

Чтобы вынести repos/kb-cache на отдельный диск, смонтируйте его в соответствующий подкаталог DATA_DIR или задайте DATA_DIR целиком на отдельном томе перед первой установкой.