【RAGFlow】全由国内镜像源搭建docker版

一、部署说明

安装当前最新的Ubuntu系统Ubuntu 24.04.2 LTS，因为这里完全使用docker镜像启动服务来实现RAGFlow平台搭建，所以其他相关工具和库就不需要提供安装部署了；由于海外仓库访问会遭遇网络延迟高、下载速度慢的问题，所以这里代码资源使用国内的Gitee（码云），Dokcer仓库也完全使用国内资源部署完成。下面部署过程希望对大家有所帮助，谢谢~

⛳主流镜像源对比

💡 RAGFlow 是什么？

RAGFlow 是一款基于深度文档理解构建的开源 RAG（Retrieval-Augmented Generation）引擎。RAGFlow 可以为各种规模的企业及个人提供一套精简的 RAG 工作流程，结合大语言模型（LLM）针对用户各类不同的复杂格式数据提供可靠的问答以及有理有据的引用。

🔎 系统架构

📝 机器配置

• CPU >= 4 核
• RAM >= 16 GB
• Disk >= 50 GB
• Docker >= 24.0.0 & Docker Compose >= v2.26.1
  如果你并没有在本机安装 Docker（Windows、Mac，或者 Linux）, 可以参考文档 Install Docker Engine 自行安装。

说明：这里使用的是4核i5 6500的CPU，32G内存，500G硬盘,Docker version 26.1.3, build 26.1.3-0ubuntu1~24.04.1

二、基础配置

📝系统源

备份当前系统的源：
cp /etc/apt/sources.list /etc/apt/sources.list.bak
修改源内容如下：

# 清华源
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
# 阿里源
deb http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse

# 以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换
deb http://security.ubuntu.com/ubuntu/ focal-security main restricted universe multiverse
deb-src http://security.ubuntu.com/ubuntu/ focal-security main restricted universe multiverse

🏞️Docker配置

🧱前提条件

确保你的服务器上已经安装了Docker。如果没有安装，可以按照以下步骤进行安装：

检查Docker状态：
sudo systemctl status docker
此命令用于检查Docker服务的运行状态。

更新APT包管理器：
sudo apt update
安装Docker：
sudo apt install docker.io

🚃配置Docker镜像源

为了加速Docker镜像的拉取，建议将Docker镜像源更改为国内源。具体步骤如下：

• 进入Docker配置文件目录：
  cd /etc/docker/
• 编辑daemon.json文件
  正常这个文件是不存在的，直接vim创建并编辑即可：
  vim daemon.json

使用vim或其他文本编辑器打开daemon.json文件，并添加以下内容：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live",
    "https://registry.docker-cn.com",
    "https://cr.console.aliyun.com",
    "https://mirror.ccs.tencentyun.com",
    "https://huecker.io/",
    "https://dockerhub.timeweb.cloud",
    "https://noohub.ru/",
    "https://dockerproxy.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.nju.edu.cn",
    "https://xx4bwyg2.mirror.aliyuncs.com",
    "http://f1361db2.m.daocloud.io",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.registry.cyou",
    "https://docker-cf.registry.cyou",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://mirror.aliyuncs.com",
    "https://dockerproxy.com",
    "https://mirror.baidubce.com",
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.rainbond.cc"
  ]
}

保存并退出编辑器。(vim：ESC-> :wq，回车)

• 重新加载Docker配置
  通常修改daemon.json文件后，Docker服务会自动重新加载配置。如果不确定，可以重启Docker服务：
  sudo systemctl restart docker
• 调整系统参数（可选，但推荐）：
  sudo sysctl -w vm.max_map_count=262144
  此命令用于调整Linux内核参数，以提高Docker容器的性能，也可以设置更高值。

三、部署RAGFlow

🎨Docker镜像下载和启动

• 克隆RAGFlow仓库：
  git clone https://gitee.com/changanbuyihou/ragflow.git

• 进入Docker目录：
  cd ragflow/docker/

• 配置环境变量：
  编辑docker/.env文件，将DOC_ENGINE设置为infinity。这通常是RAGFlow的一个配置选项，用于指定文档引擎。

• 启动Docker容器：
  docker-compose -f docker-compose.yml up -d
  此命令将使用docker-compose.yml文件中的配置启动Docker容器。-d参数表示以守护进程模式运行容器。

• 镜像共有五个：mysql、ragflow、minio、redis、es01
  – mysql：数据存储，存储结构化数据；大概560M。
  – ragflow：主服务，前后端；大概9.88G。
  – minio：对象存储，存储非结构化数据；大概150M。
  – redis：高速缓存，多样化数据结构支持，分布式系统支撑（消息队列、回话管理）；大概140M。
  – es01：分布式搜索和分析引擎，主要用于实时搜索、分析和存储大规模数据；大概1.33G。

⚠️错误处理

第一次下载完成后创建服务时会有报错，提示ragflow-mysql错误，容器不健康

再次执行：docker-compose -f docker-compose.yml up -d 即可

四、实际测试

🌈模型配置

平台搭建好之后，会默认提供Tongyi-Qianwen的模型，但此时的模型是不可用的，你需要输入可用的API-Key，才能正常使用。

• 这个key的获取，主要从阿里的 百炼大模型 的控制台中创建。
  
• 填好“API-Key”之后，点击页面右上角的“系统模型设置”，就可以对应选择到通义千问的各种模型了。
  

📦知识库

💬聊天

👁搜索

➰Agent

📁文件管理

🌐参考链接

1. 国内docker镜像源
2. 怎么使用阿里的docker国产镜像源
3. 清华源 docker镜像
4. 中科大 docker源
5. Docker——配置国内源
6. 【k8s、docker】Docker配置文件daemon.json解析(镜像源)