لماذا تستضيف Activepieces ذاتيًا على خادم VPS
تفرض منصات الأتمتة من نوع SaaS رسومًا حسب عدد المهام المُنفَّذة وتضع حدودًا سريعًا: 1000 أو 5000 عملية شهريًا، ثم ترتفع الفاتورة. بنشر Activepieces على خادم VPS الخاص بك، تحوّل هذه التكلفة المتغيرة إلى تكلفة ثابتة وقابلة للتوقّع. والأهم أن webhooks الخاصة بك ومفاتيح API الطرف الثالث والبيانات التي تمرّ عبر سير عملك تبقى على جهاز تتحكم فيه، وهو ما يُغيّر كل شيء بالنسبة للوكالات التي تتعامل مع بيانات العملاء. يوفّر Activepieces أكثر من 280 موصّلًا (pieces) ومحرّرًا مرئيًا قائمًا على التفرّعات والحلقات، وكلّ ذلك برخصة MIT لنواته. خادم VPS Cloud هو البيئة المثالية: يعمل على مدار الساعة طوال الأسبوع، ويمتلك عنوان IP ثابتًا لاستقبال webhooks، ويتوسّع حسب الطلب عندما يزداد حجم أتمتتك.
الفوائد الملموسة للاستضافة الذاتية
- عمليات تنفيذ غير محدودة: لا حصّة شهرية بعد الآن ولا فوترة حسب المهمة، خادم VPS وحده هو ما يُحتسب.
- بيانات سيادية: لا تغادر webhooks ورموز OAuth والـ payloads خادمك أبدًا.
- موصّلات مخصّصة: أنشئ pieces خاصة بك بلغة TypeScript لواجهات API الداخلية لديك.
- عنوان IP ثابت وتوفّر على مدار الساعة طوال الأسبوع، أمران ضروريان لاستقبال webhooks موثوقة.
- تحديثات تحت السيطرة: تُثبّت الإصدار الذي يناسبك، دون أي تغيير مفروض.
- تكلفة قابلة للتوقّع: خادم VPS واحد يحلّ محلّ اشتراك تنفجر تكلفته مع الحجم.
المتطلبات التقنية
يبقى Activepieces معقولًا في استهلاك الموارد. خصّص خادم VPS بذاكرة 2 vCPU و4 غيغابايت RAM لاستخدام مريح في الإنتاج مع بضع عشرات من التدفقات النشطة؛ ويكفي 2 غيغابايت للبدء في مرحلة الاختبار. جهّز 20 غيغابايت من القرص، وDocker وDocker Compose مثبّتين، واسم نطاق (مثل automation.yourdomain.com) يشير إلى عنوان IP الخاص بالخادم، والمنفذين 80/443 مفتوحين. يحتاج Activepieces إلى قاعدة PostgreSQL وإلى Redis: كلاهما متوفّر في docker-compose الرسمي، فلا داعي لتثبيتهما بشكل منفصل.
نشر Activepieces باستخدام Docker
تحضير الخادم VPS وDocker
اتصل عبر SSH، وحدّث النظام ثم ثبّت Docker: curl -fsSL https://get.docker.com | sh. تحقّق باستخدام docker compose version. أنشئ مجلدًا مخصّصًا mkdir -p /opt/activepieces && cd /opt/activepieces.
الحصول على docker-compose الرسمي
نزّل الملف المرجعي: curl -O https://raw.githubusercontent.com/activepieces/activepieces/main/docker-compose.yml إضافةً إلى ملف .env. يجمع ملف compose هذا كلًّا من Activepieces وPostgreSQL وRedis.
ضبط متغيرات البيئة
في ملف .env، اضبط AP_FRONTEND_URL=https://automation.yourdomain.com، وولّد AP_ENCRYPTION_KEY (32 محرفًا سِتّ عشريًا) وAP_JWT_SECRET باستخدام openssl rand -hex 16. حدّد كلمة مرور PostgreSQL وAP_QUEUE_MODE=REDIS.
تشغيل الحزمة
شغّل المجموعة كلها في الخلفية باستخدام docker compose up -d. تابع بدء التشغيل عبر docker compose logs -f activepieces حتى ترى الخادم يستمع على المنفذ الداخلي 80.
إعداد وكيل عكسي وشهادة SSL
ضع Caddy أو Nginx Proxy Manager أمام الحاوية. مع Caddy، يكفي سطران: automation.yourdomain.com { reverse_proxy localhost:8080 }. يحصل Caddy تلقائيًا على شهادة Let's Encrypt عبر HTTPS.
إنشاء حساب المسؤول والاختبار
افتح https://automation.yourdomain.com، وأنشئ المستخدم الأول (الذي يصبح مسؤولًا)، ثم ابنِ تدفق اختبار يُطلَق عبر webhook للتأكّد من أن عنوان IP العام يستقبل فعلًا النداءات الواردة.
فعّل وضع الـ worker المنفصل في الإنتاج: اضبط AP_EXECUTION_MODE=SANDBOXED وشغّل حاوية أو أكثر من حاويات worker المخصّصة تشير إلى نفس Redis. بذلك تعزل تنفيذ التدفقات عن خادم الويب، ما يمنع سير عمل ثقيل من إبطاء الواجهة، ويمكنك التوسّع أفقيًا بمجرد إضافة workers عندما يزداد حجم عمليات التنفيذ.
التوثيق الرسمي
للإعدادات المتقدمة والخيارات الخاصة بالأداة، ارجع إلى التوثيق الرسمي لـ Activepieces. يغطّي هذا الدليل النشر على خادم VPS؛ ويبقى توثيق الناشر المرجعَ للضبط الدقيق والتحديثات الكبرى وحالات الاستخدام الخاصة.
