【RAGFlow代码详解-29】Docker 部署

Docker Compose 架构

RAGFlow 使用多服务 Docker Compose 设置来编排核心应用程序服务器、可选任务执行程序和支持的基础设施服务。主要部署配置在 docker/docker-compose.yml 1-75 中定义

主要服务配置包括运行状况检查依赖项和 .env 文件中的环境变量注入。可选的 MCP 服务器配置在 docker/docker-compose.yml 10-24 中 作为注释示例提供

服务编排和入口点

容器启动过程由 entrypoint.sh 脚本管理，该脚本通过命令行参数提供灵活的服务配置。该脚本支持多种作模式和组件隔离。

入口点脚本通过环境变量替换 docker/entrypoint.sh 133-141 处理配置模板处理，并管理分布式部署 docker/entrypoint.sh 45-56 的主机 ID 生成

MCP 服务器集成

模型上下文协议 （MCP） 服务器为 RAGFlow 提供外部工具集成功能。它可以通过 Docker 部署启用，并支持自托管和多租户主机模式。

MCP 服务器将 RAGFlow 的检索功能公开为 MCP 工具，ragflow_retrieval 工具支持数据集和文档过滤 mcp/server/server.py 175-203

配置管理

部署配置系统使用基于模板的环境变量替换来生成运行时配置文件。这样可以灵活地进行部署定制，而无需重新构建容器。

配置模板处理可确保在容器启动时正确应用特定于环境的设置 docker/entrypoint.sh 133-141

部署模式

RAGFlow 通过入口点脚本的命令行界面支持多种部署配置，允许组件隔离和扩展场景。

部署模式	描述	命令参数	用例
全栈	启用所有组件（默认）	没有	单节点开发/测试
仅限 API 服务器	没有任务处理的 Web 服务器	–disable-taskexecutor	单独的加工工人
API Server Only	没有 Web 服务器的任务执行器	–disable-webserver --workers=N	分布式处理节点
MCP 服务器	启用 MCP 协议服务器	–enable-mcpserver	外部工具集成
Range Workers	特定工作人员 ID 范围	–consumer-no-beg=X --consumer-no-end=Y	细粒度的工人控制

任务执行工作者使用 jemalloc 进行内存管理 docker/entrypoint.sh 154-158，并通过唯一主机标识符 docker/entrypoint.sh 195-207 支持分布式作