s01

系统架构总览

架构层

从请求入口到响应出口

Nginx 统一代理 → 三服务分层

LangGraph Server 负责 Agent 运行时，Gateway 负责 REST API，Frontend 负责 UI

🏗️

DeerFlow 2.0 系统架构概览

DeerFlow 将系统拆为三个独立服务：Next.js Frontend 负责 UI，FastAPI Gateway 负责 REST API 资源管理，LangGraph Server 负责 Agent 运行时。Nginx 统一代理，各层独立部署、独立扩展。这是理解后续所有模块的全局地图。

系统架构总览

DeerFlow 采用三服务分层架构：Frontend (Next.js) 负责 UI 渲染，Gateway (FastAPI) 负责 REST API 和资源管理，LangGraph Server 负责 Agent 运行时。Nginx 作为统一入口进行路由分发。

1/6

Key Source Code

Nginx 路由规则 — 一个入口，按路径前缀分发到三个服务

nginx.conf

upstream gateway { server 127.0.0.1:8000; }
upstream langgraph { server 127.0.0.1:2024; }
upstream frontend { server 127.0.0.1:3000; }

server {
    listen 80;
    location /api/ { proxy_pass http://gateway; }
    location /langgraph/ { proxy_pass http://langgraph; }
    location / { proxy_pass http://frontend; }
}

nginx

Gateway 路由注册 — FastAPI 管理 agents/threads/memory/uploads 等资源

gateway/app.py

app = FastAPI()
app.include_router(agents_router, prefix="/api")
app.include_router(threads_router, prefix="/api")
app.include_router(memory_router, prefix="/api")
app.include_router(uploads_router, prefix="/api")
app.include_router(skills_router, prefix="/api")
app.include_router(channels_router, prefix="/api")
app.include_router(mcp_router, prefix="/api")

python