Wdrożenie

Neotask może działać wszędzie -- od laptopa po klaster Kubernetes. Wybierz metodę wdrożenia odpowiadającą Twoim potrzebom.

Lokalna instalacja

Najprostszy sposób na rozpoczęcie. Zainstaluj Neotask bezpośrednio na macOS, Linux lub Windows (przez WSL2). Brama działa jako usługa w tle zarządzana przez launchd (macOS) lub systemd (Linux).

Wymagania: Node.js 22+

Co otrzymujesz:

Brama działająca jako usługa w tle
Automatyczne uruchamianie przy starcie
Aplikacja towarzysząca macOS (na macOS)
Wszystkie narzędzia CLI

Docker

Uruchamiaj bramę w kontenerze Docker z trwałymi woluminami konfiguracji i przestrzeni roboczej. Idealne do wdrożeń VPS lub gdy chcesz izolacji od systemu hosta.

Funkcje:

Wstępnie zbudowane obrazy oparte na Node 22 (Debian)
Opcjonalny Chromium + Xvfb do automatyzacji przeglądarki (dodaje ~300MB)
Konfiguracja Docker Compose z trwałymi woluminami
Punkt końcowy sprawdzania stanu w /health
Działa jako użytkownik node bez uprawnień roota
Obsługa piaskownicy agenta (Docker-in-Docker dla izolowanego wykonania)

Trwały stan:

Konfiguracja: ~/.neotask/neotask.json
Przestrzeń robocza: ~/.neotask/workspace/
Sesje: ~/.neotask/agents/*/sessions/
Stan kanału: ~/.neotask/whatsapp/ itp.

Kubernetes

Wdrażaj do Kubernetes używając wzorca StatefulSet dla trwałego przechowywania. Dostępne są wykresy Helm utrzymywane przez społeczność.

Typowa konfiguracja:

StatefulSet dla bramy (trwałe sesje i konfiguracja)
ConfigMap dla konfiguracji neotask.json
Secret dla tokenów i kluczy API
PersistentVolumeClaim dla danych sesji i przestrzeni roboczej
Service (ClusterIP lub LoadBalancer) dla dostępu WebSocket

Fly.io

Wdrożenie jednym poleceniem na Fly.io z trwałymi woluminami i automatycznym HTTPS.

Funkcje:

Maszyna wirtualna x86 z konfigurowalną pamięcią RAM (domyślnie 2048MB)
Trwały wolumin /data dla konfiguracji i sesji
Automatyczne zakończenie TLS
Dostęp SSH do konfiguracji
Obsługa webhooków przez ngrok (opcjonalnie)

Hetzner VPS

Uruchamiaj na dedykowanym VPS Hetzner z Docker Compose. Pełna obsługa infrastruktury jako kodu z modułami Terraform utrzymywanymi przez społeczność.

Konfiguracja obejmuje:

Konfiguracja Docker Compose
Trwałe katalogi dla konfiguracji, przestrzeni roboczej i stanu kanału
Niestandardowy Dockerfile do pieczenia wymaganych binariów
Zapora i utwardzanie bezpieczeństwa

Render

Wdrożenie oparte na planie na platformie Render z automatycznymi kompilacjami i 1GB trwałego dysku.

GCP Compute Engine

Wdrożenie oparte na Docker na Google Cloud z trwałym dyskiem i automatyzacją uruchamiania.

Podman

Wykonanie kontenerów bez uprawnień roota z obsługą Podman i systemd Quadlet. Idealne dla środowisk, gdzie dostęp do demona Docker jest ograniczony.

Wybór wdrożenia

Potrzeba	Zalecane
Tylko wypróbowanie	Lokalna instalacja
Użytek osobisty na Macu	Lokalna + aplikacja towarzysząca macOS
Serwer zawsze włączony	Docker na VPS (Hetzner, DigitalOcean)
Produkcja ze skalowaniem	Kubernetes
Szybkie wdrożenie w chmurze	Fly.io lub Render
Kontenery bez uprawnień roota	Podman

Zdalny dostęp

Domyślnie brama nasłuchuje tylko na localhost (127.0.0.1). Dla zdalnego dostępu:

Tailscale -- Sieć VPN mesh z automatycznym DNS. Brama może być powiązana z Twoją siecią Tailnet dla bezpiecznego dostępu z dowolnego miejsca. Tailscale Serve może udostępniać panel sterowania z HTTPS.
Tunel SSH -- Przekaż port bramy przez SSH dla bezpiecznego zdalnego dostępu bez otwierania portów.
Powiązanie LAN -- Powiąż z lokalną siecią dla dostępu z innych urządzeń w tej samej sieci. Automatyczne odkrywanie przez Bonjour/mDNS.

Szczegółowe informacje o konfiguracji znajdziesz w artykule Brama.