API 网关
API Gateway
统一 API 入口、反向代理分离、RESTful 端点管理
子问题
1.多服务反向代理
2.RESTful API 设计
3.健康检查与监控
4.OpenAPI 文档自动生成
5.SSE/流式响应的反向代理配置
6.跨进程配置同步（文件 mtime 检测）
7.虚拟路径到真实文件系统的安全映射
各项目的解法1 solutions
Signals
横向对比
| 维度 | DeerFlow |
|---|---|
| 网关框架 | FastAPI 应用工厂 + uvicorn，7 组 Router 模块化 |
| 反向代理 | nginx 路径路由，4 upstream（gateway/langgraph/frontend/provisioner） |
| CORS 策略 | nginx 集中化：proxy_hide_header 去重 + add_header always 统一添加 |
| 流式支持 | nginx 关闭 proxy_buffering + X-Accel-Buffering no + 600s 超时 |
| API 文档 | FastAPI 内置 /docs(Swagger) + /redoc + /openapi.json，nginx 透传 |
| 路径安全 | path_utils 虚拟路径解析 + Path.resolve() 防穿越 |
| 配置热更新 | MCP 配置写文件 + LangGraph mtime 检测自动重载 |
最佳实践
1.Gateway 与 Agent Server 进程分离
2.nginx proxy_hide_header 去重后再 add_header 避免 CORS 头冲突
3.Gateway 不初始化 Agent 工具，保持进程职责单一
4.本地开发与容器部署使用不同 nginx 配置（localhost vs service name）