Базы данных и Тюнинг 19 мин чтения 2026-11-06

Интерактивная BI-аналитика и дашборды с Metabase: развертывание в Docker Compose на VDS для интернет-магазинов и сервисов без платных облачных подписок

Пошаговое инженерное руководство по развертыванию открытой BI-системы Metabase v0.65.2 в Docker Compose на VDS. Настройка внутренней базы PostgreSQL 16, шифрование учетных данных AES-256, безопасное подключение боевых баз в режиме Read-Only с таймаутом запросов, Nginx Reverse Proxy с SSL и автоматическая выгрузка отчетов в Telegram.

Инженерная редакция SysKit Проверено инженерами SysKit.ru

Любому растущему интернет-магазину, сервису подписки или b2b-проекту необходима наглядная аналитика: ежедневная динамика выручки, средний чек, когортный анализ повторных покупок и воронки оформления заказов. Исторически бизнес решал эту задачу двумя путями: либо вручную сводил выгрузки в Excel, либо подключал облачные SaaS-платформы вроде PowerBI и Tableau. Однако в современных реалиях облачные западные сервисы стали недоступны для оплаты, несут риски внезапной блокировки учетных записей и нарушают требования 152-ФЗ о локализации персональных данных клиентов на территории РФ. Открытая BI-платформа Metabase (более 50 000 звёзд на GitHub, лицензия AGPLv3) решает эту проблему радикально: она разворачивается за 15 минут в Docker Compose на собственном российском VDS, подключается к рабочей базе данных в изолированном режиме чтения и предоставляет сотрудникам интуитивный визуальный конструктор отчетов без необходимости писать сложные SQL-запросы.

1. Архитектура Metabase: почему это идеальный выбор для бизнеса

В отличие от тяжеловесных enterprise-комбайнов (таких как Apache Superset) или систем мониторинга серверных метрик (Grafana), Metabase с самого начала проектировалась с упором на демократизацию данных внутри команды. Это означает, что маркетолог, операционный директор или менеджер склада могут самостоятельно собрать нужный срез по продажам за пару кликов мыши, не отвлекая разработчиков и администраторов баз данных составлением кастомных SQL-скриптов.

Архитектурно Metabase состоит из трех ключевых уровней:

  • Ядро визуализации и API (Java Runtime): высокопроизводительный сервис на базе Clojure/Java, который транслирует клики пользователя в оптимизированные SQL-запросы под конкретную СУБД, кэширует результаты выборок и отрисовывает интерактивные графики.
  • Внутренняя база метаданных (Application Database): хранилище для учетных записей пользователей, настроек прав доступа, структуры дашбордов, формул метрик и сохраненных вопросов. В боевой среде здесь категорически запрещено использовать встроенную SQLite/H2 — стандартом надежности является выделенный контейнер postgres:16-alpine.
  • Внешние аналитические источники (Data Sources): ваши рабочие СУБД (PostgreSQL интернет-магазина, MySQL от CRM, ClickHouse или реплика базы данных), к которым Metabase обращается строго по протоколу Read-Only.
Критерий Metabase (Self-Hosted) Microsoft PowerBI Apache Superset Grafana
Лицензия и контроль Open Source (AGPLv3) Проприетарный SaaS Open Source (Apache 2.0) Open Source (AGPLv3)
Порог входа для не-технарей Минимальный (No-Code UI) Средний (язык DAX) Высокий (требуется SQL) Средний (PromQL / SQL)
Потребление памяти (RAM) 1.5 – 2 ГБ RAM Облачные ресурсы 4 – 8 ГБ RAM (тяжелый стек) 150 – 300 МБ RAM
Фокус использования Бизнес-метрики, продажи, воронки Корпоративная отчетность Big Data, Data Science Мониторинг серверов и логов
Соответствие 152-ФЗ РФ 100% (хранение на вашем VDS) Риск утечки в зарубежные ЦОД 100% (при своем сервере) 100% (при своем сервере)

Для небольших и средних команд Metabase выступает идеальным балансом: в ней нет избыточной сложности enterprise-решений, но есть мощный графический построитель вопросов (Query Builder), сводные таблицы, фильтры перекрестных связей и возможность автоматического экспорта отчетов в PDF, CSV или Telegram.

2. Подготовка операционной системы VDS и изоляция сетевых портов

Развертывание аналитической платформы рекомендуется выполнять на базе чистого дистрибутива Ubuntu 24.04 LTS или Debian 12. Поскольку Metabase функционирует внутри виртуальной машины Java (JVM), критически важно защитить операционную систему от внезапного завершения процессов через Out Of Memory (OOM) Killer при пиковых нагрузках, а также закрыть прямой доступ к портам сервисов через файрвол UFW.

Первым шагом подключаемся к серверу по SSH, обновляем пакетную базу и подключаем файл подкачки (Swap) объемом 4 ГБ, который послужит амортизатором при резких скачках потребления оперативной памяти:

# Обновление системных репозиториев
sudo apt update && sudo apt upgrade -y

# Создание и активация файла подкачки (Swap) на 4 ГБ
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Автоматическое монтирование при загрузке системы
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Оптимизация агрессивности свопинга (swappiness = 10)
sudo sysctl vm.swappiness=10
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf

Далее устанавливаем официальный стек Docker Engine и плагин Docker Compose. Не используйте устаревшие пакеты docker-compose из штатных репозиториев Ubuntu, устанавливайте современный Docker CLI v2:

# Установка вспомогательных утилит
sudo apt install -y ca-certificates curl gnupg lsb-release

# Добавление официального GPG-ключа и репозитория Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Проверка корректности установки Docker
sudo docker --version && sudo docker compose version

Для сетевой защиты настраиваем межсетевой экран ufw. Наружу должны смотреть исключительно стандартные порты SSH (22), HTTP (80) и HTTPS (443). Порт самого веб-интерфейса Metabase (3000) и порт внутренней базы данных (5432) мы привяжем к петлевому интерфейсу 127.0.0.1, исключая несанкционированные попытки сканирования через внешние сети. Проверить доступность портов сервера после настройки всегда можно с помощью бесплатного онлайн-инструмента проверки открытых портов SysKit:

# Базовые правила UFW: запретить входящие, разрешить исходящие
sudo ufw default deny incoming
sudo ufw default allow outgoing

# Открытие портов SSH, HTTP и HTTPS
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'Nginx HTTP'
sudo ufw allow 443/tcp comment 'Nginx HTTPS'

# Активация файрвола
sudo ufw enable
sudo ufw status verbose

3. Боевой Docker Compose манифест с базой PostgreSQL 16

Для развертывания создаем изолированный рабочий каталог /opt/metabase, в котором разместим переменные окружения, манифест контейнеров и конфигурационные файлы прокси-сервера:

sudo mkdir -p /opt/metabase/nginx
sudo chmod 750 /opt/metabase
cd /opt/metabase

Создаем файл переменных окружения .env. Для генерации надежного криптографического ключа MB_ENCRYPTION_SECRET_KEY и паролей к базе данных используем утилиту openssl или встроенный генератор надежных паролей SysKit:

# Генерация 32-байтного ключа шифрования AES-256 для учетных записей Metabase
MB_SECRET_KEY=$(openssl rand -base64 32)
POSTGRES_PWD=$(openssl rand -base64 24 | tr -d "=+/" | cut -c1-20)

cat <<EOF | sudo tee /opt/metabase/.env
# Основные параметры Metabase
MB_SITE_URL=https://bi.yourdomain.ru
MB_ENCRYPTION_SECRET_KEY=${MB_SECRET_KEY}
MB_ANON_TRACKING_ENABLED=false
MB_ENABLE_EMBEDDING=true

# Параметры внутренней базы метаданных (PostgreSQL 16)
POSTGRES_DB=metabase_app
POSTGRES_USER=metabase_user
POSTGRES_PASSWORD=${POSTGRES_PWD}

# Настройки выделения памяти для виртуальной машины Java
JAVA_OPTS=-Xms512m -Xmx1536m -XX:+UseG1GC -Dfile.encoding=UTF-8
EOF

sudo chmod 600 /opt/metabase/.env

Теперь создаем боевой файл /opt/metabase/docker-compose.yml. Обратите внимание на директивы mem_limit, которые предотвращают утечки памяти, и привязку порта Metabase строго к адресу 127.0.0.1:3000. Чтобы быстро собрать рецепты для смежных контейнеров, вы всегда можете воспользоваться нашим интерактивным генератором Docker Compose:

services:
  postgres:
    image: postgres:16-alpine
    container_name: metabase_postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - metabase_net
    mem_limit: 512m
    cpus: 1.0
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5

  metabase:
    image: metabase/metabase:v0.65.2
    container_name: metabase_app
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    ports:
      - "127.0.0.1:3000:3000"
    mem_limit: 2048m
    cpus: 2.0
    environment:
      MB_DB_TYPE: postgres
      MB_DB_DBNAME: ${POSTGRES_DB}
      MB_DB_PORT: 5432
      MB_DB_USER: ${POSTGRES_USER}
      MB_DB_PASS: ${POSTGRES_PASSWORD}
      MB_DB_HOST: postgres
      MB_ENCRYPTION_SECRET_KEY: ${MB_ENCRYPTION_SECRET_KEY}
      MB_SITE_URL: ${MB_SITE_URL}
      MB_ANON_TRACKING_ENABLED: ${MB_ANON_TRACKING_ENABLED}
      MB_ENABLE_EMBEDDING: ${MB_ENABLE_EMBEDDING}
      JAVA_OPTS: ${JAVA_OPTS}
    volumes:
      - metabase_plugins:/plugins
    networks:
      - metabase_net

networks:
  metabase_net:
    driver: bridge

volumes:
  postgres_data:
    driver: local
  metabase_plugins:
    driver: local

Запускаем контейнеры в фоновом режиме и контролируем процесс первичной инициализации схемы базы данных:

cd /opt/metabase
sudo docker compose up -d

# Просмотр логов запуска (первичная миграция базы занимает 30-45 секунд)
sudo docker compose logs -f metabase

Когда в журнале появится строка вида INFO metabase.core :: Metabase Initialization COMPLETE, сервис готов к приему входящего трафика.

4. Конфигурация Nginx Reverse Proxy, Let's Encrypt SSL и сжатия

Для безопасного доступа пользователей и защиты веб-сессий настраиваем обратный прокси-сервер Nginx с автоматическим выпуском бесплатного сертификата Let's Encrypt. Важная особенность Metabase — аналитические запросы к крупным таблицам могут выполняться от 10 до 60 секунд, поэтому стандартные таймауты Nginx (60с) необходимо увеличить до 300 секунд во избежание ошибок 504 Gateway Time-out.

Устанавливаем Nginx и клиент Certbot:

sudo apt install -y nginx certbot python3-certbot-nginx

Чтобы избежать распространенной ошибки chicken-and-egg (когда тест nginx -t падает из-за еще не существующих файлов сертификатов), настройку проводим в два последовательных шага. Сначала создаем базовый HTTP-конфиг /etc/nginx/sites-available/metabase.conf для прохождения валидации домена:

upstream metabase_upstream {
    server 127.0.0.1:3000;
    keepalive 32;
}

server {
    listen 80;
    listen [::]:80;
    server_name bi.yourdomain.ru;

    location / {
        proxy_pass http://metabase_upstream;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Активируем конфигурацию, проверяем синтаксис и выпускаем сертификат Let's Encrypt с автоматической настройкой редиректа на HTTPS:

# Активация виртуального хоста
sudo ln -s /etc/nginx/sites-available/metabase.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# Получение SSL-сертификата через Certbot с автоматическим редиректом на HTTPS
sudo certbot --nginx -d bi.yourdomain.ru --non-interactive --agree-tos --redirect -m admin@yourdomain.ru

После успешного получения сертификата дополняем /etc/nginx/sites-available/metabase.conf боевыми параметрами безопасности, поддержкой WebSockets, сжатием Gzip и расширенными таймаутами для аналитических выборок. Вы также можете сгенерировать готовые наборы директив в нашем бесплатном генераторе конфигураций Nginx:

upstream metabase_upstream {
    server 127.0.0.1:3000;
    keepalive 32;
}

server {
    listen 80;
    listen [::]:80;
    server_name bi.yourdomain.ru;

    # Автоматический редирект HTTP на HTTPS
    return 301 https://$host$request_uri;
}

server {
    # В штатных версиях Nginx из дистрибутивов Ubuntu 24.04 (nginx 1.24) и Debian 12 (nginx 1.22)
    # протокол HTTP/2 объявляется прямо в директиве listen:
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    # Примечание: если вы используете upstream-репозиторий nginx.org (v1.26+), синтаксис раздельный: listen 443 ssl; http2 on;
    server_name bi.yourdomain.ru;

    # Пути к сертификатам Let's Encrypt
    ssl_certificate /etc/letsencrypt/live/bi.yourdomain.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bi.yourdomain.ru/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    # Лимиты загрузки (для импорта кастомных CSV-датасетов)
    client_max_body_size 50M;

    # Расширенные таймауты для тяжелых аналитических выборок
    proxy_connect_timeout 300s;
    proxy_send_timeout 300s;
    proxy_read_timeout 300s;
    send_timeout 300s;

    # Включение сжатия Gzip для ускорения передачи дашбордов и JSON
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml image/svg+xml;

    # Заголовки безопасности
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;

    location / {
        proxy_pass http://metabase_upstream;
        proxy_http_version 1.1;

        # Проброс WebSockets для мгновенного обновления дашбордов
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Передача реальных IP-адресов клиента
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Буферизация ответов
        proxy_buffering on;
        proxy_buffer_size 128k;
        proxy_buffers 4 256k;
        proxy_busy_buffers_size 256k;
    }
}

Применяем обновленную боевую конфигурацию:

sudo nginx -t && sudo systemctl reload nginx

После выпуска сертификата проверьте корректность цепочки шифрования с помощью онлайн-утилиты проверки SSL-сертификатов, а также убедитесь в отсутствии циклических редиректов через проверку редиректов SysKit.

5. Системные требования и подбор оптимального тарифа VDS

Поскольку ядро Metabase написано на Clojure и работает поверх Java Virtual Machine (JVM), сервис требует фиксированного запаса оперативной памяти для сборщика мусора (G1 Garbage Collector) и компиляции внутренних плагинов визуализации. Если на VDS не хватает RAM, контейнер быстро упадет с ошибкой java.lang.OutOfMemoryError.

В зависимости от объема обрабатываемых данных и количества одновременных пользователей инженеры SysKit выделили три конфигурационных профиля:

Профиль проекта Пользователи Рекомендуемые ресурсы VDS Параметры JAVA_OPTS
Стартовый (Малый бизнес) 1 – 5 аналитиков 2 vCPU • 4 ГБ RAM • 40 ГБ NVMe -Xms512m -Xmx1536m
Стандартный (Интернет-магазин / CRM) 5 – 25 пользователей 4 vCPU • 8 ГБ RAM • 80 ГБ NVMe -Xms1024m -Xmx3584m
Enterprise / Аналитический отдел 25 – 100+ сотрудников 8 vCPU • 16 ГБ RAM • 160 ГБ NVMe -Xms2048m -Xmx7168m

Для надежного размещения аналитической платформы рекомендуется выбирать проверенные российские дата-центры с быстрыми накопителями NVMe: скорость дисковых операций напрямую влияет на скорость считывания временных таблиц PostgreSQL при построении сложных срезов.

Рекомендуемые VDS-провайдеры

Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с

Выбор редакции
⚡

Timeweb Cloud — Быстрые NVMe VDS

Оптимальная производительность NVMe-накопителей и скоростной канал до 1 Гбит/с для аналитической базы и мгновенной загрузки тяжелых графиков Metabase.

Конфигурация
2 vCPU 3.3 ГГц • 4 ГБ RAM • 40 ГБ NVMe • Трафик без лимита
Премиум Tier III
🔷

Selectel — Надежная Enterprise-инфраструктура

Изолированные ресурсы в дата-центрах Tier III в Москве и Санкт-Петербурге с гарантированной защитой от DDoS и совместимым S3 для дампов базы.

Конфигурация
2 vCPU • 4 ГБ RAM • 50 ГБ NVMe • Канал 100 Мбит/с
Быстрый старт
🟠

Beget — Простота управления и надежность

Удобная панель управления, автоматические ежедневные снапшоты диска и мгновенная установка Docker в один клик при создании сервера.

Конфигурация
2 vCPU • 4 ГБ RAM • 30 ГБ NVMe • Безлимитный трафик

6. Первый запуск: инициализация администратора и защита учетных записей

После успешного запуска контейнеров и настройки Nginx перейдите в браузере по адресу вашего домена https://bi.yourdomain.ru. Вас встретит стартовый мастер первоначальной настройки Metabase:

  1. Выбор языка: выберите «Русский» (интерфейс Metabase полностью переведен, включая подсказки конструктора запросов).
  2. Создание учетной записи администратора: укажите имя, фамилию, рабочий корпоративный email и сгенерируйте сложный пароль не менее чем из 16 символов с помощью генератора паролей SysKit. Избегайте использования банальных логинов admin или root.
  3. Подключение базы данных: на первом шаге нажмите «Я сделаю это позже» (I'll add my data later), чтобы сначала завершить настройку базовой безопасности системы.
  4. Сбор данных и телеметрия: снимите галочку с отправки анонимных данных разработчикам (мы также принудительно заблокировали ее переменной MB_ANON_TRACKING_ENABLED=false на уровне контейнера).

Сразу после входа в панель перейдите в раздел Настройки администратора (Admin settings) → Параметры (Settings) → Аутентификация:

  • Двухфакторная аутентификация (2FA / TOTP): обязательно активируйте обязательный ввод 6-значного кода из приложений Google Authenticator или Яндекс Ключ для всех пользователей с правами администратора.
  • Таймаут неактивной сессии: установите принудительное завершение веб-сессии через 24–48 часов неактивности (Session Expiration), предотвращая несанкционированный доступ с забытых рабочих станций.
  • Права групп (Permissions): создайте отдельные группы пользователей (например, «Маркетинг», «Бухгалтерия», «Руководство»). По умолчанию встроенная группа All Users должна иметь минимальные права только на чтение общедоступных сводок без права скачивания сырых данных.

7. Безопасное подключение боевых баз данных в режиме Read-Only

Главная ошибка начинающих администраторов — подключение Metabase к рабочей базе данных с учетной записью суперпользователя (postgres или root). Это несет колоссальные риски: случайный запрос на обновление или зависшая тяжелая выборка с декартовым произведением строк может заблокировать таблицы в боевых транзакциях интернет-магазина. Подключение выполняется исключительно через изолированного пользователя с правами SELECT и жестким лимитом времени выполнения запросов.

Для PostgreSQL (боевая база магазина или CRM):

Подключаемся к PostgreSQL через терминал и создаем роль с изолированными правами и принудительным лимитом времени выполнения запроса в 30 секунд:

-- Создание пользователя только для чтения
CREATE ROLE metabase_ro WITH LOGIN PASSWORD 'Secr3t_Metabase_RO_Pass!2026';

-- Разрешение на подключение к анализируемой базе данных
GRANT CONNECT ON DATABASE shop_production TO metabase_ro;

-- Переход в контекст целевой базы данных
\c shop_production

-- Предоставление прав на чтение схемы и всех существующих таблиц
GRANT USAGE ON SCHEMA public TO metabase_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO metabase_ro;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO metabase_ro;

-- Автоматическое назначение прав SELECT на любые новые таблицы в будущем
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO metabase_ro;

-- Защита боевой базы: принудительный обрыв любого запроса Metabase дольше 30 секунд
ALTER ROLE metabase_ro SET statement_timeout = '30s';

Для MySQL / MariaDB:

-- Создание пользователя с доступом только на чтение
CREATE USER 'metabase_ro'@'%' IDENTIFIED BY 'Secr3t_Metabase_RO_Pass!2026';

-- Выдача прав строго на выборку данных и просмотр представлений
GRANT SELECT, SHOW VIEW ON shop_production.* TO 'metabase_ro'@'%';

FLUSH PRIVILEGES;

Важное отличие MySQL от PostgreSQL: в MySQL директива SET GLOBAL max_execution_time применяется глобально ко всем запросам всех пользователей на сервере, что может привести к нежелательному обрыву легитимных тяжелых операций интернет-магазина. Поэтому для MySQL таймаут изолируется строго на уровне сессии подключения Metabase: в настройках источника данных в интерфейсе Metabase (блок Advanced options → Additional JDBC connection string options) укажите параметр:

sessionVariables=max_execution_time=30000

Это ограничит время выполнения аналитических выборок ровно 30 секундами только для соединений Metabase, гарантируя бесперебойную работу боевых клиентских транзакций. Для высоконагруженных проектов с тысячами заказов в день подключение Metabase рекомендуется выполнять к отдельной Read-Only реплике СУБД.

Подключение в интерфейсе Metabase:

В панели Metabase открываем Admin → Databases → Add database:

  • Database type: выберите PostgreSQL или MySQL.
  • Display name: наглядное имя (например, «Интернет-магазин (Production RO)»).
  • Host: IP-адрес сервера базы данных (или имя хоста в Docker-сети).
  • Port: стандартный 5432 (PostgreSQL) или 3306 (MySQL).
  • Database name: shop_production.
  • Username / Password: созданный пользователь metabase_ro.
  • Advanced options: обязательно включите опцию «Периодическое сканирование схемы» (Sync schema) в ночное время (например, в 03:00), чтобы Metabase не нагружала СУБД частым анализом метаданных в разгар рабочего дня.

После сохранения источника данных перейдите в подраздел Admin → Data Model. Здесь вы можете скрыть из аналитического конструктора технические служебные колонки (например, хэши паролей password_hash, токены сессий и персональные номера телефонов), защитив данные в строгом соответствии с требованиями 152-ФЗ.

8. Построение дашбордов, визуальные запросы без SQL и когортный анализ

Основное преимущество Metabase — интерактивный конструктор вопросов (Question Builder), который позволяет анализировать продажи даже сотрудникам без знания синтаксиса SQL:

Пример 1: Построение графика ежедневной выручки интернет-магазина

  1. Нажмите «+ Новый» (New) → «Вопрос» (Question) и выберите таблицу orders (Заказы).
  2. В блоке Фильтр (Filter) добавьте условие: status = 'delivered' и created_at: Предыдущие 30 дней.
  3. В блоке Суммировать (Summarize) выберите агрегацию: Сумма (Sum) от поля total_amount.
  4. В блоке Группировать по (Group by) укажите дату: created_at: По дням.
  5. Нажмите «Визуализация» и переключитесь на «Линейный график» (Line Chart) или «Диаграмму с областями». Система мгновенно отобразит динамику выручки по дням со средним чеком.

Пример 2: Когортный анализ удержания клиентов (Retention)

Для понимания того, как часто покупатели возвращаются за повторными заказами, в Metabase используется визуальный сводный отчет (Pivot Table):

  • Строки сводной таблицы: месяц первой покупки клиента (когорта).
  • Колонки: порядковый номер последующего месяца (+1, +2, +3 мес.).
  • Значения ячеек: процент пользователей когорты, совершивших повторный заказ в указанный интервал.
  • Цветовая тепловая карта (Heatmap) наглядно подсветит, в какой именно месяц происходит основной отток покупателей.

Все полученные графики объединяются в единый интерактивный Дашборд руководителя (Executive Dashboard). На дашборд выносятся ключевые метрики (KPI карточки с выручкой за сегодня), графики динамики заказов, топ-10 популярных товаров и глобальный фильтр по диапазону дат, переключающий все графики одновременно одним кликом.

9. Автоматизация отчетов: рассылка сводок в Telegram и регламент бэкапов

Руководству и операционным менеджерам удобнее получать ключевые цифры прямо в Telegram, не заходя каждый день в веб-интерфейс. В современной архитектуре Metabase (v0.50+, v0.64 LTS, v0.65+) официальным и гарантированно стабильным способом программной выгрузки метрик является REST API агрегации данных: эндпоинт POST /api/card/:id/query/json. Он возвращает точные вычисленные показатели (суммарная выручка, число оформленных заказов, средний чек), которые за секунду форматируются в наглядную утреннюю сводку для Telegram-канала или чата руководителей.

Для безопасного хранения учетных записей не прописывайте пароли открытым текстом в скриптах — сохраните их в защищенном файле конфигурации /opt/metabase/.telegram_report.env с правами доступа только для суперпользователя:

sudo apt install -y jq curl

cat <<EOF | sudo tee /opt/metabase/.telegram_report.env
METABASE_URL="https://bi.yourdomain.ru"
MB_USER="admin@yourdomain.ru"
MB_PASSWORD="YourStrongAdminPassword2026"
CARD_ID="1"
TELEGRAM_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRstuVWXyz"
TELEGRAM_CHAT_ID="-1001234567890"
EOF

sudo chmod 600 /opt/metabase/.telegram_report.env

Создаем автоматический скрипт /opt/metabase/send_telegram_report.sh с надежным извлечением метрик через jq:

#!/usr/bin/env bash
set -euo pipefail

# Загрузка изолированных учетных данных
CONFIG_FILE="/opt/metabase/.telegram_report.env"
if [[ ! -f "${CONFIG_FILE}" ]]; then
    echo "Ошибка: Конфигурационный файл ${CONFIG_FILE} не найден" >&2
    exit 1
fi
# shellcheck source=/dev/null
source "${CONFIG_FILE}"

# 1. Авторизация в REST API Metabase (или передача постоянного ключа X-API-KEY)
AUTH_RESPONSE=$(curl -s -X POST "${METABASE_URL}/api/session" \
  -H "Content-Type: application/json" \
  -d "{\"username\": \"${MB_USER}\", \"password\": \"${MB_PASSWORD}\"}")

SESSION_TOKEN=$(echo "${AUTH_RESPONSE}" | jq -r '.id // empty')
if [[ -z "${SESSION_TOKEN}" ]]; then
    echo "Ошибка аутентификации в Metabase API: ${AUTH_RESPONSE}" >&2
    exit 1
fi

# 2. Выгрузка суточных агрегированных метрик через официальный эндпоинт query/json
METRICS_JSON=$(curl -s -X POST "${METABASE_URL}/api/card/${CARD_ID}/query/json" \
  -H "X-Metabase-Session: ${SESSION_TOKEN}")

# 3. Извлечение ключевых показателей через jq (выручка, число заказов, средний чек)
TOTAL_REVENUE=$(echo "${METRICS_JSON}" | jq -r '.[0].total_revenue // .[0].sum // "0"')
ORDERS_COUNT=$(echo "${METRICS_JSON}" | jq -r '.[0].orders_count // .[0].count // "0"')
AVG_CHECK=$(echo "${METRICS_JSON}" | jq -r '.[0].avg_check // "0"')
YESTERDAY=$(date -d "yesterday" +%d.%m.%Y 2>/dev/null || date -v-1d +%d.%m.%Y)

# 4. Формирование наглядного текста сводки
MESSAGE=$(cat <<EOF
📊 Сводка продаж интернет-магазина за ${YESTERDAY}:
💰 Выручка: ${TOTAL_REVENUE} ₽
📦 Оформлено заказов: ${ORDERS_COUNT}
💳 Средний чек: ${AVG_CHECK} ₽
🔗 Открыть дашборд: ${METABASE_URL}
EOF
)

# 5. Отправка форматированного сообщения в Telegram-канал
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
     --data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
     --data-urlencode "text=${MESSAGE}" > /dev/null

Совет по безопасности: в современных версиях Metabase (v0.50+) в разделе Admin → Settings → Authentication → API Keys можно сгенерировать постоянный API-ключ. В этом случае шаг авторизации через логин и пароль исключается, а в запрос выгрузки графика достаточно передать заголовок -H "X-API-KEY: mb_...".

Делаем скрипт исполняемым и добавляем его в планировщик cron для ежедневной отправки в 09:00 утра:

sudo chmod 700 /opt/metabase/send_telegram_report.sh

# Добавление задания в crontab
(crontab -l 2>/dev/null; echo "0 9 * * * /opt/metabase/send_telegram_report.sh >/dev/null 2>&1") | crontab -

Регламент резервного копирования метабазы

Вся ценность инсталляции Metabase сосредоточена в ее внутренней базе PostgreSQL (настроенные вопросы, формулы метрик, дашборды и права пользователей). Для создания ежедневного дампа метабазы перенаправляем стандартный вывод pg_dump напрямую в файл на хосте (исключая сохранение дампа внутри изолированного контейнера), после чего архивируем его для отправки в объектное S3-хранилище (например, с использованием Kopia и дедупликации):

# Создание локального каталога бэкапов на хосте
sudo mkdir -p /var/backups

# Создание горячего дампа метабазы с прямой записью потока данных на хост
sudo docker exec metabase_postgres pg_dump -U metabase_user -d metabase_app -F c -b > /var/backups/metabase_$(date +%Y%m%d_%H%M%S).dump

# Ротация локальных архивов старше 30 дней
find /var/backups/ -name "metabase_*.dump" -mtime +30 -delete

Чек-лист системного администратора для запуска Metabase в Production:

  1. В манифесте Docker Compose используется внешний контейнер postgres:16-alpine вместо встроенной базы H2.
  2. В файле .env задан постоянный 32-байтный криптографический ключ MB_ENCRYPTION_SECRET_KEY.
  3. Параметры памяти JVM зафиксированы через JAVA_OPTS и соответствуют лимиту mem_limit в Docker Compose.
  4. Порт 3000 привязан строго к 127.0.0.1 и закрыт от прямого внешнего доступа через файрвол UFW.
  5. В Nginx настроен защищенный протокол HTTPS, протоколы TLSv1.2/1.3 и таймауты проксирования увеличены до 300 секунд.
  6. Все боевые базы данных подключены через отдельную учетную запись metabase_ro строго с правами SELECT.
  7. Для роли metabase_ro в PostgreSQL задан statement_timeout = '30s', а в MySQL передан параметр сессии sessionVariables=max_execution_time=30000.
  8. В модели данных (Data Model) скрыты служебные поля, пароли и персональные данные клиентов.
  9. Для учетных записей администраторов включена двухфакторная аутентификация TOTP.
  10. Настроено ежедневное резервное копирование базы metabase_app в изолированное S3-хранилище.

Вопросы и ответы (FAQ)

Популярные вопросы вебмастеров и сисадминов по данной теме

Почему нельзя использовать стандартную встроенную базу H2 для Metabase в production?
По умолчанию при первом запуске без переменных MB_DB_* Metabase создает локальный файл базы данных H2 внутри контейнера. Встроенная H2 предназначена исключительно для ознакомительного запуска: при внезапной перезагрузке контейнера или сбое питания файл H2 часто необратимо повреждается, она не поддерживает параллельные транзакции при росте числа пользователей и блокирует масштабирование. Переход на выделенный инстанс PostgreSQL 16 обеспечивает полную транзакционную надежность, поддержку пула соединений и возможность снятия горячих дампов через pg_dump без остановки сервиса.
Не замедлит ли Metabase работу основного интернет-магазина или CRM?
При правильной архитектурной настройке — нет. Подключение Metabase к боевой базе данных настраивается строго через отдельного служебного пользователя с правами SELECT (Read-Only) и обязательной директивой statement_timeout = '30s' (или max_execution_time для MySQL). Это гарантирует, что даже самый тяжелый ошибочный запрос аналитика будет принудительно прерван движком СУБД до того, как исчерпает ресурсы CPU или заблокирует строки в боевых транзакциях. Для высоконагруженных проектов рекомендуется подключать Metabase к read-only реплике базы данных.
Зачем нужна переменная MB_ENCRYPTION_SECRET_KEY и можно ли ее сменить позже?
Переменная MB_ENCRYPTION_SECRET_KEY задает 32-байтный криптографический ключ, с помощью которого Metabase шифрует пароли подключения ко всем внешним базам данных (PostgreSQL, MySQL, ClickHouse) по алгоритму AES-256-GCM. Если ключ не задан, учетные данные хранятся в открытом виде в таблицах метабазы. Менять ключ после подключения баз данных нельзя: старые пароли расшифровать не удастся, и администратору придется вручную переподключать каждый источник данных. Ключ генерируется один раз утилитой openssl rand -base64 32 и надежно сохраняется в файле .env.
Как настроить рассылку отчетов в Telegram, если в Metabase нет прямого коннектора к Telegram?
Встроенный механизм подписок (Subscriptions) в Metabase из коробки ориентирован на Email и вебхуки Slack. Для Telegram самым надежным и производительным решением является использование официального REST API агрегированных данных: эндпоинт POST /api/card/{id}/query/json. Легковесный скрипт в cron запрашивает суточные метрики (выручка, количество заказов, средний чек), форматирует их в наглядную текстовую сводку с эмодзи и отправляет в Telegram-канал руководства через sendMessage официального Telegram Bot API.
Сколько оперативной памяти требуется Metabase при 5–10 активных пользователях?
Сам контейнер Metabase работает на базе виртуальной машины Java (JVM). Для стабильной работы контейнеру Metabase необходимо выделить не менее 1.5–2 ГБ оперативной памяти через директиву JAVA_OPTS='-Xms512m -Xmx1536m' и лимит mem_limit в Docker Compose. Внутренняя метабаза PostgreSQL 16 потребляет около 250–350 МБ RAM. Таким образом, комфортный минимум для VDS составляет 4 ГБ RAM: это полностью исключает срабатывание ядра Linux OOM Killer при генерации сложных сводных отчетов.

Читайте также в блоге SysKit

Смежные руководства и полезные технические статьи