Розгортання
Neotask може працювати де завгодно, від вашого ноутбука до кластера Kubernetes. Виберіть метод розгортання, що відповідає вашим потребам.
Локальне встановлення
Найпростіший спосіб розпочати. Встановіть Neotask безпосередньо на macOS, Linux або Windows (через WSL2). Gateway працює як фонова служба, керована launchd (macOS) або systemd (Linux).
Вимоги: Node.js 22+
Що ви отримуєте:
- Gateway, що працює як фонова служба
- Автоматичний запуск при завантаженні системи
- Застосунок-компаньйон для macOS (на macOS)
- Всі інструменти CLI
Docker
Запускайте Gateway у Docker-контейнері з постійними томами конфігурації та робочого простору. Ідеально для розгортань на VPS або коли вам потрібна ізоляція від хост-системи.
Функції:
- Готові образи на основі Node 22 (Debian)
- Опційний Chromium + Xvfb для автоматизації браузера (додає ~300 МБ)
- Налаштування Docker Compose з постійними томами
- Кінцева точка перевірки стану на
/health - Виконується від імені непривілейованого користувача
node - Підтримка sandbox для агентів (Docker-in-Docker для ізольованого виконання)
Постійний стан:
- Конфігурація:
~/.neotask/neotask.json - Робочий простір:
~/.neotask/workspace/ - Сесії:
~/.neotask/agents/*/sessions/ - Стан каналів:
~/.neotask/whatsapp/тощо
Kubernetes
Розгортайте в Kubernetes за допомогою шаблону StatefulSet для постійного сховища. Доступні підтримувані спільнотою Helm-чарти.
Типове налаштування:
- StatefulSet для Gateway (постійні сесії та конфігурація)
- ConfigMap для конфігурації
neotask.json - Secret для токенів та API-ключів
- PersistentVolumeClaim для даних сесій та робочого простору
- Service (ClusterIP або LoadBalancer) для доступу через WebSocket
Fly.io
Розгортання однією командою на Fly.io з постійними томами та автоматичним HTTPS.
Функції:
- x86-ВМ з конфігурованою оперативною пам'яттю (за замовчуванням 2048 МБ)
- Постійний том
/dataдля конфігурації та сесій - Автоматичне завершення TLS
- SSH-доступ для конфігурації
- Підтримка вебхуків через ngrok (опційно)
Hetzner VPS
Запускайте на виділеному VPS Hetzner з Docker Compose. Повна підтримка інфраструктури як коду з модулями Terraform від спільноти.
Налаштування включає:
- Конфігурацію Docker Compose
- Постійні директорії для конфігурації, робочого простору та стану каналів
- Власний Dockerfile для вбудовування необхідних бінарних файлів
- Налаштування брандмауера та посилення безпеки
Render
Розгортання на основі Blueprint на Render з автоматичними збірками та постійним диском 1 ГБ.
GCP Compute Engine
Розгортання на основі Docker у Google Cloud з постійним диском та автоматизацією запуску.
Podman
Безкореневе виконання контейнерів з підтримкою Podman та системного Quadlet. Ідеально для середовищ, де доступ до демону Docker обмежений.
Вибір способу розгортання
| Потреба | Рекомендація |
|---|---|
| Просто спробувати | Локальне встановлення |
| Особисте використання на Mac | Локально + застосунок-компаньйон для macOS |
| Завжди увімкнений сервер | Docker на VPS (Hetzner, DigitalOcean) |
| Продуктивне середовище з масштабуванням | Kubernetes |
| Швидке хмарне розгортання | Fly.io або Render |
| Безкореневі контейнери | Podman |
Віддалений доступ
За замовчуванням Gateway слухає лише на localhost (127.0.0.1). Для віддаленого доступу:
- Tailscale, VPN-мережа типу «сітка» з автоматичним DNS. Gateway може прив'язатися до вашої Tailnet для безпечного доступу з будь-якого місця. Tailscale Serve може надавати доступ до панелі з HTTPS.
- SSH-тунель, Перенаправте порт Gateway через SSH для безпечного віддаленого доступу без відкриття портів.
- Прив'язка до локальної мережі, Прив'яжіться до вашої локальної мережі для доступу з інших пристроїв у тій самій мережі. Автоматичне виявлення через Bonjour/mDNS.
Деталі конфігурації дивіться в розділі Gateway.