📈 تثبيت Swetrix — تحليلات الويب الخالية من الكوكيز والمحترمة للخصوصية على Docker

نشر منصة Swetrix على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لتحليلات الويب الخالية تماماً من ملفات تعريف الارتباط مع قاعدة بيانات ClickHouse السريعة وتتبع الأهداف والأداء على المنفذين 8234 و8235.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر واجهة Swetrix على المنفذ 8234 وواجهة التتبع على المنفذ 8235 مع قاعدة بيانات ClickHouse وكاش Redis جاهزاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x swetrix-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين الدائم لقاعدة بيانات ClickHouse وRedis (`./clickhouse-data` و`./redis-data`) وتشغيل واجهة Swetrix على المنفذ 8234 ومجمع الأحداث على المنفذ 8235.

sudo bash swetrix-ubuntu.sh

4 تسجيل الدخول ودمج كود التتبع بالموقع

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8234. سجل دخولك ببيانات المشرف المولدة، وأنشئ مشروع موقعك، وانسخ كود التتبع الخفيف وضعه بموقعك لمتابعة إحصائيات الزوار الحية.

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

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

المنفذالغرض
8234Frontend / dashboard (host → container 3000)
8235API (host → container 5005) — where tracking events are sent
admin@example.comGenerated password, printed after install — change it
ClickHouse + RedisInternal — ClickHouse stores your analytics data

نظرة عامة

تعد Swetrix منصة تحليلات ويب مفتوحة المصدر بالكامل وعصرية صُممت لتكون بديلاً ممتازاً ومحترماً للخصوصية لمنصة Google Analytics. تعمل المنصة عبر المنفذ 8234 (لوحة التحكم الأمامية) والمنفذ 8235 (مجمع بيانات التتبع البرمجي API)، لتقدم إحصائيات شاملة لزيارات المواقع، ومصادر الإحالة، ومسارات التحويل (Funnels)، وتتبع الأحداث المخصصة، ومراقبة سرعة تحميل الصفحات وسجلات أخطاء JavaScript دون جمع بيانات المستخدمين الشخصية ودون الحاجة لنوافذ الكوكيز المنبثقة، بالاعتماد على قاعدة بيانات ClickHouse التحليلية فائقة السرعة.

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

تعاني منصة Google Analytics 4 من التعقيد الشديد والبطء، فضلاً عن انتهاك خصوصية الزوار بملفات التتبع ومخالفة لوائح حماية البيانات الأوروبية (GDPR). تمنحك Swetrix لوحة تحكم نظيفة وسريعة تحترم خصوصية زوارك: تتبع الزيارات المباشرة، ومسارات الشراء، وسرعة الموقع بكود خفيف لا يتجاوز 5 كيلوبايت، دون أي ملفات كوكيز، مع ملكية كاملة لبياناتك على سيرفرك الخاص.

متى تحتاجه

  • تبحث عن بديل مفتوح المصدر لـ Google Analytics متوافق مع GDPR لا يتطلب عرض لافتات الكوكيز المنبثقة
  • تحتاج إلى محرك تحليلات فائق السرعة بـ ClickHouse قادر على معالجة ملايين الزيارات شهرياً بكفاءة
  • تريد تتبع أهداف التحويل المخصصة ومسارات قمع المبيعات ومصادر الحملات التسويقية (UTM)
  • تحتاج إلى مراقبة سرعة تحميل الصفحات ومؤشرات تجربة المستخدم (Core Web Vitals) وسجلات أخطاء المتصفح
  • تريد سيادة واستقلالية كاملة على بيانات زوار موقعك دون مشاركتها مع شركات الإعلانات

من يحتاجه

  • أصحاب المواقع والمدونات ومؤسسو مشاريع الـ SaaS للحصول على تحليلات دقيقة ونظيفة بدون نوافذ كوكيز مزعجة
  • فرق التسويق الرقمي لتتبع معدلات التحويل وقنوات الإحالة ونتائج الحملات الإعلانية بدقة
  • مطورو الواجهات الأمامية لمراقبة أداء سرعة الصفحات وسجلات أخطاء JavaScript لدى الزوار الحقيقيين
  • المؤسسات الملتزمة بمعايير حماية البيانات والخصوصية الصارمة (GDPR وCCPA وPECR)
  • أصحاب السيرفرات المنزلية لاستضافة خادم تحليلات مركزي لكافة مواقعهم وتطبيقاتهم الشخصية

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

  • تتبع الزيارات ومصادر الإحالة والدول للشركات والمواقع الإخبارية في الوقت الفعلي
  • قياس نسب إتمام عمليات الشراء في المتاجر الإلكترونية وتحديد الصفحات التي يتراجع عندها العملاء
  • مراقبة سرعة تحميل الموقع ومؤشرات Core Web Vitals عبر مختلف الدول وأنواع الأجهزة
  • التقاط أخطاء JavaScript البرمجية غير المعالجة بمتصفحات المستخدمين لتصحيحها فوراً
  • مشاركة روابط لوحات تحكم عامة أو محمية بكلمة مرور مع العملاء وأصحاب المصلحة

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

  • خالٍ بنسبة 100% من الكوكيز ومتوافق مع GDPR: تتبع دقيق بدون جمع عناوين IP وبدون نوافذ موافقة
  • قاعدة بيانات ClickHouse التحليلية: معالجة واستعلام مليارات السجلات في أجزاء من الثانية
  • كود تتبع فائق الخفة: كود برمجي بحجم أقل من 5 كيلوبايت يعمل لا متزامناً دون أي تأثير على سرعة الموقع
  • تتبع الأحداث المخصصة ومسارات القمع: تتبع النقرات، والتسجيل، والمبيعات، ومسارات التحويل متعددة الخطوات
  • مراقبة الأداء والأخطاء: قياس سرعة تحميل الصفحات والتقاط استثناءات وأخطاء JavaScript اللحظية
  • لوحات تحكم عامة وقابلة للمشاركة: إنشاء روابط مشاهدة مخصصة لمشاركة الإحصائيات بشفافية
  • واجهة برمجية REST API متكاملة: استخراج البيانات برمجياً والربط مع أدوات التقارير الخارجية
  • معمارية Docker Compose تجمع الواجهة (منفذ 8234) والـ API (منفذ 8235) مع ClickHouse وRedis

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8234 لعرض لوحة تحكم Swetrix
  • سجل الدخول ببيانات المشرف المولدة (`admin@example.com` / كلمة المرور) وغيّر كلمة المرور فورياً
  • اضغط على '+ Add Project' واكتب اسم موقعك ونطاقه والمنطقة الزمنية لتوليد معرّف المشروع
  • انسخ كود التتبع المولد وضعه داخل وسم `<head>` في موقعك الإلكتروني
  • اضبط رابط مجمع الـ API في الكود ليشير إلى رابط سيرفرك العام (منفذ 8235)
  • ضع الواجهة (منفذ 8234) والـ API (منفذ 8235) خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx)
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./clickhouse-data`

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

  • تنبيه أمني حاسم: غيّر البريد وكلمة المرور الافتراضية للمشرف فور تسجيل الدخول لأول مرة
  • استخدم تشفير HTTPS دائماً للواجهة ومجمع الـ API لمنع حظر المتصفحات للمحتوى غير المشفر (Mixed Content)
  • أبقِ منافذ قواعد البيانات الداخلية (ClickHouse 8123 وRedis 6379) مغلقة ومعزولة داخل شبكة Docker
  • اضبط سياسات CORS في إعدادات الـ API لقصر استقبال بيانات التتبع على نطاقات مواقعك المعتمدة فقط
  • احمِ مجلد البيانات `./clickhouse-data` بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صور الحاويات دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم Swetrix لوحة التحكم عبر منفذ TCP 8234 (المحول من 3000 الداخلي) ومجمع بيانات الـ API عبر منفذ TCP 8235 (المحول من 5005 الداخلي). يجب السماح بالمنفذين 8234 و8235 في جدار الحماية للشبكة المحلية (`ufw allow 8234,8235/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 وأبقِ منافذ ClickHouse وRedis مغلقة خارجياً.

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

  • انسخ مجلد `./clickhouse-data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات ClickHouse وسجلات الزيارات التاريخية
  • انسخ مجلد `./redis-data` الذي يحتوي على الجلسات النشطة وبيانات الكاش المؤقتة
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع إحصائيات المواقع بنجاح

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

  • ضبط رابط كود التتبع بـ HTTP على موقع يعمل بـ HTTPS مما يتسبب في حظر المتصفحات لإرسال بيانات الزيارات
  • كشف منافذ ClickHouse وRedis للإنترنت العام مباشرة
  • عدم ربط مجلد التخزين الدائم `./clickhouse-data`، مما يسبب فقدان سجلات الزيارات عند تحديث الحاوية
  • تشغيل ClickHouse على سيرفر بذاكرة عشوائية أقل من 2 جيجابايت RAM مما يسبب انهيار الحاوية
  • ترك بيانات المشرف الافتراضية دون تغيير

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

  • الزيارات لا تسجل — افحص وحدة التحكم بالمتصفح بحثاً عن أخطاء Mixed Content أو CSP وتأكد من عمل مجمع الـ API
  • مجمع الـ API يعيد خطأ 500 — تأكد من عمل حاوية ClickHouse واستقرارها بالأمر `docker compose ps`
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs swetrix-api -f`
  • استهلاك مرتفع للذاكرة في ClickHouse — اضبط حدود الذاكرة القصوى في ملف المتغيرات
  • بيانات الموقع الجغرافي لا تظهر — تأكد من تهيئة وتنزيل قاعدة بيانات GeoLite2 بحاوية الـ API

البدائل

منصة Plausible Analytics الخفيفة. منصة Umami المبنية بـ Node.js. منصة Matomo الشاملة. منصة Shynet الخفيفة. منصة Google Analytics 4 السحابية.

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

تجنب استخدام Swetrix إذا كنت تبحث عن عداد زيارات فائق البساطة لمدونة شخصية صغيرة يزورها أقل من 100 زائر شهرياً (حيث تعد Umami مع SQLite أخف بكثير). وإذا كنت تحتاج إلى ربط متقدم جداً مع شبكات إعلانات Google Ads وإعادة الاستهداف الإعلاني، فإن Google Analytics مخصصة لحملات الإعلانات.

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

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

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

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

ما هي منصة Swetrix وكيف تقارن بـ Google Analytics؟

تعد Swetrix منصة تحليلات ويب مفتوحة المصدر تحترم الخصوصية وتعمل بدون ملفات كوكيز. وخلافاً لـ Google Analytics 4، لا تجمع Swetrix بيانات شخصية ولا تستخدم ملفات تتبع، مما يجعلها متوافقة تماماً مع قوانين GDPR بدون الحاجة لنوافذ الكوكيز.

لماذا تستخدم Swetrix قاعدة بيانات ClickHouse؟

تعد ClickHouse قاعدة بيانات عمودية تحليلية فائقة السرعة، تتيح لـ Swetrix استقبال ومعالجة ملايين أحداث الزيارات في الثانية الواحدة وتوليد تقارير لوحات التحكم في أجزاء من الثانية.

هل يمكن تتبع الأحداث المخصصة وأهداف التحويل في Swetrix؟

نعم! تدعم Swetrix تتبع الأحداث المخصصة عبر كود جافاسكريبت بسيط (مثل `swetrix.track('signup_completed')`) مع تتبع الخصائص الإضافية ومسارات قمع المبيعات متعددة الخطوات.

هل تدعم Swetrix مراقبة سرعة الصفحات وأخطاء الموقع؟

نعم! تتضمن Swetrix ميزة مراقبة الأداء (لقياس سرعة تحميل الصفحات ومؤشرات Core Web Vitals) وتتبع أخطاء الواجهة الأمامية لالتقاط استثناءات JavaScript الحية لدى الزوار.

كم تستهلك Swetrix من الذاكرة العشوائية (RAM)؟

تستهلك حزمة Swetrix بالكامل (الواجهة والـ API وقاعدة ClickHouse وكاش Redis) ما بين 600 ميجابايت إلى 1.5 جيجابايت من الذاكرة داخل Docker حسب كثافة الزيارات.