⚡ تثبيت Windmill — منصة المطورين وأتمتة مسارات العمل وتوليد الواجهات على Docker
نشر منصة Windmill على Ubuntu باستخدام Docker — محرك أتمتة مسارات العمل البرمجية وبديل Retool وAirflow لتحويل سكريبتات بايثون وTypeScript وGo وBash إلى واجهات ويب وتطبيقات داخلية على المنفذ 8000.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/automation/windmill/windmill-ubuntu.sh
chmod +x windmill-ubuntu.sh
sudo bash windmill-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/automation/windmill/windmill-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x windmill-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد قاعدة بيانات PostgreSQL (`./postgres-data`) ومجلد بيانات المنظومة (`./windmill-data`) وتشغيل خادم وعمال Windmill على المنفذ 8000.
sudo bash windmill-ubuntu.sh
4 إنشاء حساب المشرف وكتابة أول سكريبت
افتح متصفحك على الرابط http://ip-سيرفرك:8000. أنشئ حساب المشرف، واكتب أو الصق سكريبت بايثون أو TypeScript بمعاملات محددة النوع، لتشاهد Windmill يولد واجهة مستخدم تفاعلية ونقطة Webhook برمجية تلقائياً.
http://:8000
# Default login: admin@windmill.dev / changeme
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8000 | Windmill Web UI + API |
| 5432 | PostgreSQL (internal only) |
نظرة عامة
تعد Windmill منصة مطورين ومحرك أتمتة مسارات عمل برمجية (Workflow Orchestration & Developer Platform) مفتوح المصدر وفائق السرعة تم تصميمه كبديل عصري لمنصات Retool وTemporal وApache Airflow. تعمل المنصة عبر المنفذ 8000 بالاعتماد على قاعدة PostgreSQL، لتتيح للمبرمجين كتابة سكريبتات بلغات بايثون، وTypeScript، وGo، وBash، وSQL، وتحويلها فورياً إلى واجهات مستخدم بصرية، ونقاط Webhook، ومهام مجدولة (Cron Jobs)، ومسارات عمل معقدة متعددة الخطوات تدعم الشروط والتفرعات والموافقات البشرية.
لماذا تستخدمه
يتطلب بناء الأدوات الإدارية الداخلية ومسارات الأتمتة البرمجية وقتاً طويلاً لتصميم الواجهات، فضلاً عن ثقل المنصات القديمة مثل Airflow. كما تفرض المنصات التجارية (مثل Retool) اشتراكات شهرية باهظة تُحسب بعدد المستخدمين. يمنحك Windmill منصة متكاملة لكتابة كود نقي بلغتك المفضلة والحصول على تطبيقات داخلية ومسارات معالجة فورية في دقائق على سيرفرك الخاص بدون أي رسوم تراخيص وبأداء فائق الاستجابة.
متى تحتاجه
- تريد تحويل سكريبتات بايثون أو TypeScript أو Bash إلى أدوات ويب تفاعلية بنماذج إدخال مولدة تلقائياً
- تحتاج إلى محرك أتمتة خفيف وسريع لتنفيذ مسارات معالجة البيانات (ETL) ومهام البنية التحتية
- تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً لمنصات Retool وSuperblocks لبناء لوحات الإدارة الداخلية للشركات
- تحتاج لمركز موحد لجدولة المهام الدورية (Cron Jobs) مع سجلات تنفيذ تفصيلية وإعادة المحاولة التلقائية عند الخطأ
- تريد مسارات عمل تتطلب موافقة بشرية مسبقة (Human-in-the-loop) قبل تنفيذ المهام الحساسة مثل حذف الحسابات
من يحتاجه
- مهندسو ومطورو الخلفية لبناء لوحات الإدارة الداخلية وأدوات الدعم الفني دون الحاجة لتطوير واجهات مخصصة
- مهندسو الـ DevOps والـ SRE لأتمتة مهام صيانة السيرفرات وإعداد البنى التحتية وكتيبات حل الأعطال
- مهندسو ومحللو البيانات لتنسيق خطوط معالجة وتدفق البيانات (ETL) واستخراج التقارير التلقائية
- مديرو تقنية المعلومات لبناء بوابات خدمة ذاتية للموظفين لطلب الصلاحيات والتهيئة الوظيفية
- أصحاب السيرفرات المنزلية لأتمتة صيانة وترقيات الخدمات بلوحات تحكم ويب تفاعلية
حالات الاستخدام الشائعة
- بناء أداة دعم فني ببايثون تستعلم من قاعدة بيانات PostgreSQL، وتعدل حالة المشترك، وترسل تنبيهاً على Slack
- تنسيق خط معالجة يومي: سحب البيانات من واجهة برمجية، ومعالجتها بـ TypeScript، وتخزينها بمستودع البيانات
- إنشاء بوابة خدمة ذاتية لطلب إنشاء سيرفر افتراضي يقوم الموظف بإدخال بياناته وتفعيل سكريبت Ansible تلقائياً
- جدولة فحص دوري لقواعد البيانات كل ساعة وإرسال إشعار فوري لـ Telegram عند تجاوز الحدود المحددة
- تطبيق مسار عمل لإنهاء خدمة الموظفين يتطلب موافقة المدير بالبريد قبل مسح الحسابات والصلاحيات
الميزات الرئيسية
- توليد تلقائي للواجهات على المنفذ 8000: تحويل معاملات الدوال في بايثون وTypeScript إلى نماذج إدخال تفاعلية
- بيئة تنفيذ متعددة اللغات: دعم أصلي ومعزول لسيرفرات بايثون وTypeScript (Deno/Bun) وGo وBash وSQL
- مصمم مسارات عمل بصرية: بناء تدفقات العمل بالسحب والإفلات مع دعم التفرعات والحلقات والموافقات
- مصمم تطبيقات تفاعلي: بناء لوحات تحكم متطورة بمكونات جاهزة (جداول بيانات، أزرار، رسوم بيانية)
- إدارة الموارد والأسرار المشفرة: تخزين اتصالات قواعد البيانات ومفاتيح الـ API المشفرة وإعادة استخدامها بأمان
- أداء فائق السرعة: مبرمج بلغتي Rust وGo مع زمن استجابة يقل عن 10 ميلي ثانية لكل خطوة
- صلاحيات دقيقة وسجلات تدقيق كاملة: توثيق شامل لكل عملية تشغيل ومعاملات الإدخال ومن قام بالتنفيذ
- معمارية Docker Compose تجمع خادم Windmill وعمال التنفيذ مع قاعدة بيانات PostgreSQL 16
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8000
- أنشئ حساب المشرف الأول وسمّ مساحة العمل الرئيسية (Workspace)
- اضغط على '+ Script'، واختر بايثون أو TypeScript، واكتب دالة بمعاملات محددة، واضغط 'Save & Deploy'
- اختبر تشغيل السكريبت من نموذج الواجهة المولد تلقائياً أو عبر رابط الـ Webhook الخاص به
- خزن بيانات الاتصال الحساسة في قسم Resources (مثل مفاتيح الـ API واتصالات قواعد البيانات)
- ضع Windmill خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة بيانات PostgreSQL (`./postgres-data`)
أفضل ممارسات الأمان
- تنبيه أمني حاسم: عيّن قيمة سرية معقدة لـ `WM_SECRET` في ملف `.env` قبل تشغيل الحاوية
- عطّل ميزة التسجيل العام للمستخدمين بعد إنشاء حسابك الإداري
- استخدم تشفير HTTPS دائماً لحماية مفاتيح الـ API وبيانات السكريبتات المنقولة بالشبكة
- لا تكتب كلمات المرور كنصوص مكشوفة داخل كود السكريبتات؛ استخدم نظام Resources المشفر في Windmill
- أبقِ منفذ قاعدة البيانات الداخلي PostgreSQL 5432 معزولاً عن الإنترنت العام
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Windmill واجهة الويب والواجهة البرمجية والـ Webhooks عبر منفذ TCP 8000. اسمح بالمنفذ 8000 للشبكة المحلية (`ufw allow 8000/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8000، مع إبقاء المنفذ 8000 مغلقاً خارجياً وقاعدة البيانات معزولة.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./postgres-data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL بكافة السكريبتات والمسارات وسجلات التشغيل
- انسخ مجلد `./windmill-data` الذي يحتوي على ملفات الحزم وحالة العمال
- استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec windmill-db pg_dump -U windmill windmill > windmill_backup.sql`
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env` المحتوي على `WM_SECRET`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
الأخطاء الشائعة
- كتابة مفاتيح الـ API وكلمات المرور داخل كود السكريبت مباشرة بدلاً من استخدام مخزن Resources المشفر
- تشغيل مهام معالجة مجمعة تستغرق ساعات طويلة بدون تخصيص طوابير عمال مخصصة
- عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب مسح كافة السكريبتات والمسارات عند تحديث الحاوية
- التشغيل عبر بروتوكول HTTP غير المشفر مما يكشف مدخلات العمليات الحساسة وبيانات الخوادم
- عدم ضبط حدود الذاكرة لحاويات العمال مما يسمح لسكريبتات بايثون الثقيلة باستهلاك كامل رام السيرفر
استكشاف الأخطاء وإصلاحها
- ظهور خطأ 502 Bad Gateway في الواجهة — انتظر 30 ثانية لاكتمال إقلاع PostgreSQL وراجع السجلات: `docker logs windmill-server -f`
- توقف السكريبت بانتهاء المهلة (Timeout) — ارفع الحد الزمني في إعدادات السكريبت أو أضف عمالاً إضافيين
- فشل استيراد مكتبات بايثون — اكتب اسم المكتبة المطلوبة في بداية السكريبت أو اضبط حزم الحاوية
- فشل الاتصال بقاعدة البيانات — تأكد من عمل حاوية `windmill-db` وتطابق البيانات بملف `.env`
- العمال لا ينفذون المهام — تأكد من صحة حالة حاوية العمال بالأمر: `docker logs windmill-worker -f`
البدائل
منصة Retool التجارية للأدوات الداخلية. منصة Temporal لأتمتة مسارات العمل بالكود. منصة Apache Airflow لمسارات البيانات. منصة n8n للأتمتة البصرية المعتمدة على العقد. منصة Superblocks للأدوات الداخلية.
متى لا تستخدمه
تجنب استخدام Windmill إذا كنت تبحث فقط عن أداة ربط بصرية تعتمد على السحب والإفلات لغير المبرمجين لربط جداول Google Sheets بـ Gmail (حيث صُممت n8n لمسارات العمل البصرية). وإذا كنت تحتاج فقط لمهمة cron دورية بسيطة لمزامنة مجلدين، فإن أمر crontab العادي بالسيرفر أخف وأبسط.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي منصة Windmill وما الفرق بينها وبين Retool وn8n؟
تعد Windmill منصة موجهة للمطورين. بينما تركز n8n على الربط البصري لغير المبرمجين وتركز Retool على تصميم الواجهات الرسومية، تتيح Windmill كتابة كود حقيقي (بايثون، TypeScript، Go، Bash، SQL) وتحويله تلقائياً إلى واجهات وتطبيقات ومسارات عمل فائقة السرعة بزمن استجابة أقل من 10 ميلي ثانية.
ما هي لغات البرمجة التي تدعمها منصة Windmill؟
تدعم Windmill لغات Python، وTypeScript/JavaScript (عبر Deno وBun)، وGo، وBash، وSQL بشكل أصلي. ويمكنك كتابة سكريبتات بأي من هذه اللغات ودمجها معاً في مسار عمل واحد.
كيف تقوم منصة Windmill بتوليد واجهات المستخدم تلقائياً؟
يقوم Windmill بقراءة وتفسير أنواع المعاملات البرمجية المحددة في الدالة الرئيسية للسكريبت (مثل `def main(email: str, count: int = 5):`)، ويولد واجهة ويب تفاعلية فورية بحقول نصوص وأرقام وقوائم منسدلة مع التحقق من صحة المدخلات.
هل يمكن استخدام مكتبات خارجية مثل Pandas أو Axios داخل السكريبتات؟
نعم! يقوم Windmill بتثبيت وتخزين الحزم الخارجية من PyPI (لبايثون) وnpm (لـ TypeScript) تلقائياً عند استدعائها بالأكواد.
كم تستهلك منصة Windmill من الذاكرة العشوائية (RAM)؟
تمت برمجة خادم وعمال Windmill بلغتي Rust وGo مما يجعلها خفيفة وسريعة للغاية، حيث تستهلك عادة ما بين 200 إلى 500 ميجابايت فقط من الرام داخل Docker.
