DeerFlow 长时程智能体：从终端模式到 Docker Compose 生产部署的完整路径

DeerFlow 长时程智能体从终端模式到 Docker Compose 生产部署的完整路径【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flowDeerFlow 是开源的长时程智能体执行框架把沙箱代码执行、持久记忆、技能与子代理拼成一体处理从几分钟到几小时的复杂任务。本文覆盖它的四条部署路径终端 TUI、本地热重载开发、Docker Compose 生产编排、多 worker 横向扩展。场景速查先定位你的部署形态你的情况推荐方案预计耗时只想验证模型和沙箱是否工作TUI 终端模式10 分钟要改前后端代码、需要热重载make dev本地开发20 分钟团队共享、长期在线服务make upDocker 生产30 分钟多 worker 横向扩展生产 Postgres Redis 流桥半天沙箱要上 K8sprovisioner 模式另见 docker/provisioner/README.md看集群TUI 终端模式不装容器先跑通模型适用你刚拿到 API key想先确认模型、技能、记忆这条链路是通的再决定上哪种部署形态。TUI 走内嵌的DeerFlowClient不起 Gateway、前端、nginx也不依赖 Docker。前置条件版本说明Python3.12核心运行时uv0.6.15包管理模型 API key—.env中配置uv pip install deerflow-harness[tui] make setup # 交互式向导选模型、搜索、沙箱偏好约 2 分钟 deerflow --print 用一句话介绍你自己预期 stdout 打印模型回复文本即代表链路打通。注意TUI 里开的会话会写共享的threads_meta同一台机器上 Web UI 侧边栏也会看到。本地开发make dev 热重载三件套适用你要给后端加 middleware、给前端加页面需要改完即生效。一条命令拉起 Gateway、Next.js 前端和 nginx内部端口固定 8001 / 3000 / 2026统一入口 http://localhost:2026 。前置条件版本说明Node.js22前端构建pnpm / uv / nginx—make check自动校验config.yaml—make setup已生成make install make doctor # 校验配置与系统要求有问题会给出可执行的修复建议 make dev curl -s http://127.0.0.1:8001/health # HTTP 200 即 Gateway 就绪⚠️ 常见陷阱不要用裸uvicorn --reload起 Gateway。Agent 运行时会持续往.deer-flow/写运行时文件如果这个目录在 reload 监听范围内Uvicorn 会在你正在跑的 run 中途把 Gateway 重启掉。make dev已经预建并排除了该目录永远走它。Docker Compose 生产编排make up 一键起四个容器适用给团队用、机器要长期开着。make up本地构建镜像并启动 nginx、frontend、gateway、redis 四个容器入口端口 2026可经PORT覆盖脚本会等 Gateway/health返回 200 才报成功失败时退出码非零并打印容器状态和最近日志。前置条件版本说明Docker Composev2.24老客户端解析不了开发编排里的可选env_file语法BETTER_AUTH_SECRET—前端会话安全必需config.yaml / extensions_config.json—容器内分别以只读/可写挂载make up curl -s http://127.0.0.1:2026/api/health # 返回 {status:ok}⚠️ 常见陷阱入口默认只绑127.0.0.1这是刻意设计——Agent 能执行命令、读写文件默认只信任本机。要对外发布BIND_HOST0.0.0.0之前必须先通过/setup建好管理员账号再挂上 TLS 认证前置或 IP 白名单顺序反了等于裸奔。DEER_FLOW_INTERNAL_AUTH_TOKEN由make up自动生成并持久化手工拉多 worker 时才需要自己填。请求路径如下完整服务定义见 docker/docker-compose.yaml改挂载或端口时对着它改别手抄。横向扩展多 worker 的四个硬前提默认GATEWAY_WORKERS1。RunManager 和 StreamBridge 单例、run 状态都活在这个 worker 进程内存里负载均衡器直接挂上去会丢 run。扩到多 worker 必须同时满足四条配置要求作用database.backendpostgrescheckpointer、Store、应用数据共享stream_bridge.typeredis跨 worker 的 SSE 投递与Last-Event-ID重放run_ownership.heartbeat_enabledtrue租约续期、死 worker 接管与孤儿恢复run_events.backenddb内存/JSONL 事件库无法跨进程保证单例投递回执满足后再调GATEWAY_WORKERS并在外层代理剥离客户端伪造的X-Forwarded-*头。生产加固清单入口保持127.0.0.1默认必须对外时先走/setup建管理员再开BIND_HOST TLS/认证前置 IP 白名单GATEWAY_ENABLE_DOCSfalse关闭 Swagger/ReDoc/OpenAPI开 LangSmith 或 Langfuse 追踪LLM 调用、Agent run、工具执行全量进面板开启token_budget并设max_tokens防单次 run 成本失控持久化部署前把DEER_FLOW_HOME纳入备份记忆 v1→v2 存储迁移单向不可回退升级前先快照多 workerPostgres Redis 流桥 租用心跳 run_events.backend: db四件套齐了再动GATEWAY_WORKERS多 worker 时确认DEER_FLOW_INTERNAL_AUTH_TOKEN已在各 worker 间共享装完之后的第一件事进/setup建管理员账号发一条会落文件的任务比如让它读你上传的 CSV 出张图用它一次性验证模型、沙箱、产物面板三条链路。【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考