📝 تثبيت Grav — نظام إدارة محتوى بملفات مسطحة دون قاعدة بيانات

انشر Grav على Ubuntu بـ Docker — نظام إدارة محتوى سريع بملفات مسطحة يخزّن المحتوى كملفات Markdown دون أي قاعدة بيانات، مع لوحة إدارة اختيارية، على المنفذ 8228.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Grav على المنفذ 8228. لا توجد قاعدة بيانات: المحتوى ملفات Markdown على القرص. أنشئ حساب المسؤول على /admin عند الزيارة الأولى.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/cms/grav/grav-ubuntu.sh
chmod +x grav-ubuntu.sh
./grav-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/cms/grav/grav-ubuntu.sh

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

chmod +x grav-ubuntu.sh

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

./grav-ubuntu.sh

4 إنشاء حساب المسؤول

http://your-server-ip:8228/admin

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

المنفذالغرض
8228Grav website and admin panel (mapped from container port 80)

نظرة عامة

Grav نظام إدارة محتوى سريع بملفات مسطحة مكتوب بلغة PHP يخزّن كل صفحة كملف Markdown على القرص بدلاً من صفوف في قاعدة بيانات. هيكل المجلدات على نظام الملفات يعكس مباشرة هيكل صفحات الموقع وتسلسل الروابط، بحيث لا توجد MySQL أو PostgreSQL أو SQLite يجب تثبيتها أو تأمينها أو نسخها احتياطياً أو ضبطها. يعرض Grav الصفحات بتحليل Markdown وبيانات YAML الأمامية عبر نظام قوالب قائم على Twig، مع طبقة تخزين مؤقت قوية تحافظ على أداء سريع رغم غياب قاعدة البيانات. توفر لوحة إدارة اختيارية عبر الويب تجربة تحرير صفحات مألوفة للمستخدمين الذين لا يريدون تحرير ملفات Markdown مباشرة.

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

كل نظام إدارة محتوى تقليدي — WordPress وDrupal وJoomla — يخزّن المحتوى في قاعدة بيانات، وهذا يعني حاوية قاعدة بيانات يجب تشغيلها وتأمينها ونسخها احتياطياً بشكل منفصل عن ملفاتك وإبقاءها مُحدَّثة ضد حقن SQL وثغرات أخرى خاصة بقواعد البيانات. يزيل Grav هذه الطبقة بأكملها: محتواك مجرد ملفات Markdown في مجلدات، مما يعني أنه يمكن تحريرها بأي محرر نصوص، وتتبعها في Git بتاريخ إصدارات كامل، واستعادتها بمجرد نسخ الملفات مرة أخرى. للمطورين والمستخدمين التقنيين المرتاحين مع الملفات وGit، وللمواقع التي لا تحتاج بيانات علائقية معقدة، يقدم Grav موقعاً سريعاً وآمناً بعبء تشغيلي أقل بكثير من نظام إدارة محتوى مرتبط بقاعدة بيانات.

متى تحتاجه

  • تريد نظام إدارة محتوى دون قاعدة بيانات يجب تثبيتها أو تأمينها أو تصحيحها أو نسخها احتياطياً بشكل منفصل عن محتواك
  • تريد تخزين محتوى موقعك كملفات Markdown عادية يمكنك تحريرها وإصدارها ومقارنتها مثل الكود
  • أنت مرتاح مع Git وتريد تاريخاً كاملاً للمحتوى وسير عمل تحريري قائم على طلبات السحب (pull requests)
  • تحتاج موقعاً سريعاً وخفيفاً (مدونة، توثيق، بورتفوليو، موقع أعمال صغير) دون عبء قاعدة البيانات
  • تريد إزالة حقن SQL كفئة كاملة من الثغرات بعدم امتلاك قاعدة بيانات على الإطلاق
  • تريد خيار لوحة إدارة مألوفة للمحررين غير التقنيين مع الحفاظ على التخزين الأساسي كملفات

من يحتاجه

  • المطورون والكتّاب التقنيون الذين يريدون إدارة محتوى الموقع كملفات Markdown في مستودع Git
  • مشغلو المختبرات المنزلية والمستضيفون الذاتيون الذين يريدون مدونة شخصية أو موقع بورتفوليو دون تشغيل حاوية قاعدة بيانات
  • فرق التوثيق التي تريد محتوى خاضعاً للتحكم بالإصدار وقابلاً للمقارنة مع تاريخ تحرير كامل عبر Git
  • الشركات الصغيرة والمستقلون الذين يحتاجون موقعاً بسيطاً وسريعاً دون العبء التشغيلي لـ WordPress وMySQL
  • أصحاب المواقع المهتمون بالخصوصية والأمان الذين يريدون إزالة سطح هجوم قاعدة البيانات بالكامل
  • الوكالات التي تبني مواقع عملاء يجب تسليمها لمحرري محتوى لا يريدون تعلّم SQL أو أدوات معقدة
  • أي شخص يهاجر من نظام إدارة محتوى ثقيل الاعتماد على قواعد البيانات ويريد تحميل صفحات أسرع ونسخاً احتياطية أبسط

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

  • تشغيل مدونة شخصية أو موقع بورتفوليو حيث كل منشور ملف Markdown يمكنك تحريره محلياً ودفعه بـ Git
  • استضافة توثيق تقني يستفيد من التحكم بالإصدار والمقارنات ومراجعة طلبات السحب لتغييرات المحتوى
  • بناء موقع تسويقي لشركة صغيرة بتحميل صفحات سريع وأدنى صيانة سيرفر
  • ترحيل مشروع مولّد موقع ثابت (Jekyll، Hugo) لنظام يوفر أيضاً لوحة إدارة ويب اختيارية
  • تشغيل موقع قليل الصيانة حيث النسخ الاحتياطي بسيط كنسخ مجلد، دون الحاجة لتفريغ قاعدة بيانات
  • نشر موقع يحتاج تحمّل ارتفاعات الحركة بتكلفة زهيدة بفضل التخزين المؤقت القوي القائم على الملفات في Grav

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

  • تخزين بملفات مسطحة — كل صفحة ملف Markdown ببيانات YAML أمامية، دون أي قاعدة بيانات مطلوبة من أي نوع
  • هيكل مجلدات يعكس مباشرة تسلسل روابط الموقع وتنقّله، مما يجعل تنظيم المحتوى بديهياً
  • لوحة إدارة اختيارية عبر الويب لإنشاء وتحرير وتنظيم الصفحات دون لمس الملفات مباشرة
  • محرك قوالب قائم على Twig للسمات، يمنح تحكماً دقيقاً في التخطيط والتصميم
  • تخزين مؤقت متعدد الطبقات وقوي (تخزين الصفحة، تخزين Twig، تخزين الإعداد) يحافظ على أداء سريع دون قاعدة بيانات
  • ملائم لـ Git بالتصميم — يمكن رفع المحتوى ومقارنته وتفريعه ومراجعته عبر طلبات سحب مثل الكود
  • سوق إضافات وسمات لتوسيع الوظائف، من أدوات SEO إلى النماذج إلى تحسين الصور
  • دعم متعدد اللغات مدمج لإدارة المحتوى المترجم عبر نسخ لغوية متعددة لنفس الصفحات

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

  • زر /admin عند الإطلاق الأول لإنشاء حساب المسؤول عبر معالج الإعداد
  • استكشف لوحة الإدارة لإنشاء صفحاتك الأولى، أو ابدأ تحرير ملفات Markdown مباشرة في مجلد user/pages
  • اختر وثبّت سمة من سوق Grav، أو خصّص قوالب Twig للسمة الافتراضية
  • ثبّت إضافات للوظائف التي تحتاجها، مثل SEO أو النماذج أو محسّن الصور، عبر لوحة الإدارة
  • إذا فضّلت التحرير القائم على الملفات، اربط مجلد المحتوى بمستودع Git للنشر الخاضع للتحكم بالإصدار
  • اضبط إعدادات موقعك الأساسية (اسم الموقع، اللغة، المنطقة الزمنية) في قسم إعداد لوحة الإدارة
  • اضبط سلوك التخزين المؤقت المناسب لنمط حركتك، لأن تخزين Grav المؤقت هو ما يحافظ على سرعة موقع بدون قاعدة بيانات
  • انسخ احتياطياً مجلد user/ الذي يحتوي صفحاتك وإعدادك والوسائط المرفوعة، بمجرد أن يصبح موقعك مباشراً

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

  • بدون قاعدة بيانات، فئة كاملة من الثغرات — حقن SQL — لا تنطبق ببساطة على Grav
  • عيّن كلمة مرور قوية لحساب لوحة الإدارة، لأنه يملك تحكماً كاملاً في محتوى الموقع وإعداده
  • حافظ على تحديث نواة Grav وكل الإضافات والسمات المثبتة، لأن ثغرات الإضافات لا تزال ممكنة حتى دون قاعدة بيانات
  • قيّد صلاحيات الملفات على مجلد user/ بشكل مناسب حتى تستطيع فقط عملية سيرفر الويب الكتابة إليه
  • ضع وكيلاً عكسياً مع HTTPS أمام Grav لأي نشر إنتاجي أو عام
  • عطّل أو احمِ بكلمة مرور مسار لوحة الإدارة إذا لم تحتج التحرير عبر الويب، مما يقلل سطح الهجوم
  • راجع الإضافات المثبتة دورياً وأزل أي منها غير مستخدم، لأن كل إضافة كود إضافي يعمل على موقعك
  • انسخ احتياطياً مجلد user/ بانتظام، لأنه المصدر الوحيد للحقيقة لمحتوى موقعك بأكمله

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

يستمع Grav على منفذ المضيف 8228 في هذا النشر، معيّن من المنفذ الداخلي 80 للحاوية، ويخدم كلاً من الموقع العام ولوحة /admin على نفس المنفذ. لأي استخدام إنتاجي أو عام، ضع Grav خلف وكيل عكسي مع HTTPS، لأن تسجيل دخول لوحة الإدارة لا يجب أن يُنقل أبداً عبر HTTP عادي. على شبكة داخلية موثوقة تُستخدم فقط لتحرير المحتوى، قد يكون HTTP العادي عبر المنفذ 8228 مقبولاً، لكن قيّد الوصول بقواعد جدار ناري إذا كان السيرفر قابلاً للوصول خارج شبكتك المحلية.

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

  • انسخ احتياطياً مجلد user/ بالكامل، الذي يحتوي كل الصفحات والإعدادات والوسائط المرفوعة والإضافات/السمات المثبتة
  • انسخ احتياطياً docker-compose.yml أو أمر التشغيل حتى يمكن إعادة إنشاء تعيين المنفذ وإعداد الحجم بشكل مطابق
  • إذا كان محتواك متتبَّعاً في Git، فإن مستودعك نفسه يعمل بالفعل كشكل من أشكال النسخ الاحتياطي المستمر بتاريخ كامل
  • اختبر استعادة مجلد user/ على نسخة منفصلة دورياً للتأكد أن نسختك الاحتياطية تحتوي فعلاً كل ما هو مطلوب
  • وثّق أي إعداد سمة أو إضافة مخصص بشكل منفصل إذا لم يكن مخزناً بالفعل داخل مجلد user/
  • بما أنه لا توجد قاعدة بيانات، النسخ الاحتياطي الكامل هو حقاً مجرد نسخ مجلد — جدوله بانتظام كما تفعل مع أي نسخ احتياطي للملفات

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

  • نسيان نسخ مجلد user/ احتياطياً، بافتراض خاطئ أن نظام إدارة محتوى بدون قاعدة بيانات يعني عدم الحاجة لنسخ أي شيء احتياطياً
  • ترك لوحة /admin قابلة للوصول عبر HTTP عادي، مما يكشف بيانات تسجيل الدخول لأي شخص على مسار الشبكة
  • تحرير الصفحات مباشرة كملفات بينما تخزين لوحة الإدارة المؤقت قديم، مما يجعل التغييرات تظهر متأخرة أو غير متسقة
  • تثبيت إضافات كثيرة جداً دون مراجعة ضرورتها، مما يضيف سطح هجوم غير ضروري لموقع بدون قاعدة بيانات
  • عدم رفع المحتوى لـ Git رغم أن Grav مثالي لذلك، مما يفوّت فوائد تاريخ الإصدارات والتراجع
  • افتراض أن التخزين بملفات مسطحة يعني عدم الحاجة لتحديثات أمنية — نواة Grav والإضافات لا تزال تحتاج تحديثات منتظمة
  • ضبط صلاحيات ملفات فضفاضة جداً على مجلد user/، مما يسمح بوصول كتابة غير مقصود
  • عدم مسح التخزين المؤقت بعد تغييرات إعداد كبيرة، مما يؤدي لسلوك محيّر حيث تبدو الإعدادات القديمة مستمرة

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

  • لوحة الإدارة غير متاحة على /admin — تحقق أن المنفذ 8228 معيّن بشكل صحيح وأن الحاوية تعمل باستخدام docker ps
  • تغييرات ملفات Markdown لا تظهر على الموقع — امسح تخزين Grav المؤقت، لأن التخزين المؤقت القوي قد يقدّم محتوى قديماً
  • تسجيل الدخول للوحة الإدارة يفشل — تأكد أنك أكملت معالج الإعداد الأولي وتستخدم بيانات اعتماد المسؤول الصحيحة
  • صفحات جديدة أُنشئت في لوحة الإدارة لا تظهر في التنقل — تحقق من إعدادات الرؤية والنشر للصفحة
  • سمة أو إضافة تسبب أخطاء بعد التثبيت — تحقق من التوافق مع إصدار Grav لديك وراجع سجلات الأخطاء
  • الموقع يُحمّل ببطء رغم التخزين المؤقت — تحقق أن دليل التخزين المؤقت لديه صلاحيات كتابة صحيحة لعملية سيرفر الويب
  • الوسائط المرفوعة لا تظهر — تأكد أن صلاحيات الملفات في مجلدات وسائط user/pages تسمح لسيرفر الويب بقراءتها
  • المحتوى متعدد اللغات لا يتبدل بشكل صحيح — تحقق من إعداد اللغة وأن ملفات Markdown المترجمة تتبع اصطلاح تسمية Grav

البدائل

يملك WordPress نظاماً بيئياً للإضافات أكبر بكثير ومألوفاً لدى الجميع تقريباً، لكنه يتطلب MySQL ويجلب صيانة وسطح هجوم أكبر بكثير من نظام بملفات مسطحة. مولّدات المواقع الثابتة مثل Hugo أو Jekyll أخف حتى من Grav لأنها تنتج HTML ثابتاً خالصاً دون بيئة تشغيل PHP، لكنها تفتقر للوحة إدارة Grav الاختيارية عبر الويب للمحررين غير التقنيين. Kirby نظام إدارة محتوى آخر بملفات مسطحة بفلسفة مشابهة لكنه منتج تجاري يتطلب ترخيصاً للاستخدام الإنتاجي، على عكس نموذج Grav المجاني ومفتوح المصدر بالكامل. لنظام إدارة محتوى مجاني وبدون قاعدة بيانات يوازن بين تخزين ملفات صديق للمطورين ومحرر بصري اختياري، يبقى Grav أحد أكثر الخيارات اكتمالاً.

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

إذا احتجت بيانات علائقية معقدة — تجارة إلكترونية بمخزون وطلبات، أو حسابات مستخدمين بصلاحيات، أو محتوى مترابط بكثافة — فإن نظام إدارة محتوى مرتبط بقاعدة بيانات أو إطار تطبيق سيخدمك بشكل أفضل من نموذج Grav القائم على الملفات. إذا لم يكن فريقك مهتماً بـ Markdown أو Git وأراد أكبر نظام إضافات ممكن بغض النظر عن التعقيد، فقد تفوق شهرة WordPress وحجم سوقه بساطة Grav. إذا احتجت إخراجاً ثابتاً خالصاً دون معالجة على جانب السيرفر عند الطلب، فإن مولّد موقع ثابت مثل Hugo سيكون أسرع حتى، بتكلفة فقدان لوحة إدارة Grav الحية الاختيارية.

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

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

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

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

ما هو Grav؟

Grav نظام إدارة محتوى بملفات مسطحة يخزّن الصفحات كملفات Markdown في هيكل مجلدات بدلاً من قاعدة بيانات — تخطيط الدليل هو هيكل الموقع.

هل يحتاج Grav فعلاً لا قاعدة بيانات؟

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

ما المنفذ الذي يستخدمه وكيف أسجّل الدخول؟

يعمل Grav على منفذ المضيف 8228 (معيّن من منفذ الحاوية 80). لا يوجد تسجيل دخول افتراضي: تزور مسار /admin وتنشئ حساب المسؤول الأول بنفسك.

هل يمكنني الاحتفاظ بمحتواي في Git؟

نعم، وهذا أحد الأسباب الرئيسية لاختيار Grav. بما أن الصفحات ملفات Markdown عادية، يمكنك رفعها لمستودع، والحصول على تاريخ كامل لكل تغيير في المحتوى، ومقارنة ومراجعة التعديلات مثل الكود، وحتى تمرير تغييرات المحتوى عبر طلبات السحب — لا شيء من هذا عملي مع نظام إدارة محتوى مرتبط بقاعدة بيانات.

كيف يقارَن بـ WordPress؟

يملك WordPress نظاماً بيئياً للإضافات أكبر بكثير ومألوفاً لدى الجميع تقريباً، لكنه يتطلب MySQL ويجلب صيانة وسطح هجوم أكبر بكثير. Grav أخف وأسرع وبدون قاعدة بيانات وملائم لـ Git، لكن لديه إضافات جاهزة أقل.