Distribution
Neotask kan köras var som helst, från din laptop till ett Kubernetes-kluster. Välj distributionsmetoden som passar dina behov.
Lokal installation
Det enklaste sättet att komma igång. Installera Neotask direkt på macOS, Linux eller Windows (via WSL2). Gateway körs som en bakgrundstjänst hanterad av launchd (macOS) eller systemd (Linux).
Krav: Node.js 22+
Vad du får:
- Gateway som körs som en bakgrundstjänst
- Automatisk start vid uppstart
- macOS-följapp (på macOS)
- Alla CLI-verktyg
Docker
Kör Gateway i en Docker-container med beständiga konfigurations- och arbetsytevolumer. Idealisk för VPS-distributioner eller när du vill ha isolering från ditt värdsystem.
Funktioner:
- Förbyggda avbildningar baserade på Node 22 (Debian)
- Valfritt Chromium + Xvfb för webbläsarautomatisering (lägger till ~300MB)
- Docker Compose-konfiguration med beständiga volymer
- Hälsokontrollslutpunkt vid
/health - Körs som icke-root
node-användare - Agentsandlåde-stöd (Docker-in-Docker för isolerad exekvering)
Beständigt tillstånd:
- Konfiguration:
~/.neotask/neotask.json - Arbetsyta:
~/.neotask/workspace/ - Sessioner:
~/.neotask/agents/*/sessions/ - Kanaltillstånd:
~/.neotask/whatsapp/, osv.
Kubernetes
Distribuera till Kubernetes med hjälp av StatefulSet-mönstret för beständig lagring. Community-underhållna Helm-diagram är tillgängliga.
Typisk konfiguration:
- StatefulSet för Gateway (beständiga sessioner och konfiguration)
- ConfigMap för
neotask.json-konfiguration - Secret för tokens och API-nycklar
- PersistentVolumeClaim för sessionsdata och arbetsyta
- Service (ClusterIP eller LoadBalancer) för WebSocket-åtkomst
Fly.io
Ett-kommando-distribution till Fly.io med beständiga volymer och automatisk HTTPS.
Funktioner:
- x86 VM med konfigurerbart RAM (standard 2048MB)
- Beständig
/data-volym för konfiguration och sessioner - Automatisk TLS-terminering
- SSH-åtkomst för konfiguration
- Webhook-stöd via ngrok (valfritt)
Hetzner VPS
Kör på en dedikerad Hetzner VPS med Docker Compose. Fullt stöd för infrastruktur-som-kod med community Terraform-moduler.
Konfigurationen inkluderar:
- Docker Compose-konfiguration
- Beständiga kataloger för konfiguration, arbetsyta och kanaltillstånd
- Anpassad Dockerfile för att baka in nödvändiga binärer
- Brandvägg och säkerhetshärdning
Render
Ritningsbaserad distribution på Render med automatiska byggen och 1GB beständig disk.
GCP Compute Engine
Docker-baserad distribution på Google Cloud med beständig disk och startautomatisering.
Podman
Rootlös containerexekvering med Podman och systemd Quadlet-stöd. Idealisk för miljöer där åtkomst till Docker-daemon är begränsad.
Välja en distribution
| Behov | Rekommenderas |
|---|---|
| Bara prova det | Lokal installation |
| Personligt bruk på din Mac | Lokal + macOS-följapp |
| Alltid-på-server | Docker på VPS (Hetzner, DigitalOcean) |
| Produktion med skalning | Kubernetes |
| Snabb molndistribution | Fly.io eller Render |
| Rootlösa containrar | Podman |
Fjärråtkomst
Som standard lyssnar Gateway bara på localhost (127.0.0.1). För fjärråtkomst:
- Tailscale, VPN-meshnätverk med automatisk DNS. Gateway kan binda till ditt Tailnet för säker åtkomst var som helst. Tailscale Serve kan exponera instrumentpanelen med HTTPS.
- SSH-tunnel, Vidarebefordra Gateway-porten via SSH för säker fjärråtkomst utan att exponera portar.
- LAN-bindning, Bind till ditt lokala nätverk för åtkomst från andra enheter på samma nätverk. Automatisk upptäckt via Bonjour/mDNS.
Se Gateway för konfigurationsdetaljer.