🛒 تثبيت EverShop — منصة تجارة إلكترونية حديثة بـ Node.js
انشر EverShop على Ubuntu بـ Docker — متجر إلكتروني مفتوح المصدر سريع وحديث مبني على Node.js وReact، مع لوحة تحكم أنيقة وقاعدة بيانات PostgreSQL، على المنفذ 3048.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/ecommerce/evershop/evershop-ubuntu.sh
chmod +x evershop-ubuntu.sh
sudo bash evershop-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/ecommerce/evershop/evershop-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x evershop-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر ويشغّل EverShop مع قاعدة بيانات PostgreSQL الخاصة به على المنفذ 3048، مع ملفات الوسائط في وحدة تخزين مرتبطة وكلمة مرور قاعدة بيانات مُولَّدة.
sudo bash evershop-ubuntu.sh
4 إنشاء المستخدم المشرف
لا يأتي EverShop بتسجيل دخول افتراضي — أنشئ حساب المشرف بالأمر المدمج، ثم سجّل الدخول إلى لوحة التحكم عبر /admin:
docker exec evershop npm run user:create -- --email admin@example.com --password YOURPASS --name Admin
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3048 | Storefront (host → container 3000); admin panel at /admin |
| No default login | Create the admin with npm run user:create after install |
| PostgreSQL + ./media | Products, orders, customers, and uploaded images |
نظرة عامة
EverShop منصة تجارة إلكترونية حديثة ومفتوحة المصدر مبنية على Node.js وExpress وReact، مع GraphQL يُشغّل طبقة واجهة البرمجة وPostgreSQL كقاعدة بياناته. يمنحك متجراً أمامياً عاملاً ولوحة تحكم أنيقة قائمة على React جاهزين — منتجات بمتغيرات، فئات، سلة تسوق ودفع، طلبات، عملاء، وعروض ترويجية — دون قواعد الأكواد الأقدم والأثقل لمنصات مثل Magento أو نهج "ابنِ متجرك الأمامي بنفسك" الكامل عديم الرأس لبعض منافسي Node.js. المقصود منه أن يكون بديلاً متكاملاً أخف وأحدث للفرق المرتاحة لمنظومة JavaScript.
لماذا تستخدمه
يمنحك EverShop متجراً أمامياً ولوحة تحكم قابلين للاستخدام فوراً بعد التثبيت بدلاً من مطالبتك ببناء واجهة أمامية من واجهة برمجة عديمة الرأس أولاً. ولأنه مبني بالكامل على Node.js وReact وGraphQL، يستطيع المطورون العاملون بالفعل في منظومة JavaScript توسيعه وتخصيص مظهره دون تبديل اللغات أو تعلّم قاعدة كود PHP أو Python. مع عدم وجود رسوم لكل معاملة، وعدم الارتباط بمُصنّع، وملكية كاملة لبيانات متجرك على قاعدة بيانات PostgreSQL الخاصة بك، إنه خيار جيد للمطورين الذين يريدون متجراً حديثاً وذاتي الاستضافة دون الثقل التشغيلي للمنصات الأقدم.
متى تحتاجه
- تريد متجراً إلكترونياً ذاتي الاستضافة دون رسوم منصة متكررة أو عمولات لكل معاملة
- فريقك مرتاح لـ Node.js وReact ويريد تخصيص مظهر أو توسيع متجر بمنظومة مألوفة
- تريد متجراً أمامياً ولوحة تحكم عاملين جاهزين بدلاً من بناء واجهة أمامية من واجهة برمجة عديمة الرأس
- تحتاج ملكية كاملة لبيانات منتجاتك وطلباتك وعملائك على قاعدة بيانات PostgreSQL الخاصة بك
- تُقيّم بديلاً أخف وأحدث لمنصات التجارة الإلكترونية القائمة على PHP القديمة
من يحتاجه
- مطورو JavaScript/Node.js الذين يريدون بناء أو تخصيص متجر دون التبديل لمنظومة PHP أو Python
- الشركات الصغيرة والناشئة التي تطلق متجراً إلكترونياً وتريد تجنب رسوم منصة SaaS المتكررة
- الوكالات التي تبني متاجر أمامية مخصصة لعملاء يحتاجون مرونة تخصيص مظهر قائمة على React
- عشاق الاستضافة الذاتية الذين يريدون تحكماً كاملاً وملكية بيانات على خلفية تجارتهم الإلكترونية
- المطورون المنتقلون من منصة عديمة الرأس فقط ويريدون متجراً أمامياً ولوحة تحكم قابلين للاستخدام مُضمَّنين
- المؤسسون التقنيون الذين يريدون الإطلاق بسرعة بإعدادات افتراضية منطقية قبل الاستثمار في تخصيص عميق
حالات الاستخدام الشائعة
- إطلاق متجر إلكتروني صغير إلى متوسط بمنتجات ومتغيرات وفئات وتدفق دفع عامل
- بناء مظهر متجر أمامي مخصص بـ React فوق مكوّنات EverShop الموجودة وواجهة برمجة GraphQL
- تشغيل متجر ذاتي الاستضافة دون دفع رسوم لكل معاملة لمنصة تجارة إلكترونية SaaS مستضافة
- إدارة المنتجات والطلبات والعملاء والعروض الترويجية عبر لوحة تحكم React المدمجة
- دمج المتجر الأمامي أو لوحة التحكم مع خدمات Node.js أخرى باستخدام واجهة برمجة GraphQL في EverShop
- إنشاء نموذج أولي سريع لتجارة إلكترونية باستخدام متجر EverShop الجاهز قبل التخصيص العميق
الميزات الرئيسية
- بنية Node.js متكاملة بالكامل — خلفية Express، متجر أمامي ولوحة تحكم React، وواجهة برمجة GraphQL في قاعدة كود واحدة متكاملة
- متجر أمامي ولوحة تحكم عاملان متاحان فوراً بعد التثبيت، وليس مجرد خلفية عديمة الرأس
- منتجات بمتغيرات وفئات ومجموعات وإدارة خصائص مرنة
- سلة تسوق ودفع وطلبات وإدارة عملاء كاملة جاهزة
- نظام عروض ترويجية وكوبونات لتشغيل خصومات وحملات تسويقية
- PostgreSQL كخلفية قاعدة بيانات، مما يمنحك مخزن بيانات علائقي قوي ومفهوم جيداً
- نظام إضافات ووحدات لإضافة وظائف مخصصة دون تفريع قاعدة الكود الأساسية
- ترخيص مفتوح المصدر GPLv3 دون رسوم لكل معاملة أو ارتباط بمُصنّع
كيفية الاستخدام بعد التثبيت
- أنشئ المستخدم المشرف بالأمر المدمج (docker exec evershop npm run user:create) لأنه لا يوجد تسجيل دخول افتراضي
- سجّل الدخول إلى لوحة التحكم عبر /admin واضبط اسم متجرك وعملته وإعداداته الأساسية
- أضف أول منتجاتك، بما في ذلك المتغيرات والصور والفئات، عبر لوحة التحكم
- اضبط طرق الشحن وقواعد الضرائب ومزوّدي الدفع المناسبين لمنطقتك
- خصّص مظهر المتجر الأمامي باستخدام مكوّنات React الخاصة بـ EverShop إذا احتجت هوية بصرية تتجاوز الإعدادات الافتراضية
- أعدّ وكيلاً عكسياً مع HTTPS على نطاقك الخاص قبل قبول أي طلبات حقيقية أو تسجيلات دخول عملاء
- اختبر تدفق الدفع الكامل من البداية للنهاية بطلب تجريبي قبل إعلان المتجر للعامة
- اضبط نسخاً احتياطية دورية لـ PostgreSQL بمجرد أن يحتوي المتجر بيانات منتجات وطلبات حقيقية تستحق الحماية
أفضل ممارسات الأمان
- ضع EverShop دائماً خلف وكيل عكسي مع HTTPS قبل الإطلاق الفعلي — يجب ألا تُنقل بيانات الدفع وتسجيلات دخول المشرف عبر HTTP عادي أبداً
- أنشئ المستخدم المشرف فوراً بعد التثبيت بكلمة مرور قوية وفريدة لأنه لا يوجد حساب افتراضي يجب القلق حول تعطيله
- قيّد الوصول للمنفذ 3048 على مستوى جدار الحماية واكشفه فقط عبر وكيلك العكسي، وليس مباشرة
- أبقِ قاعدة بيانات PostgreSQL غير قابلة للوصول للعامة — يجب أن تكون قابلة للوصول فقط من حاوية EverShop نفسها
- بدّل كلمة مرور قاعدة البيانات المُولَّدة إذا اشتبهت في كشفها، وخزّن بيانات الاعتماد في مدير أسرار بدلاً من نص عادي
- أبقِ EverShop وتبعياته محدّثة للحصول على تصحيحات أمنية، خاصة لمسارات كود الدفع والدفع الإلكتروني
- قيّد وصول لوحة التحكم بعنوان IP أو VPN بالإضافة للمصادقة إذا كان المتجر يتعامل مع بيانات عملاء حساسة
المنافذ وإعدادات جدار الحماية
يستمع EverShop على المنفذ 3048 في المضيف، مرتبط بالمنفذ الداخلي 3000 في الحاوية، ويخدم كلاً من المتجر الأمامي العام على الرابط الجذري ولوحة التحكم على /admin على نفس المنفذ. لأي متجر حقيقي، يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت — ضع وكيلاً عكسياً مثل Nginx Proxy Manager أمامه على المنفذ 443 مع شهادة TLS صالحة، لأن نماذج الدفع وتسجيلات دخول المشرف يجب ألا تُنقل عبر HTTP عادي أبداً. يجب ألا تُكشف حاوية قاعدة بيانات PostgreSQL للإنترنت على الإطلاق؛ تحتاج فقط أن تكون قابلة للوصول من حاوية تطبيق EverShop على شبكة Docker الداخلية. بمجرد وضع الوكيل العكسي، احجب الوصول الخارجي المباشر للمنفذ 3048 في جدار الحماية.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام — تحتوي كل سجل منتج وطلب وعميل وإعداد
- انسخ وحدة التخزين ./media احتياطياً، التي تخزّن صور المنتجات وأصولاً أخرى مرفوعة منفصلة عن قاعدة البيانات
- خزّن كلمة مرور قاعدة البيانات المُولَّدة وأي بيانات اعتماد واجهة برمجة بأمان خارج ملف بيئة الحاوية
- وثّق تخصيصاتك والإضافات المثبّتة حتى تتمكن من إعادة تطبيقها بعد الترحيل أو التعافي من كارثة
- خزّن النسخ الاحتياطية خارج نفس مضيف المتجر الحي حتى لا يأخذ فشل السيرفر نسختك الوحيدة معه
- اختبر الاستعادة دورياً بتشغيل نسخة EverShop جديدة من قاعدة بيانات منسوخة احتياطياً والتأكد من تحميل الطلبات والمنتجات بشكل صحيح
الأخطاء الشائعة
- قبول طلبات حقيقية قبل وضع HTTPS أمام المتجر — بيانات الدفع وبيانات اعتماد المشرف ستنتقل بنص عادي
- نسيان إنشاء المستخدم المشرف بعد التثبيت وعدم القدرة على الوصول للوحة التحكم إطلاقاً
- كشف المنفذ 3048 أو منفذ PostgreSQL مباشرة للإنترنت بدلاً من التوجيه عبر وكيل عكسي
- عدم نسخ وحدة التخزين ./media احتياطياً، وفقدان كل صور المنتجات حتى لو كانت قاعدة البيانات نفسها منسوخة احتياطياً
- تخطي اختبار دفع كامل قبل الإطلاق، واكتشاف مشاكل إعداد الدفع أو الشحن فقط بعد وصول عملاء حقيقيين إليها
- تجاهل ضبط أداء PostgreSQL كلما نما كتالوج المنتجات وتاريخ الطلبات، مما يؤدي لصفحات لوحة تحكم ومتجر أمامي بطيئة
- تعديل ملفات EverShop الأساسية مباشرة بدلاً من استخدام نظام الإضافات، مما يجعل التحديثات المستقبلية صعبة أو مدمّرة
استكشاف الأخطاء وإصلاحها
- فشل تسجيل دخول لوحة التحكم — تأكد أن المستخدم المشرف أُنشئ فعلياً بأمر user:create وأن البريد/كلمة المرور متطابقان
- المتجر الأمامي يُحمَّل لكن الصور مفقودة — تحقق أن وحدة التخزين ./media مرتبطة بشكل صحيح وأن أذونات الملفات تسمح للحاوية بقراءتها
- الدفع يفشل أو يتوقف — تحقق من اتصال PostgreSQL من حاوية EverShop وراجع سجلات التطبيق بحثاً عن أخطاء اتصال قاعدة البيانات
- لوحة التحكم قابلة للوصول لكن المتجر الأمامي ليس كذلك (أو العكس) — تحقق أن وكيلك العكسي يوجّه كلاً من المسار الجذري و/admin لنفس حاوية EverShop
- أخطاء اتصال قاعدة البيانات بعد إعادة التشغيل — تأكد أن حاوية PostgreSQL بدأت بنجاح وأن كلمة المرور المُولَّدة في إعدادات EverShop لا تزال متطابقة
- تغييرات المظهر المخصص لا تظهر — تحقق أنك تُحرر مكوّنات React الصحيحة وأن البناء/التخزين المؤقت نُظّف بعد التغييرات
- الأداء يتدهور مع كتالوج كبير — راجع فهارس PostgreSQL وأداء الاستعلامات، وتحقق من حدود موارد الحاوية (المعالج/الذاكرة)
البدائل
Medusa هو أقرب مقارنة مباشرة — أيضاً منصة Node.js، لكنه عديم الرأس أولاً ويستهدف المطورين الذين يريدون بناء متجرهم الأمامي الخاص بدلاً من استخدام واحد مُضمَّن جاهزاً؛ وهو مرخّص بـ MIT مقابل GPLv3 في EverShop. Vendure خيار آخر أصلي بـ TypeScript بفلسفة مشابهة عديمة الرأس أولاً وبنية أكثر اعتماداً على الإضافات. PrestaShop وBagisto منصتان PHP ناضجتان (Bagisto مبني على Laravel) بمنظومات أكبر بكثير من المظاهر والوحدات لكن بمنظومات أثقل في التشغيل والصيانة. يبقى WooCommerce أكبر خيار ذاتي الاستضافة من حيث قاعدة التثبيت، مبني على WordPress، وهو مناسب للفرق المستثمرة بالفعل في تلك المنظومة. للمطورين الذين يريدون تحديداً متجراً أمامياً ولوحة تحكم Node.js/React عاملين مُضمَّنين من اليوم الأول بدلاً من عديم الرأس فقط، EverShop هو الأنسب مباشرة.
متى لا تستخدمه
EverShop ليس الخيار المناسب إذا كنت تريد بنية عديمة الرأس بالكامل وتبني كل شيء بنفسك بأقصى مرونة أمامية — Medusa أو Vendure مصممان بشكل أكثر تحديداً لذلك النمط. إذا كان فريقك يعمل بشكل أساسي بـ PHP ولديه بالفعل خبرة في تلك المنظومة، فإن PrestaShop أو Bagisto أو WooCommerce ستكون على الأرجح أكثر إنتاجية من تبني منظومة Node.js جديدة فقط من أجل المتجر. منظومة مجتمع وإضافات EverShop أيضاً أصغر من Medusa أو Saleor، فإذا احتجت سوقاً كبيراً من الإضافات والتكاملات الجاهزة، فقد توفر منصة أكثر رسوخاً وقت تطوير. وإذا احتجت كتالوجاً بحجم مؤسسي ضخم بمتطلبات متعددة المناطق والعملات معقدة، فإن منصة بسجل إنتاجي أطول على ذلك الحجم قد تكون خياراً أكثر أماناً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو EverShop؟
إنه منصة تجارة إلكترونية حديثة ومفتوحة المصدر مبنية على Node.js وReact. توفر متجراً أمامياً سريعاً ولوحة تحكم React أنيقة وواجهة برمجة GraphQL وأساسيات المتجر — منتجات بمتغيرات، فئات، سلة تسوق ودفع، طلبات، عملاء، وعروض ترويجية — في قاعدة كود أخف وأحدث من المنصات الأقدم.
ما المنفذ الذي يستخدمه وأين لوحة التحكم؟
يعمل EverShop على المنفذ 3048 في المضيف (مرتبط بمنفذ 3000 في الحاوية). المتجر الأمامي على الرابط الجذري ولوحة التحكم على مسار /admin. لمتجر حقيقي ستضع وكيلاً عكسياً مع TLS على نطاقك الخاص أمام كليهما، لأن تسجيلات دخول الدفع والمشرف يجب ألا تنتقل عبر HTTP عادي أبداً.
ما بيانات اعتماد المشرف الافتراضية؟
لا توجد أي منها — لا يأتي EverShop بتسجيل دخول افتراضي، وهذا جيد للأمان. بعد التثبيت تُنشئ المستخدم المشرف بتشغيل الأمر المدمج (docker exec evershop npm run user:create مع بريدك وكلمة مرورك واسمك)، ثم تسجّل الدخول عبر /admin.
هل يحتاج PostgreSQL؟
نعم — يستخدم EverShop PostgreSQL، وهذا النشر يضبطه تلقائياً كحاوية ثانية بكلمة مرور مُولَّدة. يخزّن منتجاتك وطلباتك وعملاءك هناك.
كيف يُقارَن بـ Medusa أو PrestaShop؟
Medusa هو أقرب مقارنة — أيضاً Node.js، لكنه عديم الرأس أولاً، يستهدف المطورين الذين يبنون متجرهم الأمامي الخاص. يتضمن EverShop متجراً أمامياً ولوحة تحكم قابلين للاستخدام جاهزين. PrestaShop وBagisto منصتان PHP ناضجتان بمنظومات أكبر بكثير من المظاهر والوحدات لكن أثقل في التشغيل.