DeerFlow 部署指南3 条路径从本地跑通到上生产【免费下载链接】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 部署这件事先回答两个问题你准备把它跑在哪里又打算给谁用。DeerFlow 是一个开源长时程 SuperAgent能连续干几分钟到几小时的活——研究、写代码、出报告全程在沙箱里执行。按给谁用选路就够了自己先体验走本地开发给团队共享走单机容器化要对外提供服务走云端托管。一句话结论三条路共用同一套config.yaml与.env从本地切到生产不用重写配置。上面就是你部署成功后打开的界面。下面把三条路径逐一拆开。三问选型本地体验、单机容器化还是云端托管动手前先对号入座这张表帮你 30 秒定路径部署路径门槛硬件起点适合谁本地开发会终端命令即可4 vCPU / 8 GB 内存自己试用、二次开发单机容器化会用 Docker Compose4 vCPU / 8 GB生产建议 8 vCPU / 16 GB团队共享一台 Linux 服务器云端 FaaS 托管需要云账号与镜像仓库平台按量付费对外提供访问、不想养机器注意2 vCPU / 4 GB 基本不够跑内存吃紧时先降低并发任务数再考虑升配。路径一10 分钟本地部署跑通第一个研究任务检查环境与克隆仓库本地模式把后端、前端、nginx 都起在你机器上所以先确认 Node 22、pnpm、uv 是否就位——make check会替你查清并点名缺失项。git clone https://gitcode.com/GitHub_Trending/de/deer-flow cd deer-flow make check最小配置一个向导搞定模型与密钥DeerFlow 跑起来的前提是它能调通一个 LLM。别手改配置文件make setup会引导你选模型提供商、填搜索 API Key自动生成config.yaml并把密钥写进.env全程约 2 分钟。make setup启动与验证因为make dev自带热重载改代码立即生效最适合验证环境。make dev打开http://localhost:2026发一条消息等它开始搜索、写文件、回消息就说明整条链路通了。之后随时可以跑make doctor它会列出配置问题并给出可执行的修复提示本地模式不需要公网 IPIM 通道也全部走长连接出网。路径二单机 Docker 部署一次构建处处一致为什么选容器化团队场景下最大的麻烦是我这边能跑。Docker 把 Python、Node、nginx、redis 全部封进镜像镜像内依赖在构建期装好容器启动时不再联网装包环境差异被彻底消除。架构nginx 是唯一入口容器栈里 nginx 对外只暴露 2026 端口并默认只绑定 127.0.0.1 回环地址——这是刻意的安全设计Gateway 的 8001 端口永远留在容器内部。生产模式一键启动先执行make setup准备好config.yaml与.env和路径一相同然后一条命令完成构建与启动make up会等到 Gateway 的/health通过才宣布成功失败时直接打印容器状态和最近日志省掉你翻日志的时间。make up make down镜像构建或启动卡住时用docker compose logs看哪个服务在报错需要进容器现场排查时用docker compose exec打开对应服务的 shell。资源与日志管理给 gateway 容器设 CPU / 内存上限防止一个长研究任务占满宿主机。把.env与config.yaml挂载为只读卷改配置用docker compose重新挂载不进容器手改。redis 数据落持久卷会话与队列状态重启不丢。用docker stats盯资源水位日志按服务名分开看docker compose logs gateway。路径三火山引擎 FaaS 云端托管把入口交给平台FaaS 托管的逻辑只有一句平台负责公网入口、弹性伸缩和计费你只交付一个能在 2026 端口提供服务的镜像。关键环境变量变量说明示例必填模型提供商 Key如 DEEPSEEK_API_KEY / OPENAI_API_KEYsk-xxx是TAVILY_API_KEY搜索 APItvly-xxx是BIND_HOST容器对外绑定地址0.0.0.0是云端必填PORTnginx 对外端口2026否默认值GATEWAY_CORS_ORIGINS跨域来源白名单https://faas-domain.com否BIND_HOST默认是 127.0.0.1只在本机有效放到云端必须显式改为 0.0.0.0让 nginx 真正对外同时确保你的 TLS 终结和防火墙在平台侧配好完成首次初始化设置之前不要暴露公网。托管流程本地执行make up确认/health通过、界面可用——以本地验证过的镜像为准别在平台上盲调。把镜像推送到火山引擎的容器镜像服务。在 FaaS 平台创建容器型应用监听 2026 端口填入上表环境变量设置 CPU / 内存配额与冷启动预热。保存后拿到访问域名浏览器验证登录与研究任务各走一遍。平台原理网关、CDN、弹性策略不需要你关心镜像与环境变量对了服务就通了。上生产前安全、监控、备份、高可用加固清单安全入口只暴露 2026 一个端口Gateway 8001 保持内网。TLS 终结放在 DeerFlow 之前平台或反向代理应用层不直接收公网明文。密钥只放.env不进镜像、不进 git生产用 Docker 沙箱隔离代码执行本地直跑沙箱仅限开发。公网入口先完成用户初始化再开BIND_HOST0.0.0.0。监控在.env里开启 LangSmith 或 Langfuse tracing记录每次 LLM 调用、工具执行与 token 消耗。盯四个指标API P95 响应时间、模型调用成功率、内存与 CPU 水位、并发任务数。基础手段docker stats 分服务docker compose logs请求级排障可开启 Gateway 的 trace 关联响应头带X-Trace-Id串联日志与 tracing。备份持久化部署把database.backend配成 sqlite 或 postgres定期备份数据库文件。config.yaml、.env、extensions_config.json纳入配置备份保留历史版本配置事故可快速回滚。高可用生产默认单 Gateway worker需要多副本时按官方要求上 Postgres Redis stream bridge 心跳租约让任务与事件流可跨 worker 恢复。多副本前确认沙箱所有权也走 redis 协调避免互删对端沙箱。排错速查现象、原因、解法现象常见原因解法make check或依赖安装失败Node / pnpm / uv 缺失或版本不达标按提示补齐工具uv 装不上就uv clean后重装重试端口 2026 被占用本机已有服务占用用PORT环境变量改发布端口或在.env中指定启动报密钥缺失.env未填模型或搜索 Key重新跑make setup或对照 config.example.yaml 手工补全Linux 上 Docker 报 permission denied当前用户无 docker 组权限将用户加入 docker 组后重新登录镜像构建 / 拉取很慢网络到上游仓库慢构建前导出UV_INDEX_URL、NPM_REGISTRY指向可用镜像源Gateway 起不来make up非零退出模型配置错、密钥无效看它打印的 Gateway 日志逐条核对config.yaml与.env界面能开但发消息无响应nginx 未把流量正确转给 Gateway查 gateway 日志里的 4xx/5xx确认/api/*路由正常按你的角色下一步各一句话自己先试现在执行make setup加make dev跑通一个研究任务再谈别的。团队共享按路径二make up起容器然后逐条过一遍加固清单再开放访问。云端托管先本地验证/health再推镜像到火山引擎 FaaS只改BIND_HOST和密钥别在平台上盲调。完整的部署细节与高级配置沙箱模式、MCP、IM 通道、tracing以仓库内的 docs/ 与 backend/docs/ 为准。【免费下载链接】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），仅供参考