无头部署（Docker）

NevoFlux Agent 可以在容器中以**无头（headless）**方式运行，无需桌面环境。官方 nevoflux/agent 镜像打包了守护进程、无头浏览器以及内置知识库。你交给它一条自然语言 任务，agent 便会驱动真实浏览器（自动化 + 计算机控制 + shell/文件工具）并返回结果。

“无头”指的是部署模式，而非功能缩水。 无头任务能完成桌面会话所能做的一切—— 浏览网页、使用工具、运行技能、读写知识库。唯一的区别是没有可见窗口。

本章节自 nevoflux-agent v0.3.10 起提供。自 v0.3.13 起，镜像会在每次发布时 推送到 Docker Hub。此后容器又多了几种接入方式：

以及打包方式：

• Docker 镜像 —— 如何拉取或构建、构建参数、运行模式、浏览器引擎以及实时观看（VNC）。
• Docker Compose —— 随发行版附带的 docker-compose.yml，逐项讲解。

快速开始

# 1. 拉取官方镜像（amd64 + arm64；自 v0.3.13 起发布）
docker pull nevoflux/agent:0.3.16          # 或 :latest

# 2. 运行长驻服务（运行时需要你的服务商密钥）
docker run --rm -p 8080:8080 -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" nevoflux/agent:0.3.16

# 3. 提交一个浏览器任务
curl -s localhost:8080/tasks -H 'Content-Type: application/json' \
  -d '{"task":"open example.com and report the title","mode":"browser"}'
# → {"id":"task-0"}
curl -s localhost:8080/tasks/task-0
# → {"id":"task-0","status":"succeeded","output":"The title is Example Domain.", ...}

同一端口也响应 OpenAI 与 Anthropic SDK 以及 A2A 客户端——它们都没有认证，所以只把它 发布给你信任的调用方（见两种运行模式）。

需要定制构建（额外的 pack、固定的 agent/browser 版本组合、未发布的二进制）？见 Docker 镜像 → 自行构建。

更喜欢用 Compose？请看 Docker Compose —— 它将同样的运行方式连同所有加固参数一起预置好了。

镜像里有什么

两种运行模式——按信任级别选择

无头模式的安全性取决于容器粒度，因为容器即沙箱——本产品并不自建沙箱。shell / 文件工具运行在守护进程内，因此边界就是容器本身，再加上它的网络出口策略以及不挂载宿主 凭据。

为何粒度很重要。 由于 bash / run_command 在守护进程内执行，一个长驻容器若服务 多个不可信任务，就会重新打开跨任务污染的风险（一个任务可能留下状态影响下一个）。 对于不可信负载，请为每个任务分配独立的一次性容器。

硬边界由应用之外设定：

• 网络出口策略 —— 白名单只放行 LLM API 与你的任务域名（出口代理，或有防火墙的网络 / k8s NetworkPolicy）。
• 不挂载宿主凭据 —— 只挂载 /work（结果）和只读的 base-profiles。最好通过前置代理注入 API 密钥，使被提示注入的 agent 无法从环境变量读取它。
• 谁能访问这些端口。 任务 API、OpenAI / Anthropic 端点与 /mcp 都没有认证；A2A 有可选的 Bearer 令牌；只有管理 API 强制要求令牌。请把网络可达性当作访问控制。

进程内的防护（每任务工具白名单、文件沙箱、SENSITIVE_PATHS、域名校验）是纵深防御的 层，而非边界。

一次性路径的现状——截至 v0.3.16 仍未接通。 随附的部署资产包含 oneshot Compose 服务与 run --task … 一次性形式，但该 CLI 子命令尚未接入 agent 二进制（已对 v0.3.16 重新核实）——目前只有 --daemon --headless 服务模式生效。在其落地之前，可通过 为每个任务运行一个全新的服务容器（启动、提交一个任务、销毁容器）来获得真正的按任务 隔离，或对可信的顺序流程使用带 end_session 的会话模式。 详见 Compose 页面。

Kubernetes

对于规模化的不可信负载，请每个任务一个 Job：restartPolicy: Never、 activeDeadlineSeconds = 你的挂钟上限、securityContext 设置 runAsNonRoot / readOnlyRootFilesystem / seccompProfile: RuntimeDefault / drop: ["ALL"]、/work 与数据目录用 emptyDir、出口用 NetworkPolicy、base-profiles 作为只读卷。并发与预热容量由平台负责——本产品每个任务只运行一个浏览器。