배포

Neotask는 어디서나 실행할 수 있습니다, 노트북에서 Kubernetes 클러스터까지. 귀하의 필요에 맞는 배포 방법을 선택하세요.

로컬 설치

시작하는 가장 간단한 방법입니다. macOS, Linux, 또는 Windows(WSL2를 통해)에 Neotask를 직접 설치합니다. 게이트웨이는 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

영구 스토리지를 위한 StatefulSet 패턴을 사용하여 Kubernetes에 배포합니다. 커뮤니티에서 유지 관리하는 Helm 차트를 사용할 수 있습니다.

일반적인 설정:

• 게이트웨이를 위한 StatefulSet (영구 세션 및 구성)
• neotask.json 구성을 위한 ConfigMap
• 토큰 및 API 키를 위한 Secret
• 세션 데이터 및 워크스페이스를 위한 PersistentVolumeClaim
• WebSocket 접근을 위한 Service (ClusterIP 또는 LoadBalancer)

Fly.io

영구 볼륨과 자동 HTTPS가 있는 Fly.io에 원 커맨드 배포.

특징:

• 구성 가능한 RAM이 있는 x86 VM (기본값 2048MB)
• 구성 및 세션을 위한 영구 /data 볼륨
• 자동 TLS 종료
• 구성을 위한 SSH 접근
• ngrok을 통한 웹훅 지원 (선택적)

Hetzner VPS

Docker Compose를 사용하여 전용 Hetzner VPS에서 실행합니다. 커뮤니티 Terraform 모듈을 통한 완전한 인프라 코드 지원.

설정 포함:

• Docker Compose 구성
• 구성, 워크스페이스, 채널 상태를 위한 영구 디렉토리
• 필요한 바이너리를 포함하기 위한 커스텀 Dockerfile
• 방화벽 및 보안 강화

Render

자동 빌드와 1GB 영구 디스크가 있는 Render에서의 Blueprint 기반 배포.

GCP Compute Engine

영구 디스크 및 시작 자동화가 있는 Google Cloud에서의 Docker 기반 배포.

Podman

Podman 및 systemd Quadlet 지원을 사용한 루트리스 컨테이너 실행. Docker 데몬 접근이 제한된 환경에 이상적입니다.

배포 선택

원격 접근

기본적으로 게이트웨이는 localhost(127.0.0.1)에서만 수신합니다. 원격 접근을 위해:

• Tailscale, 자동 DNS가 있는 VPN 메시 네트워크. 게이트웨이가 어디서나 안전한 접근을 위해 Tailnet에 바인딩할 수 있습니다. Tailscale Serve는 HTTPS로 대시보드를 노출할 수 있습니다.
• SSH 터널, 포트를 노출하지 않고 SSH를 통해 게이트웨이 포트를 안전하게 포워딩합니다.
• LAN 바인딩, 동일 네트워크의 다른 기기에서 접근하기 위해 로컬 네트워크에 바인딩합니다. Bonjour/mDNS를 통한 자동 발견.

구성 세부 사항은 게이트웨이를 참조하세요.