DeerFlow 部署实战3 条路径从 10 分钟本地跑通到生产上线【免费下载链接】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 是一个开源的长程 SuperAgent 框架agent 可以在沙箱里做研究、写代码、产出交付物。把它跑起来常是上手的第一道坎——这篇文章按你怎么用整理了三种最常见的 DeerFlow 部署路径帮你 30 秒内选对路线。先搞清楚你要什么三条路径共用同一套配置config.yaml模型、沙箱、搜索等运行行为和.envAPI key 等密钥。区别只在于服务跑在哪、给谁用。你的场景推荐路径预计耗时需要的前置条件自己尝鲜、本机跑通核心功能路径一本地开发模式10–20 分钟Python 3.12make install会装其余依赖团队内网共用、环境要稳定可复现路径二Docker Compose15–30 分钟首次构建偏久Docker Compose v22.24对外提供服务、要上服务器或集群路径三服务器 / K8s半天到一天一台 Docker 服务器或 K8s 集群一个简单判断法只给你自己用选路径一给几个同事在内网用选路径二要暴露公网、有多机扩展需求选路径三。不确定就先走路径一跑通之后换另外两条只是启动方式的变化配置完全复用。路径一个人体验路径用 make dev 在本地跑通全部你要做什么克隆仓库、装依赖、生成配置然后一条命令把整套服务拉起来。不用自己分别启动各个服务项目把 Gateway、前端、nginx 打包进了一个统一启动脚本。怎么做git clone https://gitcode.com/GitHub_Trending/de/deer-flow cd deer-flow make install # 一次性装好前端与后端依赖 make setup # 交互式向导顺带把模型 API key 填进去 make dev # 启动 Gateway(8001) 前端(3000) nginx(2026)make setup是个向导按提示选模型提供商、填 API key它会替你写好config.yaml。如果你更习惯手动也可以参考 config.example.yaml 自行编辑。怎么确认成功了curl http://localhost:8001/health返回 200 后打开浏览器访问 http://localhost:2026。2026 是 nginx 提供的统一入口——把 nginx 理解成门卫所有请求先经过它页面类转发给前端/api/*类转发给 Gateway。你在界面里发一条消息看到 agent 开始检索、写文件说明链路已经全通不想开浏览器也可以用终端模式TUI安装后直接运行deerflow会话和 Web UI 共享两边都能看到彼此的对话。停服只需要一条make stop它会清掉 8001/3000/2026 上的服务进程。路径二团队内网路径Docker Compose 是最省事的内网部署如果你不熟悉 Docker Compose它就是用一个文件声明一批容器、一次性启动的方式团队每个人跑出来的环境一模一样谁也不用在各自机器上手动装 Python 和 Node。你要做什么装好 Docker准备好两个配置文件然后一条命令构建并启动。怎么做cp config.example.yaml config.yaml # 填模型 key、搜索 key 等 make up # 构建镜像 启动全部容器make up背后是 docker/docker-compose.yaml一次拉起 nginx2026 统一入口、frontendNext.js、gatewayFastAPI agent 运行时、redis跨 worker 的 SSE 流桥接K8s 沙箱模式下还会带一个 provisioner。Gateway 带内置健康检查nginx 会等它就绪后才放行流量所以第一次启动等得久一点是正常的。怎么确认成功了docker compose -f docker/docker-compose.yaml ps curl http://localhost:2026/api/models第一条命令里各服务应显示 runninggateway 是 healthy第二条能返回模型列表就可以把 http://服务器地址:2026 分享给同事了。两个容易踩的小地方前端会话安全要求.env里设置BETTER_AUTH_SECRET别留空运行时数据对话、记忆、上传文件都落在DEER_FLOW_HOME目录默认backend/.deer-flowcompose 里已经挂载重建容器数据不会丢。路径三对外服务路径服务器或 FaaS 上的正确暴露方式先理解默认的安全姿态入口端口默认只绑定127.0.0.1也就是只有本机可访问。这是刻意设计——DeerFlow 的 agent 能在沙箱里执行命令所以项目默认把自己当成受信任的本地环境。对外暴露必须由你主动做对而不是顺手改出来。你要做什么三步——放开端口绑定、把服务放到你自己的认证与加密门面后面、完成首次运行配置后再开门。怎么做先在.env里把绑定地址改成可对外让端口真正可达BIND_HOST0.0.0.0 PORT2026然后不要把 2026 直接暴露公网而是放在一个带 TLS 终止和认证的门前反向代理或 WAF 都行只放行的请求才到 DeerFlow。顺序不能反先在本机把首次运行配置管理员初始化、模型配置确认做完再开放入口。如果你用的是火山引擎 FaaS 这类平台项目自带 Kubernetes 模式沙箱侧以 all-in-one-sandbox 容器跑在 FaaS 上provisioner 负责向集群申请沙箱有标准 K8s 集群的话直接用deploy/helm/deer-flow的 Helm chart 部署具体环境变量对照 backend/docs/CONFIGURATION.md 逐项填。怎么确认成功了在另一台机器上curl https://你的域名/能看到页面curl https://你的域名/api/models能看到模型列表。哪一步不通就先查门面代理、认证是否放行再查服务本身。让服务跑起来之后跑通之后关心点从怎么启动变成坏了怎么办。下面几项是出现频率最高的。 接口没响应去哪找问题先看日志位置取决于你走的路径本地模式下在logs/目录里分gateway.log、frontend.log、nginx.log三个文件Docker 模式直接用内置命令make docker-logs # 看全部服务 make docker-logs --gateway # 只看 Gateway排查顺序建议固定先curl http://localhost:8001/health判断 Gateway 是否活着——不活就看 gateway 日志活着但页面 502多半是代理层看 nginx 日志。大多数没响应这两步就能定位。️ 服务要对外时最容易出事的三个设置按优先级排第一别把宿主 Docker socket 挂进容器——只有显式选择 aio 沙箱模式时脚本才会挂载它等于把宿主机的 root 交给了容器项目文档里有专门的安全说明第二.env不要提交进仓库里面的 key 是真实密钥第三Gateway 默认单 worker 是有原因的运行态在 worker 内存里想加 worker 提吞吐之前先确认 Redis 流桥接已启用并接受取消、去重等能力仍是 worker 本地的这个边界。 要备份什么两个目录加两个文件运行时目录DEER_FLOW_HOME对话历史、记忆、上传文件、生成物都在这里和config.yaml、.env。前者是数据后两者是身份。Docker 部署只要卷挂载正确容器随时可以删掉重建。⚡ 常见卡点速查你看到的现象大概率原因一条命令解决make dev直接报 No DeerFlow config file foundconfig.yaml还没生成make setup启动时报端口已被占用3000/8001/2026另一个 DeerFlow 实例还开着make stopcurl localhost:8001/health无响应Gateway 没起来多半是依赖或配置报错重跑make dev看终端最后的错误信息容器启动报找不到 env 文件Docker 模式缺.envcp .env.example .env模型调用返回 401key 没写进.env或配置里没引用环境变量检查api_key: $XXX_API_KEY与.env对应项Compose 解析 env_file 就报错客户端版本低于 2.24升级 Docker Desktop 或 Compose 插件沙箱第一次启动明显慢沙箱镜像没预拉取make setup-sandbox另有一类agent 行为异常研究中断、文件没写出来通常不是部署问题先查config.yaml里模型和沙箱模式的配置别急着重启服务。下一步建议如果 Web UI 已满足你的需求停在这里就够了想继续扩展 MCP 工具或接入飞书、Slack去仓库的backend/docs/MCP_SERVER.md和backend/docs/IM_CHANNEL_CONNECTIONS.md看对应文档。【免费下载链接】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），仅供参考