配置

本页面涵盖 DeerFlow 应用的所有配置层——config.yaml、前端环境变量、extensions_config.json 和运行时环境变量。

config.yaml

config.yaml 是 DeerFlow 的主要配置文件。所有 Agent 行为、模型选择、工具加载和运行时功能都由它控制。

参见配置参考页面了解文件格式和每个章节的详细说明。

模型提供商

OpenAI


models:
  - name: gpt-4o
    use: langchain_openai:ChatOpenAI
    model: gpt-4o
    api_key: $OPENAI_API_KEY
    request_timeout: 600.0
    max_retries: 2
    supports_vision: true
    thinking_enabled: false

Claude


models:
  - name: claude-sonnet
    use: langchain_anthropic:ChatAnthropic
    model: claude-sonnet-4-5
    api_key: $ANTHROPIC_API_KEY
    max_tokens: 16000
    supports_vision: true
    thinking_enabled: false

启用扩展思考：


- name: claude-extended-thinking
  use: langchain_anthropic:ChatAnthropic
  model: claude-sonnet-4-5
  api_key: $ANTHROPIC_API_KEY
  max_tokens: 16000
  thinking_enabled: true
  extra_body:
    thinking:
      type: enabled
      budget_tokens: 10000

Gemini


models:
  - name: gemini
    use: langchain_google_genai:ChatGoogleGenerativeAI
    model: gemini-2.5-pro-preview-03-25
    api_key: $GEMINI_API_KEY
    request_timeout: 600.0
    max_retries: 2
    supports_vision: true
    thinking_enabled: false

DeepSeek


models:
  - name: deepseek
    use: langchain_openai:ChatOpenAI
    model: deepseek-reasoner
    api_key: $DEEPSEEK_API_KEY
    base_url: https://api.deepseek.com
    request_timeout: 600.0
    max_retries: 2
    supports_vision: false
    thinking_enabled: true

Ollama（本地）


models:
  - name: ollama-llama
    use: langchain_ollama:ChatOllama
    model: llama3.3
    base_url: http://localhost:11434
    request_timeout: 600.0
    max_retries: 2
    supports_vision: false
    thinking_enabled: false

确保 Ollama 已运行并已拉取所需模型：


ollama pull llama3.3

沙箱


# 本地开发（默认）
sandbox:
  use: deerflow.sandbox.local:LocalSandboxProvider
  allow_host_bash: false
 
# 基于容器（推荐用于多用户）
sandbox:
  use: deerflow.community.aio_sandbox:AioSandboxProvider
  replicas: 3
  idle_timeout: 600

工具

参见工具页面了解完整的工具配置参考。快速参考：


tools:
  - use: deerflow.community.ddg_search.tools:web_search_tool
  - use: deerflow.community.jina_ai.tools:web_fetch_tool
  - use: deerflow.sandbox.tools:ls_tool
  - use: deerflow.sandbox.tools:read_file_tool
  - use: deerflow.sandbox.tools:write_file_tool
  - use: deerflow.sandbox.tools:bash_tool

技能


skills:
  container_path: /mnt/skills
  # path: /custom/path/to/skills  # 可选；默认为仓库 skills/ 目录

技能可用性在 extensions_config.json 中管理（参见下方）。

检查点（线程持久化）


checkpointer:
  type: sqlite
  connection_string: .deer-flow/checkpoints.db
 
# 或使用 Redis（高负载生产环境）：
# checkpointer:
#   type: redis
#   connection_string: redis://localhost:6379/0

前端环境变量

将 frontend/.env.example 复制为 frontend/.env。OAuth、魔法链接（Resend）、JWT 等认证配置写在项目根目录 .env（由 Gateway 读取）。

变量	必需	描述
`NEXT_PUBLIC_APP_NAME`	否	界面显示的产品名称
`NEXT_PUBLIC_APP_SHORT_NAME`	否	侧栏缩写（1–6 字符）
`NEXT_PUBLIC_BACKEND_BASE_URL`	否	直连 Gateway；留空则走 nginx 代理（推荐）
`NEXT_PUBLIC_LANGGRAPH_BASE_URL`	否	LangGraph 兼容地址；留空则走 nginx 代理
`DEER_FLOW_INTERNAL_GATEWAY_BASE_URL`	否	SSR 访问 Gateway（默认 `http://127.0.0.1:8001`）
`DEER_FLOW_TRUSTED_ORIGINS`	否	SSR 认证校验的来源列表（逗号分隔）
`SKIP_ENV_VALIDATION`	否	Docker 构建时可设为 `1` 跳过 env 校验

根目录 .env 认证项：AUTH_JWT_SECRET、AUTH_FRONTEND_BASE_URL、AUTH_*_CLIENT_*、RESEND_*。见根目录 .env.example。

extensions_config.json

extensions_config.json 控制 MCP 服务器和技能的运行时启用状态，独立于 config.yaml。

默认位置：项目根目录（与 config.yaml 同一目录）。

MCP 服务器


{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"],
      "enabled": true
    }
  }
}

不要为 DeerFlow 工作区文件引入 MCP filesystem server。它会与 DeerFlow 内置文件工具形成路径语义不同的重复能力，让 LLM 行为不稳定。DeerFlow 当前没有为 filesystem server 适配 MCP Roots 模式，也不会把 /mnt/user-data/… 这类沙箱路径映射成 @modelcontextprotocol/server-filesystem 可接受的路径。

技能启用状态

技能启用状态会反映在 extensions_config.json 中。你可以直接编辑它，或通过 DeerFlow 应用界面进行管理。

运行时环境变量

这些变量在 DeerFlow 进程中设置（通过 .env、Docker 环境或 shell）：

变量	默认值	描述
`DEER_FLOW_CONFIG_PATH`	自动发现	`config.yaml` 的绝对路径
`LOG_LEVEL`	`info`	日志详细程度（`debug`/`info`/`warning`/`error`）
`DEER_FLOW_ROOT`	仓库根目录	用于 Docker 中的技能和线程挂载

Harness 配置部署指南