今天有空尝试了下最近很火来自字节开源的 DeerFlow这框架在 Linux 下安装会顺利很多只是公司开发电脑是 Windows 11 版本的所以本地安装折腾了一番功夫才安装上中间放弃了 2 次不想装了做其他事去了做完后无聊又再次尝试终于成功特此记录分享给需要的朋友。DeerFlow 有两种安装方式一种是基于本地的 Docker 一种是直接纯本地纯本地的方式对环节要求更严格需要Node.js 22、pnpm、uv、nginx我本机除了 nginx 没有其他都有但不想为它单独再装一个 nginx所以直接用 Docker 的方式而官方也更推荐用 Docker 的方式对于开发也支持热更新挂载源码后端进程在下一次配置访问时会自动获取变更因此模型元数据更新在开发过程中无需手动重启。坑1make config 失败make config 失败提示make:*** [config]错误 9009原因是电脑没有安装 Python 安装 Python 或者在 Anaconda 等虚拟环境中有 Python 依赖的情况下执行即可成功。坑2make init 失败make init 失败提示process_begin: CreateProcess(NULL, env bash D:\Projects\ai\deer-flow\scripts\docker.sh init, ...) failed. make (e2): 系统找不到指定的文件。 make: *** [docker-init] 错误 2原因是需要在 Git Bash 终端里执行才可以。此原因在官方文档中有特别说明在 Windows 上请使用 Git Bash 运行本地开发流程。基于 bash 的服务脚本不支持直接在原生 cmd.exe 或 PowerShell 中执行且 WSL 也不保证可用因为部分脚本依赖 Git for Windows 的 cygpath 等工具。安装前准备因此基于以上 2 个坑安装前先确认电脑是否满足以下1.安装好 Docker2.安装好 Git3.安装好 Node.js 224.安装好 Python 或者 Anaconda 虚拟环境5.安装好 make 命令支持可以通过 GnuWin32 安装Make for Windows克隆 DeerFlow 仓库在你计划要安装的目录里点击鼠标右键选择 Git Bash Here通过 Git Bash 进入当前目录然后执行以下命令git clone https://github.com/bytedance/deer-flow.git cd deer-flow创建激活虚拟环境因为我本机没装 Python 都是基于 Anaconda 的虚拟环境开发的所以此步要先创建并激活conda create -n deer-flow python3.12 -y conda activate deer-flow生成本地配置文件在项目根目录deer-flow/执行make config这个命令会基于示例模板生成本地配置文件。初始化配置1.编辑 config.yaml至少定义一个模型models: - name: gpt-4 # 内部标识 display_name: GPT-4 # 展示名称 use: langchain_openai:ChatOpenAI # LangChain 类路径 model: gpt-4 # API 使用的模型标识 api_key: $OPENAI_API_KEY # API key推荐使用环境变量 max_tokens: 4096 # 单次请求最大 tokens temperature: 0.7 # 采样温度 - name: openrouter-gemini-2.5-flash display_name: Gemini 2.5 Flash (OpenRouter) use: langchain_openai:ChatOpenAI model: google/gemini-2.5-flash-preview api_key: $OPENAI_API_KEY # 这里 OpenRouter 依然沿用 OpenAI 兼容字段名 base_url: https://openrouter.ai/api/v1OpenRouter 以及类似的 OpenAI 兼容网关建议通过 langchain_openai:ChatOpenAI 配合 base_url 来配置。如果你更想用 provider 自己的环境变量名也可以直接把 api_key 指向对应变量例如 api_key: $OPENROUTER_API_KEY。2.为已配置的模型设置 API key编辑项目根目录下的 .env 文件推荐TAVILY_API_KEYyour-tavily-api-key OPENAI_API_KEYyour-openai-api-key # 如果配置使用的是 langchain_openai:ChatOpenAI base_urlOpenRouter 也会读取 OPENAI_API_KEY # 其他 provider 的 key 按需补充 INFOQUEST_API_KEYyour-infoquest-api-key启动安装拉取 sandbox 镜像首次运行或镜像更新时执行make docker-init启动服务会根据 config.yaml 自动判断 sandbox 模式过程中会下载安装依赖需要科学上网支持。make docker-start如果过程中以下类似错误是网络问题重试几次即可failed to solve: ghcr.io/astral-sh/uv:0.7.20: failed to resolve source metadata for ghcr.io/astral-sh/uv:0.7.20: failed to do request: Head https://ghcr.io/v2/astral-sh/uv/manifests/0.7.20: EOF make: *** [docker-start] Error 17耐心等待跑完就可以看到 DeerFlow Docker is starting! Application: http://localhost:2026 API Gateway: http://localhost:2026/api/* LangGraph: http://localhost:2026/api/langgraph/* View logs: make docker-logs Stop: make docker-stop这样就代表你安装成功了访问 http://localhost:2026 即可看到。安装成功进入地址后默认是一个欢迎页面点击中间的 “Get Started with 2.0” 就进入了 DeerFlow Web 交互界面。