RagFlow 部署指南以及相关问题解决

傀儡师

RagFlow 部署指南

一、RagFlow 概述

RagFlow 是一款开源的 RAG（Retrieval-Augmented Generation）引擎，专注于深度文档理解，能够助力企业及个人构建高效的 RAG 工作流程。借助大语言模型（LLM），它可以精准处理各种复杂格式的数据，为用户提供可靠的问答服务，并附上详实的引用依据。

二、部署前置条件

• 硬件配置要求：
  • CPU：至少 4 核，以保障系统在处理 RagFlow 任务时具备充足的运算能力，避免因 CPU 资源不足导致运行卡顿或任务处理延迟。
  • RAM：不低于 16GB，为 RagFlow 及其相关服务的运行提供充裕的内存空间，确保数据的高效缓存和处理，减少因内存紧张引发的性能问题。
  • Disk：大于等于 50GB，用于存储 RagFlow 运行过程中产生的各类数据，包括但不限于日志文件、临时数据文件以及可能的数据库文件等。
• 软件版本要求：
  • Docker：需达到 24.0.0 及以上版本。Docker 作为实现 RagFlow 镜像部署的核心工具，其高版本能够提供更出色的性能和功能支持，确保容器化应用的稳定运行和高效管理。
  • Docker Compose：不低于 v2.26.1 版本。它在多容器 Docker 应用的配置和部署中发挥着关键作用，与 Docker 紧密协作，保障 RagFlow 各个组件在容器环境中正确启动、运行和协同工作。
• 必备工具
  • FinalShell

三、部署阶段

• 部署参考官方给的命令，使用FinalShell或其他ssh工具，链接飞牛，进入到存放项目的目录

  git clone https://github.com/infiniflow/ragflow.git 
  cd ragflow 
  docker compose -f docker/docker-compose.yml up -d 
  

• 执行完命令docker compose会多一个docker项目
  

正常的话，是这个状态结束了。

常见问题

• 端口冲突
  找到docker-compose.yml 编辑把端口改成未占用即可，一般是80、443，根据实际情况自行改

• MySQL 无限重启
  解决方式：cd 到ragflow目录下的docker目录下，也就是该项目的docker-compose.yml所在的目录，执行一下命令

docker compose down -v # 删除所有本地数据，
docker compose up

• ragflow-server 无法启动
  解决方式：使用FinalShell进入 /ragflow/docker 目录

为了规避问题把权限先给到位

再次启动不出意外基本解决问题

希望可以帮助有需要的朋友，有其他问题也欢迎留言交流！

nameyq

这东西一直不明白到底有什么用途、。

傀儡师

nameyq 发表于 2025-6-19 16:51
这东西一直不明白到底有什么用途、。

你可以理解为，给ai加一个特定的或指定文件的知识库，当问一些相关问题的时候，他会优先从知识库中获取答案，回复给你，特定场景适合法律法规，公司内部文件等