سيرفر مخصص: تثبيت Plausible على نظام التشغيل
تم إنشاء هذا الدليل باستخدام المنتجات التالية:
(قد تختلف التفاصيل مع المنتجات من مزودين مختلفين ولكن المفاهيم الرئيسية تظل كما هي)
مقدمة
Plausible هي منصة تحليلات ويب خفيفة الوزن ومفتوحة المصدر تعمل بدون ملفات تعريف الارتباط (كوكيز) وتلتزم تمامًا بلوائح الخصوصية. تقدم مقاييس رئيسية مثل عدد الزوار، وعدد مرات مشاهدة الصفحات، ومدة الزيارة، عبر لوحة معلومات نظيفة وبديهية. بفضل سهولة الاستخدام، والأداء السريع، والبنية التحتية القائمة في الاتحاد الأوروبي، تُعد Plausible بديلاً حديثًا وواعياً للخصوصية عن Google Analytics.
تفكر في استضافة هذه الخدمة بنفسك؟ سنرشدك خطوة بخطوة حول كيفية إعدادها وتكوينها، مع كل ما تحتاج لمعرفته.
المتطلبات الأساسية
قبل تثبيت Plausible، تأكد من أن بيئة الاستضافة الخاصة بك تلبي المتطلبات التالية لضمان تثبيت سلس وأداء مثالي.
| الأجهزة | الحد الأدنى | توصية ZAP-Hosting |
|---|---|---|
| CPU | 1 نواة CPU | 4 أنوية CPU |
| RAM | 2 جيجابايت | 4 جيجابايت |
| مساحة القرص | 10 جيجابايت | 25 جيجابايت |
يتطلب البرنامج تثبيت جميع التبعيات اللازمة وأن يعمل على نظام تشغيل مدعوم. تأكد من أن سيرفرك يلبي المتطلبات التالية قبل المتابعة بالتثبيت:
التبعيات: Docker
نظام التشغيل: أحدث إصدار من Ubuntu/Debian يدعم Docker 26+
تأكد من تثبيت جميع التبعيات واستخدام إصدار نظام التشغيل الصحيح لتجنب مشاكل التوافق أثناء تثبيت Plausible.
التحضير
قبل إعداد Plausible، تحتاج إلى تحضير نظامك. يشمل ذلك تحديث نظام التشغيل إلى أحدث إصدار وتثبيت جميع التبعيات المطلوبة. هذه التحضيرات تضمن بيئة مستقرة وتساعد في منع المشاكل أثناء أو بعد التثبيت.
تحديث النظام
للتأكد من أن نظامك يعمل بأحدث البرامج وتحسينات الأمان، يجب عليك دائمًا تنفيذ تحديثات النظام أولاً. للقيام بذلك، شغّل الأمر التالي:
sudo apt update && sudo apt upgrade -y
هذا يضمن أن نظامك يحتوي على أحدث تصحيحات الأمان وإصدارات البرامج قبل المتابعة.
تثبيت التبعيات
بمجرد الانتهاء من عملية التحديث، يمكنك الآن متابعة تثبيت التبعيات.
Git
سيتم تنزيل بيانات Plausible عبر GitHub. لذلك، يجب تثبيت Git أولاً. للقيام بذلك، شغّل الأمر التالي:
sudo apt install git-all
Docker
سيتم نشر وتشغيل Plausible على جهازك باستخدام حاوية Docker. لذلك، يجب تثبيت Docker أولاً. للقيام بذلك، شغّل الأمر التالي:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
يتوفر شرح كامل لعملية التثبيت وكيفية استخدام Docker في دليلنا الخاص بـ Docker.
التثبيت
الآن بعد أن تم استيفاء جميع المتطلبات واكتمال التحضيرات اللازمة، يمكنك المتابعة بتثبيت تطبيق Plausible.
ابدأ باستنساخ مستودع النسخة المجتمعية وإنشاء ملف التكوين اللازم:
$ git clone -b v3.0.1 --single-branch https://github.com/Plausible/community-edition Plausible-ce
بعد ذلك، أنشئ ملف بيئة (.env) وحدد المتغيرات الأساسية. يجب أن يشير BASE_URL إلى النطاق الفعلي الذي يحتوي بالفعل على سجل DNS يحل إلى سيرفرك. ستحتاج أيضًا إلى توليد SECRET_KEY_BASE عشوائي لا يقل عن 64 بايت:
touch .env
echo "BASE_URL=https://Plausible.example.com" >> .env
echo "SECRET_KEY_BASE=$(openssl rand -base64 48)" >> .env
echo "HTTP_PORT=80" >> .env
echo "HTTPS_PORT=443" >> .env
تحقق من محتوى الملف باستخدام cat .env للتأكد من صحة القيم. يجب أن يكون الإخراج كالتالي:
BASE_URL=https://Plausible.example.com
SECRET_KEY_BASE=As0fZsJlUpuFYSthRjT5Yflg/NlxkFKPRro72xMLXF8yInZ60s6xGGXYVqml+XN1
HTTP_PORT=80
HTTPS_PORT=443
تسمح هذه المنافذ الافتراضية لـ Let’s Encrypt بإصدار شهادات TLS تلقائيًا. إذا كنت تخطط لتشغيل Plausible خلف بروكسي عكسي، يمكنك تعديل هذه القيم. بالإضافة إلى ذلك، أنشئ ملف compose.override.yml لكشف المنافذ الصحيحة لحاوية Plausible:
cat > compose.override.yml << EOF
services:
Plausible:
ports:
- 80:80
- 443:443
EOF
أخيرًا، ابدأ الخدمات المطلوبة باستخدام Docker Compose:
docker compose up -d
بمجرد تشغيل الحاويات، افتح متصفحك على النطاق المحدد في BASE_URL وأنشئ أول حساب مستخدم.
التكوين
يمكن دمج Plausible مع Google Search Console لتعزيز تحليلاتك ببيانات استعلامات البحث. هذا يتيح لك رؤية الكلمات المفتاحية التي تجلب حركة المرور إلى موقعك، مما يوفر رؤى أعمق حول سلوك الزوار.
مع وجود حساب Google Cloud قائم وعميل OAuth مُعد، كل ما عليك هو إضافة بيانات الاعتماد (GOOGLE_CLIENT_ID و GOOGLE_CLIENT_SECRET) إلى ملف .env. بعد الحفظ، أعد تشغيل خدمات Docker باستخدام docker compose up -d. في لوحة معلومات Plausible، اذهب إلى إعدادات الموقع > التكاملات لإكمال الاتصال واتباع تعليمات المصادقة.
لمن لا يمتلك عميل OAuth بعد أو غير مألوف مع العملية، يقدم ويكي Plausible الرسمي دليلًا تفصيليًا خطوة بخطوة. يشرح كيفية إنشاء مشروع في Google Cloud، وتمكين APIs المطلوبة، وتكوين عميل OAuth، وإضافة بيانات الاعتماد المولدة إلى Plausible: ويكي Plausible: التكامل مع Google.
إذا كنت تستخدم Google Search Console، يمكنك تكوين التكامل مع Google لسحب بيانات من Search Console حول مصطلحات البحث، وهذا شيء رائع جدًا.
إذا كان لديك حساب Google Cloud مع عميل OAuth، يمكنك ببساطة لصق GOOGLE_CLIENT_ID و GOOGLE_CLIENT_SECRET في ملف .env، وأعد تشغيل خدمة Docker باستخدام docker compose up -d، واتبع التعليمات في شاشة إعدادات الموقع > التكاملات في Plausible.
الخاتمة والمزيد من الموارد
تهانينا! لقد قمت الآن بتثبيت وتكوين Plausible بنجاح على سيرفرك المخصص. نوصي أيضًا بإلقاء نظرة على الموارد التالية، والتي قد توفر لك مساعدة إضافية وإرشادات خلال عملية تكوين السيرفر:
- Plausible.io - الموقع الرسمي
- github.com/Plausible/analytics - الإعلانات، المناقشات، تقارير المشاكل
هل لديك أسئلة محددة غير مغطاة هنا؟ لأي استفسارات أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم لدينا، المتوفر يوميًا لمساعدتك! 🙂