gromy/ms-frontend repository overview

⁠ms-frontend

Mail Admin Frontend — веб-панель администрирования Р7-Почтовый сервер.

Nginx отдаёт статику админ-панели и проксирует запросы к связанным службам (API, MCP, MailFilter, Processing, SpamProtect, SpamBackend). При старте рендерит vhost из Jinja2-шаблонов, настраивает TLS, генерирует конфиг подключения к PostgreSQL для Lua-эндпоинта /instances и ожидает доступности заданных бэкендов.

• Базовый образ: Debian Bookworm
• HTTP: порт 80
• HTTPS: порт 443
• Статика: /opt/r7-mailserver/adminpanel
• Конфигурация nginx: /etc/nginx/conf.d/mailadmin.conf

⁠Быстрый старт

docker run -d \
  --name ms-frontend \
  --hostname ms-frontend \
  -p 8080:80 \
  -p 8443:443 \
  -e MS_FRONTEND_HOSTNAME=mailadmin.example.com \
  -e MS_FRONTEND_DB_HOST=ms-psql \
  -e MS_FRONTEND_DB_PWD=secret \
  -e MS_API_HOST=ms-api \
  -e MS_MCP_HOST=ms-mcp \
  -v ms-frontend-ssl:/app/ssl \
  gromy/ms-frontend:latest

Минимально необходимо указать параметры подключения к PostgreSQL. Прокси-блоки nginx создаются только для служб, у которых заданы оба параметра *_HOST и *_PORT.

docker run --env-file .env --name ms-frontend \
  -p 8080:80 -p 8443:443 \
  -v ms-frontend-ssl:/app/ssl \
  gromy/ms-frontend:latest

⁠Порты

⁠Тома

Рекомендуется монтировать том для сохранения сертификатов между перезапусками.

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

⁠Пути и хостнейм

⁠TLS

⁠PostgreSQL

Используются для генерации backend/config (эндпоинт /instances, 50-generate-instances-config.sh).

⁠Прокси к ms-api

⁠Прокси к ms-mcp

⁠Прокси к ms-mailfilter

⁠Прокси к ms-processing

⁠Прокси к ms-spamprotect

⁠Прокси к ms-spambackend

⁠Пример Docker Compose

services:
  ms-frontend:
    image: gromy/ms-frontend:latest
    hostname: ms-frontend
    env_file: .env
    environment:
      MS_FRONTEND_HOSTNAME: mailadmin.example.com
      MS_API_HOST: ms-api
      MS_MCP_HOST: ms-mcp
      MS_MF_HOST: ms-mailfilter
      MS_PROCESSING_HOST: ms-processing
      MS_SP_HOST: ms-spamprotect
      MS_SB_HOST: ms-spambackend
    ports:
      - "8080:80"
      - "8443:443"
    volumes:
      - frontend-ssl:/app/ssl
    depends_on:
      ms-psql:
        condition: service_healthy
      ms-api:
        condition: service_started

volumes:
  frontend-ssl:

⁠Связанные образы

⁠Ссылки

• GitLab — ms-frontend⁠
• Документация переменных окружения: README.md в репозитории