📈 تثبيت Matomo — بديل Google Analytics ذاتي الاستضافة

انشر Matomo على Ubuntu — منصة تحليلات الويب مفتوحة المصدر الرائدة مع ملكية كاملة للبيانات، توافق مع GDPR، خرائط حرارية، وتحليل مسارات التحويل.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Matomo مع قاعدة بيانات وسيرفر ويب كاملين.
عرض على GitHub

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

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

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

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/matomo/matomo-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x matomo-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker، يُعِد MariaDB، يضبط Nginx، ويُشغّل Matomo تلقائياً.

sudo bash matomo-ubuntu.sh

4 إكمال معالج الإعداد

افتح المتصفح، انتقل إلى رابط Matomo، وأكمل معالج التثبيت:

http://<your-server-ip>

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

المنفذالغرض
80HTTP Web Interface
443HTTPS (via reverse proxy)

نظرة عامة

Matomo (المعروف سابقاً بـ Piwik) هو منصة تحليلات ويب مجانية ومفتوحة المصدر تمنحك ملكية كاملة 100% لبيانات زوارك. بدلاً من إرسال بيانات الزيارات إلى سيرفرات جوجل، يعمل Matomo بالكامل على بنيتك التحتية الخاصة — كل مشاهدة صفحة ونقرة وتحويل يبقى تحت سيطرتك. يقدّم نفس عمق التقارير الأساسي مثل Google Analytics، بالإضافة إلى ميزات مثل الخرائط الحرارية وتسجيلات الجلسات واختبارات A/B التي عادة ما تكون محجوبة خلف خطط مدفوعة في المنصات الأخرى.

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

Matomo موجود من أجل الفرق وأصحاب المواقع الذين يريدون تحليلات ويب دقيقة وعميقة دون تسليم بيانات الزوار لطرف ثالث. ولأنه ذاتي الاستضافة، لا توجد عينات بيانات (data sampling) على المواقع عالية الزيارات، ولا حدود احتفاظ بيانات تعسفية، ولا خطر أن تغيّر منصة ما شروطها أو تُغلق تقاريرك التاريخية. كما أنه من المنصات القليلة المبنية من الأساس حول التوافق مع GDPR — بإخفاء هوية IP، إعدادات احتفاظ بيانات قابلة للتخصيص، ومسار موثّق نحو العمل بدون شريط موافقة كوكيز في العديد من الدول.

متى تحتاجه

  • تحتاج عمق تقارير بمستوى Google Analytics لكن لا يمكنك إرسال بيانات الزوار لمزوّد سحابي أمريكي لأسباب قانونية أو سياسات داخلية
  • موقعك عالي الزيارات وتصطدم بحدود عينات البيانات في أدوات تحليلات أخرى تقدّر النتائج تقديرياً فقط
  • تعمل في الاتحاد الأوروبي أو سوق منظّم للخصوصية وتحتاج توافقاً موثّقاً مع GDPR وتحكماً كاملاً في مدة الاحتفاظ بالبيانات
  • تريد تتبع مسارات التحويل والأهداف وأداء التجارة الإلكترونية دون دفع مقابل مستوى تحليلات متقدم
  • تحتاج ربط بيانات التحليلات بأنظمة داخلية أخرى عبر الاستعلام المباشر عن قاعدة البيانات

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

  • استبدال Google Analytics في موقع حكومي أو مؤسسي لا يمكنه استخدام أدوات تتبع مستضافة في أمريكا
  • تتبع أداء الحملات التسويقية ومصادر الزيارات ومسارات التحويل لمتجر إلكتروني
  • تحليل سلوك المستخدم بالخرائط الحرارية وتسجيلات الجلسات لتحسين معدلات تحويل صفحات الهبوط
  • تشغيل اختبارات A/B على صفحات التسعير أو مسارات التسجيل وقياس أي نسخة تحوّل أفضل
  • تقديم لوحات تحليلات ذاتية الاستضافة بعلامة تجارية خاصة للعملاء كجزء من خدمة الوكالة
  • الحفاظ على بيانات تحليلات تاريخية كاملة دون حدود احتفاظ من طرف ثالث أو عينات بيانات

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

  • تتبع زوار فوري، مشاهدات صفحات، أحداث، وأهداف تحويل بدون عينات بيانات مهما كان حجم الزيارات
  • خرائط حرارية وتسجيل جلسات مدمجة لتصور بالضبط كيف ينقر الزوار ويتصفحون الصفحات
  • مسارات تحويل وتتبع أهداف متعددة الخطوات لمعرفة أين يتوقف الزوار بالضبط في مسار التحويل
  • محرك اختبارات A/B لمقارنة نسخ الصفحات وقياس فروق التحويل ذات الدلالة الإحصائية
  • تتبع تجارة إلكترونية مع تقارير منتجات وفئات وإيرادات مماثلة لوحدة التجارة الإلكترونية في GA4
  • استيراد بيانات Google Analytics بنقرة واحدة حتى لا تفقد التقارير التاريخية عند الترحيل
  • مجموعة أدوات GDPR تشمل إخفاء هوية IP، دعم Do-Not-Track، إخفاء هوية البيانات، وأدوات تصدير/حذف بيانات المستخدم
  • إدارة مواقع متعددة من تثبيت واحد، مع أدوار وصلاحيات مستخدمين لكل موقع
  • واجهة REST API وسوق إضافات مجانية ومدفوعة لتقارير وتكاملات مخصصة

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

  • أكمل معالج الإعداد: أنشئ اتصال قاعدة البيانات، حساب المسؤول، وأضف موقعك الأول للتتبع
  • انسخ كود التتبع JavaScript من Administration → Websites → Manage والصقه قبل وسم </head> في كل صفحة تريد تتبعها
  • تحقق من عمل التتبع بزيارة موقعك ومراجعة Visitors → Visits Log لمشاهدة زيارة مباشرة في Matomo
  • أعدّ الأهداف تحت Administration → Goals لتتبع التحويلات مثل إرسال النماذج أو التسجيلات أو عمليات الشراء
  • فعّل إعدادات GDPR الصديقة للخصوصية تحت Administration → Privacy — إخفاء هوية IP، احترام Do Not Track، وضبط مدة الاحتفاظ بالبيانات
  • ثبّت إضافة Heatmap & Session Recording من متجر الإضافات داخل التطبيق إذا أردت تتبع السلوك البصري
  • ادعُ أعضاء الفريق تحت Administration → Users وحدد صلاحيات عرض أو إدارة لكل موقع
  • ضع Matomo خلف Nginx Proxy Manager مع شهادة SSL صالحة قبل تتبع أي زيارات إنتاجية

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

  • قدّم نطاق تتبع Matomo دائماً عبر HTTPS — إرسال بيانات التحليلات عبر HTTP عادي يكشف معلومات الزوار
  • عيّن كلمة مرور قوية لحساب المسؤول الأعلى الذي يُنشأ أثناء معالج الإعداد
  • قيّد صفحة تسجيل دخول إدارة Matomo على عناوين IP موثوقة أو ضعها خلف VPN إذا لم تكن بحاجة لوصول عام
  • حافظ على تحديث Matomo وإضافاته — يخبرك المحدّث المدمج بالإصدارات الجديدة بما فيها التصحيحات الأمنية
  • فعّل المصادقة الثنائية لجميع حسابات المسؤولين تحت Personal → Security
  • راجع قسم Users بانتظام لحذف الحسابات التي لم تعد بحاجة للوصول للوحة التحكم
  • اضبط مستخدم قاعدة البيانات بأقل صلاحيات يحتاجها Matomo فعلياً، وليس وصول جذر root
  • راجع إعدادات الاحتفاظ ببيانات GDPR دورياً حتى تُحذف سجلات الزوار القديمة تلقائياً حسب سياستك

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

لا يستمع Matomo نفسه على منفذ مخصص — يُقدَّم عبر سيرفر الويب (Nginx أو Apache) على منفذ HTTP القياسي 80 ومنفذ HTTPS 443. يُعِد سكريبت التثبيت Nginx لتقديم تطبيق Matomo PHP وتمرير الطلبات إلى PHP-FPM داخلياً، بينما يستمع MariaDB فقط على localhost (المنفذ 3306) ولا يُكشف خارجياً أبداً. للاستخدام الإنتاجي، ضع Matomo خلف وكيل عكسي مثل Nginx Proxy Manager مع شهادة TLS صالحة على المنفذ 443، واحظر الوصول المباشر للمنفذ 80 من الإنترنت العام باستثناء تحديات ACME/Let's Encrypt HTTP. لا تكشف أبداً منفذ MariaDB للإنترنت.

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

  • انسخ قاعدة بيانات MariaDB احتياطياً بانتظام باستخدام mysqldump — تحتوي على كل سجلات الزوار والتقارير والمواقع وحسابات المستخدمين
  • انسخ ملف config/config.ini.php الخاص بـ Matomo احتياطياً، فهو يحتوي تفاصيل الاتصال بقاعدة البيانات والإعدادات الأساسية
  • انسخ أي ملفات مرفوعة وإضافات مخصصة مثبتة من السوق احتياطياً
  • خزّن النسخ الاحتياطية خارج السيرفر ومشفّرة، واختبر إجراء الاستعادة دورياً على نسخة تجريبية
  • قبل تشغيل تحديث أساسي لـ Matomo، خذ نسخة احتياطية كاملة لقاعدة البيانات والملفات — التحديثات قد تتضمن ترحيلات هيكلية يصعب التراجع عنها
  • أتمت النسخ الاحتياطي بمهمة cron تُصدّر قاعدة البيانات وتؤرشف دليل Matomo يومياً أو أسبوعياً

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

  • نسيان إضافة كود التتبع لكل صفحة — التغطية الجزئية للتتبع تُشوّه كل التقارير
  • تشغيل Matomo عبر HTTP عادي في الإنتاج، ما يكشف بيانات الزوار وبيانات اعتماد المسؤول أثناء النقل
  • عدم تفعيل مهمة cron للأرشفة — بدونها قد تكون تقارير المواقع عالية الزيارات بطيئة عند الطلب
  • ترك مستخدم قاعدة البيانات بصلاحيات مفرطة بدلاً من تقييده على قاعدة بيانات Matomo فقط
  • تجاهل إعدادات GDPR تماماً والافتراض أن الاستضافة الذاتية وحدها تُحقق متطلبات التوافق
  • عدم تحديث Matomo بانتظام، ما يترك ثغرات معروفة دون تصحيح في تثبيت متاح للعموم
  • خلط زيارات الاختبار/التجريب ببيانات التحليلات الإنتاجية بدلاً من استخدام معرّف موقع منفصل

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

  • بيانات التتبع لا تظهر — تحقق من وجود كود JavaScript في مصدر الصفحة، وحاجب طلبات في كونسول المتصفح، وأن مانعات الإعلانات لا تحذف كود التتبع
  • بطء تحميل التقارير في المواقع عالية الزيارات — فعّل مهمة cron للأرشفة تحت Administration → System Check حتى تُحسب التقارير مسبقاً بدلاً من توليدها عند التحميل
  • معالج الإعداد يفشل في الاتصال بقاعدة البيانات — تحقق من أن حاوية MariaDB تعمل وأن بيانات الاعتماد في config.ini.php تطابق مستخدم قاعدة البيانات
  • لا يمكن تسجيل الدخول بعد التثبيت — أعد تعيين كلمة مرور المسؤول الأعلى مباشرة في قاعدة البيانات أو عبر أمر كونسول Matomo إذا لم يكن استرداد البريد الإلكتروني مضبوطاً
  • أخطاء SSL/HTTPS بعد وضع Matomo خلف وكيل عكسي — تأكد أن الوكيل يمرر رأس X-Forwarded-Proto حتى يولّد Matomo روابط HTTPS صحيحة
  • الخرائط الحرارية لا تُسجّل — تأكد أن إضافة Heatmap & Session Recording مفعّلة وأن إصدار كود التتبع يدعمها

البدائل

Google Analytics (GA4) مجاني ولا يحتاج استضافة، لكنه يرسل كل بيانات الزوار لسيرفرات جوجل، ويطبق عينات بيانات على المواقع عالية الزيارات، ويثير مخاوف GDPR للعديد من المواقع الأوروبية. Plausible وUmami أدوات تحليلات خفيفة، بدون كوكيز، تركّز على الخصوصية وأبسط تشغيلاً من Matomo لكن بعمق تقارير أقل بكثير — بدون خرائط حرارية أو تسجيلات جلسات أو اختبارات A/B. Fathom Analytics بديل مستضاف مدفوع يركّز على الخصوصية بمجموعة ميزات مشابهة في البساطة. PostHog يذهب أبعد من Matomo نحو تحليلات المنتج ومفاتيح الميزات وإعادة تشغيل الجلسات، لكن بمنحنى تعلّم أصعب واستهلاك موارد أكبر. للفرق التي تريد عمق تقارير بمستوى Google Analytics مع ملكية كاملة للبيانات وتصميم يضع GDPR أولاً، يبقى Matomo الخيار الأكمل ذاتي الاستضافة.

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

إذا كنت تحتاج فقط عدّاد مشاهدات وزوار أساسي بإعداد بسيط، فأداة خفيفة مثل Plausible أو Umami ستكون أسهل بكثير في التشغيل والصيانة من Matomo. يتطلب Matomo قاعدة بيانات، بيئة تشغيل PHP، وصيانة دورية (تحديثات، مهام cron للأرشفة) تضيف عبئاً تشغيلياً مقارنة بأداة تحليلات SaaS مستضافة. إذا كان موقعك عالي الزيارات جداً ولا تريد إدارة موارد سيرفر لأرشفة التقارير، فمنصة تحليلات مستضافة قد توسّع بشكل أكثر توقعاً. إذا لم يكن لديك متطلبات GDPR أو إقامة بيانات ولا تمانع إرسال البيانات لجوجل، يبقى GA4 مجانياً ولا يحتاج أي بنية تحتية للصيانة.

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

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

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

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

هل Matomo مجاني فعلاً؟

نعم. النسخة ذاتية الاستضافة (Matomo On-Premise) مجانية بالكامل ومفتوحة المصدر برخصة GPLv3، بدون حدود زوار أو مشاهدات صفحات. يقدّم Matomo أيضاً خطة سحابية مدفوعة (Matomo Cloud)، وبعض الإضافات المتقدمة في السوق (مثل بعض ميزات الخرائط الحرارية المتقدمة) مدفوعة، لكن منصة التحليلات الأساسية مجانية بالكامل للاستضافة الذاتية.

هل يتطلب Matomo شريط موافقة كوكيز بموجب GDPR؟

في العديد من الدول، يمكن لتثبيت Matomo ذاتي الاستضافة مضبوط بشكل صحيح (إخفاء هوية IP، بدون تتبع عبر مواقع متعددة، كوكيز من الطرف الأول) أن يُعفى من متطلبات موافقة الكوكيز — وينشر Matomo إرشادات حول هذا. لكن المتطلبات القانونية الدقيقة تعتمد على بلدك وكيفية ضبط التتبع، لذا استشر إرشادات حماية البيانات المحلية قبل الاعتماد على هذا.

هل يمكن لـ Matomo استيراد بيانات Google Analytics الحالية لدي؟

نعم. يتضمن Matomo إضافة Google Analytics Importer تسحب بيانات GA/GA4 التاريخية إلى Matomo، حتى لا تفقد التقارير السابقة عند الانتقال من Google Analytics.

هل سيُبطئ Matomo موقعي؟

كود التتبع صغير ويُحمّل بشكل غير متزامن، لذا تأثيره على سرعة تحميل الصفحة ضئيل. توليد التقارير يحدث على سيرفر Matomo نفسه وليس على الموقع المتتبَّع، لذا طالما أن مهمة cron للأرشفة مضبوطة، أداء الموقع أمام الزوار لا يتأثر.

كم من موارد السيرفر يحتاجها Matomo؟

للمواقع صغيرة إلى متوسطة الزيارات، عادة ما يكفي 1-2 معالج افتراضي وذاكرة 2 غيغابايت. المواقع عالية الزيارات (ملايين المشاهدات شهرياً) تستفيد من ذاكرة ومعالج أكبر لأرشفة التقارير، وقد تحتاج ضبط دقيق لقاعدة البيانات أو نسخة MariaDB مخصصة.