Rybbit на VPS: приватная аналитика вместо Google Analytics

Почему вебмастера уходят с Google Analytics

Причин обычно четыре, и денег среди них нет — GA4 бесплатный.

Отсюда и спрос на приватные счётчики: небольшой скрипт, никаких cookie, простые понятные отчёты и база данных, которая физически стоит у вас.

Что такое Rybbit

Rybbit — открытая веб-аналитика под лицензией AGPL-3.0, самый быстрорастущий проект в своей нише: 12,6 тысячи звёзд на GitHub, актуальная версия v2.8.0 от 27 июля 2026 года. Есть платное облако разработчиков и есть полноценная самостоятельная установка — о ней и речь.

Что вы получаете после установки:

• обычный дашборд: посетители, сессии, страницы, источники, страны, устройства, браузеры — всё на одном экране без конструктора отчётов;
• цели и воронки — «сколько людей дошло от статьи до формы заявки и где отвалилось»;
• записи сессий — видео того, как посетитель двигал мышь и кликал по странице (выключено по умолчанию);
• карта путей по сайту, отчёт по возвращаемости, скорость страниц (Core Web Vitals);
• отслеживание ошибок JavaScript у реальных посетителей;
• публичный дашборд — можно открыть статистику клиенту или читателям по ссылке;
• сколько угодно сайтов и пользователей на одной установке.

Как Rybbit узнаёт посетителей без cookie

Это главное, что стоит понять до установки: от механики зависит и юридическая сторона, и то, как читать цифры.

Классический счётчик кладёт в браузер cookie с идентификатором и потом узнаёт его. Rybbit не кладёт ничего — ни cookie, ни записи в localStorage. Вместо этого сервер при каждом событии считает короткий хеш:

user_id = sha256(IP-адрес + User-Agent) → первые 12 символов

Одинаковый IP и один и тот же браузер дают одинаковый хеш — значит, это один и тот же посетитель. Сам IP-адрес при этом в базу не записывается: он нужен только для определения страны с городом и для расчёта хеша. Сохранение IP включается отдельным переключателем, но по умолчанию он выключен — и включать его без веской причины не надо.

В настройках сайта есть переключатель User ID Salting: он добавляет к хешу секретную «соль», которая меняется каждые сутки. С ним связать посетителя между вчера и сегодня невозможно даже теоретически — приватность выше. Но вместе с этим ломается отчёт о возвращаемости: каждый день все посетители становятся новыми. По умолчанию соль выключена, и для обычного контентного сайта это правильный выбор.

Rybbit, Plausible, Umami, Matomo и Метрика: что выбрать

Как выбирать. Нужен простой счётчик посещаемости и сервер поменьше — берите Umami: одна база, один контейнер, минимум обслуживания. Нужен полный набор инструментов веб-мастера — цели, воронки, записи сессий — и не жалко 4 ГБ памяти, берите Rybbit. Matomo имеет смысл, когда нужна максимально близкая замена «большой» аналитике с электронной коммерцией и привычным интерфейсом, и вы готовы обслуживать PHP-приложение.

Про Яндекс.Метрику. Она бесплатная, точная и с Вебвизором — если вопросов к передаче данных наружу нет, это рабочий вариант, и статью можно закрывать. Rybbit ставят тогда, когда данные не должны уходить никому вообще, когда аудитория не только российская, или когда счётчик нужен без cookie-баннера. Никто не мешает держать оба.

Что понадобится

• VPS от 2 ГБ RAM, лучше 4 ГБ. Ubuntu 24.04 LTS, диск от 20 ГБ. Архитектура x86-64 — на ARM ClickHouse запускается не везде.
• Поддомен для панели, в примерах — stats.example.com. Отдельный домен покупать не нужно, хватит поддомена вашего же сайта.
• Свободные порты 80 и 443. Если на сервере уже стоит Nginx или Apache — это не помеха, ниже есть отдельный раздел для такого случая.

Отдельная установка обслуживает любое количество сайтов, так что ставить её на каждый проект не нужно — одной хватит на все.

Шаг 1. Готовим сервер: Docker, DNS и память

Ставим Docker официальным скриптом — он же поставит плагин Compose:

sudo apt update && sudo apt install -y git dnsutils
curl -fsSL https://get.docker.com | sudo sh

Теперь в панели вашего регистратора добавьте A-запись, которая указывает поддомен на IP-адрес сервера:

Тип   Имя     Значение
A     stats   203.0.113.10

Подождите, пока запись разойдётся, и проверьте с сервера — должен вернуться его же IP-адрес:

dig +short stats.example.com

Если включён файрвол, откройте порты для веб-сервера:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Если у сервера ровно 2 ГБ — сделайте это до установки

Два гигабайта — это работающий минимум, но без запаса: ClickHouse при старте забирает память агрессивно и на голом сервере может уронить сам себя. Файл подкачки снимает вопрос за минуту:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

На сервере с 4 ГБ и больше этот шаг можно пропустить.

Шаг 2. Установка Rybbit

Скачиваем репозиторий в /opt/rybbit и запускаем установочный скрипт, указав свой поддомен:

sudo git clone https://github.com/rybbit-io/rybbit.git /opt/rybbit
cd /opt/rybbit
sudo chmod +x *.sh
sudo ./setup.sh stats.example.com

Что делает скрипт:

• создаёт файл /opt/rybbit/.env с вашим доменом и случайным секретным ключом;
• скачивает готовые образы и поднимает шесть контейнеров: базы ClickHouse, PostgreSQL и Redis, бэкенд, интерфейс и веб-сервер Caddy;
• Caddy сам получает сертификат Let’s Encrypt и дальше сам его продлевает — certbot и конфиги Nginx не нужны.

Скачивание образов занимает 2–5 минут. Проверяем, что все шесть контейнеров живы:

sudo docker ps

В колонке STATUS у clickhouse, postgres и redis должно быть healthy. Если какой-то контейнер перезапускается по кругу — смотрите его логи, например:

sudo docker logs --tail 50 clickhouse

Шаг 3. Первый вход и закрытие регистрации

Откройте в браузере https://stats.example.com/signup и создайте аккаунт администратора. Если страница не открывается по HTTPS, дайте Caddy минуту на выпуск сертификата и посмотрите, что он пишет:

sudo docker logs --tail 30 caddy

Откройте /opt/rybbit/.env и поменяйте одну строку:

DISABLE_SIGNUP=true

Заодно, раз уж речь о приватности: своя установка по умолчанию отправляет разработчикам обезличенную статистику — версию и число строк в таблицах, без данных о посетителях. Отключается там же, отдельной строкой:

DISABLE_TELEMETRY=true

Применяем — скрипт перезапускает стек с новыми переменными:

cd /opt/rybbit && sudo ./restart.sh

Коллег после этого можно приглашать изнутри панели: Settings → Organization. Ваш собственный вход, разумеется, продолжает работать.

Шаг 4. Ставим счётчик на сайт

В панели нажмите Add Site, укажите домен сайта — и Rybbit покажет готовый тег. Выглядит он так:

<script
  src="https://stats.example.com/api/script.js"
  data-site-id="1"
  defer
></script>

data-site-id у каждого сайта свой — берите его из панели, не из примера. Скрипт весит около 33 КБ, в сжатом виде — примерно 10 КБ, и грузится с атрибутом defer, то есть отрисовку страницы не задерживает.

Если сайт на WordPress

Проще всего плагином WPCode: Плагины → Добавить новый → найти WPCode → установить → в разделе Header вставить тег из панели Rybbit и сохранить. Правки в тему не нужны, и обновление темы ничего не сломает.

Если плагины ставить не хочется, добавьте в functions.php дочерней темы:

function rybbit_analytics_script() {
    echo '<script src="https://stats.example.com/api/script.js" data-site-id="1" defer></script>';
}
add_action('wp_head', 'rybbit_analytics_script');

В родительскую тему код класть нельзя — первое же обновление его сотрёт. Подробнее про сам сервер под WordPress — в статье WordPress на VPS.

Проверка. Откройте сайт в обычном окне браузера (не в режиме инкогнито с блокировщиком) и загляните в панель Rybbit: в шапке дашборда есть счётчик посетителей онлайн, он оживёт за несколько секунд, а сам визит появится в разделе Sessions. Если тихо, откройте консоль браузера клавишей F12, введите rybbit и нажмите Enter: если в ответ ошибка, скрипт не загрузился.

Если на сервере уже работает Nginx

Встроенному Caddy нужны порты 80 и 443. Если их уже занял ваш веб-сервер, он просто не поднимется. В этом случае Rybbit ставится без Caddy, а наружу его отдаёт существующий Nginx. Отличие ровно в одном флаге:

sudo git clone https://github.com/rybbit-io/rybbit.git /opt/rybbit
cd /opt/rybbit
sudo chmod +x *.sh
sudo ./setup.sh stats.example.com --no-webserver

Откройте /opt/rybbit/.env и приведите две строки к такому виду:

HOST_BACKEND_PORT="127.0.0.1:3001:3001"
HOST_CLIENT_PORT="127.0.0.1:3002:3002"

cd /opt/rybbit && sudo ./restart.sh

Теперь оба порта слушают только сам сервер. Создаём конфиг Nginx:

server {
    listen 80;
    server_name stats.example.com;

    client_max_body_size 10M;

    location /api/ {
        proxy_pass http://127.0.0.1:3001;
        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;
    }

    location / {
        proxy_pass http://127.0.0.1:3002;
        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;
    }
}

Включаем и выпускаем сертификат:

sudo ln -s /etc/nginx/sites-available/stats.example.com /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d stats.example.com

Заголовок X-Real-IP здесь не украшение: именно из него Rybbit берёт адрес посетителя для определения страны. Забудете строку — вся аудитория окажется из города, где стоит ваш сервер. Строка client_max_body_size 10M нужна для записей сессий: без неё браузер будет получать ошибку 413 при отправке длинных записей.

Проксирование счётчика через свой домен

Своя установка уже теряет меньше визитов, чем облачный счётчик: вашего поддомена нет в готовых списках блокировщиков, в отличие от адресов Google и Яндекса. Но для браузера это всё ещё запрос на посторонний домен, а часть блокировщиков и режимов приватности режут такие запросы по общим правилам.

Лечится тем, что скрипт раздаётся с адреса самого сайта. Rybbit специально сделан под это: он смотрит, откуда его загрузили, отрезает от адреса хвост /script.js и дальше шлёт данные по тому же пути. То есть достаточно пробросить один префикс.

Добавьте в конфиг Nginx того сайта, который считаете (не панели), внутрь блока server:

location /stats/ {
    proxy_pass https://stats.example.com/api/;
    proxy_set_header Host stats.example.com;
    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_ssl_server_name on;
    client_max_body_size 10M;
}

sudo nginx -t && sudo systemctl reload nginx

После этого замените в теге адрес скрипта на путь своего сайта:

<script
  src="https://example.com/stats/script.js"
  data-site-id="1"
  defer
></script>

Проверить можно прямо с сервера — в ответ должен прийти код 200:

curl -s -o /dev/null -w "%{http_code}\n" https://example.com/stats/script.js

Последний штрих: в панели откройте настройки сайта и включите First-Party Proxy. Этот переключатель говорит Rybbit, что перед ним стоит ваш собственный прокси и заголовкам с IP-адресом посетителя можно доверять.

Ресурсы: сколько ест и как не забить диск

Основной потребитель памяти — ClickHouse: он рассчитан на аналитику больших объёмов и резервирует память заранее. Отсюда и минимум в 2 ГБ. Посмотреть реальное потребление на своём сервере:

sudo docker stats --no-stream

Если сервер на 2 ГБ, кроме файла подкачки из первого шага уменьшите число рабочих процессов бэкенда: по умолчанию их четыре, для небольшого сайта хватит одного. Добавьте строку в /opt/rybbit/.env и перезапустите:

CLUSTER_WORKERS=1

cd /opt/rybbit && sudo ./restart.sh

Диск: главная ловушка

Обычные события занимают мало — ClickHouse сжимает их очень плотно. Всё меняют записи сессий: одна запись весит примерно в тысячу раз больше, чем событие о просмотре страницы, и хранится она в той же базе. Именно поэтому эта функция выключена по умолчанию — включайте её осознанно и следите за местом.

Что сколько занимает по факту (frog — пароль ClickHouse по умолчанию; обе базы слушают только сам сервер, наружу они не торчат):

sudo docker exec clickhouse clickhouse-client --password frog \
  --query "SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size
           FROM system.parts WHERE active AND database = 'analytics'
           GROUP BY table ORDER BY sum(bytes_on_disk) DESC"

Сроки хранения по умолчанию:

Если записи сессий съедают место быстрее, чем хотелось бы, сократите срок хранения до двух недель:

sudo docker exec clickhouse clickhouse-client --password frog --database analytics \
  --query "ALTER TABLE session_replay_events
           MODIFY TTL toDateTime(timestamp) + INTERVAL 14 DAY"

Обновление и резервная копия

Обновление — одна команда, она сама заберёт новый код и образы и пересоздаст контейнеры:

cd /opt/rybbit && sudo ./update.sh

Резервная копия состоит из трёх частей. Первая и самая важная — /opt/rybbit/.env: там лежит ключ BETTER_AUTH_SECRET, от которого зависят и входы пользователей, и идентификаторы посетителей. Потеряете его — потеряете связь с накопленной статистикой. Вторая — настройки сайтов и пользователи в PostgreSQL:

sudo docker exec postgres pg_dump -U frog -d analytics -Fc \
  | sudo tee /root/rybbit-pg-$(date +%F).dump > /dev/null

Третья — сами данные аналитики в ClickHouse. Их проще всего забрать копией каталога, для этого стек нужно ненадолго остановить:

cd /opt/rybbit
sudo docker compose --profile with-webserver stop
sudo tar czf /root/rybbit-ch-$(date +%F).tar.gz \
  -C /var/lib/docker/volumes/rybbit_clickhouse-data/_data .
sudo ./restart.sh

Простой — меньше минуты. Как автоматизировать выгрузку копий на внешнее хранилище, описано в статье Restic + rclone: бэкапы VPS в облако.

Частые проблемы