Analytics без Google: Plausible и Umami

Пошаговый гайд по развёртыванию self hosted analytics на Plausible и Umami и интеграции с Next.js. Окончательная настройка займёт примерно 60–120 минут, в зависимости от скорости сети и опыта с Docker.

Self hosted решения решают две главные задачи: контроль над данными и минимизация внешних запросов. При этом они требуют инфраструктуры, резервного копирования и базовых навыков DevOps. Ожидаемая экономия на платных планах и снижение GDPR/локальных рисков делает self hosted аналитики привлекательными для проектов от стартапов до крупных сайтов с трафиком до 100k хитов/день.

Шаг 1: Plausible self-hosted

Задача: развернуть Plausible Analytics 1.46 (релиз 2025) с PostgreSQL и Redis через Docker Compose; домен plausible.example.com, TLS через certbot.

Команды и конфигурация (удобно на Ubuntu 24.04):

mkdir -p ~/plausible && cd ~/plausible
cat > docker-compose.yml <<'YAML'
version: '3.7'
services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: plausible
      POSTGRES_PASSWORD: plausible_pass
      POSTGRES_DB: plausible_prod
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    restart: unless-stopped
  redis:
    image: redis:7-alpine
    restart: unless-stopped
  plausible:
    image: plausible/analytics:1.46
    environment:
      DATABASE_URL: postgres://plausible:plausible_pass@postgres:5432/plausible_prod
      REDIS_URL: redis://redis:6379
      SECRET_KEY_BASE: "$(head -c 32 /dev/urandom | base64)"
      PORT: 8000
    ports:
      - "8000:8000"
    depends_on:
      - postgres
      - redis
    restart: unless-stopped
YAML

docker compose up -d --remove-orphans

Пояснение: Docker Compose создаёт три контейнера: PostgreSQL, Redis и Plausible. Образ plausible/analytics:1.46 в 2025 году имеет размаркированный размер ~150 MB. Запуск командой занимает типично 10–40 секунд для pull + 20–60 секунд для инициализации БД в зависимости от сети.

Ожидаемый успешный вывод (после docker compose up -d):

Creating network "plausible_default" with the default driver
Creating plausible_postgres_1 ... done
Creating plausible_redis_1    ... done
Creating plausible_plausible_1 ... done

Типичная ошибка: приложение не стартует из-за неверного SECRET_KEY_BASE или проблем с доступом к PostgreSQL.

Ошибка:
plausible_1  | ERROR: could not connect to server: Connection refused
plausible_1  | Is the server running on host "postgres" (172.18.0.2) and accepting
plausible_1  | TCP/IP connections on port 5432?

Фикс: проверьте логи PostgreSQL и порядок запуска. Выполните:

docker compose logs postgres --tail=100
docker compose ps
# если БД не инициализируется, очистите volume и попробуйте снова
docker compose down -v && docker compose up -d

Шаг 2: Umami альтернатива

Задача: запустить Umami 1.31 (релиз 2026) — лёгкая, single-page self hosted аналитика, на том же сервере, используя PostgreSQL или MySQL. Мы покажем развёртывание с PostgreSQL.

Команды и конфигурация:

mkdir -p ~/umami && cd ~/umami
cat > docker-compose.yml <<'YAML'
version: '3.7'
services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami_pass
      POSTGRES_DB: umami_db
    volumes:
      - ./pgdata:/var/lib/postgresql/data
  umami:
    image: ghcr.io/umami-software/umami:1.31
    env_file: .env
    ports:
      - "3000:3000"
    depends_on:
      - db
    restart: unless-stopped
YAML

cat > .env <<'ENV'
DATABASE_URL=postgresql://umami:umami_pass@db:5432/umami_db
SECRET_KEY=umami_secret_$(head -c 16 /dev/urandom | base64)
ENV

docker compose up -d --build

Пояснение: Umami легче по функционалу, меньше кода для front-end (скрипт клиента ~2.4 KB gz в 2026). Типичный pull и build занимает 20–60 секунд, запуск сервиса 5–15 секунд.

Ожидаемый успешный вывод:

Creating network "umami_default" with the default driver
Creating umami_db_1    ... done
Creating umami_umami_1 ... done

Типичная ошибка: миграции базы не выполнены или переменная окружения DATABASE_URL неверна.

Ошибка в логах umami_1:
Error: connect ECONNREFUSED 127.0.0.1:5432
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1145:16)

Фикс: проверьте, что db запускается, и используйте правильный хост в DATABASE_URL. Если база пустая, выполните миграции вручную:

docker compose exec umami node ./build/index.js migrate

Шаг 3: интеграция в Next.js

Задача: внедрить трекинг страниц и событий в Next.js 14 (релиз 2025) с минимальным влиянием на перформанс. Покажем два варианта: подключение клиентского скрипта и отправка событий с сервера (server-side).

Вариант A — вставка скрипта Plausible/Umami в app/layout.tsx (app router):

// app/components/AnalyticsClient.tsx
'use client'
import { useEffect } from 'react'

export default function AnalyticsClient() {
  useEffect(() => {
    const script = document.createElement('script')
    script.defer = true
    script.dataset.domain = 'your-domain.com'
    script.src = 'https://plausible.example.com/js/plausible.js'
    document.body.appendChild(script)
    return () => { document.body.removeChild(script) }
  }, [])
  return null
}

// app/layout.tsx
import AnalyticsClient from './components/AnalyticsClient'
export default function RootLayout({ children }) {
  return (
    {children}
  )
}

Ожидаемый вывод в браузерной консоли при успешной загрузке скрипта:

plausible.js loaded
plausible: tracking pageview

Типичная ошибка: скрипт блокируется CORS или по CSP, или указан неверный путь к скрипту (HTTP/HTTPS). Фикс: проверьте CSP заголовки (Content-Security-Policy) в Nginx и используйте протокол-совместимый URL (https). Пример CSP для Nginx:

add_header Content-Security-Policy "default-src 'self'; script-src 'self' https://plausible.example.com";

Вариант B — server-side трекинг для переходов, которые должны быть анонимными или не доступны клиенту (Next.js API route):

// app/api/track/route.ts (Next.js 14, Route Handlers)
import { NextResponse } from 'next/server'

export async function POST(req) {
  const payload = await req.json()
  // отправляем событие в Plausible /api/event
  await fetch('https://plausible.example.com/api/event', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_PLAUSIBLE_TOKEN'
    },
    body: JSON.stringify(payload)
  })
  return NextResponse.json({ status: 'ok' })
}

Ожидаемый вывод при вызове API из клиентского кода:

Response: {"status":"ok\