RAGFlow 能解决什么问题？

如果你手头有一堆 PDF、Word、Excel 文档，想让 AI 帮你精准回答其中的问题，但直接用大模型经常胡编乱造，那么 RAGFlow 就是为你准备的。它是一款开源的 RAG（检索增强生成）引擎，核心能力是「深度文档理解」——能把复杂表格、扫描件、多栏排版里的文字和结构准确提取出来，再结合大模型给出有依据的回答。

和普通向量数据库方案相比，RAGFlow 的优势在于：

• 切块更智能：按语义和版面切分，不会把表格拦腰截断；
• 引用可追溯：每条回答都能点开看原文出处，方便核对；
• 部署在自己手里：数据不出内网，适合企业知识库、合同审查、技术文档问答等场景。

准备工作：注册与入口

RAGFlow 是开源软件，不需要注册账号，直接部署即可使用。官方推荐用 Docker 方式安装，对国内用户比较友好。你需要准备：

• 一台能联网的电脑或服务器，建议 8GB 以上内存、20GB 以上磁盘；
• 安装好 Docker 和 Docker Compose（Windows 用户装 Docker Desktop 即可）；
• 一个可用的国内大模型 API Key，比如通义千问、智谱 GLM、DeepSeek 等，用于生成回答。

如果不想自己部署，也可以访问 RAGFlow 官网查看在线体验入口，但正式使用建议本地或私有服务器部署。

分步骤实操：从零跑通 RAGFlow

步骤 1：拉取代码并启动服务

打开终端或命令行，依次执行以下命令（Windows 用 PowerShell 或 CMD 同样可以）：

1. 克隆仓库：输入 git clone https://github.com/infiniflow/ragflow.git，回车等待下载完成。如果 GitHub 访问慢，可以换用国内镜像源。
2. 进入目录：输入 cd ragflow/docker，进入 Docker 配置文件夹。
3. 启动服务：输入 docker compose -f docker-compose.yml up -d，回车后会自动拉取镜像并启动。首次启动需要下载几个 GB 的镜像，耐心等待几分钟。
4. 检查状态：输入 docker logs -f ragflow-server，看到「Running on all addresses」或类似提示，说明启动成功。

步骤 2：登录并配置模型

打开浏览器，访问 http://localhost:9380（如果部署在服务器上，把 localhost 换成服务器 IP）。首次进入需要注册一个管理员账号，邮箱和密码自己填，点击注册即可。

登录后，点击左下角的「设置」图标，找到「模型提供商」或「模型管理」选项。这里需要添加至少一个大模型：

• 选择「通义千问」或「智谱 AI」等国内厂商；
• 把你在对应平台申请的 API Key 粘贴进去；
• 点击「确定」保存，系统会自动测试连通性。

建议同时添加一个嵌入模型（Embedding），比如通义千问的 text-embedding-v2，用于文档向量化。

步骤 3：创建知识库并上传文档

回到首页，点击「知识库」标签，然后点击「创建知识库」按钮。填写知识库名称，比如「公司产品手册」，解析方法选择「General」即可，其他参数保持默认，点击「确定」。

进入知识库后，点击「添加文件」，把准备好的 PDF、Word、Excel 或 TXT 文件拖进去。上传完成后，点击「解析文件」按钮，RAGFlow 会开始深度解析。解析时间取决于文件大小和数量，一般几页的文档几秒钟就好。

解析完成后，你可以点开某个文档，查看它被切成了哪些块。如果发现切分不合理，可以手动调整或重新解析。

步骤 4：创建问答助手并测试

点击左侧「聊天」标签，再点击「创建助手」。给助手起个名字，比如「产品问答小助手」，然后关联刚才创建的知识库。在「模型」选项里选择你配置好的大模型，其他参数可以先用默认值。

保存后进入对话界面，在输入框里问一个文档里有的问题，比如「产品保修期是多久？」。如果一切正常，助手会给出答案，并在下方显示引用来源。点击引用编号，可以跳转到原文对应位置。

进阶技巧

常见问题

Q1：启动后访问 localhost:9380 打不开怎么办？

先确认 Docker 容器是否都在运行，输入 docker ps 查看。如果 ragflow-server 状态不是 Up，输入 docker logs ragflow-server 看报错。常见原因是内存不足，建议给 Docker 分配至少 8GB 内存。另外检查 9380 端口是否被占用，可以改成其他端口。

Q2：上传的 PDF 解析出来是乱码或空白？

可能是扫描件没有文字层，RAGFlow 默认不开启 OCR。你需要在知识库配置里打开 OCR 选项，或者先用其他工具把扫描件转成可复制文字的 PDF。另外，加密 PDF 也会解析失败，记得先解除密码。

Q3：回答不准，总是说「不知道」？

先检查文档是否解析成功，可以在知识库列表里看「解析状态」是否为绿色。如果解析正常，尝试调小切块大小，或者开启混合检索。还可以在助手设置里把「相似度阈值」调低一些，让更多相关片段进入上下文。最后，确认选择的大模型能力足够，太小的模型可能理解不了复杂问题。