Альтернатива Яндекс.Метрике и Google Analytics

1. Подготовьте сервер и домен

• Linux-сервер: Docker Engine, Compose v2, Python 3.10+. Ориентир: 2 ГБ ОЗУ и от 5 ГБ свободного диска. Это не результат нагрузочного теста.
• Поддомен для сборщика: например, stats.example.org. Его DNS-запись A должна указывать на ваш VPS. AAAA добавляйте только при рабочем IPv6.
• Свободные порты: TCP 80/443, UDP 443 и локальный TCP 3217. Учётной записи нужен доступ к Docker.
• Компьютер: Windows 10/11, OpenSSH Client, PowerShell, Python 3.10+, Node.js 22+ и npm.
• SSH: рабочий ключ и проверенный отпечаток сервера. Не отключайте проверку ключа хоста.

Если 80/443 уже заняты сайтом или прокси, не останавливайте его. Этот установщик рассчитан на свободные порты. Для общего сервера нужна отдельная интеграция с действующим прокси.

2. Скачайте исходники отдельно на сервер и компьютер

На GitHub выберите Code → Download ZIP и распакуйте архив. На сервере используйте отдельную папку, например /opt/site-analytics. При наличии Git можно скачать так:

git clone https://github.com/bolgbolg1-dev/comrad404-analytics.git site-analytics
cd site-analytics
python3 tools/check_package.py

Установите Docker по официальной инструкции для своего дистрибутива. На Windows нужна отдельная копия исходников: не переносите с сервера .env, private/ и конфигурацию.

3. Запустите установщик на Linux-сервере

Из корня скачанного проекта выполните команду, заменив stats.example.org своим доменом:

python3 install.py --domain stats.example.org --project site-analytics

Введите новый пароль администратора Umami длиной от 16 символов. Пароль не нужно писать в команде или отправлять в чат. Установщик создаёт конфигурацию, поднимает приватные приложение и БД, меняет стандартный пароль, затем запускает сборщик HTTPS.

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

4. Проверьте HTTPS и закрытые отчёты

На сервере, в папке проекта, выполните:

docker compose ps
curl --fail http://127.0.0.1:3217/api/heartbeat
curl -I https://stats.example.org/collect.js
curl -I https://stats.example.org/api/websites
curl -I https://stats.example.org/api/auth/login

Контейнеры должны работать; heartbeat и скрипт — отвечать успешно. Два последних публичных адреса должны возвращать 404, не страницу входа и не данные. Сертификат HTTPS — без предупреждений. PostgreSQL не должен иметь опубликованного порта, Umami — слушать только 127.0.0.1. Порт 3217 наружу не открывайте.

5. Настройте локальную панель на Windows

Откройте PowerShell в отдельной папке проекта на компьютере:

python configure.py
cd dashboard
npm.cmd ci
npm.cmd test
npm.cmd run build
cd ..
.\Start-Analytics.cmd

Мастер спросит адрес VPS, SSH-пользователя, путь к ключу, абсолютный путь установки на сервере, приватный порт и пароль Umami. Сохраните настройки только на доверенном компьютере. Панель откроется на http://127.0.0.1:3219, расширенный Umami — на http://127.0.0.1:3217.

6. Добавьте сайт и установите код счётчика

В панели откройте Настройки → Добавить сайт, укажите название и домен. Нажмите Скопировать код. Разместите вставку один раз перед </head> в общем шаблоне сайта либо передайте «Инструкцию разработчику» программисту.

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

7. Убедитесь, что просмотры поступают

Откройте свой сайт в обычном браузере, пройдите по двум страницам и нажмите Проверить подключение в настройках панели. Проверка отдельно показывает наличие вставки в HTML и поступление данных. Если вставка добавляется JavaScript, HTML-проверка может её не увидеть.

Чтобы не учитывать свой браузер, откройте сайт с ?site_analytics=off; чтобы вернуть учёт — с ?site_analytics=on. Это настройка конкретного браузера. События добавляются отдельно, без содержимого форм:

window.siteAnalytics.track('button_click')

Названия статей вместо URL можно задать в локальном runtime/page-titles.json. Без него отображаются адреса; автоматическая синхронизация с WordPress в переносимый пакет не включена.

8. Подготовьте копии и восстановление

Сохраните зашифрованную внешнюю копию серверных настроек и регулярно делайте дамп БД. В папке проекта на сервере:

mkdir -p backups
chmod 700 backups
umask 077
docker compose exec -T db pg_dump -U umami -d umami -Fc > backups/umami.dump

Переносите копию за пределы VPS. Пока восстановление в отдельной БД не проверено, копию нельзя считать проверенной. Расписание копий не устанавливается автоматически.

При обрыве связи нажмите Переподключиться. После перезагрузки компьютера снова откройте Start-Analytics.cmd: автозапуск Windows не ставится. Если серверная установка прервалась, не удаляйте .env, private/ или Docker volumes; сначала разберите причину по локальным логам. Не выполняйте docker compose down -v: это удаляет тома со статистикой.