🧩 تثبيت Appsmith — منصة منخفضة الكود مفتوحة المصدر لبناء الأدوات الداخلية

انشر Appsmith على Ubuntu بـ Docker — منصة منخفضة الكود لبناء الأدوات الداخلية ولوحات التحكم والداشبوردات التي تتصل مباشرة بقواعد بياناتك وواجهات برمجتك.

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

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

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

سكريبت تثبيت آلي — Appsmith جاهز بأمر واحد، منشئ التطبيقات على المنفذ 8080.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Low-Code/appsmith/appsmith-ubuntu.sh
chmod +x appsmith-ubuntu.sh
sudo bash appsmith-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Low-Code/appsmith/appsmith-ubuntu.sh

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

chmod +x appsmith-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم، يسحب صورة Appsmith CE، ويُشغّل الحاوية مع تخزين دائم للتطبيقات ومصادر البيانات والمستخدمين تحت دليل appsmith-stacks.

sudo bash appsmith-ubuntu.sh

4 الدخول إلى الواجهة

افتح المتصفح، أنشئ حساب المسؤول الأول من شاشة التسجيل، وابدأ ببناء أول تطبيق لك:

http://<your-server-ip>:8080

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

المنفذالغرض
8080HTTP Web Interface + Builder

نظرة عامة

Appsmith منصة منخفضة الكود مفتوحة المصدر لبناء الأدوات الداخلية ولوحات التحكم وشاشات CRUD دون كتابة تطبيق واجهة أمامية كامل من الصفر. تأتي كحاوية Docker واحدة مكتفية ذاتياً تجمع السيرفر وقاعدة بيانات MongoDB مدمجة لتخزين الإعدادات وRedis للتخزين المؤقت، لذا يمكنك بدء بناء الشاشات بعد دقائق من التثبيت. يوفر منشئ السحب والإفلات أكثر من 45 عنصر واجهة جاهز — جداول، نماذج، رسوم بيانية، أزرار، قوائم منسدلة — تربطها بالبيانات عبر JavaScript مباشرة في المتصفح، دون خطوة بناء منفصلة أو سيرفر خلفي تنشره بنفسك.

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

معظم الأدوات الداخلية — لوحات تحكم فرق الدعم، داشبوردات العمليات، نماذج تهيئة الموظفين — هي شاشات CRUD بسيطة فوق قاعدة بيانات أو واجهة برمجية موجودة، ومع ذلك يستهلك بناؤها يدوياً وقتاً هندسياً حقيقياً لشيء لا يواجه العملاء أبداً. يزيل Appsmith هذا العبء: اتصل مباشرة بـ PostgreSQL أو MySQL أو MongoDB أو واجهة REST/GraphQL، اسحب جدولاً أو نموذجاً إلى اللوحة، اربطه باستعلام عبر تعبير JS قصير، وستحصل على أداة قابلة للاستخدام في فترة بعد ظهر واحدة بدلاً من أسبوع عمل. ولأنه ذاتي الاستضافة، بيانات اعتماد قاعدة بياناتك ومنطق تطبيقك الداخلي لا تغادر بنيتك التحتية أبداً.

متى تحتاجه

  • لديك قاعدة بيانات أو مجموعة واجهات برمجية تحتاج واجهة CRUD داخلية سريعة للموظفين — لوحات تحكم، طوابير موافقات، داشبوردات عمليات
  • فريق الهندسة لديك يعيد بناء نفس نمط شاشة النموذج أو الجدول الداخلية لأقسام مختلفة باستمرار
  • تريد أدوات داخلية تتصل مباشرة بالبيانات الإنتاجية دون إعطاء كل أداة سيرفراً خلفياً مُعداً يدوياً
  • غير المهندسين في فريقك — العمليات، الدعم، المالية — يحتاجون واجهة بسيطة لعرض وتعديل السجلات دون الوصول لـ SQL
  • تريد استبدال سير عمل قائم على جداول البيانات والبريد الإلكتروني بتطبيق حقيقي مدعوم بقاعدة بياناتك الفعلية
  • تحتاج بناء نموذج أولي سريع لسير عمل داخلي قبل تقرير ما إذا كان يستحق بناءً مخصصاً كاملاً

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

  • بناء لوحة تحكم للبحث في سجلات العملاء وعرضها وتعديلها من قاعدة بيانات PostgreSQL إنتاجية
  • إنشاء واجهة سير عمل موافقات حيث يراجع المدراء ويوافقون على الطلبات المخزنة في جدول قاعدة بيانات
  • تجميع لوحة دعم داخلية تسحب التذاكر من واجهة برمجية وتتيح للوكلاء تحديث الحالة مباشرة
  • بناء واجهة CRUD فوق مجموعة MongoDB لفريق محتوى أو مخزون لإدارة السجلات
  • ربط عدة واجهات REST معاً في لوحة تحكم عمليات واحدة دون كتابة سيرفر خلفي مخصص
  • منح فريق المالية واجهة لتصفح وتصدير بيانات من مستودع بيانات دون وصول SQL مباشر

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

  • منشئ واجهة بالسحب والإفلات مع أكثر من 45 عنصر جاهز — جداول، نماذج، رسوم بيانية، نوافذ منبثقة، قوائم منسدلة، وأدوات رفع ملفات
  • أكثر من 25 تكاملاً أصلياً مع مصادر البيانات بما فيها PostgreSQL وMySQL وMongoDB وRedis وDynamoDB وElasticSearch وFirestore وS3
  • موصلات REST API وGraphQL لربط أي خدمة خارجية إلى جانب قواعد بياناتك
  • JavaScript مدمج مباشرة في المتصفح لربط العناصر بالاستعلامات وكتابة منطق مخصص دون خطوة بناء
  • تحكم بالإصدارات عبر Git لربط تطبيق بمستودع GitHub أو GitLab أو Bitbucket للتاريخ والتراجع
  • كائنات JS ومكتبات استعلامات قابلة لإعادة الاستخدام لمشاركة المنطق عبر صفحات وتطبيقات متعددة
  • تحكم بالوصول قائم على الأدوار ومجموعات مستخدمين لتقييد من يمكنه عرض أو تعديل أو نشر كل تطبيق
  • نشر بنقرة واحدة يُصدر تطبيقاً يعمل فوراً، منفصلاً عن نسخة التطوير القابلة للتعديل

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

  • أنشئ حساب المسؤول الأول من شاشة التسجيل فور فتح واجهة الويب
  • أضف مصدر بيانات تحت Datasources — أدخل تفاصيل اتصال PostgreSQL أو MySQL أو MongoDB أو REST API
  • أنشئ تطبيقاً جديداً واسحب عناصر مثل Table أو Form أو Chart إلى اللوحة من لوحة العناصر
  • اربط عنصراً باستعلام بكتابة تعبير بأسلوب JS، مثل {{ Table1.selectedRow.name }}، لجلب بيانات حية
  • اكتب استعلاماً على مصدر بياناتك تحت لوحة Queries وأشر إليه من أي عنصر في الصفحة
  • أعد التنقل بين الصفحات وأضف صفحات إضافية إذا احتاجت الأداة أكثر من شاشة واحدة
  • اضبط مجموعات المستخدمين والصلاحيات تحت Settings حتى يصل فقط الموظفون المناسبون أو يعدّلوا التطبيق
  • انقر Deploy لنشر نسخة حية للقراءة يتفاعل معها المستخدمون النهائيون

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

  • غيّر بيانات اعتماد المسؤول الأعلى الافتراضية فور إنشاء الحساب الأول — يملك تحكماً كاملاً في المثيل
  • ضع Appsmith خلف وكيل عكسي مع HTTPS لأن بيانات تسجيل الدخول وسلاسل الاتصال تنتقل بنص عادي HTTP افتراضياً على المنفذ 8080
  • قيّد بيانات اعتماد مصادر البيانات لمستخدمي قاعدة بيانات بأقل صلاحية — لا يجب أن يملك تطبيق مخترق وصولاً كاملاً لقاعدة البيانات
  • خزّن الأسرار في مخزن بيانات اعتماد مصدر البيانات بدلاً من كتابتها مباشرة داخل كائنات JS أو الاستعلامات
  • فعّل التحكم بالوصول القائم على الأدوار وخصص المستخدمين لمجموعات بدلاً من مشاركة تسجيل دخول مسؤول واحد
  • حافظ على تحديث صورة Appsmith Docker — اسحب الإصدارات الجديدة بانتظام لتلقي تصحيحات الأمان
  • قيّد الوصول الشبكي للمنفذ 8080 على الشبكات الموثوقة أو VPN إذا كانت الأداة تُستخدم داخلياً فقط
  • راجع سجلات وصول الوكيل العكسي دورياً لرصد محاولات تسجيل دخول أو أنماط وصول غير معتادة

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

يكشف Appsmith منفذاً واحداً، 8080 في هذا النشر، يخدم كلاً من المنشئ المرئي والتطبيق المنشور عبر HTTP عادي. ولأن هذا المنفذ يحمل بيانات اعتماد قاعدة البيانات ومفاتيح API وجلسات تسجيل الدخول، يجب ألا يُكشف مباشرة للإنترنت العام — ضعه خلف Nginx Proxy Manager أو وكيل عكسي آخر مع شهادة TLS صالحة قبل السماح بالوصول عن بُعد. داخلياً، تُشغّل الحاوية أيضاً MongoDB وRedis مدمجين لإعداداتها وتخزينها المؤقت الخاص؛ هذه غير منشورة ولا تحتاج قواعد جدار ناري. إذا كان فريقك يحتاج Appsmith على الشبكة المحلية فقط، احظر المنفذ 8080 في الجدار الناري لحركة المرور الخارجية واطلب VPN مثل WireGuard للاستخدام عن بُعد.

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

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

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

  • ترك حساب المسؤول الأعلى بكلمة مرور ضعيفة أو افتراضية على مثيل يمكن الوصول إليه من الإنترنت
  • كشف المنفذ 8080 دون وكيل عكسي وTLS، مما يرسل بيانات اعتماد قاعدة البيانات عبر HTTP عادي
  • منح اتصال مصدر بيانات التطبيق بيانات اعتماد كاملة لقاعدة البيانات بدلاً من مستخدم محدود الصلاحيات
  • عدم استخدام تحكم Git بالإصدارات، ثم فقدان العمل عند تعديل أو حذف تطبيق بالخطأ
  • كتابة مفاتيح API أو كلمات المرور مباشرة داخل كائنات JS بدلاً من استخدام تخزين بيانات الاعتماد على مستوى مصدر البيانات
  • بناء تطبيق واحد ضخم بدلاً من تقسيم الأدوات المختلفة إلى تطبيقات منفصلة بصلاحياتها الخاصة
  • كتابة استعلامات تعمل مع كل ضغطة مفتاح بدلاً من عند النقر على زر، مما يسبب حملاً زائداً على قاعدة البيانات

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

  • الحاوية لا تبدأ — تحقق من docker logs appsmith بحثاً عن أخطاء تهيئة MongoDB أو Redis، وتأكد من صلاحيات حجم stacks
  • لا يمكن الاتصال بمصدر بيانات PostgreSQL أو MySQL — تحقق أن قاعدة البيانات تسمح باتصالات بعيدة وأن جدارها الناري يسمح بحركة مرور من IP مضيف Appsmith
  • العناصر تعرض بيانات فارغة أو قديمة — تحقق أن الاستعلام الأساسي عمل فعلاً في لوحة Queries وأن تعبير الربط يطابق بنية الاستجابة
  • تحميل بطيء للصفحات — قلّل عدد الاستعلامات المضبوطة للتشغيل التلقائي عند تحميل الصفحة وحوّل غير الحرجة منها للتشغيل عند إجراء المستخدم فقط
  • التغييرات لا تظهر للمستخدمين النهائيين — تذكر أن المنشئ يعدّل مسودة؛ انقر Deploy لنشر التغييرات على التطبيق الحي
  • فشل تسجيل الدخول بعد إضافة نطاق مخصص — حدّث عنوان URL المضبوط للتطبيق في متغيرات بيئة docker-compose ليطابق النطاق الجديد
  • استخدام ذاكرة مرتفع — تعمل MongoDB وRedis المدمجتان داخل نفس حاوية سيرفر التطبيق، لذا خصص 2 جيجابايت رام على الأقل للاستخدام المريح

البدائل

Retool هو أقرب منافس تجاري بمنشئ أكثر صقلاً وميزات مؤسسية أوسع، لكنه مغلق المصدر وفئته ذاتية الاستضافة مكلفة عند التوسع. Budibase وToolJet كلاهما منشئا منخفض الكود مفتوحا المصدر بفلسفة شبيهة بـ Appsmith — يميل Budibase نحو قاعدة بيانات مدمجة وتطبيقات أبسط، بينما بنية إضافات ToolJet مشابهة لنموذج مصادر بيانات Appsmith. تركز n8n وWindmill على أتمتة سير العمل الخلفي بدلاً من بناء واجهات تفاعلية، فهي تحل مشكلة مختلفة. كأداة ذاتية الاستضافة ومفتوحة المصدر مصممة خصيصاً لواجهات CRUD الداخلية مع دعم قوي لمصادر البيانات الأصلية، يبقى Appsmith من أكمل الخيارات.

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

صُمم Appsmith للأدوات الداخلية الموجهة للموظفين — وليس مخصصاً لتطبيقات العملاء العامة أو المواقع التسويقية أو المنتجات التي تحتاج تصميماً مخصصاً دقيقاً، لأن المنشئ القائم على العناصر يضحي ببعض المرونة البصرية مقابل السرعة. إذا كان فريقك يحتاج إدارة حالة معقدة من جانب العميل، أو رسوماً متحركة، أو نظام تصميم مخصص كامل، فتطبيق React أو Vue مبني يدوياً سيخدمك بشكل أفضل. لاستعلام واحد لمرة واحدة، قد يكون سكريبت أخف أبسط من إعداد تطبيق كامل. وإذا كانت مؤسستك تحتاج SSO مؤسسي أو سجلات تدقيق دقيقة أو دعماً مخصصاً، تحقق ما إذا كانت النسخة المجتمعية المجانية تغطي احتياجاتك أو ما إذا كانت فئة Business المدفوعة من Appsmith مطلوبة.

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

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

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

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

هل Appsmith مجاني حقاً للاستضافة الذاتية؟

نعم. النسخة المجتمعية مفتوحة المصدر برخصة Apache 2.0 ومجانية للاستضافة الذاتية دون حدود مستخدمين أو قيود زمنية، مع وصول لجميع العناصر الأساسية وتكاملات مصادر البيانات والمنشئ القائم على JS. الميزات المتقدمة مثل SSO وRBAC الدقيق وسجلات التدقيق محجوزة لفئة Business المدفوعة.

ما قواعد البيانات والواجهات البرمجية التي يمكن لـ Appsmith الاتصال بها؟

يملك Appsmith أكثر من 25 تكاملاً أصلياً بما فيها PostgreSQL وMySQL وMongoDB وRedis وDynamoDB وElasticSearch وFirestore وSnowflake وS3، بالإضافة إلى موصلات REST API وGraphQL عامة لأي شيء آخر. يمكنك دمج عدة مصادر بيانات في نفس التطبيق.

هل أحتاج معرفة JavaScript للبناء بـ Appsmith؟

معرفة JavaScript الأساسية تساعد في ربط البيانات وكتابة منطق شرطي، لكن معظم الأدوات الداخلية البسيطة يمكن بناؤها بسحب العناصر وكتابة تعبيرات قصيرة مثل {{ Table1.selectedRow.id }}. سير العمل المعقد يستفيد من كائنات JS، التي تعمل كدوال صغيرة من جانب السيرفر تستدعيها من الواجهة.

كيف أنقل تطبيقاً من التطوير إلى الإنتاج؟

يفصل Appsmith بين عرض المنشئ القابل للتعديل والتطبيق المنشور. انقر Deploy في الزاوية العلوية اليمنى لنشر تغييراتك الحالية كالنسخة الحية التي يراها المستخدمون النهائيون، بينما تستمر في تعديل المسودة بشكل منفصل. تكامل Git يتيح أيضاً التفريع والمراجعة ودمج التغييرات قبل النشر.

هل يمكن لعدة أشخاص البناء في Appsmith بنفس الوقت؟

نعم، تدعم النسخة المجتمعية التعديل المتزامن مع مؤشرات حضور فورية تُظهر من يعمل أيضاً على نفس التطبيق. للتعاون المنظم بفروع وطلبات سحب، اربط التطبيق بمستودع Git حتى يمكن مراجعة التغييرات قبل دمجها في الفرع الرئيسي.