部署
Neotask 可以在任何地方运行 -- 从您的笔记本电脑到 Kubernetes 集群。选择适合您需求的部署方式。
本地安装
最简单的入门方式。直接在 macOS、Linux 或 Windows（通过 WSL2）上安装 Neotask。Gateway 作为由 launchd（macOS）或 systemd（Linux）管理的后台服务运行。
要求： Node.js 22+
您将获得：
- Gateway 作为后台服务运行
- 开机自动启动
- macOS 伴侣应用（在 macOS 上）
- 所有 CLI 工具
Docker
在 Docker 容器中运行 Gateway，使用持久的配置和工作空间卷。非常适合 VPS 部署或当您需要与主机系统隔离时。
特性：
- 基于 Node 22（Debian）的预构建镜像
- 可选的 Chromium + Xvfb 用于浏览器自动化（增加约 300MB）
- 带持久卷的 Docker Compose 配置
/health健康检查端点- 以非 root
node用户运行 - 代理沙箱支持（Docker-in-Docker 用于隔离执行）
持久状态：
- 配置：
~/.neotask/neotask.json - 工作空间：
~/.neotask/workspace/ - 会话：
~/.neotask/agents/*/sessions/ - 频道状态：
~/.neotask/whatsapp/等
Kubernetes
使用 StatefulSet 模式部署到 Kubernetes 以实现持久存储。社区维护的 Helm charts 可用。
典型配置：
- StatefulSet 用于 Gateway（持久会话和配置）
- ConfigMap 用于
neotask.json配置 - Secret 用于 token 和 API key
- PersistentVolumeClaim 用于会话数据和工作空间
- Service（ClusterIP 或 LoadBalancer）用于 WebSocket 访问
Fly.io
一条命令部署到 Fly.io，带持久卷和自动 HTTPS。
特性：
- 可配置 RAM 的 x86 VM（默认 2048MB）
- 持久
/data卷用于配置和会话 - 自动 TLS 终止
- SSH 访问用于配置
- 通过 ngrok 的 webhook 支持（可选）
Hetzner VPS
使用 Docker Compose 在专用 Hetzner VPS 上运行。完整的基础设施即代码支持，带社区 Terraform 模块。
配置包括：
- Docker Compose 配置
- 用于配置、工作空间和频道状态的持久目录
- 自定义 Dockerfile 用于内置所需二进制文件
- 防火墙和安全加固
Render
在 Render 上基于 Blueprint 的部署，带自动构建和 1GB 持久磁盘。
GCP Compute Engine
在 Google Cloud 上基于 Docker 的部署，带持久磁盘和启动自动化。
Podman
使用 Podman 和 systemd Quadlet 支持的无 root 容器执行。非常适合限制 Docker 守护进程访问的环境。
选择部署方式
| 需求 | 推荐 |
|---|---|
| 只是试用 | 本地安装 |
| Mac 上的个人使用 | 本地 + macOS 伴侣应用 |
| 始终在线的服务器 | VPS 上的 Docker（Hetzner、DigitalOcean） |
| 带扩展的生产环境 | Kubernetes |
| 快速云部署 | Fly.io 或 Render |
| 无 root 容器 | Podman |
远程访问
默认情况下，Gateway 仅监听 localhost（127.0.0.1）。要进行远程访问：
- Tailscale -- VPN 网状网络，带自动 DNS。Gateway 可以绑定到您的 Tailnet，从任何地方安全访问。Tailscale Serve 可以通过 HTTPS 暴露仪表盘。
- SSH 隧道 -- 通过 SSH 转发 Gateway 端口，无需暴露端口即可安全远程访问。
- 局域网绑定 -- 绑定到本地网络，从同一网络上的其他设备访问。通过 Bonjour/mDNS 自动发现。
详见 Gateway 了解配置详情。