DeerFlow 部署指南从 5 分钟终端到生产环境的 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 是一个开源的长时程智能体框架Deep Exploration and Efficient Research Flow靠子智能体、沙箱、记忆和可扩展技能把几分钟到几小时级别的研究与编码任务跑完。这篇文章的目标只有一个帮你在自己机器上把它部署起来跑通然后判断要不要继续上云。动手前 10 分钟环境准备先花 10 分钟把地基打好后面三条路全靠它。硬门槛一句话Python 3.12、Node 22外加 uv 和 pnpm 两个包管理器。组件用途是否必需Python 3.12后端运行时✅Node 22前端构建✅uv管理 Python 依赖并建虚拟环境✅pnpm管理 Node 依赖✅Docker Compose v2.24容器化部署仅 Docker 路线需要克隆下来跑一遍配置向导就完事git clone https://gitcode.com/GitHub_Trending/de/deer-flow cd deer-flow make setup # 交互式向导选模型商、搜索工具、沙箱模式 make doctor # 体检缺什么它直接告诉你三个关键配置向导会帮你填这里只说明白原理搜索工具在config.yaml的tools段启用web_search对应 API Key 写进.env比如TAVILY_API_KEY。没配也能跑只是 agent 少了联网搜索的手。模型config.yaml的models段base_url指到服务商端点api_key用$ENV_VAR引用.env里的变量。密钥永远别硬编码进配置。可选服务RAG、TTS、Langfuse 这类全是开关式的不配就禁用不会卡启动。完整的字段参考直接看 config.example.yaml配置细节见 backend/docs/CONFIGURATION.md。路径 ATUI 终端模式3 条命令跑通只想先摸核心能力的走这里——不碰 Gateway、不碰前端、不碰 nginx最轻的一条路。cd backend uv pip install deerflow-harness[tui] # 安装 TUI 依赖 cd .. deerflow # 启动终端工作台TUI 是嵌在DeerFlowClient里跑的直接吃你刚生成的config.yaml记忆、技能、沙箱配置全都复用。活没活一句话丢一句 hello 进去能流式回话、工具卡片正常滚动就算通。不想开界面也行deerflow --print ping直接在终端打印答案。路径 B本地完整开发环境前后端都拉起来改代码、联调前后端的别省这一步热重载能救你很多命。make install # 后端 前端依赖一次装齐 make dev # 一键起 gateway(8001) frontend(3000) nginx(2026)浏览器打开http://localhost:2026应该能看到登录/工作台界面后端活没活curl -s http://localhost:8001/health返回 200 就齐活。改config.yaml后模型元数据下次配置读取就生效不用手动重启。路径 CDocker 一条命令拉起前后端环境隔离、要团队统一跑法走容器。生产拓扑是 nginx frontend gateway redis端口默认只绑127.0.0.1docker/docker-compose.yaml 和 scripts/deploy.sh 里都有完整定义不用手写 YAML。make up # 构建镜像并拉起全部服务健康检查通过才返回 make down # 停掉访问http://localhost:2026。make up会等 Gateway 的/health端点通过才报成功——它自己就是存活探针起不来会直接打印容器状态和最近的 Gateway 日志。上云那条路火山引擎 FaaS 与纯 Docker 的差异FaaS 上跑镜像和配置基本照搬路径 C真正的差异在三点弹性伸缩是平台托管的不用自己配 HPA按并发实例数扩缩长任务注意配好实例数下限别让研究任务跑到一半被缩容掉。冷启动依赖必须在构建期全部打进镜像DeerFlow 的生产镜像本就不在启动时装依赖再配实例预热把首请求延迟压下去。环境变量多一层下表是 FaaS 侧特有或必须显式声明的变量作用必填NEXT_PUBLIC_API_URL前端指向网关的地址✅BETTER_AUTH_SECRET前端登录会话签名密钥✅OPENAI_API_KEY或对应模型 KeyLLM 调用✅TAVILY_API_KEY搜索工具可选多 worker 扩容时还有硬前提Postgres 后端 Redis 流桥 心跳默认单 worker 是有意为之README.md 的 IMPORTANT 段写得很清楚扩容前先读它。生产加固 checklist跑稳之前这几条过一遍️安全容器用非 root 用户跑入口默认只绑回环要对外就先上 TLS 认证设BIND_HOST0.0.0.0前/setup建好管理员账号密钥一律走.env不进配置、不进镜像。监控make up自带/health检查日志跟一条命令docker compose logs -f deer-flow-gateway。资源限制给 gateway 一个memory: 4G / cpus: 2、frontend1G / 1的起步值即可跑满了再按 README.md 的 sizing 表往上调。备份config.yaml和.env改动即入库数据库每天备份、留 7 天。排障速查现象 → 修复按出现频率排的端口被占服务起不来→.env里加PORT2027再make up本地开发模式端口固定 2026改的是对外入口。依赖装不上→cd backend uv sync --reinstall前端对应pnpm install --force。API Key 配了不生效→make doctor直接告诉你缺哪个变量重点查config.yaml里是不是真的用了$ENV_VAR引用。容器起不来→docker compose logs --tail100 deer-flow-gateway九成是配置路径或密钥问题。前端连不上后端→ 确认走localhost:2026统一入口别直连 8001跨源部署要配GATEWAY_CORS_ORIGINS。FaaS 首请求超时→ 开实例预热 调大网关超时长任务走 SSE 流式而不是同步等待。从终端 5 分钟到云端生产其实就这三条路加一层加固。建议先走路径 A 验证配置真的能跑通再按你的用途挑 B 或 C——反正跑通之后升级路径随时在make里。【免费下载链接】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），仅供参考 DeerFlow 部署指南：从 5 分钟终端到生产环境的 3 条路径
DeerFlow 部署指南从 5 分钟终端到生产环境的 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 是一个开源的长时程智能体框架Deep Exploration and Efficient Research Flow靠子智能体、沙箱、记忆和可扩展技能把几分钟到几小时级别的研究与编码任务跑完。这篇文章的目标只有一个帮你在自己机器上把它部署起来跑通然后判断要不要继续上云。动手前 10 分钟环境准备先花 10 分钟把地基打好后面三条路全靠它。硬门槛一句话Python 3.12、Node 22外加 uv 和 pnpm 两个包管理器。组件用途是否必需Python 3.12后端运行时✅Node 22前端构建✅uv管理 Python 依赖并建虚拟环境✅pnpm管理 Node 依赖✅Docker Compose v2.24容器化部署仅 Docker 路线需要克隆下来跑一遍配置向导就完事git clone https://gitcode.com/GitHub_Trending/de/deer-flow cd deer-flow make setup # 交互式向导选模型商、搜索工具、沙箱模式 make doctor # 体检缺什么它直接告诉你三个关键配置向导会帮你填这里只说明白原理搜索工具在config.yaml的tools段启用web_search对应 API Key 写进.env比如TAVILY_API_KEY。没配也能跑只是 agent 少了联网搜索的手。模型config.yaml的models段base_url指到服务商端点api_key用$ENV_VAR引用.env里的变量。密钥永远别硬编码进配置。可选服务RAG、TTS、Langfuse 这类全是开关式的不配就禁用不会卡启动。完整的字段参考直接看 config.example.yaml配置细节见 backend/docs/CONFIGURATION.md。路径 ATUI 终端模式3 条命令跑通只想先摸核心能力的走这里——不碰 Gateway、不碰前端、不碰 nginx最轻的一条路。cd backend uv pip install deerflow-harness[tui] # 安装 TUI 依赖 cd .. deerflow # 启动终端工作台TUI 是嵌在DeerFlowClient里跑的直接吃你刚生成的config.yaml记忆、技能、沙箱配置全都复用。活没活一句话丢一句 hello 进去能流式回话、工具卡片正常滚动就算通。不想开界面也行deerflow --print ping直接在终端打印答案。路径 B本地完整开发环境前后端都拉起来改代码、联调前后端的别省这一步热重载能救你很多命。make install # 后端 前端依赖一次装齐 make dev # 一键起 gateway(8001) frontend(3000) nginx(2026)浏览器打开http://localhost:2026应该能看到登录/工作台界面后端活没活curl -s http://localhost:8001/health返回 200 就齐活。改config.yaml后模型元数据下次配置读取就生效不用手动重启。路径 CDocker 一条命令拉起前后端环境隔离、要团队统一跑法走容器。生产拓扑是 nginx frontend gateway redis端口默认只绑127.0.0.1docker/docker-compose.yaml 和 scripts/deploy.sh 里都有完整定义不用手写 YAML。make up # 构建镜像并拉起全部服务健康检查通过才返回 make down # 停掉访问http://localhost:2026。make up会等 Gateway 的/health端点通过才报成功——它自己就是存活探针起不来会直接打印容器状态和最近的 Gateway 日志。上云那条路火山引擎 FaaS 与纯 Docker 的差异FaaS 上跑镜像和配置基本照搬路径 C真正的差异在三点弹性伸缩是平台托管的不用自己配 HPA按并发实例数扩缩长任务注意配好实例数下限别让研究任务跑到一半被缩容掉。冷启动依赖必须在构建期全部打进镜像DeerFlow 的生产镜像本就不在启动时装依赖再配实例预热把首请求延迟压下去。环境变量多一层下表是 FaaS 侧特有或必须显式声明的变量作用必填NEXT_PUBLIC_API_URL前端指向网关的地址✅BETTER_AUTH_SECRET前端登录会话签名密钥✅OPENAI_API_KEY或对应模型 KeyLLM 调用✅TAVILY_API_KEY搜索工具可选多 worker 扩容时还有硬前提Postgres 后端 Redis 流桥 心跳默认单 worker 是有意为之README.md 的 IMPORTANT 段写得很清楚扩容前先读它。生产加固 checklist跑稳之前这几条过一遍️安全容器用非 root 用户跑入口默认只绑回环要对外就先上 TLS 认证设BIND_HOST0.0.0.0前/setup建好管理员账号密钥一律走.env不进配置、不进镜像。监控make up自带/health检查日志跟一条命令docker compose logs -f deer-flow-gateway。资源限制给 gateway 一个memory: 4G / cpus: 2、frontend1G / 1的起步值即可跑满了再按 README.md 的 sizing 表往上调。备份config.yaml和.env改动即入库数据库每天备份、留 7 天。排障速查现象 → 修复按出现频率排的端口被占服务起不来→.env里加PORT2027再make up本地开发模式端口固定 2026改的是对外入口。依赖装不上→cd backend uv sync --reinstall前端对应pnpm install --force。API Key 配了不生效→make doctor直接告诉你缺哪个变量重点查config.yaml里是不是真的用了$ENV_VAR引用。容器起不来→docker compose logs --tail100 deer-flow-gateway九成是配置路径或密钥问题。前端连不上后端→ 确认走localhost:2026统一入口别直连 8001跨源部署要配GATEWAY_CORS_ORIGINS。FaaS 首请求超时→ 开实例预热 调大网关超时长任务走 SSE 流式而不是同步等待。从终端 5 分钟到云端生产其实就这三条路加一层加固。建议先走路径 A 验证配置真的能跑通再按你的用途挑 B 或 C——反正跑通之后升级路径随时在make里。【免费下载链接】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），仅供参考