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