النشر
يمكن تشغيل Neotask في أي مكان, من جهاز الحاسوب المحمول إلى مجموعة Kubernetes. اختر طريقة النشر التي تناسب احتياجاتك.
التثبيت المحلي
أبسط طريقة للبدء. ثبّت Neotask مباشرة على macOS أو Linux أو Windows (عبر WSL2). تعمل البوابة كخدمة خلفية تديرها launchd (على macOS) أو systemd (على Linux).
المتطلبات: Node.js 22+
ما تحصل عليه:
- البوابة تعمل كخدمة خلفية
- بدء تشغيل تلقائي عند الإقلاع
- تطبيق macOS المرافق (على macOS)
- جميع أدوات CLI
Docker
تشغيل البوابة في حاوية Docker مع وحدات تخزين إعداد ومساحة عمل دائمة. مثالي لنشر VPS أو عندما تريد عزلاً عن نظام المضيف.
الميزات:
- صور مبنية مسبقاً مبنية على Node 22 (Debian)
- Chromium + Xvfb اختياري لأتمتة المتصفح (يضيف ~300MB)
- إعداد Docker Compose مع وحدات تخزين دائمة
- نقطة نهاية التحقق من الصحة على
/health - يعمل كمستخدم
nodeغير الجذر - دعم بيئة تحديد الوكيل (Docker-in-Docker للتنفيذ المعزول)
الحالة الدائمة:
- الإعداد:
~/.neotask/neotask.json - مساحة العمل:
~/.neotask/workspace/ - الجلسات:
~/.neotask/agents/*/sessions/ - حالة القناة:
~/.neotask/whatsapp/وغيرها
Kubernetes
النشر على Kubernetes باستخدام نمط StatefulSet للتخزين الدائم. تتوفر مخططات Helm التي يديرها المجتمع.
الإعداد النموذجي:
- StatefulSet للبوابة (جلسات وإعداد دائم)
- ConfigMap لإعداد
neotask.json - Secret للرموز ومفاتيح API
- PersistentVolumeClaim لبيانات الجلسة ومساحة العمل
- Service (ClusterIP أو LoadBalancer) للوصول إلى WebSocket
Fly.io
النشر بأمر واحد على Fly.io مع وحدات تخزين دائمة وHTTPS تلقائي.
الميزات:
- آلة افتراضية x86 بذاكرة RAM قابلة للتكوين (2048MB افتراضياً)
- وحدة تخزين
/dataدائمة للإعداد والجلسات - إنهاء TLS تلقائي
- وصول SSH للإعداد
- دعم Webhook عبر ngrok (اختياري)
Hetzner VPS
التشغيل على Hetzner VPS مخصص مع Docker Compose. دعم كامل للبنية التحتية كرمز مع وحدات Terraform المجتمعية.
يشمل الإعداد:
- تكوين Docker Compose
- أدلة دائمة للإعداد ومساحة العمل وحالة القناة
- Dockerfile مخصص لإضافة الثنائيات المطلوبة
- جدار الحماية وتعزيز الأمان
Render
نشر مبني على المخططات على Render مع عمليات بناء تلقائية وقرص دائم بحجم 1GB.
GCP Compute Engine
نشر مبني على Docker على Google Cloud مع قرص دائم وأتمتة بدء التشغيل.
Podman
تنفيذ الحاويات بدون صلاحيات الجذر مع دعم Podman وsystemd Quadlet. مثالي للبيئات التي يكون فيها الوصول إلى Docker daemon مقيداً.
اختيار طريقة النشر
| الحاجة | الموصى به |
|---|---|
| مجرد تجربة | التثبيت المحلي |
| الاستخدام الشخصي على Mac | المحلي + تطبيق macOS المرافق |
| خادم دائم التشغيل | Docker على VPS (Hetzner، DigitalOcean) |
| إنتاج مع توسع | Kubernetes |
| نشر سحابي سريع | Fly.io أو Render |
| حاويات بدون صلاحيات الجذر | Podman |
الوصول عن بُعد
بشكل افتراضي، تستمع البوابة فقط على localhost (127.0.0.1). للوصول عن بُعد:
- Tailscale, شبكة VPN شبكية مع DNS تلقائي. يمكن للبوابة الارتباط بـ Tailnet الخاص بك للوصول الآمن من أي مكان. يمكن لـ Tailscale Serve كشف لوحة التحكم بـ HTTPS.
- نفق SSH, إعادة توجيه منفذ البوابة عبر SSH للوصول الآمن عن بُعد دون كشف المنافذ.
- ربط LAN, الارتباط بشبكتك المحلية للوصول من أجهزة أخرى على نفس الشبكة. اكتشاف تلقائي عبر Bonjour/mDNS.
راجع البوابة لتفاصيل الإعداد.