📈 تثبيت Umami — تحليلات ويب بسيطة وخاصة

انشر Umami على Ubuntu مع Docker — منصة تحليلات ويب نظيفة وسريعة تحترم الخصوصية. تتبّع الصفحات والجلسات والأحداث عبر مواقع متعددة من لوحة تحكم واحدة.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — Umami مع MySQL بأمر واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/umami/umami-ubuntu.sh
chmod +x umami-ubuntu.sh
sudo bash umami-ubuntu.sh

خطوات التنفيذ

1 تحميل وتشغيل السكريبت

يثبّت السكريبت Docker ويشغّل Umami مع قاعدة بيانات MySQL وبيانات اعتماد مُولَّدة تلقائياً.

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/umami/umami-ubuntu.sh
chmod +x umami-ubuntu.sh
sudo bash umami-ubuntu.sh

2 الدخول إلى واجهة الويب

افتح المتصفح وانتقل إلى Umami. سجّل الدخول بالبيانات الافتراضية وغيّرها فوراً:

http://<your-server-ip>:3002

Username: admin
Password: umami
⚠️ قم بتغيير بيانات الدخول فور أول تسجيل!

3 إضافة موقع

اذهب إلى الإعدادات ← المواقع ← إضافة موقع. أدخل اسم موقعك ونطاقه. سيُولّد Umami معرّفاً فريداً وكود تتبع.

4 تضمين كود التتبع

انسخ وسم <script> من إعدادات الموقع وأضفه في قسم <head>. ستبدأ الإحصاءات بالظهور فوراً. Umami يعمل بدون كوكيز ومتوافق مع GDPR.

المنافذ المستخدمة

المنفذالغرض
3002Umami Web Dashboard

نظرة عامة

Umami هو حل تحليلات ويب مفتوح المصدر ذاتي الاستضافة مصمم ليكون بسيطاً وسريعاً ومحترماً للخصوصية. يجمع بيانات مجمّعة ومجهولة الهوية فقط — بدون ملفات تعريف الارتباط، بدون تتبع عبر المواقع، بدون بيانات شخصية — مما يجعله متوافقاً تماماً مع GDPR. تُحمَّل لوحة التحكم في أقل من ثانية وتعرض بيانات الزوار في الوقت الفعلي.

لماذا تستخدمه

Umami هو أبسط طريق لتحليلات الويب المتوافقة مع GDPR على سيرفرك الخاص. لا يحتاج إلا إلى قاعدة بيانات واحدة (PostgreSQL أو MySQL)، يعمل في حاوية Docker واحدة، ولا يتطلب ClickHouse — مما يجعله قابلاً للتشغيل على مضيفات بـ 512 MB RAM فقط. لوحة التحكم فورية وسريعة وجاهزة للغات المتعددة. للأفراد والفرق الصغيرة التي تريد أرقام حركة حقيقية دون جهاز مراقبة Google، يقدم Umami تماماً ما يلزم دون أي تعقيدات.

متى تحتاجه

  • سيرفرك محدود الذاكرة (أقل من 2 GB) ومتطلب ClickHouse في Plausible عائق
  • تريد أبسط تحليلات ذاتية الاستضافة بقاعدة بيانات واحدة وحاوية واحدة
  • تُشغّل مدونة شخصية أو معرض أعمال أو موقع تجاري صغير وتحتاج مقاييس حركة أساسية
  • تحتاج إلى مراقبة مواقع صغيرة متعددة من لوحة تحكم واحدة دون رسوم لكل موقع
  • تريد أعداد زوار فوريين معروضة في لوحة تحكم عامة كدليل اجتماعي أو تقارير عملاء

من يحتاجه

  • المدونون وصانعو المنتجات المستقلون الذين يريدون بيانات حركة دون تتبع Google
  • المستقلون الذين يديرون مواقع العملاء ويحتاجون لوحات تحليلات خفيفة قابلة للمشاركة
  • الوكالات الصغيرة التي تبحث عن حل بسيط ذاتي الاستضافة بدعم مواقع متعددة
  • مؤسسو SaaS الذين يريدون تتبع سلوك المستخدم دون مزودي تحليلات خارجيين
  • المطورون الذين يريدون نشراً سريعاً — Umami يعمل في أقل من خمس دقائق بـ Docker Compose
  • مشرفو تقنية المعلومات الذين يديرون بوابات ويب داخلية ويحتاجون مقاييس استخدام أساسية
  • مشرفو المشاريع مفتوحة المصدر الذين يريدون إحصاءات زيارات مجهولة دون تتبع المساهمين
  • أصحاب المواقع غير التقنيين الذين يجدون Google Analytics معقداً ويريدون فقط مشاهدات الصفحة وأعلى الصفحات

حالات الاستخدام الشائعة

  • استبدال Google Analytics ببديل محترم للخصوصية ذاتي الاستضافة
  • تتبع مواقع متعددة من نسخة Umami واحدة بلوحات تحكم لكل موقع
  • مراقبة أعداد الزوار الفوريين ومشاهدات الصفحة ومصادر الإحالة
  • إنشاء روابط لوحة تحكم عامة مشتركة لتقارير العملاء
  • تتبع الأحداث المخصصة كنقرات الأزرار وإرسال النماذج بواجهة JavaScript
  • تحليل توزيع أنواع الأجهزة والمتصفحات والبلدان للجمهور

الميزات الرئيسية

  • الخصوصية أولاً: لا كوكيز، لا بيانات شخصية، متوافق تماماً مع GDPR
  • لوحة تحكم فورية — شاهد الزوار النشطين ومشاهدات الصفحة ومصادر الإحالة لحظة بلحظة
  • تتبع الأحداث المخصصة عبر واجهة JavaScript بسيطة: umami.track('button-clicked')
  • دعم مواقع متعددة — أدر مواقع غير محدودة من نسخة Umami واحدة
  • التحكم في وصول الفريق — أضف مستخدمين وعيّنهم لمواقع محددة
  • لوحات تحكم عامة قابلة للمشاركة — أنشئ رابطاً عاماً لأي موقع
  • خفيف الوزن: حاوية Node.js واحدة، لا ClickHouse، يعمل مع PostgreSQL أو MySQL
  • إعادة تسمية سكريبت التتبع — قدّمه من مسارك الخاص لتجاوز حاجبات الإعلانات

كيفية الاستخدام بعد التثبيت

  • سجّل الدخول فوراً ببيانات الاعتماد الافتراضية (admin/umami) وغيّر اسم المستخدم وكلمة المرور
  • أضف موقعك الأول: اضغط Add Website وأدخل اسم النطاق واسم العرض
  • انسخ وسم سكريبت التتبع الظاهر في إعدادات الموقع في <head> موقعك
  • بشكل اختياري أعد تسمية نقطة نهاية السكريبت (مثلاً /stats.js بدلاً من /umami.js) لتقليل تدخل حاجبات الإعلانات
  • زر موقعك من المتصفح وتأكد من ظهور زيارة فورية في لوحة تحكم Umami
  • أعدّ الأحداث المخصصة بواجهة JavaScript لتتبع تفاعلات مستخدمين محددة كنقرات الأزرار وإرسال النماذج
  • فعّل خيار لوحة التحكم العامة إذا أردت رابطاً قابلاً للمشاركة لأصحاب المصلحة
  • اضبط نسخاً احتياطية لوحدة قاعدة بيانات PostgreSQL أو MySQL لحماية تاريخ التحليلات

أفضل ممارسات الأمان

  • غيّر بيانات اعتماد المشرف الافتراضية فوراً — admin/umami موثق علناً وسيكون أول ما يحاوله المهاجم
  • قدّم Umami عبر HTTPS عبر وكيل عكسي — لا تكشف المنفذ 3000 للإنترنت مباشرة
  • اضبط متغير بيئة APP_SECRET بسلسلة عشوائية قوية قبل الإطلاق الأول
  • قيّد وصول قاعدة البيانات للشبكة الداخلية لـ Docker — لا يجب أن تكون PostgreSQL/MySQL متاحة علنياً
  • حدّث صورة Docker لـ Umami بانتظام للحصول على تصحيحات الأمان وإصلاحات الأخطاء
  • استخدم مستخدم قاعدة بيانات مخصص بالأذونات التي يحتاجها Umami فقط — ليس مستخدم postgres الخارق
  • طبّق rate limiting على وكيلك العكسي لمنع هجمات brute-force على نقطة /api/auth/login
  • راجع من لديه وصول مشرف مقابل عارض لكل موقع في نسخة Umami الخاصة بك

المنافذ وإعدادات جدار الحماية

يعمل Umami على المنفذ 3000 داخل الحاوية. ربطه بـ localhost:3000 على المضيف واكشف المنفذ 443 (HTTPS) فقط خارجياً عبر Nginx Proxy Manager أو Caddy. لا تكشف المنفذ 3000 للإنترنت أبداً. يجب أن تكون قاعدة البيانات (PostgreSQL على 5432 أو MySQL على 3306) متاحة فقط داخل شبكة Docker وليس من الخارج.

النسخ الاحتياطي والصيانة

  • انسخ احتياطياً مجلد بيانات PostgreSQL أو MySQL — يحتوي على تاريخ التحليلات بالكامل
  • جدوِّل نسخاً احتياطية تلقائية بـ Duplicati أو restic تستهدف وحدة قاعدة البيانات
  • صدّر البيانات كـ CSV من واجهة Umami بشكل دوري كأرشيف ثانوي
  • قبل ترقية Umami، التقط لقطة لوحدة قاعدة البيانات حتى تتمكن من التراجع إذا فشلت عمليات الترحيل
  • اختبر إجراءات الاسترداد: أنشئ نسخة Umami جديدة على نسخة احتياطية من قاعدة البيانات وتحقق من تحميل لوحاتك
  • خزّن أرشيفات النسخ الاحتياطية خارج السيرفر (S3 أو B2 أو VPS منفصل) للنجاة من فشل المضيف

الأخطاء الشائعة

  • استخدام بيانات الاعتماد الافتراضية — admin/umami أول ما تجربه الروبوتات؛ غيّرها في غضون دقائق من التثبيت
  • كشف المنفذ 3000 مباشرة للإنترنت دون وكيل عكسي أو HTTPS
  • نسيان ضبط APP_SECRET — الافتراضي يجعل رموز الجلسة قابلة للتنبؤ وغير آمنة
  • عدم التحقق من تحميل سكريبت التتبع — استخدم DevTools للتأكد من استجابة 200/204 من نقطة نهاية السكريبت
  • تجاهل نسخ قاعدة البيانات احتياطياً — تلف قاعدة البيانات أو حذف الحاوية يفقد تاريخ التحليلات بالكامل
  • عدم توجيه مسار سكريبت التتبع — بعض المتصفحات والإضافات تحجب /umami.js بالاسم

استكشاف الأخطاء وإصلاحها

  • لا بيانات في لوحة التحكم → تحقق أن وسم سكريبت التتبع في <head> وأن معرّف الموقع في السكريبت يطابق الموجود في إعدادات Umami
  • سكريبت التتبع محجوب → أعد تسمية نقطة نهاية السكريبت لشيء عام مثل /metrics.js وقدّمه من نطاقك
  • لا يمكن تسجيل الدخول → APP_SECRET تغيّر بين عمليات إعادة التشغيل مما يُبطل الجلسات؛ امسح الكوكيز وسجّل الدخول مجدداً
  • أخطاء اتصال قاعدة البيانات → تحقق من DATABASE_URL في متغيرات البيئة وتأكد أن حاوية قاعدة البيانات تعمل
  • لوحة التحكم لا تُحمَّل → راجع docker logs umami لأخطاء الإقلاع؛ عادةً مشكلة اتصال بقاعدة البيانات عند التشغيل الأول
  • Umami تُظهر 0 زوار فوريين رغم تحميل الصفحات → تحقق أن نطاق الموقع في الإعدادات يطابق تماماً النطاق الذي يستخدمه الزوار (www مقابل بدون www مهم)
  • API يُرجع 401 → رمز جلستك انتهت صلاحيته؛ سجّل خروجاً ودخولاً لتحديثه

البدائل

Plausible هو خيار تحليلات ذاتية الاستضافة الأكثر صقلاً — لوحات تحكم أفضل وملخصات بريدية ومجموعة ميزات أكثر اكتمالاً — لكنه يتطلب ClickHouse و2+ GB RAM. Matomo هو الخيار الأكثر شمولاً ذاتياً مع خرائط حرارية وتسجيل الجلسات ومسارات التجارة الإلكترونية، لكنه أثقل تشغيلاً بكثير. Fathom Analytics وSimple Analytics خيارات سحابية صديقة للخصوصية بنفس بساطة Umami لكن برسوم شهرية. Google Analytics مجاني ويتكامل مع Google Ads، لكنه مسؤولية خصوصية في أسواق منظمة بـ GDPR.

متى لا تستخدمه

تجنب Umami إذا كنت تحتاج ميزات تحليلات متقدمة كتسجيل الجلسات أو الخرائط الحرارية أو تصور مسارات التحويل أو اختبار A/B — Umami يُبقي نطاقه محدوداً عن قصد. تجنبه أيضاً إذا كنت تحتاج تتبعاً تفصيلياً لرحلة المستخدم أو تحليل المجموعات؛ نموذج البيانات قائم على الزيارات وليس قادراً على إعادة تشغيل الجلسات. إذا كنت تُشغّل Plausible مع ClickHouse وهو مستقر، فلا داعي للتبديل — كلاهما يخدم نفس غرض التحليلات ذات الخصوصية أولاً.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

هل Umami مجاني فعلاً؟ ما الثمن الخفي؟

Umami مفتوح المصدر بالكامل (رخصة MIT) وذاتي الاستضافة، لذا لا توجد رسوم لكل زائر أو اشتراكات. التكلفة الوحيدة هي استضافة سيرفرك. Umami Cloud (النسخة SaaS المدارة) لها طبقة مدفوعة، لكن النسخة ذاتية الاستضافة لا تفرض حدوداً اصطناعية على المواقع أو مشاهدات الصفحة أو أعضاء الفريق.

ما الفرق بين Umami وPlausible؟

كلاهما أدوات تحليلات مفتوحة المصدر وصديقة للخصوصية. الفروق الرئيسية: Umami يحتاج قاعدة بيانات واحدة فقط (PostgreSQL أو MySQL)، بينما تحتاج Plausible كلاً من PostgreSQL وClickHouse. هذا يجعل Umami يعمل على مضيفات بـ 512 MB RAM فقط، بينما تحتاج Plausible 2+ GB. Plausible لديها ملخصات بريدية وواجهة مستخدم أكثر صقلاً وتوثيق أفضل قليلاً. للمواقع الصغيرة أو السيرفرات محدودة الموارد، Umami هو الخيار الأفضل.

هل يمكنني تغيير URL سكريبت التتبع لتجنب حاجبات الإعلانات؟

نعم. يمكنك ضبط مسار السكريبت بتعيين متغير البيئة TRACKER_SCRIPT_NAME، أو بإضافة location block في الوكيل العكسي يربط مساراً مخصصاً مثل /metrics.js بنقطة نهاية سكريبت Umami الداخلية. تقديم السكريبت من نطاقك الخاص باسم عام يمنع معظم حاجبات الإعلانات من التعرف عليه وحجبه.

هل يدعم Umami تتبع الأحداث المخصصة بما يتجاوز مشاهدات الصفحة؟

نعم. أضف سكريبت تتبع Umami واستدعِ umami.track('event-name', { key: 'value' }) في JavaScript الخاص بك. يمكنك تتبع نقرات الأزرار وإرسال النماذج وتنزيلات الملفات أو أي تفاعل مخصص. تظهر هذه الأحداث في لوحة تحكم Umami تحت تبويب Events لموقعك.

كيف أمنح العميل وصولاً للقراءة فقط لإحصاءات موقعه؟

خياران: (1) فعّل لوحة التحكم العامة — اذهب إلى إعدادات الموقع، فعّل Share URL، وأرسل الرابط المُنشأ. يمكن للعميل عرض كل الإحصاءات دون تسجيل دخول. (2) أنشئ حساباً عضوية للعميل في Umami بوصول عارض لموقعه المحدد فقط. الخيار الأول أبسط؛ الثاني يمنحك تحكماً أكبر فيما يمكنه وما لا يمكنه رؤيته.

هل يمكن لـ Umami تتبع الزوار عبر نطاقات متعددة؟

كل موقع في Umami يحصل على معرّف تتبع خاص به ولوحة تحكم منفصلة. يُتتبع الزوار لكل نطاق بشكل منفصل — وهذا مقصود للخصوصية. إذا كنت تُشغّل عدة مواقع وتريد تتبعاً موحداً عبر النطاقات، ستحتاج إلى تجميع البيانات خارجياً عبر API. لمعظم حالات الاستخدام، لوحات التحكم لكل موقع هي تماماً ما تحتاجه.

هل يعمل Umami بدون JavaScript (للزوار الذين عطّلوه)؟

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

كيف أُرقّي Umami دون فقدان البيانات؟

اسحب أحدث صورة (docker pull ghcr.io/umami-software/umami:postgresql-latest)، أوقف الحاوية الحالية، وأعد إنشاءها. يُشغّل Umami عمليات ترحيل قاعدة البيانات تلقائياً عند الإقلاع. خذ دائماً نسخة احتياطية من قاعدة البيانات قبل الترقية. تحقق من صفحة إصدارات Umami على GitHub لأي تغييرات جذرية أو خطوات ترحيل يدوية قبل سحب إصدار رئيسي جديد.