Развёртывание

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 для автоматизации браузера (добавляет ~300MB)
Настройка 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.

Особенности:

VM на x86 с настраиваемым объёмом RAM (по умолчанию 2048MB)
Постоянный том /data для конфигурации и сессий
Автоматическое завершение TLS
SSH-доступ для настройки
Поддержка вебхуков через ngrok (опционально)

Hetzner VPS

Запуск на выделенном VPS Hetzner с Docker Compose. Полная поддержка инфраструктуры как кода с модулями Terraform от сообщества.

Настройка включает:

Конфигурацию Docker Compose
Постоянные директории для конфигурации, рабочего пространства и состояния каналов
Пользовательский Dockerfile для включения необходимых бинарных файлов
Настройку брандмауэра и защиту безопасности

Render

Развёртывание на основе Blueprint на Render с автоматическими сборками и 1GB постоянного диска.

GCP Compute Engine

Развёртывание на основе Docker в Google Cloud с постоянным диском и автоматизацией запуска.

Podman

Безрутовое выполнение контейнеров с Podman и поддержкой systemd 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 для безопасного удалённого доступа без открытия портов.
Привязка к LAN, привязка к локальной сети для доступа с других устройств в той же сети. Автоматическое обнаружение через Bonjour/mDNS.

Подробности конфигурации см. в разделе Gateway.