# النشر

يمكن تشغيل 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.

راجع [البوابة](gateway.md) لتفاصيل الإعداد.