文章目錄DeerFlow Docker Desktop 部署教程1 準(zhǔn)備2 下載官方倉庫3 把兩個示例配置改名關(guān)鍵步驟4 編輯 config.yaml 填模型5 創(chuàng)建 .env 環(huán)境變量文件6 用 Docker Desktop 啟動7 驗(yàn)證DeerFlow Docker Desktop 部署教程核心思路下載官方倉庫 → 把兩個示例配置改名成正式配置并填上模型 → 寫.env→ 用 Docker Compose 啟動。1 準(zhǔn)備安裝并啟動Docker Desktop自帶 Docker Compose v2macOS / Windows 均可。準(zhǔn)備一個 LLM 的 API KeyOpenAI / 火山方舟豆包 / GLM / DeepSeek / Claude 等均可。2 下載官方倉庫方式 A推薦能隨時更新git clone https://github.com/bytedance/deer-flow.git cd deer-flow方式 B免裝 git在 GitHub 頁面https://github.com/bytedance/deer-flow點(diǎn)綠色Code → Download ZIP解壓后進(jìn)入deer-flow目錄。3 把兩個示例配置改名關(guān)鍵步驟倉庫根目錄下有config.example.yaml和extensions_config.example.json兩個示例文件需要復(fù)制并改名為正式配置文件名示例文件改名為config.example.yamlconfig.yamlextensions_config.example.jsonextensions_config.json在倉庫根目錄執(zhí)行macOS/Linux 或 Windows 的 Git Bash / WSLcp config.example.yaml config.yaml cp extensions_config.example.json extensions_config.jsonWindows 直接用資源管理器選中文件復(fù)制 → 粘貼再改名去掉.example即可。config.yaml后端主配置模型、沙箱、工具、內(nèi)存等DeerFlow 默認(rèn)從倉庫根目錄讀取它。extensions_config.jsonMCP 服務(wù)器和技能的啟用狀態(tài)獨(dú)立于config.yaml默認(rèn)位置是倉庫根目錄。復(fù)制過去即可用里面所有 MCP 服務(wù)器默認(rèn)enabled: false不啟用也無妨。4 編輯config.yaml填模型打開config.yaml找到models:段取消注釋去掉#并按需修改一個模型條目。示例OpenAImodels: - name: gpt-4 display_name: GPT-4 use: langchain_openai:ChatOpenAI model: gpt-4 api_key: $OPENAI_API_KEY換成國內(nèi)可用的話示例文件里也內(nèi)置了豆包Volcengine、GLM、DeepSeek、Kimi 等模板挑一個填上你的 API Key 即可。5 創(chuàng)建.env環(huán)境變量文件在倉庫根目錄新建.env和config.yaml同級寫入OPENAI_API_KEYsk-你的key DEER_FLOW_ROOT你的deer-flow絕對路徑 BETTER_AUTH_SECRETopenssl rand -base64 32 生成的強(qiáng)隨機(jī)串 BETTER_AUTH_URLhttp://localhost:2026DEER_FLOW_ROOT必須填倉庫的絕對路徑數(shù)據(jù)會掛載到這里。Windows 下填如C:\Users\你\deer-flowmacOS 填如/Users/你/deer-flow。BETTER_AUTH_SECRET至少 32 字符可用命令openssl rand -base64 32生成。compose 文件會通過env_file: ../.env自動加載它。6 用 Docker Desktop 啟動在deer-flow目錄打開終端Windows 用 PowerShell/CMDmacOS 用 Terminal執(zhí)行export DEER_FLOW_ROOT你的deer-flow絕對路徑 docker compose -f docker/docker-compose-dev.yaml up --build首次會自動構(gòu)建并啟動nginx / 前端 /gateway含 Agent 運(yùn)行時等服務(wù)。之后想放后臺運(yùn)行用-d代替--builddocker compose -f docker/docker-compose-dev.yaml up -d。啟動后打開Docker Desktop在左側(cè) Containers 里能看到deer-flow的容器在運(yùn)行。7 驗(yàn)證瀏覽器訪問http://localhost:2026開始使用?；蝌?yàn)證 APIcurl http://localhost:2026/api/models返回你的模型列表即部署成功。