国潮造物局 · 实操文章

RAGFlow完整入门：让一份复杂PDF能被检索到正确段落

从官方入口、安装与首次配置开始，跟做“让一份复杂PDF能被检索到正确段落”，附样例、流程图、验收与故障排查。

本页目录 · 15个部分

国潮造物局编辑部 · 资料整理日期 2026-10-21 · 企业应用 · 12分钟

资料核对：2026-10-21。官方Quickstart及版本选择已核对；未安装运行。图为本站原创操作示意，不是软件界面截图。

01 先知道要做成什么

让一份复杂PDF能被检索到正确段落。本篇只教一个能检查结果的首个任务，再扩展到真实工作；不把生成一次等同于专业交付。

RAGFlow偏技术部署。先阅读官方Quickstart选择稳定版本，安装其要求的Docker与Compose，按文档克隆官方仓库并切到对应发行版本；在该版本docker目录按说明准备环境文件和启动命令。不同版本服务与配置会变，本文不拼接未经验证的通用启动命令。

先用3页无敏感信息的PDF，包含一个表格和一段正文；准备官方要求的机器资源、模型及嵌入服务。安装工具、下载模型、调用云服务可能分别计费。先查看官方要求与许可，密钥只存凭证设置或环境变量，不放提示词。

严格按所选稳定版Quickstart启动，查看容器健康与日志，按文档地址完成账号设置；不要默认开放服务器所有端口。

在设置中配置聊天与嵌入模型，新建数据集，选择适合PDF的解析方式；不要先传几百页扫描件。

上传PDF后等解析与索引完成，检查表格行列、页码和分块。错误先修材料或解析设置，不能跳过。

先用表格里的唯一词检索，再建立关联数据集的聊天助手。核对引用的页码与真实内容。

依据资料回答指定产品的规格，并指出来自哪页。表格中找不到的字段说明未提供，不猜数值。

保存版本、配置和数据集备份；对外开放前补认证、TLS和数据隔离检查。

指定规格能检索，引用页正确；表格没有把列头与其它型号混在一起。建议记录：输入、实际输出、是否通过、需修改的地方。先用一条正例和一条反例，确认后再扩大批量。

解析失败先看解析任务与存储；资源不足按官方要求扩容；模型失败单独测连通。开发版文档不直接当稳定版命令。

先用本篇虚构样例练习，再替换成经授权并脱敏的材料。涉及账号、客户、商业和个人信息时先确认平台数据处理规则。对外发布前核对事实、权利和访问权限；官网界面更新时以官方帮助为准。