1、RAGFlow介绍

RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,通过融合前沿的 RAG 技术与 Agent 能力,为大型语言模型提供卓越的上下文层。它提供可适配任意规模企业的端到端 RAG 工作流,凭借融合式上下文引擎与预置的 Agent 模板,助力开发者以极致效率与精度将复杂数据转化为高可信、生产级的人工智能系统。

1.1 兼容各类异构数据源

支持丰富的文件类型,包括 Word 文档、PPT、Excel 表格、TXT 文件、图片、PDF、影印件、复印件、结构化数据、网页等。

1.2 github文档

ragflow/README_zh.md at main · infiniflow/ragflow · GitHub

2、本地部署

2.1 Docker 部署前提条件

  • 建议起步配置:4 核 CPU、16 GB 内存和 50 GB 可用磁盘。实际资源需求取决于文档引擎、数据规模、解析任务和并发量;启用本地模型或其他额外组件时,请同时满足相应组件的资源要求。
  • Docker ≥ 24.0.0,Docker Compose ≥ v2.26.1。

2.2 启动服务

2.2.1 修改配置

如果使用 Elasticsearch,将 Docker 宿主机的 vm.max_map_count 设置为至少 262144。使用 Infinity 时则不需要执行此步骤:

如需确认 vm.max_map_count 的大小:

[]# sysctl vm.max_map_count
vm.max_map_count = 65530

如果使用 Elasticsearch 且 vm.max_map_count 的值小于 262144,可以进行重置:

# 这里我们设为 262144:
sudo sysctl -w vm.max_map_count=262144

你的改动会在下次系统重启时被重置。如果希望做永久改动,还需要在 /etc/sysctl.conf 文件里把 vm.max_map_count 的值再相应更新一遍:

vm.max_map_count=262144

2.2.2 克隆仓库:

git clone https://github.com/infiniflow/ragflow.git

2.2.3 切换到发布标签并使用 Docker Compose 启动服务器

进入仓库中的 Docker 部署目录。

cd ragflow/docker

切换到 v1.0.0-rc3 发布标签。

git checkout v1.0.0-rc3

在启动 RAGFlow 服务及其依赖服务。

docker compose -f docker-compose.yml up -d
2.3.3.1 镜像无法下载
方案一

镜像下载提示: 如果无法从默认仓库拉取镜像,请先在 docker/.env 中将 RAGFLOW_IMAGE 设置为以下镜像源之一,并保留 v1.0.0-rc3 标签:

  • 华为云:swr.cn-north-4.myhuaweicloud.com/infiniflow/ragflow:v1.0.0-rc3
  • 阿里云:registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:v1.0.0-rc3
方案二

(1)使用 DaoCloud 加速源拉取镜像(复制全部,注意全部是英文减号)

# 拉取依赖镜像
docker pull m.daocloud.io/docker.io/apache/kvrocks:2.16.0
docker pull m.daocloud.io/docker.io/library/nats:2.14.2
docker pull m.daocloud.io/docker.io/library/elasticsearch:8.14.0
docker pull m.daocloud.io/docker.io/library/mysql:8.0.40
docker pull m.daocloud.io/docker.io/pgsty/silo:RELEASE.2026-08-06T00-00-00Z

# ragflow主镜像使用华为云国内镜像源
docker pull swr.cn-north-4.myhuaweicloud.com/infiniflow/ragflow:v1.0.0-rc3

(2)docker tag 重标记为 compose 识别的原始镜像名。不改动任何 yml 配置文件,本地镜像打上官方 compose 期望的镜像名称,启动直接复用本地镜像,不走外网拉取

# kvrocks
docker tag m.daocloud.io/docker.io/apache/kvrocks:2.16.0 apache/kvrocks:2.16.0

# nats
docker tag m.daocloud.io/docker.io/library/nats:2.14.2 nats:2.14.2

# elasticsearch
docker tag m.daocloud.io/docker.io/library/elasticsearch:8.14.0 elasticsearch:8.14.0

# mysql
docker tag m.daocloud.io/docker.io/library/mysql:8.0.40 mysql:8.0.40

# minio(silo)
docker tag m.daocloud.io/docker.io/pgsty/silo:RELEASE.2026-08-06T00-00-00Z pgsty/silo:RELEASE.2026-08-06T00-00-00Z

# ragflow主程序
docker tag swr.cn-north-4.myhuaweicloud.com/infiniflow/ragflow:v1.0.0-rc3 infiniflow/ragflow:v1.0.0-rc3

校验本地镜像标签是否存在

docker images | grep -E "mysql|kvrocks|nats|elasticsearch|pgsty/silo|infiniflow/ragflow"
2.3.3.2 修改访问端口

默认是80端口, 在 docker/.env修改SVR_WEB_HTTP_PORT,改成自己的端口

SVR_WEB_HTTP_PORT=8088

mysql从3306改为3307

EXPOSE_MYSQL_PORT=3307

minio修改为空,这两条 port 端口映射直接失效,不会把容器 9000、9001 绑定到宿主机任何端口上。

MINIO_CONSOLE_PORT=
MINIO_PORT=

2.3 访问

  • 访问http://${ip}:8088
  • 首次注册账号 → 该账号即管理员

参考文档:

知识库主流分片策略_知识库文档分片策略-CSDN博客

Logo

更多推荐