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），僅供參考 DeerFlow 部署指南：3 條路徑從本地跑通到上生產
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），僅供參考