🛒 تثبيت Bagisto — منصة تجارة إلكترونية مبنية على Laravel
انشر Bagisto على Ubuntu بـ Docker — منصة تجارة إلكترونية مفتوحة المصدر وكاملة الميزات مبنية على Laravel وVue.js، مع دعم متعدد المتاجر والعملات ولوحة تحكم غنية، على المنفذ 8198.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/ecommerce/bagisto/bagisto-ubuntu.sh
chmod +x bagisto-ubuntu.sh
sudo bash bagisto-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/ecommerce/bagisto/bagisto-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x bagisto-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، ويُشغّل Bagisto مع قاعدة بيانات MySQL على المنفذ 8198. لاحظ أن الصورة الأصلية تستخدم بيانات اعتماد قاعدة بيانات افتراضية وتسجيل دخول مسؤول افتراضي، لذا تعامل مع هذا كإعداد تجريبي حتى تُصلّبه.
sudo bash bagisto-ubuntu.sh
4 تسجيل الدخول وتغيير بيانات الاعتماد الافتراضية
افتح لوحة التحكم على /admin، سجّل الدخول ببيانات admin@example.com / admin123 الافتراضية، وغيّر كلمة المرور فوراً قبل أي شيء آخر:
http://<your-server-ip>:8198/admin
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8198 | Storefront (host → container 80); admin panel at /admin |
| ⚠️ admin@example.com / admin123 | Upstream default login — change it immediately |
| ⚠️ Default DB password | Upstream default — change before any real use |
| MySQL | Internal — products, orders, and customer records |
نظرة عامة
Bagisto منصة تجارة إلكترونية مجانية ومفتوحة المصدر مبنية على Laravel بواجهة متجر ولوحة تحكم بـ Vue.js. تمنحك متجراً إلكترونياً كاملاً جاهزاً من الصندوق — منتجات بمتغيرات وخصائص، فئات، سلة وإتمام شراء، إدارة طلبات، حسابات عملاء، ولوحة تحكم غنية — دون رسوم ترخيص أو اقتطاع نسبة من الإيرادات. ولأنها مبنية على Laravel، يستطيع المطورون المطّلعون على منظومة PHP توسيعها بحزم Laravel القياسية ووحدات مخصصة وتكاملات API بدلاً من تعلّم نظام إضافات خاص.
لماذا تستخدمه
تفرض معظم منصات التجارة الإلكترونية المجانية مفاضلة: إما متجر بسيط بمرونة محدودة، أو منصة قوية تتطلب مهارات متخصصة للتخصيص. تتجنب Bagisto هذه المفاضلة ببنائها على Laravel، أحد أكثر أطر PHP استخداماً، فتحصل على منصة قابلة للتوسيع فعلياً دون منحنى تعلّم متخصص. دعم متعدد المتاجر والقنوات والعملات واللغات مدمج في النواة وليس إضافة مدفوعة منفصلة، وهذا مهم جداً بمجرد أن تبيع في أكثر من منطقة أو تحت أكثر من علامة تجارية.
متى تحتاجه
- تريد إطلاق متجر إلكتروني دون رسوم لكل معاملة أو اشتراك شهري في منصة
- تحتاج بيع نفس الكتالوج عبر متاجر أو عملات أو لغات متعددة من مكتب خلفي واحد
- فريقك مرتاح مع Laravel/PHP ويريد تخصيص الدفع أو قواعد التسعير أو التكاملات بكود يتحكم فيه
- تُقيّم بديلاً ذاتي الاستضافة لـ Shopify أو WooCommerce مع مسار حقيقي لسوق متعدد البائعين
- تحتاج ميزات B2B مثل تسعير خاص بالعميل أو عروض أسعار أو طلبات بالجملة إلى جانب متجر B2C عادي
- تريد ملكية كاملة لبيانات العملاء والطلبات بدلاً من تخزينها لدى مزود SaaS خارجي
من يحتاجه
- الشركات الصغيرة والمتوسطة التي تطلق متجراً إلكترونياً وتريد تجنب رسوم منصات SaaS المتكررة
- الوكالات التي تبني متاجر مخصصة للعملاء وتحتاج مرونة على مستوى Laravel بدلاً من نظام سمات مقفل
- التجار الذين يتوسعون في مناطق متعددة ويحتاجون دعم عملات ولغات ومتاجر متعددة منذ اليوم الأول
- رواد الأعمال الذين يبنون سوقاً متعدد البائعين حيث يدير البائعون المستقلون متاجرهم الخاصة
- المطورون الذين يفضلون العمل بإطار عمل رئيسي وموثّق جيداً (Laravel) بدلاً من كود تجارة إلكترونية خاص
- الشركات ذات بنية PHP/Laravel القائمة التي تريد متجراً يتكامل بسلاسة مع أنظمتها الداخلية عبر API
حالات الاستخدام الشائعة
- إطلاق متجر مباشر للمستهلك بمتغيرات منتجات وفئات وتدفق إتمام شراء كامل
- تشغيل سوق متعدد البائعين حيث يُدرج البائعون المستقلون منتجاتهم ويديرونها بأنفسهم
- تشغيل عدة متاجر إقليمية (بعملات ولغات مختلفة) من لوحة تحكم واحدة
- بناء متجر headless بواجهة أمامية مخصصة تستهلك API الخاص بـ Bagisto مع الاحتفاظ بلوحة التحكم القياسية
- تقديم طلبات جملة B2B بتسعير حسب مجموعة العملاء إلى جانب متجر تجزئة عادي
- الانتقال من منصة SaaS مدفوعة للتخلص من رسوم المعاملات واكتساب تحكم كامل بقاعدة البيانات
الميزات الرئيسية
- دعم متعدد المتاجر والقنوات لتشغيل عدة متاجر وقنوات بيع من لوحة تحكم واحدة
- دعم متعدد العملات واللغات مدمج في النواة وليس مباعاً كإضافة منفصلة
- إدارة كاملة لكتالوج المنتجات مع منتجات قابلة للتهيئة ومتغيرات وخصائص وفئات
- وحدة B2B مدمجة تدعم تسعيراً خاصاً بالعميل وحسابات شركات وطلبات عروض أسعار
- بنية headless قائمة على API تتيح بناء واجهات أمامية مخصصة (تطبيقات جوال، مواقع JAMstack) على نفس بيانات المتجر
- دعم تعدد المستأجرين لبناء سوق بنمط SaaS حيث يدير كل بائع متجراً مستقلاً
- لوحة تحكم غنية تغطي الطلبات والعملاء والمخزون والعروض والضرائب وصفحات CMS
- مجتمع مفتوح المصدر نشط مع سوق للإضافات والسمات
كيفية الاستخدام بعد التثبيت
- سجّل الدخول للوحة التحكم على /admin ببيانات admin@example.com / admin123 الافتراضية وغيّر كلمة المرور فوراً
- غيّر كلمة مرور MySQL الافتراضية وحدّث متغيرات البيئة المرتبطة بها قبل تخزين أي بيانات حقيقية
- اضبط اسم متجرك والعملة الافتراضية واللغة والمنطقة الزمنية تحت Admin → Settings → General
- أضف أول فئة ومنتجات، بما في ذلك الصور والمتغيرات والتسعير
- اضبط طريقة دفع (الدفع عند الاستلام مفعّل افتراضياً؛ أضف بوابة حقيقية مثل PayPal أو Stripe للإنتاج)
- اضبط طرق الشحن وقواعد الضرائب المناسبة للمناطق التي تشحن وتبيع إليها
- أنشئ صفحات CMS مثل من نحن واتصل بنا وسياسة الخصوصية قبل الانطلاق الفعلي
- ضع واجهة المتجر خلف نطاق مخصص وHTTPS عبر وكيل عكسي قبل استقبال عملاء حقيقيين
أفضل ممارسات الأمان
- غيّر كلاً من تسجيل الدخول الافتراضي للمسؤول (admin@example.com / admin123) وكلمة مرور MySQL الافتراضية فوراً — فهما موثّقتان علناً
- لا تترك هذا التثبيت متاحاً على الإنترنت المفتوح ببيانات افتراضية حتى مؤقتاً — فالبوتات تفحص بالضبط عن هذا
- ضع Bagisto خلف وكيل عكسي مع HTTPS لأن كلاً من إتمام الشراء وتسجيل دخول المسؤول يتعاملان مع بيانات حساسة
- قيّد الوصول المباشر لحاوية MySQL على شبكة Docker فقط — يجب ألا تُكشف أبداً على منفذ عام
- اضبط كلمات مرور قوية وفريدة لكل مستخدم مسؤول تنشئه، واحذف أو عطّل حسابات المسؤولين غير المستخدَمة
- أبقِ APP_DEBUG في Laravel معطّلاً في بيئة الإنتاج — يمكن لصفحة التصحيح تسريب بيانات اعتماد قاعدة البيانات والمسارات الداخلية
- طبّق تحديثات أمان Bagisto وLaravel فوراً، إذ تُعد منصات التجارة الإلكترونية هدفاً شائعاً للاستغلال
- انسخ احتياطياً قبل كل تحديث واختبر التحديث على نسخة تجريبية أولاً، إذ قد تفشل ترحيلات المخطط على تثبيتات مخصَّصة
المنافذ وإعدادات جدار الحماية
تشترك واجهة متجر Bagisto ولوحة التحكم في منفذ المضيف 8198، المُعيَّن من المنفذ الداخلي للحاوية 80 — وهو المنفذ الوحيد الذي يحتاج أن يكون متاحاً للعملاء والمسؤولين. تعمل قاعدة بيانات MySQL داخل نفس شبكة Docker وغير مكشوفة على منفذ مضيف في هذا الإعداد، فهي متاحة فقط من الحاويات الأخرى، لا من خارج السيرفر. لا تُحوّل المنفذ 8198 مباشرة من الراوتر إلى الإنترنت دون HTTPS أمامه؛ ضع وكيلاً عكسياً مثل Nginx Proxy Manager على المنفذ 443 مع شهادة صالحة، إذ يرسل كل من تدفق إتمام الشراء وتسجيل دخول المسؤول بيانات حساسة. إذا كشفت MySQL لاحقاً لأدوات خارجية أو نسخ احتياطي، قيّدها بعناوين IP محددة أو VPN بدلاً من فتحها على نطاق واسع.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات MySQL احتياطياً بانتظام — فهي تحمل كل منتج وطلب وسجل عميل، وهي أهم عنصر يجب حمايته
- انسخ دليل storage احتياطياً، فهو يحتوي على صور المنتجات المرفوعة، وسائط CMS، والفواتير/ملفات PDF المُولّدة
- انسخ ملف .env احتياطياً بشكل منفصل وآمن، فهو يحتوي على بيانات اعتماد قاعدة البيانات ومفاتيح التطبيق
- اختبر استعادة نسخة قاعدة البيانات ودليل storage معاً على سيرفر تجريبي قبل الوثوق بالنسخة الاحتياطية
- جدول النسخ الاحتياطي قبل كل تحديث لـ Bagisto أو Laravel، تحسباً لفشل ترحيل في منتصف الطريق
- احتفظ بنسخة احتياطية واحدة على الأقل خارج نفس السيرفر، إذ سيؤدي عطل القرص أو المضيف الكامل لفقدان نسختك الوحيدة
الأخطاء الشائعة
- ترك تسجيل الدخول الافتراضي admin@example.com / admin123 دون تغيير على تثبيت متاح للعامة
- تشغيل المتجر بكلمة مرور MySQL الافتراضية دون تدويرها أبداً
- كشف المنفذ 8198 للإنترنت دون HTTPS، فتنتقل بيانات تسجيل دخول المسؤول وبيانات إتمام شراء العملاء دون تشفير
- تخطي إعداد تعدد العملات أو اللغات مبكراً، ثم الاضطرار لإضافته لاحقاً بعد وجود منتجات وطلبات فعلاً
- عدم فصل نسخة storage الاحتياطية عن نسخة قاعدة البيانات، مما ينتج عنه صور منتجات لا تطابق الطلبات المُستعادة
- تجاهل إعداد عامل قائمة الانتظار (queue worker) للبريد والمهام الخلفية، مما يمنع إرسال رسائل تأكيد الطلبات أبداً
- تخصيص ملفات النواة مباشرة بدلاً من استخدام نظام الحزم/الوحدات في Bagisto، مما يجعل التحديثات المستقبلية صعبة أو مستحيلة
- الانطلاق الفعلي دون ضبط بوابة دفع حقيقية، تاركاً الدفع عند الاستلام كخيار الدفع الوحيد
استكشاف الأخطاء وإصلاحها
- تعذّر تسجيل الدخول للوحة التحكم — تحقق من استخدام بيانات الاعتماد الافتراضية الصحيحة ومن تشغيل حاوية قاعدة البيانات وإمكانية الوصول إليها
- واجهة المتجر تعرض خطأ 500 — تحقق من سجل Laravel في storage/logs، وتأكد من ضبط APP_KEY وصحة بيانات الاتصال بقاعدة البيانات في .env
- صور المنتجات لا تظهر — تأكد من ربط دليل storage بشكل صحيح (php artisan storage:link) ومن سماح الصلاحيات لخادم الويب بقراءته
- رسائل البريد (تأكيد الطلبات، إعادة تعيين كلمة المرور) لا تُرسل — اضبط مزود بريد حقيقي في .env وتحقق من تشغيل عامل قائمة الانتظار إذا كانت مفعّلة
- تغييرات العملة أو اللغة لا تظهر في واجهة المتجر — امسح ذاكرة تخزين Laravel المؤقتة (php artisan cache:clear وconfig:clear) بعد تعديل الإعدادات
- إتمام الشراء يفشل بصمت — تحقق من وحدة تحكم المتصفح وسجل Laravel بحثاً عن أخطاء JavaScript أو بوابة الدفع، وتأكد من ضبط طريقة الدفع المختارة بشكل صحيح
- بطء لوحة التحكم أو واجهة المتجر — تحقق من أداء استعلامات MySQL، فعّل opcache في Laravel، وفكّر بإضافة Redis للتخزين المؤقت وقوائم الانتظار على الكتالوجات الكبيرة
- أخطاء ترحيل بعد التحديث — استعد من النسخة الاحتياطية، راجع ملاحظات الإصدار بحثاً عن تغييرات جذرية، وطبّق الترحيلات على نسخة تجريبية أولاً
البدائل
PrestaShop هو منصة PHP مفتوحة المصدر رئيسية أخرى للتجارة الإلكترونية — ناضجة جداً بسوق ضخم للوحدات والسمات، لكنها مبنية على كود أقدم من أساس Bagisto القائم على Laravel. EverShop منصة حديثة headless مبنية على Node.js وReact موجهة للمطورين الذين يفضلون منظومة JavaScript على PHP. يتبنى Saleor نهجاً مشابهاً في الـ headless لكنه مبني على Python وGraphQL، ومحبوب لدى الفرق التي تبني واجهات أمامية مخصصة بالكامل. Shopware منصة PHP ألمانية الصنع متقنة بميزات B2B قوية، لكن نسختها المجتمعية المجانية أكثر محدودية من فئاتها المدفوعة. يبقى WooCommerce الخيار الأبسط لمن يشغّل WordPress بالفعل، لكنه لا يضاهي قدرات Bagisto المدمجة في تعدد المتاجر والمستأجرين. للفرق التي تريد منصة ناضجة ونشطة التطوير مبنية على Laravel بدعم حقيقي لتعدد المتاجر وB2B من الصندوق، يُعد Bagisto خياراً قوياً.
متى لا تستخدمه
Bagisto ليس الخيار المناسب إذا كنت تحتاج متجراً يعمل خلال الساعة القادمة دون أي إدارة سيرفر — منصة مستضافة مثل Shopify تتولى البنية التحتية وتصحيحات الأمان والامتثال لـ PCI نيابة عنك مقابل رسوم شهرية ومرونة أقل. إذا لم يكن لفريقك خبرة بـ PHP أو Laravel ولا وقت لاكتسابها، فإن ميزة التخصيص في Bagisto تُهدر إلى حد كبير، وستوصلك منصة أبسط (أو مستضافة) للانطلاق أسرع. لكتالوج صغير جداً بعدد قليل من المنتجات، يُعد تشغيل حزمة Laravel/MySQL كاملة بنية تحتية أكثر من اللازم — قد تكون أداة خفيفة أو إدراج في سوق قائم خياراً أفضل. وإذا كان الامتثال لـ PCI-DSS ومراجعة أمان الدفع متطلبات صارمة لا تستطيع التعامل معها داخلياً، فقد يستحق الامتثال المدمج في منصة مستضافة المفاضلة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Bagisto؟
Bagisto منصة تجارة إلكترونية مفتوحة المصدر وكاملة الميزات مبنية على Laravel بواجهة أمامية بـ Vue.js. تأتي بدعم متعدد المتاجر والقنوات، وعملات ولغات متعددة، ومتغيرات وخصائص منتجات، ومجموعات عملاء، وقواعد ضرائب، وصفحات CMS، ولوحة تحكم شاملة — واجهة متجر ومكتب خلفي كاملان دون رسوم ترخيص أو اقتطاع من المعاملات.
ما بيانات الاعتماد الافتراضية؟
تأتي صورة Docker الأصلية ببيانات admin@example.com / admin123 للوحة التحكم، بالإضافة إلى كلمة مرور MySQL افتراضية. هذه موثّقة علناً في إعداد Docker الخاص بـ Bagisto نفسه، لذا فإن أي تثبيت غير مُصلّب قابل للاختراق بسهولة — غيّر كليهما فوراً بعد التثبيت وقبل كشف المتجر لحركة مرور حقيقية.
ما المنفذ المستخدم وأين لوحة التحكم؟
يعمل Bagisto على منفذ المضيف 8198 في هذا التثبيت، المُعيَّن من المنفذ الداخلي للحاوية 80. واجهة المتجر على الرابط الجذر ولوحة التحكم على المسار /admin — مثلاً http://your-server-ip:8198/admin.
هل يدعم متاجر وعملات متعددة؟
نعم — هذه إحدى أقوى نقاط Bagisto. دعم تعدد المتاجر والقنوات والعملات واللغات مدمج في نواة المنصة وليس مباعاً كإضافات مدفوعة، وهذا مهم جداً إذا كنت تبيع عبر مناطق أو علامات تجارية متعددة من مكتب خلفي واحد.
كيف يقارَن بـ PrestaShop أو EverShop؟
PrestaShop منصة PHP مفتوحة المصدر رئيسية أخرى — ناضجة جداً، بسوق ضخم للوحدات، لكنها مبنية على كود أقدم من أساس Bagisto القائم على Laravel. EverShop منصة Node.js حديثة وheadless موجهة للمطورين الذين يفضلون JavaScript على PHP. ميزة Bagisto هي الجمع بين منظومة مطوري Laravel الرئيسية ودعم حقيقي مدمج لتعدد المتاجر وB2B منذ البداية.