RAGFlow 部署指南

约 631 字大约 2 分钟

2026-03-14

RAGFlow 是一款基于深层文档理解的开源 RAG（检索增强生成）引擎。结合大语言模型 (LLM)，它能够提供真诚的问答能力，并从各种复杂格式的数据中提供有据可查的引用。

1. 前提条件

项目	要求
CPU	≥ 4 核 (x86)
内存	≥ 16 GB
磁盘	≥ 50 GB
Docker	≥ 24.0.0
Docker Compose	≥ v2.26.1
gVisor	仅当使用代码执行器（沙箱）功能时需要

2. 系统配置

2.1 设置 vm.max_map_count

# 检查当前值
sysctl vm.max_map_count

# 临时设置（重启后失效）
sudo sysctl -w vm.max_map_count=262144

# 永久设置
echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

3. 安装部署

3.1 克隆代码并启动

# 克隆仓库
git clone https://github.com/infiniflow/ragflow.git
cd ragflow/docker

# 切换到稳定版本
git checkout -f v0.24.0

# 启动服务（CPU 版本）
docker compose -f docker-compose.yml up -d

3.2 镜像说明

镜像标签	大小	说明
v0.24.0	≈2 GB (压缩)	稳定发行版
nightly	≈2 GB (压缩)	不稳定的每日构建版

注意：Docker 镜像解压后约 7 GB

3.3 验证启动

# 查看日志
docker logs -f docker-ragflow-cpu-1

成功启动会看到：

____ ___ ______ ______ __   / __ \   / | / ____// ____// /____ _ __   / /_/ // /| | / / __ / /_  / // __ \ | | /| / / / _, _// ___ |/ /_/ // __/ / // /_/ / |/ |/ / /_/ |_|/_/  |_|\____//_/  |_|\____/ |__/|__/ 
* Running on all addresses (0.0.0.0)