系列: RAGFlow v0.25.0 源码深度解析
作者: 耿雨飞
适用版本: RAGFlow v0.25.0
导读
上一课我们完成了开发环境的搭建,能够在本地成功启动 RAGFlow 的后端和前端服务。但启动只是开始 – 当你在浏览器中创建一个知识库、上传一个文档时,这些操作是如何被后端接收和处理的?请求从进入服务器到返回响应,中间经历了哪些环节?
本课将深入 RAGFlow 后端的两个核心文件 –api/ragflow_server.py和api/apps/__init__.py,完整拆解服务器的启动流程和请求的生命周期。我们会看到 RAGFlow 如何选择 Quart 作为 Web 框架、如何动态注册 27 个 API 蓝图、如何通过 JWT + API Token 双路径实现身份认证,以及请求从进入到离开的每一个中间环节。理解这些机制,是后续深入业务模块的必要基础。
学习目标
完成本课学习后,你将能够:
- 理解框架选型– 为什么 RAGFlow 选择 Quart (异步 Flask) 而非 Django、FastAPI 等其他框架
- 掌握服务启动全流程– 从
ragflow_server.py的第一行代码到 HT