خادم VPS لـ Activepieces: أتمتة على خادمك

تحاسبك خدمات الأتمتة المستضافة على كل مهمة، ويدور العدّاد حتى على أشياء ليست عملًا أصلًا. تدفق يفحص خلاصة كل خمس دقائق يعني 8640 تشغيلًا شهريًا قبل أن يفعل أي شيء مفيد. شغّل التدفق نفسه على خادمك، وتصبح الفاتورة هي الخادم وحده.

أداة Activepieces منشئ أتمتة مفتوح المصدر: مشغّلات وخطوات وتفرّعات ومئات التكاملات الجاهزة، إضافة إلى خطوات الكود حين لا تكفي الجاهزة. النسخة المجتمعية مرخّصة بـ MIT وتعمل بلا مشاكل على خادم صغير واحد مع Docker Compose.

أي خطة

ثبّتناها على خادم اختبار وقِسنا. يشغّل ملف compose الافتراضي التطبيق وخمسة workers: نحو 2.6–3 GB من RAM مع Postgres وRedis. ومع worker واحد ينخفض إلى نحو 1.6 GB.

اختر خطة بعنوان IPv4 خاص بها. الـwebhooks هي السبب الرئيسي لاستضافة هذه الأداة بنفسك، والخدمات التي تستدعيها يجب أن تصل إلى المنفذين 80 و443؛ وفي خطط NAT لا يمكن الوصول من الخارج إلا إلى منفذ SSH. الموقعان هما ألمانيا وفنلندا، ويظهر التوفر عند الطلب. يمكنك الدفع بالعملات المشفّرة، دون KYC.

التثبيت

وجّه أولًا نطاقًا — وليكن flows.example.com — إلى الخادم. ثم بصلاحيات root على Ubuntu 24.04 أو Debian 12:

curl -fsSL https://get.docker.com | sh
git clone --depth 1 https://github.com/activepieces/activepieces.git
cd activepieces
sh tools/deploy.sh

ينسخ deploy.sh الملف .env.example إلى .env ويملأ أسرارًا عشوائية. قبل التشغيل الأول غيّر سطرين في .env وسطرًا في ملف compose:

sed -i 's|^AP_FRONTEND_URL=.*|AP_FRONTEND_URL=https://flows.example.com|; s|^AP_TELEMETRY_ENABLED=.*|AP_TELEMETRY_ENABLED=false|' .env
sed -i "s|- '8080:80'|- '127.0.0.1:8080:80'|" docker-compose.yml

السطر الأول هو المهم. ليس AP_FRONTEND_URL للروابط في الواجهة فقط: فالـworkers يتصلون بالتطبيق عبره. اتركه على http://localhost:8080 وستبحث كل حاوية worker عن التطبيق داخل نفسها، فلا تجده، ولن تُنشر تدفقاتك أبدًا. هذا بالضبط ما واجهناه: «Socket.IO connection error» في سجلات الـworker، وطلب نشر معلّق، وwebhooks تردّ بـ 404. ومع النطاق الحقيقي نُشر التدفق نفسه وعمل الـwebhook.

يُبقي أمر sed على docker-compose.yml المنفذ 8080 على localhost. المنافذ التي ينشرها Docker تتجاوز ufw، ومن دون ذلك سيكون التطبيق مكشوفًا على منفذ عارٍ بجوار HTTPS لديك.

وعلى Micro-IP اكتفِ أيضًا بـ worker واحد:

sed -i 's/replicas: 5/replicas: 1/' docker-compose.yml

والآن HTTPS والتشغيل:

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
flows.example.com {
    reverse_proxy 127.0.0.1:8080
}
EOF
systemctl reload caddy
ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp && ufw enable
docker compose -p activepieces up -d

انتظر نصف دقيقة، ثم افتح https://flows.example.com وأنشئ حسابك فورًا. أول من يسجّل يملك المنصة؛ وبعد ذلك يصبح التسجيل بالدعوة فقط.

تأكّد من أن الـwebhooks تعمل

أنشئ تدفقًا بمشغّل Webhook (Catch Webhook)، وأضف أي خطوة، ثم انشره. تعرض لوحة المشغّل عنوان URL. أرسل إليه حدثًا تجريبيًا:

curl -X POST https://flows.example.com/api/v1/webhooks/YOUR_FLOW_ID \
  -H 'content-type: application/json' \
  -d '{"event":"payment.paid","amount":16}'

يجب أن تتلقى 200، ويظهر التشغيل في Runs على أنه ناجح. وإذا تلقيت 404 بدلًا من ذلك، فعد وتحقق من AP_FRONTEND_URL.

للتشغيل اليومي

• التحديثات. يثبّت ملف compose إصدارًا محددًا (0.92.2 وقت الكتابة). غيّر الوسم في docker-compose.yml، ثم نفّذ docker compose -p activepieces pull && docker compose -p activepieces up -d. ألقِ نظرة على ملاحظات الإصدار أولًا؛ فأدوات الأتمتة تحب إعادة تسمية الأشياء.
• النسخ الاحتياطية. تعيش التدفقات والاتصالات وسجل التشغيل في وحدة تخزين Postgres. خذ نسخة dump وفق جدول واحفظها خارج الخادم — فالاتصالات تحمل رموز API الخاصة بك لخدمات أخرى.
• خطوات الكود غير معزولة في هذا الإعداد (AP_EXECUTION_MODE=UNSANDBOXED). الخادم خادمك والتدفقات تدفقاتك، لذا فهذا مقبول. ويتوقف عن أن يكون مقبولًا لحظة أن تسمح لأشخاص لا تثق بهم ببناء التدفقات.

إذا كنت تعرف n8n فالفكرة نفسها — انظر خادم VPS لـ n8n. اختر المحرّر الذي تفكر فيه بسهولة أكبر؛ فكلاهما يعمل جيدًا على الخطط نفسها.

ذو صلة

• خادم VPS لـ n8n: أداة الأتمتة الكبيرة الأخرى التي تستضيفها بنفسك
• عدة خدمات على VPS واحد: ‏Activepieces بجوار تطبيقك ولوحة معلومات، بعنوان IP واحد
• خادم VPS لـ Docker
• كيف تضيف swap على VPS
• كيف تضبط جدار الحماية ufw