⚡ تثبيت ToolJet — منصة بناء التطبيقات واللوحات الداخلية ببرمجة منخفضة على Docker

نشر منصة ToolJet على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لبناء الأدوات واللوحات الإدارية وأنظمة الـ CRM بالبرمجة منخفضة الكود (Low-Code) والربط مع أكثر من 50 قاعدة بيانات على المنفذ 3000.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر ToolJet على المنفذ 3000 مع قاعدة بيانات PostgreSQL ومصمم الواجهات البصري بالسحب والإفلات جاهزاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x tooljet-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./postgres-data`) وتوليد مفاتيح التشفير وتشغيل منصة ToolJet على المنفذ 3000.

sudo bash tooljet-ubuntu.sh

4 تسجيل الدخول وبناء أول أداة داخلية

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:3000. أنشئ حساب المشرف، واربط قاعدة بياناتك (PostgreSQL أو MySQL)، واسحب عناصر الواجهة وصمم أدوات شركتك الداخلية في دقائق.

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

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

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

نظرة عامة

تعد ToolJet منصة بناء تطبيقات داخلية مفتوحة المصدر بالبرمجة منخفضة الكود (Low-Code) صُممت لتمكين الفرق الهندسية ومسؤولي العمليات من بناء ونشر الأدوات الإدارية، ولوحات تحكم العملاء، وأنظمة الـ CRM في دقائق معدودة. تعمل المنصة عبر المنفذ 3000 بالاعتماد على قاعدة بيانات PostgreSQL، وتتصل بأكثر من 50 مصدراً للبيانات (مثل PostgreSQL وMySQL وMongoDB وRedis وStripe وواجهات REST APIs)، وتوفر أكثر من 45 عنصراً بصرياً بالسحب والإفلات، مع دعم كتابة كود جافاسكريبت وبايثون مخصص ونظام صلاحيات متطور (RBAC).

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

يستهلك بناء لوحات التحكم الداخلية وأنظمة خدمة العملاء من الصفر باستخدام React أو Vue أسابيع من وقت المبرمجين في كتابة أكواد مكررة للجداول والنماذج والربط. كما تفرض المنصات السحابية التجارية (مثل Retool) اشتراكات شهرية باهظة تُحسب بعدد الموظفين. تمنحك ToolJet بيئة بناء احترافية ومستضافة ذاتياً بدون أي تكاليف تراخيص، مع سيادة كاملة لبيانات شركتك وسرية مطلقة لقواعد بياناتك على سيرفرك الخاص.

متى تحتاجه

  • تحتاج إلى بناء لوحات تحكم داخلية وأدوات إدارة قواعد البيانات (CRUD Panels) في ساعات بدلاً من أسابيع
  • تريد ربط ودمج مصادر بيانات متعددة (PostgreSQL وMongoDB وStripe وREST APIs) في واجهة بصرية موحدة
  • تريد حماية تامة لبيانات الشركة بحيث لا تغادر استعلامات قواعد البيانات سيرفراتك الداخلية نهائياً
  • تحتاج إلى نظام صلاحيات هرمي دقيق (RBAC) لتقييد وصول الموظفين لأدوات وعمليات محددة فقط
  • تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً لمنصات Retool وAppsmith باهظة الثمن

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

  • بناء بوابة دعم فني لرد أموال العملاء تستعلم من قاعدة PostgreSQL وتنفذ أمر استرجاع عبر Stripe API
  • إنشاء لوحة إدارة مخزون ومستودعات بمسح الباركود، وجداول قابلة للتعديل وتصدير تقارير CSV
  • تصميم نموذج إلكتروني لاعتماد طلبات التوظيف مع إرسال إشعارات بريدية وتحديث قواعد البيانات
  • الاتصال بنسخة قراءة فقط (Read-Only) من قاعدة البيانات الإنتاجية لفحص مشاكل حسابات العملاء بأمان
  • بناء لوحة تحكم بصرية لتشغيل وإيقاف سكريبتات الأتمتة على سيرفراتك عبر الـ Webhooks

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

  • مصمم واجهات بصري بالسحب والإفلات على المنفذ 3000: أكثر من 45 عنصراً جاهزاً (جداول، نماذج، رسوم بيانية، نوافذ منبثقة)
  • أكثر من 50 رابط بيانات أصلي: دعم PostgreSQL وMySQL وMongoDB وRedis وSnowflake وGraphQL وREST APIs وS3
  • تنفيذ كود JavaScript وPython المخصص: كتابة تحويلات برمجية ومنطق مخصص لمعالجة مخرجات الاستعلامات
  • نظام صلاحيات هرمي متطور (RBAC): توزيع المستخدمين في مجموعات بصلاحيات قراءة أو تعديل محددة لكل تطبيق
  • تتبع الإصدارات بنظام Git: إدارة التعديلات والتبديل بين الإصدارات السابقة وتأمين التحديثات
  • تعديل جماعي متزامن: إمكانية عمل عدة مبرمجين على نفس التطبيق في الوقت الفعلي
  • إدارة بيئات العمل المتعددة: نشر التطبيقات بسهولة بين بيئات التطوير والتجربة والإنتاج
  • معمارية Docker Compose تجمع خادم وواجهة ToolJet مع قاعدة PostgreSQL 15 على المنفذ 3000

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3000 لبدء شاشة إعداد ToolJet
  • أنشئ حساب المشرف الأول بالاسم والبريد وكلمة المرور الآمنة
  • اضغط على 'Data Sources' ← '+ Add Source' لربط قاعدة بياناتك (مثل PostgreSQL أو MySQL)
  • اضغط '+ Create new app'، واسحب عنصر 'Table' إلى مساحة العمل واربطه باستعلام قاعدة البيانات
  • أضف عنصر 'Button' مع تعيين حدث `onClick` لتنفيذ استعلام تعديل أو استدعاء API خارجي
  • ضع ToolJet خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./postgres-data`

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

  • تنبيه أمني حاسم: غيّر كلمة مرور المشرف فوراً وعطّل التسجيل المفتوح للعامة من الإعدادات
  • استخدم تشفير HTTPS دائماً في الإنتاج لحماية كلمات مرور قواعد البيانات وبيانات الجلسات المنقولة بالشبكة
  • استخدم حسابات قواعد بيانات للقراءة فقط عند بناء اللوحات التي لا تتطلب تعديل أو حذف البيانات
  • حافظ على سرية مفاتيح `SECRET_KEY_BASE` و`LOCKBOX_KEY`؛ فهي المسؤولة عن تشفير كلمات مرور قواعد بياناتك المربوطة
  • احمِ مجلد البيانات `./postgres-data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم ToolJet واجهة الويب والـ API عبر منفذ TCP 3000. يجب السماح بالمنفذ 3000 في جدار الحماية للشبكة المحلية (`ufw allow 3000/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 3000، مع إبقاء المنفذ 3000 مغلقاً خارجياً.

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

  • انسخ مجلد `./postgres-data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL بالتطبيقات والاستعلامات والمستخدمين
  • احتفظ بنسخة من ملف `.env` الذي يحتوي على مفاتيح التشفير `SECRET_KEY_BASE` و`LOCKBOX_KEY`
  • استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec tooljet-postgres pg_dump -U postgres tooljet > tooljet_backup.sql`
  • احتفظ بنسخة من ملف `docker-compose.yml`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync

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

  • فقدان مفتاح `LOCKBOX_KEY` أو `SECRET_KEY_BASE` مما يجعل فك تشفير كلمات مرور قواعد البيانات المربوطة مستحيلاً بعد الاستعادة
  • ربط قواعد البيانات الإنتاجية بصلاحيات المشرف الكاملة بدلاً من استخدام حسابات مخصصة محدودة الصلاحيات
  • عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب فقدان كامل التطبيقات والاستعلامات عند تحديث الحاوية
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر مما يعرض جلسات الموظفين للتنصت
  • ترك تسجيل المستخدمين الجدد مفتوحاً للعامة على سيرفر متصل بالإنترنت

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

  • ظهور خطأ 502 Bad Gateway في الواجهة — انتظر دقيقة لاكتمال إقلاع الخادم وتطبيق الميجريشنز ثم راجع السجلات: `docker logs tooljet-server -f`
  • فشل الاتصال بمصدر البيانات — تأكد من إمكانية الوصول لقاعدة البيانات من داخل حاوية Docker (استخدم IP السيرفر المحلي بدلاً من `localhost`)
  • خطأ في فك تشفير مصادر البيانات — تأكد من تطابق قيمة `LOCKBOX_KEY` في ملف `.env` مع المفتاح المستخدم وقت حفظ البيانات
  • فشل استعلامات جافاسكريبت المخصصة — افحص وحدة التحكم بالمتصفح وأداة فحص الاستعلامات في ToolJet لتصحيح الأخطاء
  • انهيار الحاوية بسبب نفاد الذاكرة — تأكد من توفر 2 إلى 4 جيجابايت RAM على الأقل لعمليات Node.js

البدائل

منصة Appsmith مفتوحة المصدر. منصة Retool التجارية السحابية. منصة Budibase مفتوحة المصدر. واجهة NocoDB لجداول قواعد البيانات. منصة Directus لإدارة البيانات.

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

تجنب استخدام ToolJet إذا كنت تبحث عن بناء مواقع تجارية للعامة تتطلب تصاميم CSS مخصصة بالغة التعقيد وتهيئة لمحركات البحث SEO (حيث صُممت أطر مثل Next.js لمواقع المستهلكين). وإذا كنت تحتاج فقط لجدول بيانات بسيط فوق قاعدة بيانات واحدة، فإن NocoDB أبسط.

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

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

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

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

ما هي منصة ToolJet وكيف تسرع عملية التطوير البرمجي؟

تعد ToolJet منصة برمجة منخفضة الكود (Low-Code) مفتوحة المصدر، تتيح للمطورين بناء لوحات الإدارة وأدوات العمليات الداخلية في دقائق عبر سحب وإفلات العناصر البصرية وربطها بقواعد البيانات وواجهات الـ APIs دون الحاجة لكتابة كود واجهات مكرر.

ما هي مصادر البيانات التي يمكن ربطها بـ ToolJet؟

تتصل ToolJet بأكثر من 50 مصدراً للبيانات تشمل PostgreSQL وMySQL وMongoDB وRedis وElasticsearch وGraphQL وREST APIs وجداول Google Sheets وبوابات Stripe وAWS S3.

هل يمكن كتابة كود مخصص بلغة جافاسكريبت أو بايثون؟

نعم! تتيح لك ToolJet كتابة دوال مخصصة بـ JavaScript وPython لمعالجة وفلترة مخرجات الاستعلامات وتطبيق شروط منطقية معقدة وتشغيل مسارات عمل متعددة الخطوات.

هل تدعم ToolJet إدارة أدوار وصلاحيات المستخدمين (RBAC)؟

نعم! تتضمن ToolJet نظام صلاحيات هرمي شامل يتيح إنشاء مجموعات مستخدمين وتحديد التطبيقات ومصادر البيانات والإجراءات المسموح لكل مستخدم بالوصول إليها.

كم تستهلك ToolJet من الذاكرة العشوائية (RAM)؟

تستهلك حزمة ToolJet (الخادم والواجهة وقاعدة PostgreSQL) ما بين 600 ميجابايت إلى 1.2 جيجابايت من الذاكرة العشوائية داخل Docker حسب كثافة الاستخدام.