إعداد Plausible Analytics على سيرفر Linux - تشغيل تحليلات ويب تركز على الخصوصية
المنتجات المثالية لهذا الدليل
ابدأ على الفور — اطلب المنتج المناسب واتبع هذا الدليل خطوة بخطوة.
مقدمة
Plausible هو منصة تحليلات ويب مفتوحة المصدر وخفيفة الوزن تعمل بدون ملفات تعريف الارتباط (كوكيز) وتلتزم تمامًا بلوائح الخصوصية. يقدم مقاييس رئيسية مثل عدد الزوار، وعدد مرات مشاهدة الصفحات، ومدة الزيارة، عبر لوحة معلومات نظيفة وبديهية. بفضل سهولة الاستخدام، والأداء السريع، والبنية التحتية المستندة إلى الاتحاد الأوروبي، يُعتبر Plausible بديلاً حديثًا وواعٍ للخصوصية عن Google Analytics.
تفكر في استضافة هذه الخدمة بنفسك؟ سنرشدك خطوة بخطوة حول كيفية إعدادها وتكوينها، مع كل ما تحتاج لمعرفته للحفاظ على سير العمل بسلاسة.
المتطلبات الأساسية
قبل تثبيت Plausible، تأكد من أن بيئة الاستضافة الخاصة بك تلبي المتطلبات التالية لضمان تثبيت سلس وأداء مثالي.
| العتاد | الحد الأدنى | توصية ZAP-Hosting |
|---|---|---|
| CPU | 1 نواة vCPU | 4 أنوية vCPU |
| 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 Wiki: Google Integration.
إذا كنت تستخدم Google Search Console، يمكنك تكوين تكامل Google لسحب بيانات استعلامات البحث، وهذا شيء رائع جدًا.
إذا كان لديك حساب Google Cloud مع عميل OAuth، يمكنك ببساطة لصق GOOGLE_CLIENT_ID و GOOGLE_CLIENT_SECRET في ملف .env، أعد تشغيل خدمة Docker باستخدام docker compose up -d، واتبع التعليمات في شاشة إعدادات الموقع > التكاملات في Plausible.
الخاتمة والمزيد من الموارد
مبروك! لقد قمت الآن بتثبيت وتكوين Plausible بنجاح على VPS/سيرفر مخصص الخاص بك. نوصي أيضًا بإلقاء نظرة على الموارد التالية، التي قد توفر لك مساعدة إضافية وإرشادات خلال عملية تكوين السيرفر:
- Plausible.io - الموقع الرسمي
- github.com/Plausible/analytics - الإعلانات، المناقشات، تقارير المشاكل
هل لديك أسئلة محددة غير مغطاة هنا؟ لأي استفسارات أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم الخاص بنا، المتوفر يوميًا لمساعدتك! 🙂