RAGFlow 作为一款开源检索增强生成引擎,凭借其深度文档理解能力和灵活配置性,已成为企业及个人构建 AI 知识库的热门工具。本文将手把手教你完成 RAGFlow 的本地部署,解决端口冲突、镜像拉取慢等常见问题,助你快速搭建私有化 AI 知识库
一、部署前准备
- CPU:4 核及以上(推荐 x86 架构)
- 内存:≥16GB
- 磁盘空间:≥50GB(镜像文件约 9GB)
-
Docker
:≥24.0.0
-
Docker Compose
:≥2.26.1
-
操作系统
:Linux/Windows/macOS(需支持 Docker)
-
调整 Elasticsearch 内存映射限制(避免服务崩溃):
sudo sysctl -w vm.max_map_count=262144
# 永久生效需添加至 /etc/sysctl.conf -
确保 Docker 已启动且权限配置正确
二、项目下载与配置
-
Git 克隆(推荐):
git clone https://github.com/infiniflow/ragflow.git
-
手动下载:
Fork 项目至个人 GitHub 仓库,点击 Code → Download ZIP,解压至本地目录
关键配置修改
-
启用嵌入模型:
编辑 docker/.env 文件,取消注释 ragflow_image=infiniflow/ragflow:v0.17.2(默认镜像无嵌入模型),注释 slim 版本行# 原配置:
# ragflow_image=infiniflow/ragflow:v0.17.2-slim
# 修改后:
ragflow_image=infiniflow/ragflow:v0.17.2 -
国内镜像加速
(解决拉取慢问题):
替换镜像源为阿里云地址:
ragflow_image=registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:v0.17.2
-
HuggingFace 镜像
:
取消注释 hf_endpoint=https://hf-mirror.com,解决国内访问限制
- 修改 docker-compose.yml 中端口映射为 8080:80 和 8443:443
三、启动 RAGFlow 服务
进入项目目录
cd ragflow/docker
2.执行启动命令
-
CPU 版本
(无独立显卡用户):
docker compose -f docker-compose.yml up -d
-
GPU 版本
(需 NVIDIA 显卡驱动):
docker compose -f docker-compose-gpu.yml up -d
-
启动后可通过 docker logs -f ragflow-server 查看状态
3.访问服务
- 浏览器输入 http://127.0.0.1:8080 或 http://<服务器IP>:8080 进入管理界面
四、模型与知识库配置
绑定大语言模型
-
登录后点击右上角「模型提供商」,填写 OpenAI、DeepSeek 等 API 密钥
-
推荐配置
:
- 嵌入模型选择 BGE(专为中文优化)
- 生成模型可选 GPT-4、文心一言等。
创建知识库
- 点击「知识库 → 新建」,上传 PDF、Word、Excel 等文件(支持多格式混合)
- 根据文档类型选择分块策略(如长文本分段、表格解析)。
五、常见问题与优化
-
端口冲突
:检查 80/443 端口占用情况,或修改为其他端口
-
镜像拉取失败
:切换阿里云镜像源或配置 Docker 全局代理
- GPU 加速:启用 docker-compose-gpu.yml 提升嵌入模型速度。
- 知识库分片:大型文档建议拆分为多个子库,减少单次检索压力
六、结语
通过以上步骤,你可快速搭建一个支持多模态文档、高可配置的 AI 知识库。RAGFlow 的本地化部署不仅适用于个人学习,还可作为企业级知识管理解决方案,实现团队协作与数据安全
想入门 AI 大模型却找不到清晰方向?备考大厂 AI 岗还在四处搜集零散资料?别再浪费时间啦!2025 年 AI 大模型全套学习资料已整理完毕,从学习路线到面试真题,从工具教程到行业报告,一站式覆盖你的所有需求,现在全部免费分享!
👇👇扫码免费领取全部内容👇👇

一、学习必备:100+本大模型电子书+26 份行业报告 + 600+ 套技术PPT,帮你看透 AI 趋势
想了解大模型的行业动态、商业落地案例?大模型电子书?这份资料帮你站在 “行业高度” 学 AI:
1. 100+本大模型方向电子书

2. 26 份行业研究报告:覆盖多领域实践与趋势
报告包含阿里、DeepSeek 等权威机构发布的核心内容,涵盖:

- 职业趋势:《AI + 职业趋势报告》《中国 AI 人才粮仓模型解析》;
- 商业落地:《生成式 AI 商业落地白皮书》《AI Agent 应用落地技术白皮书》;
- 领域细分:《AGI 在金融领域的应用报告》《AI GC 实践案例集》;
- 行业监测:《2024 年中国大模型季度监测报告》《2025 年中国技术市场发展趋势》。
3. 600+套技术大会 PPT:听行业大咖讲实战
PPT 整理自 2024-2025 年热门技术大会,包含百度、腾讯、字节等企业的一线实践:

- 安全方向:《端侧大模型的安全建设》《大模型驱动安全升级(腾讯代码安全实践)》;
- 产品与创新:《大模型产品如何创新与创收》《AI 时代的新范式:构建 AI 产品》;
- 多模态与 Agent:《Step-Video 开源模型(视频生成进展)》《Agentic RAG 的现在与未来》;
- 工程落地:《从原型到生产:AgentOps 加速字节 AI 应用落地》《智能代码助手 CodeFuse 的架构设计》。
二、求职必看:大厂 AI 岗面试 “弹药库”,300 + 真题 + 107 道面经直接抱走
想冲字节、腾讯、阿里、蔚来等大厂 AI 岗?这份面试资料帮你提前 “押题”,拒绝临场慌!

1. 107 道大厂面经:覆盖 Prompt、RAG、大模型应用工程师等热门岗位
面经整理自 2021-2025 年真实面试场景,包含 TPlink、字节、腾讯、蔚来、虾皮、中兴、科大讯飞、京东等企业的高频考题,每道题都附带思路解析:

2. 102 道 AI 大模型真题:直击大模型核心考点
针对大模型专属考题,从概念到实践全面覆盖,帮你理清底层逻辑:

3. 97 道 LLMs 真题:聚焦大型语言模型高频问题
专门拆解 LLMs 的核心痛点与解决方案,比如让很多人头疼的 “复读机问题”:

三、路线必明: AI 大模型学习路线图,1 张图理清核心内容
刚接触 AI 大模型,不知道该从哪学起?这份「AI大模型 学习路线图」直接帮你划重点,不用再盲目摸索!

路线图涵盖 5 大核心板块,从基础到进阶层层递进:一步步带你从入门到进阶,从理论到实战。

L1阶段:启航篇丨极速破界AI新时代
L1阶段:了解大模型的基础知识,以及大模型在各个行业的应用和分析,学习理解大模型的核心原理、关键技术以及大模型应用场景。

L2阶段:攻坚篇丨RAG开发实战工坊
L2阶段:AI大模型RAG应用开发工程,主要学习RAG检索增强生成:包括Naive RAG、Advanced-RAG以及RAG性能评估,还有GraphRAG在内的多个RAG热门项目的分析。

L3阶段:跃迁篇丨Agent智能体架构设计
L3阶段:大模型Agent应用架构进阶实现,主要学习LangChain、 LIamaIndex框架,也会学习到AutoGPT、 MetaGPT等多Agent系统,打造Agent智能体。

L4阶段:精进篇丨模型微调与私有化部署
L4阶段:大模型的微调和私有化部署,更加深入的探讨Transformer架构,学习大模型的微调技术,利用DeepSpeed、Lamam Factory等工具快速进行模型微调,并通过Ollama、vLLM等推理部署框架,实现模型的快速部署。

L5阶段:专题集丨特训篇 【录播课】

四、资料领取:全套内容免费抱走,学 AI 不用再找第二份
不管你是 0 基础想入门 AI 大模型,还是有基础想冲刺大厂、了解行业趋势,这份资料都能满足你!
现在只需按照提示操作,就能免费领取:
👇👇扫码免费领取全部内容👇👇

2025 年想抓住 AI 大模型的风口?别犹豫,这份免费资料就是你的 “起跑线”!



