كيفية تثبيت Umami على Linux وإضافة التحليلات على موقع الويب الخاص بك

Umami هو برنامج تحليلي خفيف الوزن يركز على الخصوصية لمواقع الويب وتطبيقات الويب. إنه أحد أفضل البدائل المجانية لبرنامج Google Analytics ويوفر واجهة سهلة الاستخدام يمكنها الاطلاع على حركة المرور الواردة على الويب وتحليلها بشكل مشابه لبرنامج Google Analytics. نعرض هنا كيفية تثبيت Umami على Ubuntu Linux ونرشدك خلال عملية إضافة التحليلات لموقعك على الويب.

لماذا نستخدم Umami لتتبع تحليلات الموقع

واحدة من أكبر نقاط البيع في Umami هي أنه برنامج لتحليل مواقع الويب يقوم بإخفاء هوية جميع البيانات المتعلقة بمستخدميه. وهذا يجعل Umami جذابًا بشكل لا يصدق لمشرفي المواقع الذين يرغبون في الاطلاع على أداء مواقعهم على الويب دون المساس بخصوصية زوارهم.

سبب آخر لاستخدام Umami هو أنه متوافق مع اللائحة العامة لحماية البيانات ولا يعتمد على ملفات تعريف الارتباط لتتبع جلسة المستخدم. على هذا النحو، لا تحتاج إلى توفير أي لافتات اختيارية إضافية للزائرين، مما يجعل موقع الويب الخاص بك أكثر سلاسة وسهولة في التنقل.

وأخيرًا، فإن تطبيق 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

ملحوظة: يركز هذا القسم على تثبيت Docker لـ Ubuntu. إذا كنت تستخدم توزيعة مختلفة، فراجع دليلنا العام لتثبيت Docker على Linux.

قم بإنشاء ملف مستودع جديد ضمن “/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 من صفحة Github الخاصة بالمطور:

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

انتقل إلى مستودع Umami Git، ثم افتح ملف Docker Compose الذي تم إنشاؤه مسبقًا باستخدام محرر النصوص المفضل لديك:

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

قم بالتمرير للأسفل إلى فئة “البيئة:”، ثم استبدل قيمة 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 المتوفرة في نظامك:

جيد ان تعلم: تعرف على كيفية إدارة خوادم Linux وحاويات Docker باستخدام XPipe.

تأمين Umami باستخدام وكيل SSL العكسي

في هذه المرحلة، لديك الآن مثيل تحليلات Umami ذاتي المضيف يعمل على المنفذ 3000 في نظام Linux الخاص بك. ومع ذلك، للوصول إلى هذه الخدمة عبر الإنترنت، يتعين عليك تمريرها أولاً عبر وكيل SSL العكسي.

ابدأ بإضافة سجل DNS “A” جديد إلى مسجل النطاق الخاص بك مع الإشارة إلى عنوان IPv4 لخادم Umami الخاص بك. في حالتي، سأقوم بتعيين السجل “A” الخاص بي على “umami.myreallygreatserver.xyz”.

تحقق مما إذا كانت الحزمة المفاجئة “الأساسية” موجودة بالفعل في خادمك:

قم بتثبيت حزمة Certbot snap من 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<br>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 إلى موقع الويب الخاص بك

افتراضيًا، يقوم Umami بتعيين اسم المستخدم الافتراضي الخاص بك على “admin” وكلمة المرور الخاصة بك على “umami”. يمكن أن يكون هذا غير آمن بشكل لا يصدق ومن المستحسن تغييره عند تسجيل الدخول الأول.

لإصلاح هذه المشكلة، انقر فوق رمز المستخدم في الزاوية اليمنى العليا للوحة المعلومات.

انقر على حساب تعريفي الرابط في القائمة المنبثقة الصغيرة.

انقر على تغيير كلمة المرور زر تحت كلمة المرور فئة.

اكتب “أومامي” على كلمة السر الحالية textbox، ثم قم بتوفير كلمة المرور الجديدة الخاصة بك على كل من كلمة المرور الجديدة و تأكيد كلمة المرور مربعات النص.

انقر يحفظ لتطبيق كلمة المرور الجديدة، ثم حدد لوحة القيادة للعودة إلى شاشة Umami الرئيسية.

إضافة موقع ويب لتتبعه في Umami

لإضافة موقع ويب جديد إلى مثيل Umami الخاص بك، انقر فوق إعدادات الرابط الموجود في شريط التنقل العلوي بالصفحة.

انقر على أضف موقعًا إلكترونيًا الزر الموجود على الجانب الأيمن من الصفحة.

سيؤدي القيام بذلك إلى ظهور نافذة صغيرة حيث يمكنك تقديم اسم وعنوان موقع الويب الخاص بك. في حالتي، سأقدم “موقع ويب” للاسم و”web.myreallygreatserver.xyz” للنطاق.

انقر يحفظ لتنفيذ التغييرات، ثم انقر فوق يحرر على دخول موقع الويب الخاص بك.

اذهب الى شفرة التتبع علامة التبويب، ثم انسخ مقتطف HTML إلى الحافظة الخاصة بك.

في موقع الويب الخاص بك، الصق مقتطف HTML داخل ملف <head> قسم من الملف الخاص بك. يتعين عليك وضع شفرة التتبع في كل صفحة تريد تتبعها.

تأكد من أن Umami يقوم الآن بتتبع تحليلات موقع الويب الخاص بك بشكل صحيح من خلال زيارة موقع الويب الخاص بك، ثم فتح صفحة لوحة التحكم الخاصة بـ Umami.

Umami ليس البرنامج التحليلي المجاني الوحيد الذي يمكنك استخدامه. تحقق من بعض أفضل بدائل Google Analytics هنا.

حقوق الصورة: ميريام جيسير عبر Unsplash. جميع التعديلات ولقطات الشاشة بواسطة Ramces Red.

رمسيس كاتب في مجال التكنولوجيا عاش مع أجهزة الكمبيوتر طوال حياته. قارئ غزير الإنتاج وطالب في الأنثروبولوجيا، وهو شخصية غريبة الأطوار تكتب مقالات عن Linux وأي شيء لا شيء.