DeerFlow 部署指南3 條路徑從本地跑通到上生產(chǎn)【免費下載鏈接】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能連續(xù)干幾分鐘到幾小時的活——研究、寫代碼、出報告全程在沙箱里執(zhí)行。按給誰用選路就夠了自己先體驗走本地開發(fā)給團隊共享走單機容器化要對外提供服務走云端托管。一句話結(jié)論三條路共用同一套config.yaml與.env從本地切到生產(chǎn)不用重寫配置。上面就是你部署成功后打開的界面。下面把三條路徑逐一拆開。三問選型本地體驗、單機容器化還是云端托管動手前先對號入座這張表幫你 30 秒定路徑部署路徑門檻硬件起點適合誰本地開發(fā)會終端命令即可4 vCPU / 8 GB 內(nèi)存自己試用、二次開發(fā)單機容器化會用 Docker Compose4 vCPU / 8 GB生產(chǎn)建議 8 vCPU / 16 GB團隊共享一臺 Linux 服務器云端 FaaS 托管需要云賬號與鏡像倉庫平臺按量付費對外提供訪問、不想養(yǎng)機器注意2 vCPU / 4 GB 基本不夠跑內(nèi)存吃緊時先降低并發(fā)任務數(shù)再考慮升配。路徑一10 分鐘本地部署跑通第一個研究任務檢查環(huán)境與克隆倉庫本地模式把后端、前端、nginx 都起在你機器上所以先確認 Node 22、pnpm、uv 是否就位——make check會替你查清并點名缺失項。git clone https://gitcode.com/GitHub_Trending/de/deer-flow cd deer-flow make check最小配置一個向?qū)Ц愣Ｐ团c密鑰DeerFlow 跑起來的前提是它能調(diào)通一個 LLM。別手改配置文件make setup會引導你選模型提供商、填搜索 API Key自動生成config.yaml并把密鑰寫進.env全程約 2 分鐘。make setup啟動與驗證因為make dev自帶熱重載改代碼立即生效最適合驗證環(huán)境。make dev打開http://localhost:2026發(fā)一條消息等它開始搜索、寫文件、回消息就說明整條鏈路通了。之后隨時可以跑make doctor它會列出配置問題并給出可執(zhí)行的修復提示本地模式不需要公網(wǎng) IPIM 通道也全部走長連接出網(wǎng)。路徑二單機 Docker 部署一次構(gòu)建處處一致為什么選容器化團隊場景下最大的麻煩是我這邊能跑。Docker 把 Python、Node、nginx、redis 全部封進鏡像鏡像內(nèi)依賴在構(gòu)建期裝好容器啟動時不再聯(lián)網(wǎng)裝包環(huán)境差異被徹底消除。架構(gòu)nginx 是唯一入口容器棧里 nginx 對外只暴露 2026 端口并默認只綁定 127.0.0.1 回環(huán)地址——這是刻意的安全設計Gateway 的 8001 端口永遠留在容器內(nèi)部。生產(chǎn)模式一鍵啟動先執(zhí)行make setup準備好config.yaml與.env和路徑一相同然后一條命令完成構(gòu)建與啟動make up會等到 Gateway 的/health通過才宣布成功失敗時直接打印容器狀態(tài)和最近日志省掉你翻日志的時間。make up make down鏡像構(gòu)建或啟動卡住時用docker compose logs看哪個服務在報錯需要進容器現(xiàn)場排查時用docker compose exec打開對應服務的 shell。資源與日志管理給 gateway 容器設 CPU / 內(nèi)存上限防止一個長研究任務占滿宿主機。把.env與config.yaml掛載為只讀卷改配置用docker compose重新掛載不進容器手改。redis 數(shù)據(jù)落持久卷會話與隊列狀態(tài)重啟不丟。用docker stats盯資源水位日志按服務名分開看docker compose logs gateway。路徑三火山引擎 FaaS 云端托管把入口交給平臺FaaS 托管的邏輯只有一句平臺負責公網(wǎng)入口、彈性伸縮和計費你只交付一個能在 2026 端口提供服務的鏡像。關鍵環(huán)境變量變量說明示例必填模型提供商 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 終結(jié)和防火墻在平臺側(cè)配好完成首次初始化設置之前不要暴露公網(wǎng)。托管流程本地執(zhí)行make up確認/health通過、界面可用——以本地驗證過的鏡像為準別在平臺上盲調(diào)。把鏡像推送到火山引擎的容器鏡像服務。在 FaaS 平臺創(chuàng)建容器型應用監(jiān)聽 2026 端口填入上表環(huán)境變量設置 CPU / 內(nèi)存配額與冷啟動預熱。保存后拿到訪問域名瀏覽器驗證登錄與研究任務各走一遍。平臺原理網(wǎng)關、CDN、彈性策略不需要你關心鏡像與環(huán)境變量對了服務就通了。上生產(chǎn)前安全、監(jiān)控、備份、高可用加固清單安全入口只暴露 2026 一個端口Gateway 8001 保持內(nèi)網(wǎng)。TLS 終結(jié)放在 DeerFlow 之前平臺或反向代理應用層不直接收公網(wǎng)明文。密鑰只放.env不進鏡像、不進 git生產(chǎn)用 Docker 沙箱隔離代碼執(zhí)行本地直跑沙箱僅限開發(fā)。公網(wǎng)入口先完成用戶初始化再開BIND_HOST0.0.0.0。監(jiān)控在.env里開啟 LangSmith 或 Langfuse tracing記錄每次 LLM 調(diào)用、工具執(zhí)行與 token 消耗。盯四個指標API P95 響應時間、模型調(diào)用成功率、內(nèi)存與 CPU 水位、并發(fā)任務數(shù)?；A手段docker stats 分服務docker compose logs請求級排障可開啟 Gateway 的 trace 關聯(lián)響應頭帶X-Trace-Id串聯(lián)日志與 tracing。備份持久化部署把database.backend配成 sqlite 或 postgres定期備份數(shù)據(jù)庫文件。config.yaml、.env、extensions_config.json納入配置備份保留歷史版本配置事故可快速回滾。高可用生產(chǎn)默認單 Gateway worker需要多副本時按官方要求上 Postgres Redis stream bridge 心跳租約讓任務與事件流可跨 worker 恢復。多副本前確認沙箱所有權(quán)也走 redis 協(xié)調(diào)避免互刪對端沙箱。排錯速查現(xiàn)象、原因、解法現(xiàn)象常見原因解法make check或依賴安裝失敗Node / pnpm / uv 缺失或版本不達標按提示補齊工具uv 裝不上就uv clean后重裝重試端口 2026 被占用本機已有服務占用用PORT環(huán)境變量改發(fā)布端口或在.env中指定啟動報密鑰缺失.env未填模型或搜索 Key重新跑make setup或?qū)φ?config.example.yaml 手工補全Linux 上 Docker 報 permission denied當前用戶無 docker 組權(quán)限將用戶加入 docker 組后重新登錄鏡像構(gòu)建 / 拉取很慢網(wǎng)絡到上游倉庫慢構(gòu)建前導出UV_INDEX_URL、NPM_REGISTRY指向可用鏡像源Gateway 起不來make up非零退出模型配置錯、密鑰無效看它打印的 Gateway 日志逐條核對config.yaml與.env界面能開但發(fā)消息無響應nginx 未把流量正確轉(zhuǎn)給 Gateway查 gateway 日志里的 4xx/5xx確認/api/*路由正常按你的角色下一步各一句話自己先試現(xiàn)在執(zhí)行make setup加make dev跑通一個研究任務再談別的。團隊共享按路徑二make up起容器然后逐條過一遍加固清單再開放訪問。云端托管先本地驗證/health再推鏡像到火山引擎 FaaS只改BIND_HOST和密鑰別在平臺上盲調(diào)。完整的部署細節(jié)與高級配置沙箱模式、MCP、IM 通道、tracing以倉庫內(nèi)的 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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考