Если нужна замена Яндекс Метрике с хранением статистики на своём сервере, подойдёт Matomo On-Premise. Она собирает посещения, источники переходов, события, цели и данные электронной торговли. Сайт при этом можно оставить на прежнем хостинге: на VPS будет работать только аналитика.

Перед переходом проверьте две вещи: используете ли вы Вебвизор и завязаны ли рекламные кампании Яндекс Директа на цели Метрики. Записи сеансов в Matomo для своего сервера требуют платного дополнения, а рекламные интеграции придётся настраивать отдельно. Ниже разберём возможности системы, установку, подключение сайта и проверку результатов.

Когда Matomo подходит для замены Яндекс Метрики

Matomo стоит выбирать, если вам нужны отчёты о посещаемости и конверсиях, несколько сайтов в одном кабинете и контроль над базой статистики. Вы сами выбираете сервер, выдаёте доступ сотрудникам, задаёте срок хранения данных и организуете резервное копирование.

У системы есть два варианта: On-Premise устанавливается на ваш сервер, Matomo Cloud работает по подписке у разработчика. В этой инструкции рассматривается On-Premise. Бесплатное ядро не означает нулевых расходов: остаются VPS, резервные копии и обслуживание.

Актуальные возможности альтернатив можно сверить в документации Umami, описании Plausible Community Edition и на сайте Microsoft Clarity.

Какие функции Matomo бесплатны, а за какие придётся платить

Условия дополнений проверяйте до перехода: Marketing Campaigns Reporting, карты и записи сеансов, экспорт рекламных конверсий. Это поможет сравнить полную стоимость, если сейчас вы используете такие возможности в Метрике.

Какой VPS нужен для Matomo и сколько стоит содержание

Для небольшого проекта приложение и базу данных можно разместить на одном VPS. Ниже — ориентиры разработчика, а не гарантия производительности для любого сайта.

Считать нужно не только посетителей: события, скачивания, число сайтов и сегментов тоже создают нагрузку. При количестве действий свыше миллиона в месяц разработчик рекомендует рассматривать разделение базы данных и приложения. Длительное хранение подробных визитов и записи сеансов дополнительно увеличивают объём данных.

В бюджет включите VPS, внешнее хранилище резервных копий, платные дополнения при необходимости и время администратора. Существующий домен можно использовать для адреса вроде analytics.example.com: отдельный домен покупать необязательно.

Что подготовить для самостоятельной установки

Далее приведён пример для нового VPS с Ubuntu 24.04, доступом root по SSH и установленными Docker Engine и Docker Compose. Docker установите из официального репозитория по инструкции для Ubuntu. Команда docker compose version должна показывать версию Compose без ошибки.

Понадобятся три контейнера: Matomo, база MariaDB и Caddy — веб-сервер, который примет HTTPS-запросы и передаст их Matomo. Данные будут храниться в постоянных томах Docker и переживут обычное пересоздание контейнеров.

1. Создайте DNS-запись A для analytics.example.com, указав IPv4 вашего VPS. Запись AAAA добавляйте только при работающем IPv6.
2. На время установки направьте домен прямо на VPS, без CDN и дополнительного прокси. Схема ниже рассчитана на прямое подключение посетителей к Caddy.
3. Обеспечьте доступ к TCP-портам 80 и 443. Если их уже занимает другая панель или веб-сервер, используйте отдельный VPS либо адаптируйте существующий прокси: второй сервер на тех же портах не запустится.

Заменяйте analytics.example.com своим поддоменом во всех примерах. В примере используется образ matomo:5.14.0-apache. Перед новой установкой сверяйте стабильные версии в официальном образе Matomo.

Установка Matomo через Docker Compose

1. Создайте каталог и пароли

Выполняйте команды от root. Подготовьте отдельный каталог и два случайных пароля:

apt-get update
apt-get install -y openssl
install -d -m 700 /opt/matomo
cd /opt/matomo
umask 077
printf 'MATOMO_DB_PASSWORD=%s\nMARIADB_ROOT_PASSWORD=%s\n' \
  "$(openssl rand -hex 24)" "$(openssl rand -hex 24)" > .env

Файл .env содержит секреты: не публикуйте его и не прикладывайте к открытым обращениям. Генерацию выполняют один раз перед первым запуском. Перезапись файла позднее сама по себе не поменяет пароль уже созданной базы.

2. Создайте compose.yaml

Сохраните следующий текст в /opt/matomo/compose.yaml:

name: matomo

services:
  db:
    image: mariadb:10.11
    restart: unless-stopped
    logging:
      driver: local
    environment:
      MARIADB_DATABASE: matomo
      MARIADB_USER: matomo
      MARIADB_PASSWORD: ${MATOMO_DB_PASSWORD}
      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 20s

  app:
    image: matomo:5.14.0-apache
    restart: unless-stopped
    logging:
      driver: local
    environment:
      MATOMO_DATABASE_HOST: db
      MATOMO_DATABASE_DBNAME: matomo
      MATOMO_DATABASE_USERNAME: matomo
      MATOMO_DATABASE_PASSWORD: ${MATOMO_DB_PASSWORD}
      PHP_MEMORY_LIMIT: 512M
    volumes:
      - matomo_data:/var/www/html
    depends_on:
      db:
        condition: service_healthy

  caddy:
    image: caddy:2
    restart: unless-stopped
    logging:
      driver: local
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    depends_on:
      - app

volumes:
  db_data:
  matomo_data:
  caddy_data:
  caddy_config:

База данных не публикует порт в интернет. Контейнеры используют драйвер журналов local с ротацией, чтобы логи не росли бесконечно. Имена томов и каталог проекта сохраняйте при последующих обновлениях. Не используйте для обновления docker compose down -v: ключ -v удаляет тома с данными.

3. Настройте HTTPS и пройдите мастер установки

Создайте /opt/matomo/Caddyfile. На время первичной настройки разрешите вход только со своего внешнего IP. 203.0.113.15 ниже — пример адреса вашего компьютера, не адрес VPS; замените его. Если браузер выходит через IPv6, добавьте и этот адрес через пробел.

analytics.example.com {
    @outside not remote_ip 203.0.113.15
    respond @outside 403
    reverse_proxy app:80
}

Запустите проект:

cd /opt/matomo
docker compose config --quiet
docker compose up -d
docker compose ps

Если первая команда сообщает об ошибке, исправьте YAML или переменные до запуска. После запуска у базы ожидается состояние healthy, у остальных сервисов — Up. Caddy автоматически запросит сертификат при правильно настроенных DNS и доступных портах.

Откройте https://analytics.example.com. Если страница не открывается, посмотрите причину:

docker compose logs --tail=100 caddy app db

Ошибка получения сертификата требует проверки DNS, IPv6 и портов; address already in use означает занятый порт; ответ 403 — несовпадение вашего IP с временным разрешением. Не отключайте проверку HTTPS ради продолжения установки.

В мастере Matomo пройдите проверку системы. Если параметры базы не подставились автоматически, используйте: сервер db, база matomo, пользователь matomo, пароль — значение MATOMO_DB_PASSWORD из .env. Создайте администратора. В поле первого отслеживаемого сайта укажите адрес самого сайта, например https://example.com, и выберите его часовой пояс и валюту.

После завершения мастера уберите из Caddyfile строки @outside... и respond...: иначе счётчик будет принимать запросы только от вас. Итоговый файл:

analytics.example.com {
    reverse_proxy app:80
}

Примените изменение:

docker compose exec caddy caddy reload \
  --config /etc/caddy/Caddyfile --adapter caddyfile

Кабинет должен открываться по HTTPS, а просмотр отчётов — требовать входа в Matomo. Не выдавайте доступ пользователю anonymous; для администратора включите двухфакторную аутентификацию.

4. Проверьте HTTPS и IP посетителей за прокси

Caddy передаёт запросы контейнеру по внутренней сети. Чтобы Matomo корректно учитывала внешний HTTPS и адрес посетителя, проверьте раздел [General] в config/config.ini.php. Получить файл для редактирования можно так:

docker compose cp app:/var/www/html/config/config.ini.php ./config.ini.php
cp config.ini.php config.ini.php.before-proxy

В существующем разделе [General] установите параметры ниже. Не создавайте второй одноимённый раздел и не заменяйте ими весь файл:

assume_secure_protocol = 1
force_ssl = 1
proxy_client_headers[] = HTTP_X_FORWARDED_FOR

Сохраните файл и верните его в контейнер:

docker compose cp ./config.ini.php app:/var/www/html/config/config.ini.php
docker compose exec --user root app sh -c \
  'chown www-data:www-data /var/www/html/config/config.ini.php && chmod 640 /var/www/html/config/config.ini.php'

Проверьте повторный вход по HTTPS. При ошибке скопируйте сохранённый config.ini.php.before-proxy обратно в контейнер под именем /var/www/html/config/config.ini.php и повторите настройку владельца и прав.

Оба локальных файла содержат конфиденциальные настройки. Такая конфигурация рассчитана на единственный публичный прокси Caddy; при добавлении CDN потребуется заново настроить доверие к адресам прокси по документации Matomo.

Настройте обработку отчётов по расписанию

Matomo сначала записывает действия посетителей, затем рассчитывает сводные отчёты. Этот расчёт называется архивацией. Он не создаёт резервную копию. Для регулярного обновления отчётов используйте cron — планировщик Linux.

Сначала выполните расчёт вручную:

cd /opt/matomo
docker compose exec -T --user www-data app \
  php /var/www/html/console core:archive \
  --url=https://analytics.example.com/

Команда должна завершиться без ошибок подключения и доступа к файлам. Если она не работает вручную, настройка расписания не исправит причину: сначала разберите сообщение об ошибке.

Установите и включите cron, затем проверьте путь к Docker:

apt-get update
apt-get install -y cron
systemctl enable --now cron
command -v docker

Откройте crontab -e от root и добавьте следующую запись одной строкой. Пример рассчитан на Docker в /usr/bin/docker; замените путь, если предыдущая команда показала другой.

5 * * * * cd /opt/matomo && /usr/bin/flock -n /run/lock/matomo-archive.lock /usr/bin/docker compose exec -T --user www-data app php /var/www/html/console core:archive --url=https://analytics.example.com/ > /var/log/matomo-archive.log 2>&1

Задание запускается каждый час на пятой минуте. После ближайшего запуска проверьте /var/log/matomo-archive.log: время изменения должно быть новым, результат — без ошибок. Файл сохраняет вывод последнего запуска.

Только после проверки расписания отключайте в общих настройках Matomo архивацию при открытии отчётов в браузере. Этот порядок соответствует рекомендациям по автоматической архивации.

Как подключить сайт к Matomo

В Matomo откройте администрирование, выберите сайт и раздел «Код отслеживания» / Tracking Code. Скопируйте сгенерированный код: в нём уже будут адрес вашей установки и идентификатор сайта Site ID.

• Обычный сайт или CMS: добавьте код один раз в общий шаблон, обычно в область head, чтобы он присутствовал на всех нужных страницах. После изменения очистите кеш сайта.
• WordPress: для подключения к уже работающему Matomo на VPS используйте Connect Matomo либо вставку кода через подходящий инструмент. Matomo Analytics for WordPress — другой вариант, который размещает аналитику внутри WordPress. Выбор описан в официальной инструкции.
• Конструктор сайтов: нужен доступ к вставке пользовательского кода на все страницы. Проверьте, разрешает ли это ваш тариф.
• React, Vue и другие приложения без полной перезагрузки страниц: настройте отправку просмотра при смене маршрута по инструкции для SPA. Иначе может учитываться только первая страница.

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

При настройке Content Security Policy, то есть ограничений на загрузку ресурсов в браузере, разрешите домен аналитики для используемых способов загрузки скрипта и отправки запросов. Ориентируйтесь на конкретную ошибку CSP в консоли; отключать политику целиком не нужно.

Настройка целей, заявок и интернет-магазина

Существующие вызовы целей Яндекс Метрики не начинают автоматически отправлять данные в Matomo. Создайте новые цели и подключите их к тем же подтверждённым действиям пользователя.

1. В разделе целей Matomo создайте цель, например «Заявка отправлена».
2. Если после успешной заявки открывается уникальная страница благодарности, задайте условие по её URL. Такой вариант подходит, только если попадание на страницу действительно связано с заявкой.
3. Для формы без перехода выберите ручной вызов цели. После успешного ответа сервера отправляйте событие Matomo. Пример для цели с ID 1:

_paq.push(['trackGoal', 1]);

Число 1 замените идентификатором созданной цели. Этот вызов должен выполняться на сайте с подключённым кодом Matomo после успешной отправки формы. Клик по кнопке, ошибка валидации и успешная заявка — разные действия.

Проверка состоит из двух попыток: корректно отправьте тестовую заявку и убедитесь, что появилась конверсия; затем отправьте форму с ошибкой — конверсия появиться не должна. Для отслеживания простого клика создайте отдельное событие или цель с понятным названием.

Для магазина требуется интеграция электронной торговли: передача идентификатора заказа, суммы и состава покупки. Проверяйте её тестовым заказом и сверкой с CMS. Заранее определите, что считаете конверсией: создание заказа или подтверждённую оплату. Браузерная аналитика может пропускать действия, поэтому число оплаченных заказов сверяют с учётной системой.

Как сохранить UTM-метки и отчёты по рекламе

Matomo распознаёт UTM-разметку, поэтому менять все рекламные ссылки только ради смены счётчика не требуется. Для отдельных полей источника, канала и содержания объявления установите и активируйте MarketingCampaignsReporting через Marketplace в администрировании Matomo.

Проверьте результат на своей странице с тестовой ссылкой:

https://example.com/?utm_source=test&utm_medium=referral&utm_campaign=matomo_check

Откройте её в новом сеансе браузера, выполните переход по сайту и найдите посещение в журнале. После расчёта отчётов проверьте кампанию matomo_check в разделе источников и кампаний. Для одинаковых кампаний используйте одинаковое написание меток: варианты Email и email могут разделяться в отчётах.

Если посещение есть, а кампании нет, откройте инструменты разработчика браузера → Network и запрос к matomo.php. Проверьте параметр url: дошёл ли туда адрес страницы с метками. Если параметры исчезли, ищите удаляющий их редирект, обработчик адреса страницы или настройку счётчика.

В обсуждении на форуме Matomo в мае 2026 года причиной оказалась строка _paq.push(['disableCampaignParameters']);. После её удаления автор подтвердил появление данных. Это конкретный случай: менять такую настройку следует только после проверки, зачем она включена, в том числе с учётом правил обработки данных.

Как проверить Matomo, если статистика не появляется

Первую проверку проведите в отдельном профиле браузера без блокировщиков, на опубликованном сайте. Если аналитика запускается после согласия посетителя, дайте согласие. Убедитесь, что ваш IP не исключён из учёта.

1. Откройте инструменты разработчика → Network и отфильтруйте запросы по matomo.
2. Проверьте загрузку matomo.js и отправку запроса matomo.php. Для обычного просмотра должен уходить соответствующий запрос с правильным idsite.
3. Откройте в Matomo журнал посещений для нужного сайта и сегодняшней даты. Найдите тестовую страницу, затем проверьте цель и кампанию.
4. Дождитесь успешного запуска архивации и проверьте сводный отчёт. Успешный сетевой ответ сам по себе ещё не доказывает, что все данные правильно записаны.

Установка считается проверенной, когда вы видите тестовый визит, нужную кампанию и корректную цель, а сводные отчёты обновляются по расписанию. Одна открывающаяся панель Matomo подтверждает только доступность интерфейса.

Как перейти с Яндекс Метрики и не сломать рекламу

Сначала выпишите, что вы действительно используете: цели, события, UTM-отчёты, электронную торговлю, сегменты, Вебвизор и связи с Директом. Перенос заканчивается проверкой этих функций, а не появлением первого посетителя в новом кабинете. Новая установка Matomo начинает собирать данные после подключения сайта; история Метрики автоматически в неё не переносится.

1. Запустите два счётчика параллельно. Например, оставьте их на 10–14 дней, чтобы сравнить обычные дни и рекламные кампании. Это рабочий ориентир для проверки, а не обязательный срок.
2. Проверьте ключевые действия. Тестовая заявка, регистрация и заказ должны учитываться в Matomo по выбранным правилам. Отдельно проверьте источники переходов.
3. Сохраните историю Метрики. Экспортируйте важные отчёты за нужные периоды и сохраните доступ к старому счётчику. Для автоматизированной выгрузки есть API отчётов Метрики. Такой экспорт не означает автоматический импорт всей истории в Matomo.
4. Разберите зависимости Директа. Посмотрите, какие цели и аудитории используют стратегии и ретаргетинг. Пока замена не проверена, сохраняйте работающую связку с Метрикой.
5. Удаляйте старый код только после проверки. Не удаляйте сам счётчик и исторические данные ради отключения сбора на сайте.

У Matomo есть инструкция по передаче конверсий в Яндекс. Она использует экспорт из Matomo и загрузку офлайн-конверсий через Метрику с привязкой по yclid — идентификатору рекламного клика. В описанном разработчиком сценарии файл загружается вручную; автоматизация требует отдельного решения. Это не автоматическая замена всех возможностей Метрики в Директе.

Если основная задача — контроль статистики, а реклама уже эффективно работает, разумно оставить Метрику для рекламных зависимостей и использовать Matomo параллельно. Полный отказ имеет смысл после подтверждения, что нужные функции сохранены.

Cookies, персональные данные и доступ к статистике

Собственный сервер позволяет управлять размещением данных, но сам по себе не отменяет требования к их обработке. Режим без cookies тоже продолжает собирать аналитику через JavaScript. Необходимость согласия зависит от аудитории, применимых правил и конкретных настроек.

До запуска проверьте раздел Администрирование → Конфиденциальность → Анонимизация данных: маскирование IP и сроки хранения. Уберите из передаваемых URL, названий событий и пользовательских параметров телефоны, email, токены и содержимое форм. Отразите фактическую обработку в политике конфиденциальности сайта.

Если выбран сбор без cookies, добавьте в код счётчика перед существующим вызовом trackPageView строку:

_paq.push(['disableCookies']);

Не добавляйте второй trackPageView. После изменения проверьте запросы к Matomo и отсутствие её аналитических cookies в хранилище браузера. У режима без cookies есть компромисс: определение повторных посетителей и часть связанных отчётов могут стать менее точными.

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

Что обслуживать после установки

Обработку отчётов и свободное место. Контролируйте результат cron, ошибки контейнеров и заполнение диска. Если расчёт регулярно не успевает завершаться до следующего запуска, разберите тяжёлые сегменты и нагрузку базы, затем увеличивайте ресурсы или разделяйте сервисы.

Срок хранения. В разделе анонимизации отдельно настраиваются удаление подробных визитов и удаление сводных отчётов. Например, можно выбрать ограниченный срок для подробностей и более долгий для рассчитанных отчётов. Сначала убедитесь, что архивация исправно обрабатывает данные за эти периоды. После удаления исходных визитов нельзя рассчитывать на построение новых детальных сегментов за этот период. Карты и записи сеансов также зависят от исходных данных. Перед сокращением срока сделайте резервную копию и изучите последствия настроек хранения.

Резервные копии. Сохраняйте SQL-дамп базы Matomo, каталог /var/www/html/config, установленные дополнительные плагины и файлы compose.yaml, Caddyfile, .env. SQL-дамп создавайте штатным инструментом MariaDB по инструкции резервного копирования и восстановления. Копирование файлов работающего тома MariaDB без согласованного снимка не заменяет такой бэкап.

Задайте расписание по допустимой потере данных: ежедневная копия означает риск потерять изменения после последнего успешного бэкапа, вплоть до суток. Храните копии отдельно от VPS, ограничьте доступ и проверяйте успешное завершение задания. Для пробного восстановления разверните отдельную установку с теми же версиями, восстановите базу и конфигурацию, затем проверьте вход, старые отчёты и новый тестовый визит. Наличие файла ещё не подтверждает возможность восстановления.

Обновления. Перед обновлением создайте копию и проверьте совместимость дополнений. Обновляйте Matomo отдельно от перехода MariaDB на другую основную версию. Для Docker меняют тег образа в Compose, затем выполняют docker compose pull app и docker compose up -d app; если Matomo запросит обновление схемы базы, завершите его. После этого повторите проверки визита, цели и архивации. Откат после изменения схемы может потребовать восстановления базы из копии, а не только возврата старого образа.

Доступность аналитики. Стандартный код Matomo загружается асинхронно. При недоступности отдельного VPS основной сайт обычно продолжает работать, но сбор статистики прерывается. После восстановления сервера пропущенные браузерные события сами не появятся. Для важных проектов настройте внешнюю проверку доступности адреса аналитики и уведомления об ошибках резервного копирования.

Бесплатная установка Matomo на VPS HSTQ

При оплате VPS HSTQ на год мы бесплатно установим Matomo. Выберите VPS HSTQ и при обращении укажите, что нужна установка Matomo по этому предложению.

Сообщите адрес сайта, CMS, примерное количество просмотров в месяц и нужные функции: посещаемость, заявки, магазин, записи сеансов. Это поможет подобрать конфигурацию и заранее согласовать подключение сайта. Индивидуальные цели, интеграции, перенос истории и дальнейшее администрирование обсудите отдельно. Платные дополнения Matomo лицензируются отдельно.