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