VPS: إعداد Plausible على نظام التشغيل

تم إنشاء هذا الدليل باستخدام المنتجات التالية:

(قد تختلف التفاصيل مع المنتجات من مزودين مختلفين ولكن المفاهيم الرئيسية تظل كما هي)

خادم افتراضي خاص

مقدمة

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: التكامل مع Google.

إذا كنت تستخدم Google Search Console، يمكنك تكوين التكامل مع Google لسحب بيانات من Search Console حول مصطلحات البحث، وهذا شيء رائع جدًا.

إذا كان لديك حساب Google Cloud مع عميل OAuth، يمكنك ببساطة لصق GOOGLE_CLIENT_ID و GOOGLE_CLIENT_SECRET في ملف .env، ثم إعادة تشغيل خدمة Docker باستخدام docker compose up -d، واتباع التعليمات في شاشة إعدادات الموقع > التكاملات في Plausible.

الخاتمة والمزيد من الموارد

تهانينا! لقد قمت الآن بتثبيت وتكوين Plausible بنجاح على VPS الخاص بك. نوصي أيضًا بإلقاء نظرة على الموارد التالية، التي قد توفر لك مساعدة إضافية وإرشادات أثناء عملية تكوين السيرفر:

• Plausible.io - الموقع الرسمي
• github.com/Plausible/analytics - الإعلانات، المناقشات، تقارير المشاكل

هل لديك أسئلة محددة غير مغطاة هنا؟ لأي استفسارات أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم الخاص بنا، المتوفر يوميًا لمساعدتك! 🙂