📈 تثبيت Shynet — تحليلات الويب الخالية من الكوكيز وتتبع الزوار بدون جافاسكريبت على Docker

نشر منصة Shynet على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لتحليلات الويب التي تحترم الخصوصية وتعمل بدون ملفات كوكيز وبدون الحاجة لجافاسكريبت عبر بكسل التتبع الشفاف وقاعدة بيانات PostgreSQL.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Shynet على المنفذ 8233 مع قاعدة بيانات PostgreSQL 15 وتحليلات خالية من الكوكيز.
عرض على GitHub

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

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

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

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

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

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

chmod +x shynet-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين لقاعدة بيانات PostgreSQL 15 (`./db`) وتنفيذ ترحيلات Django وتشغيل حاويتي Shynet وقاعدة البيانات على المنفذ 8233 (المحول من 8080 الداخلي).

sudo bash shynet-ubuntu.sh

4 إنشاء حساب المشرف ونسخ كود التتبع

أنشئ حساب المشرف بأمر (`docker exec -it shynet ./manage.py registeradmin`)، وافتح الرابط http://ip-سيرفرك:8233، وأنشئ موقعك، وانسخ كود جافاسكريبت أو بكسل التتبع الشفاف (1x1 Pixel) إلى موقعك.

docker exec -it shynet ./manage.py registeradmin your@email.com

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

المنفذالغرض
8233Web UI (host → container 8080)
registeradminNo default login — create the admin via a management command
no-JS pixelTracks visits even when JavaScript is disabled; PostgreSQL backend

نظرة عامة

تعد Shynet منصة تحليلات ويب عصرية مفتوحة المصدر تضع خصوصية الزوار في المقام الأول. تم بناؤها باستخدام بايثون (إطار عمل Django) وقاعدة بيانات PostgreSQL، لتمنح أصحاب المواقع تحليلات دقيقة لحركة المرور دون انتهاك خصوصية المستخدمين. تعمل المنصة عبر المنفذ 8233 (المحول من 8080 الداخلي)، وتقوم بتتبع مشاهدات الصفحات، والزوار الفريدين، والمواقع المرجعية المحيلة، ونسب الارتداد، والأجهزة، والدول الجغرافية دون استخدام ملفات تعريف الارتباط (Cookies)، ودون جمع أي بيانات شخصية (PII)، وبدون الحاجة لعرض لافتات الموافقة على الكوكيز بموجب قوانين GDPR. كما تتضمن بكسل تتبع شفاف (1x1 Pixel) يتيح تسجيل الزيارات حتى عند تعطيل جافاسكريبت.

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

تتسم أداة Google Analytics 4 (GA4) بانتهاك خصوصية الزوار وتتبع تحركاتهم عبر الإنترنت، فضلاً عن إبطاء سرعة الموقع بالأكواد الثقيلة وإجبار أصحاب المواقع على عرض نوافذ الكوكيز المزعجة للامتثال للقوانين الأوروبية. تمنحك الاستضافة الذاتية لـ Shynet تحليلات واضحة ونقية: إحصائيات دقيقة بدون كوكيز، وتخلص تام من نوافذ الكوكيز المنبثقة، وسيادة كاملة بنسبة 100% على بياناتك بسيرفرك الخاص.

متى تحتاجه

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

من يحتاجه

  • أصحاب المواقع والمدونون والكتاب التقنيون للحصول على إحصائيات قراءة نقية بدون كوكيز
  • المطورون ومديرو المشاريع مفتوحة المصدر لتضمين بكسل التتبع في صفحات GitHub README وتوثيقات المشاريع
  • الشركات والمؤسسات الحريصة على الالتزام بالقوانين الأوروبية لحماية خصوصية البيانات
  • مطورو الواجهات الأمامية الباحثون عن أكواد تتبع خفيفة جداً لا تبطئ أداء وسرعة تصفح المواقع
  • أصحاب السيرفرات المنزلية لاستضافة لوحة تحليلات مستقلة وخفيفة لمواقعهم على سيرفرات Ubuntu

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

  • تضمين بكسل تتبع شفاف بحجم 1x1 في النشرات البريدية أو صفحات التوثيق لقياس عدد القراءات بدون جافاسكريبت
  • تتبع الزوار والصفحات الأكثر زيارة والمواقع المحيلة لـ 10 مواقع مختلفة من لوحة تحكم Shynet موحدة
  • إلغاء لافتات ونوافذ الكوكيز المنبثقة نهائياً من موقع شركتك بالاعتماد على التتبع الخالي من الكوكيز
  • معرفة مصادر الزيارات الأكثر تفاعلاً مع مقالاتك التقنية (Hacker News، وReddit، وتويتر)
  • قياس سرعة تحميل الصفحات ومعدلات الارتداد في مواقع التوثيق دون استخدام أكواد تتبع خارجية

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

  • خالٍ من الكوكيز افتراضياً: يعتمد على بصمات مشفرة ومجهولة الهوية دون أي ملفات تعريف ارتباط دائمة أو localStorage
  • بكسل تتبع بدون جافاسكريبت (No-JS Pixel): تتبع الزيارات عبر صورة شفافة خفيفة عند تعطيل جافاسكريبت بالمتصفح
  • امتثال تام لمعايير GDPR وCCPA: لا يجمع أي بيانات شخصية مما يلغي الحاجة القانونية لنوافذ الكوكيز
  • لوحة تحكم عصرية وبسيطة على المنفذ 8233: عرض رسوم بيانية للزوار، وأفضل الصفحات، والمواقع المحيلة، والأجهزة، والدول
  • إدارة مواقع متعددة: إنشاء وتتبع عشرات المواقع والنطاقات الفرعية المستقلة من لوحة واحدة
  • كود تتبع فائق الخفة: حجم كود جافاسكريبت أقل من 1 كيلوبايت وينفذ في أجزاء من المللي ثانية
  • معمارية Django وPostgreSQL: قاعدة بيانات علائقية متطورة مع ترحيلات آلية للبيانات
  • معمارية Docker Compose تجمع Shynet مع PostgreSQL 15 على مجلدات حفظ دائم

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

  • أنشئ حساب المشرف الأول بتنفيذ أمر: `docker exec -it shynet ./manage.py registeradmin your-email@domain.com`
  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8233 وسجل الدخول ببيانات المشرف
  • اضغط على 'New Service' واكتب اسم موقعك ونطاقه واضغط 'Create'
  • انسخ كود جافاسكريبت الخفيف أو كود صورة بكسل التتبع الشفاف (1x1 Pixel)
  • الصق الكود داخل وسم `<head>` أو `<footer>` في موقعك الإلكتروني
  • ضع Shynet خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • تصفح موقعك وتأكد من تسجيل الزيارات وظهورها فورياً في لوحة تحكم Shynet

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

  • تنبيه أمني حاسم: استخدم تشفير HTTPS دائماً في الإنتاج — لتشفير حزم التتبع وجلسات المشرفين أثناء النقل
  • اضبط متغير `SCRIPT_USE_HTTPS=True` وعيّن شفرة عشوائية قوية لـ `SECRET_KEY` في متغيرات البيئة
  • أبقِ منفذ قاعدة البيانات PostgreSQL 5432 معزولاً داخل شبكة Docker ولا تكشفه للإنترنت العام
  • فعل خيار `ONLY_SUPERUSERS_CAN_CREATE_SERVICES=True` لمنع الزوار من إنشاء خدمات تتبع عشوائية
  • احمِ مجلد البيانات `./db` الذي يحتوي على قاعدة البيانات بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم Shlink واجهة الويب ونقاط استقبال التتبع عبر منفذ TCP 8233 (المحول من 8080 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8233، مع إبقاء المنفذ 8233 ومنفذ قاعدة البيانات 5432 مغلقين في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 للزوار.

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

  • انسخ مجلد `./db` احتياطياً، والذي يحتوي على قاعدة بيانات PostgreSQL بكافة الخدمات وإحصائيات الزوار
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على متغيرات البيئة والمفاتيح السرية
  • استخرج نسخة احتياطية دورية لقاعدة البيانات عبر pg_dump: `docker exec shynet-db pg_dump -U shynet shynet > shynet_backup.sql`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من ظهور كافة إحصائيات المواقع بنجاح

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

  • نسيان إنشاء حساب المشرف الأول عبر أمر `docker exec -it shynet ./manage.py registeradmin` بعد التثبيت
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر مما يدفع المتصفحات لحظر كود التتبع بسبب قيود المحتوى المختلط
  • عدم ربط مجلد التخزين الدائم `./db`، مما يسبب فقدان سجلات الزوار عند تحديث الحاوية
  • كتابة قيمة خاطئة لمتغير `SHYNET_HOST` مما يولد روابط تتبع غير صحيحة داخل لوحة التحكم
  • كشف منفذ قاعدة البيانات PostgreSQL 5432 للإنترنت العام مباشرة

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

  • تعذر تسجيل الدخول بعد التثبيت — أنشئ حساب المشرف بالأمر: `docker exec -it shynet ./manage.py registeradmin`
  • المتصفح يحظر كود التتبع — تأكد من تشغيل سيرفر Shynet بشهادة SSL صالحة ومطابقة لبروتوكول HTTPS بموقعك
  • الزيارات لا تظهر في اللوحة — تأكد من مطابقة نطاق موقعك للنطاق المسجل في إعدادات خدمة Shynet
  • ظهور خطأ HTTP 500 في الواجهة — افحص سجلات أخطاء Django بالأمر: `docker logs shynet -f` وتأكد من اكتمال الترحيلات
  • خطأ الاتصال بقاعدة البيانات عند التثبيت — تأكد من عمل حاوية PostgreSQL ومطابقة بيانات الدخول في Compose

البدائل

منصة Umami لتحليلات الويب الموجهة للخصوصية. منصة Plausible مفتوحة المصدر. أداة GoatCounter البسيطة. منصة Matomo الشاملة للمؤسسات. أداة Google Analytics 4 التجارية.

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

تجنب استخدام Shynet إذا كنت تحتاج إلى مسارات تحويل مبيعات تجارة إلكترونية معقدة (E-Commerce Funnels) وخرائط حرارية لنقرات المستخدمين (حيث صُممت أدوات مثل Matomo أو PostHog للتحليلات المتقدمة). وإذا كنت تبحث عن منصة تحليلات مبنية بـ Node.js تتيح روابط مشاركة عامة للتحليلات، فإن Umami بديل شهير.

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

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

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

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

هل يتطلب استخدام Shynet عرض لافتة الموافقة على الكوكيز بموجب GDPR؟

لا! لأن Shynet لا يستخدم ملفات تعريف الارتباط (Cookies)، ولا يستخدم التخزين المحلي، ولا يجمع بيانات شخصية للمستخدمين، فلن تحتاج لعرض نوافذ الكوكيز المزعجة بموجب قوانين GDPR أو CCPA.

كيف يتتبع Shynet الزيارات بدون تفعيل جافاسكريبت؟

يوفر Shynet وسم صورة شفافاً بحجم 1x1 بكسل (`<img src="https://your-shynet/pixel/...">`). بمجرد تحميل المتصفح للصورة، يسجل السيرفر الزيارة تلقائياً، مما يتيح التتبع حتى في حال تعطيل جافاسكريبت.

كيف أقوم بإنشاء حساب المشرف الأول في Shynet؟

بعد تشغيل الحاوية، نفذ الأمر التالي في الطرفية: `docker exec -it shynet ./manage.py registeradmin your-email@example.com` واتبع التعليمات لتعيين كلمة المرور.

هل يمكن تتبع أكثر من موقع على نفس سيرفر Shynet؟

نعم! يمكنك إنشاء عدد غير محدود من 'الخدمات' (Services) داخل Shynet، حيث يمثل كل موقع خدمة مستقلة بكود تتبع ورسوم بيانية منفصلة.

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

يستهلك تطبيق Shynet مع قاعدة بيانات PostgreSQL حوالي 100 إلى 200 ميجابايت فقط من الذاكرة العشوائية داخل Docker مجتمعة.