Как установить Umami на Linux и добавить аналитику на свой сайт

Umami – это легкое и ориентированное на конфиденциальность аналитическое программное обеспечение для веб-сайтов и веб-приложений. Это одна из лучших бесплатных альтернатив Google Analytics, которая предоставляет простой в использовании интерфейс, позволяющий просматривать и анализировать входящий веб-трафик аналогично Google Analytics.

Почему стоит использовать Umami для отслеживания аналитики сайта

Одним из главных преимуществ Umami является то, что это программное обеспечение для аналитики сайта, которое анонимизирует все данные о своих пользователях. Это делает Umami невероятно привлекательным для веб-мастеров, которые хотят посмотреть на работу своего сайта, не нарушая конфиденциальности своих посетителей.

Еще одна причина использовать Umami – это то, что он соответствует GDPR и не использует куки для отслеживания сессии пользователя. Таким образом, вам не нужно предоставлять дополнительные баннеры для посетителей, что делает ваш сайт более плавным и удобным для навигации.

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

Получение Docker и Docker Compose для Umami

Первым шагом в самостоятельном хостинге аналитики с помощью Umami является получение Docker и Docker Compose для вашей Linux-машины. Для этого возьмите ключ подписи с сайта проекта Docker:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

Создайте новый файл репозитория в папке «/etc/apt/sources.list.d/» с помощью вашего любимого текстового редактора:

sudo nano /etc/apt/sources.list.d/docker.list

Вставьте следующую строку кода в новый файл репозитория:

deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu noble stable

Убедитесь, что ваша система полностью обновлена и работает правильно:

sudo apt update && sudo apt upgrade

Установите Docker, Docker Compose и дополнительные зависимости для Umami:

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin nginx git

Установка Umami

Перейдите в домашнюю директорию вашей учетной записи, затем извлеките Git-репозиторий Umami со страницы разработчика на Github:

cd ~ && git clone https://github.com/umami-software/umami.git

Перейдите в репозиторий Umami Git, затем откройте предварительно собранный файл Docker Compose с помощью вашего любимого текстового редактора:

cd ~/umami
nano ./docker-compose.yml

Прокрутите вниз до категории «environment:», затем замените значение переменной APP_SECRET на случайную строку символов.

Примечание: Вы можете сгенерировать свою собственную случайную строку букв и цифр, выполнив команду: cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 32 | head -n 1 .

Сохраните файл Docker Compose, а затем выполните следующую команду для сборки и установки контейнера Umami:

sudo docker compose up -d

Убедитесь, что ваш экземпляр Umami запущен, просмотрев список доступных контейнеров Docker в вашей системе:

docker ps

Полезно знать: Узнайте, как управлять Linux-серверами и контейнерами Docker с помощью XPipe.

Защита Umami с помощью обратного прокси-сервера SSL

На данный момент у вас есть собственный экземпляр Umami, работающий на порту 3000 в вашей системе Linux. Однако, чтобы получить доступ к этому сервису через интернет, вам нужно сначала пропустить его через обратный прокси-сервер SSL.

Начните с добавления новой DNS-записи «A» у вашего регистратора доменов, указывающей на IPv4-адрес вашего сервера Umami. В моем случае я задам для записи «A» значение «umami.myreallygreatserver.xyz».

Проверьте, установлен ли пакет привязки «core» на вашем сервере:

sudo snap install core

Установите пакет оснастки Certbot от Electronic Frontier Foundation (EFF):

sudo snap install certbot --classic

Создайте новый файл конфигурации сайта для обратного прокси-сервера SSL:

sudo nano /etc/nginx/sites-available/umami

Вставьте следующий блок кода в новый файл конфигурации сайта:

server {
        server_name SUBDOMAIN.YOUR-ROOT.DOMAIN;
        location / {
                proxy_pass http://127.0.0.1:3000;
                proxy_http_version 1.1;
                proxy_redirect off;
                proxy_set_header Upgrade $http_upgrade;
                proxy_set_header Connection "upgrade";
                proxy_set_header X-Forwarded-Proto https;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header Host $host;
        }
}

Замените значение переменной «server_name» на имя вашего домена.

Сохраните новый файл конфигурации сайта, затем создайте символическую ссылку на «/etc/nginx/sites-enabled:»

sudo ln -s /etc/nginx/sites-available/umami /etc/nginx/sites-enabled/

Проверьте конфигурационные файлы Nginx на наличие ошибок, затем запустите systemctl для запуска обратного прокси:

nginx -t
sudo systemctl reload nginx.service

Зарегистрируйте свой сервер Umami в EFF:

sudo certbot register --agree-tos -m YOUR@EMAIL.ADDRESS

Выполните следующую команду, чтобы сгенерировать SSL-сертификат вашего сайта:

sudo certbot --nginx -d SUBDOMAIN.YOUR-ROOT.DOMAIN

Убедитесь, что ваш экземпляр Umami работает правильно, открыв веб-браузер и перейдя на ваш поддомен.

Добавление Umami Analytics на ваш сайт

По умолчанию Umami задает имя пользователя «admin» и пароль «umami». Это может быть невероятно небезопасно, поэтому рекомендуется изменить его при первом входе в систему.

Чтобы исправить это, нажмите на значок пользователя в правом верхнем углу панели управления.

Нажмите на ссылку Профиль в небольшом всплывающем меню.

Нажмите кнопку Изменить пароль в категории Пароль.

Введите «umami» в текстовое поле Текущий пароль, затем укажите свой новый пароль в текстовых полях Новый пароль и Подтвердить пароль.

Нажмите Save, чтобы применить новый пароль, затем выберите Dashboard, чтобы вернуться на главный экран Umami.

Добавление веб-сайта для отслеживания в Umami

Чтобы добавить новый веб-сайт в ваш экземпляр Umami, нажмите на ссылку Настройки в верхней навигационной панели страницы.

Нажмите кнопку Добавить сайт в правой части страницы.

После этого появится небольшое окно, в котором вы можете указать название и адрес вашего сайта. В моем случае я укажу «Website» в качестве имени и «web.myreallygreatserver.xyz» в качестве домена.

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

Перейдите на вкладку Код отслеживания, затем скопируйте фрагмент HTML в буфер обмена.

На своем сайте вставьте HTML-сниппет в раздел <head> вашего файла. Вам нужно разместить код отслеживания на каждой странице, которую вы хотите отслеживать.

Убедитесь, что Umami теперь правильно отслеживает аналитику вашего сайта, зайдя на ваш сайт, а затем открыв страницу панели Umami.

Зарубин Иван Эксперт по Linux и Windows

Парашютист со стажем. Много читаю и слушаю подкасты. Люблю посиделки у костра, песни под гитару и приближающиеся дедлайны. Люблю путешествовать.

Похожие статьи

Комментарии (0)