Статья 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
Заголовок раздела «Docker Compose»Файл основан на docker-compose.yml из официального репозитория Umami. Порт приложения привязан к 127.0.0.1, база наружу не открыта.
mkdir -p /opt/umami && cd /opt/umamiСоздайте .env с секретами:
cat > .env <<EOFAPP_SECRET=$(openssl rand -hex 32)TWO_FACTOR_ENCRYPTION_KEY=$(openssl rand -hex 32)DB_PASSWORD=$(openssl rand -hex 16)EOFchmod 600 .envAPP_SECRET обязателен, без него контейнер не запустится. TWO_FACTOR_ENCRYPTION_KEY нужен, чтобы пользователи могли включить двухфакторную аутентификацию.
nano docker-compose.ymlservices: 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 -ddocker 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".
Nginx и HTTPS
Заголовок раздела «Nginx и HTTPS»Конфиг /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 nginxcertbot --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, новый длинный пароль и подтверждение, нажмите Save.
Интерфейс открывается на английском. Язык меняется на странице https://stats.example.com/settings/preferences: поле Language → «Русский». Там же задайте часовой пояс, иначе графики будут в UTC.
Добавление сайта
Заголовок раздела «Добавление сайта»- Откройте «Сайты» и нажмите «Добавить сайт».
- Укажите имя для себя и домен сайта без
https://, напримерexample.com. - Нажмите «Сохранить».

Код отслеживания
Заголовок раздела «Код отслеживания»Откройте сайт в списке → «Изменить». В блоке «Код отслеживания» лежит готовый фрагмент:
![]()
<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. После этого обновите код на сайте.
Через минуту после установки кода зайдите на сайт сами и откройте «Сайты» → ваш сайт. На вкладке «Обзор» видно посетителей, посещения, просмотры, отказы и среднее время. Ниже идут страницы, источники переходов, браузеры, ОС, устройства и страны. Счётчик «Онлайн» вверху показывает текущих посетителей.

В меню слева есть цели, воронки, пути, UTM-метки и отчёт «Реальное время». Чтобы показать статистику без входа, включите публичную ссылку в настройках сайта, блок «Поделиться».
Обновление
Заголовок раздела «Обновление»cd /opt/umamidocker compose pulldocker compose up -dМиграции базы Umami выполняет сама при старте. На ноябрь 2026 актуальна версия 3.5. Номер версии виден внизу страницы /settings/preferences.
Все данные лежат в PostgreSQL. Дамп базы:
cd /opt/umamidocker 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:// |