Перейти к содержимому

Статья 129 из 141

Гайды

Umami на VPS: своя веб-аналитика без cookie в Docker с PostgreSQL

Umami — открытая веб-аналитика, которую вы держите на своём сервере. Она считает посетителей, просмотры, источники трафика, браузеры и страны. Umami не ставит cookie и не собирает персональные данные, а все данные остаются в вашей базе. Подойдёт как лёгкая замена Google Analytics или Яндекс Метрики для блога, лендинга или небольшого магазина. Интерфейс переведён на русский.

Альтернатива: Plausible Community Edition, открытая версия Plausible Analytics для своего сервера. Кроме PostgreSQL ей нужна ClickHouse, поэтому она требует больше памяти.

Ресурс Минимум Комфортно
vCPU 1 2
RAM 1 ГБ 2 ГБ
Диск 5 ГБ 10 ГБ и больше при большом трафике

После запуска Umami и PostgreSQL заняли около 260 МБ памяти. Образ Umami весит около 1,3 ГБ. Ещё нужны:

  • поддомен, например stats.example.com, с A-записью на IP сервера (DNS);
  • Docker и Docker Compose;
  • Nginx и certbot.

Файл основан на docker-compose.yml из официального репозитория Umami. Порт приложения привязан к 127.0.0.1, база наружу не открыта.

Окно терминала
mkdir -p /opt/umami && cd /opt/umami

Создайте .env с секретами:

Окно терминала
cat > .env <<EOF
APP_SECRET=$(openssl rand -hex 32)
TWO_FACTOR_ENCRYPTION_KEY=$(openssl rand -hex 32)
DB_PASSWORD=$(openssl rand -hex 16)
EOF
chmod 600 .env

APP_SECRET обязателен, без него контейнер не запустится. TWO_FACTOR_ENCRYPTION_KEY нужен, чтобы пользователи могли включить двухфакторную аутентификацию.

Окно терминала
nano docker-compose.yml
services:
umami:
image: ghcr.io/umami-software/umami:latest
ports:
- "127.0.0.1:3000:3000"
environment:
DATABASE_URL: postgresql://umami:${DB_PASSWORD}@db:5432/umami
APP_SECRET: ${APP_SECRET}
TWO_FACTOR_ENCRYPTION_KEY: ${TWO_FACTOR_ENCRYPTION_KEY}
depends_on:
db:
condition: service_healthy
init: true
restart: always
healthcheck:
test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
interval: 5s
timeout: 5s
retries: 5
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: umami
POSTGRES_USER: umami
POSTGRES_PASSWORD: ${DB_PASSWORD}
volumes:
- umami-db-data:/var/lib/postgresql/data
restart: always
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
interval: 5s
timeout: 5s
retries: 5
volumes:
umami-db-data:
Окно терминала
docker compose up -d
docker compose logs -f umami

При первом запуске Umami сама создаст таблицы. В логе появятся строки All migrations have been successfully applied. и Ready. Проверка:

Окно терминала
curl http://127.0.0.1:3000/api/heartbeat

Ответ {"ok":true} значит, что сервис работает. Если порт 3000 уже занят, например Gitea, поменяйте левую часть: "127.0.0.1:3001:3000".

Конфиг /etc/nginx/sites-available/umami:

server {
listen 80;
server_name stats.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
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;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/umami /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d stats.example.com

Заголовки X-Forwarded-For и X-Real-IP нужны, чтобы Umami видела настоящий IP посетителя. Без них все визиты сольются в один и страна определится неверно. Подробнее: Nginx, Let’s Encrypt.

Откройте https://stats.example.com. Логин по умолчанию: admin, пароль: umami. С версии 3.5 Umami сразу после входа требует сменить пароль: появится окно Change password, дальше без смены не пустит.

Окно смены пароля по умолчанию после первого входа в Umami

Введите текущий пароль umami, новый длинный пароль и подтверждение, нажмите Save.

Интерфейс открывается на английском. Язык меняется на странице https://stats.example.com/settings/preferences: поле Language → «Русский». Там же задайте часовой пояс, иначе графики будут в UTC.

  1. Откройте «Сайты» и нажмите «Добавить сайт».
  2. Укажите имя для себя и домен сайта без https://, например example.com.
  3. Нажмите «Сохранить».

Окно добавления сайта в Umami: имя и домен

Откройте сайт в списке → «Изменить». В блоке «Код отслеживания» лежит готовый фрагмент:

Настройки сайта в Umami: ID сайта и код отслеживания

<script defer src="https://stats.example.com/script.js" data-website-id="ВАШ-ID-САЙТА"></script>

Вставьте его в <head> всех страниц сайта. В WordPress это делается через тему или плагин для вставки кода в шапку. Скрипт загружается с атрибутом defer и не задерживает отрисовку страницы.

Некоторые блокировщики рекламы режут запросы к script.js и /api/send. Если это важно, переименуйте их переменными окружения TRACKER_SCRIPT_NAME и COLLECT_API_ENDPOINT в docker-compose.yml. После этого обновите код на сайте.

Через минуту после установки кода зайдите на сайт сами и откройте «Сайты» → ваш сайт. На вкладке «Обзор» видно посетителей, посещения, просмотры, отказы и среднее время. Ниже идут страницы, источники переходов, браузеры, ОС, устройства и страны. Счётчик «Онлайн» вверху показывает текущих посетителей.

Отчёт Umami: популярные страницы и источники переходов

В меню слева есть цели, воронки, пути, UTM-метки и отчёт «Реальное время». Чтобы показать статистику без входа, включите публичную ссылку в настройках сайта, блок «Поделиться».

Окно терминала
cd /opt/umami
docker compose pull
docker compose up -d

Миграции базы Umami выполняет сама при старте. На ноябрь 2026 актуальна версия 3.5. Номер версии виден внизу страницы /settings/preferences.

Все данные лежат в PostgreSQL. Дамп базы:

Окно терминала
cd /opt/umami
docker compose exec -T db pg_dump -U umami umami | gzip > /root/umami-$(date +%F).sql.gz

Восстановление в чистую базу:

Окно терминала
gunzip -c /root/umami-2026-11-18.sql.gz | docker compose exec -T db psql -U umami umami

Сохраните также .env: без APP_SECRET и TWO_FACTOR_ENCRYPTION_KEY после восстановления придётся заново входить и настраивать 2FA. Копии храните вне сервера: бэкапы.

Симптом Причина и решение
Контейнер не стартует, в логе про APP_SECRET Нет файла .env рядом с docker-compose.yml или в нём пустой APP_SECRET
Код установлен, а статистика пустая Сайт открыт с включённым блокировщиком рекламы, или запросы шли от ботов и автотестов. Umami по умолчанию отбрасывает ботов, включая headless-браузеры. Проверьте с обычного браузера без блокировщика
Все визиты из одной страны и с одного IP Nginx не передаёт X-Forwarded-For. Добавьте заголовки из примера выше
502 Bad Gateway Umami ещё запускается или упала. Смотрите docker compose logs umami
Ошибка смешанного контента в консоли сайта Сайт на HTTPS, а скрипт подключён по http://. Используйте адрес с https://