跳到主要内容

构建 RAGFlow Docker 镜像

说明如何从源代码构建 RAGFlow Docker 镜像的指南。按照本指南操作，您将能够创建可用于开发、调试或测试目的的本地 Docker 镜像。

目标受众​

  • 已添加新功能或修改现有代码并需要 Docker 镜像来查看和调试其更改的开发人员。
  • 寻求为 ARM64 平台构建 RAGFlow Docker 镜像的开发人员。
  • 旨在在 Docker 镜像中探索 RAGFlow 最新功能的测试人员。

前提条件​

  • CPU ≥ 4 核
  • RAM ≥ 16 GB
  • 磁盘 ≥ 50 GB
  • Docker ≥ 24.0.0 & Docker Compose ≥ v2.26.1

构建 Docker 镜像​

此镜像大小约为 2 GB，依赖外部 LLM 和嵌入服务。

重要
  • 虽然我们也在 ARM64 平台上测试 RAGFlow，但我们不维护 ARM 的 RAGFlow Docker 镜像。但是，您也可以在 linux/arm64 或 darwin/arm64 主机上自己构建镜像。
  • 对于 ARM64 平台，请将 pyproject.toml 中的 xgboost 版本升级到 1.6.0，并确保正确安装了 unixODBC。
git clone https://github.com/infiniflow/ragflow.git
cd ragflow/
uv run download_deps.py
docker build -f Dockerfile.deps -t infiniflow/ragflow_deps .
docker build --build-arg LIGHTEN=1 -f Dockerfile -t infiniflow/ragflow:nightly-slim .

从 Docker 为 MacOS 启动 RAGFlow 服务​

构建 infiniflow/ragflow:nightly-slim 镜像后，您就可以启动一个功能齐全的 RAGFlow 服务，包含所有所需组件，如 Elasticsearch、MySQL、MinIO、Redis 等。

示例：Apple M2 Pro (Sequoia)​

  1. 编辑 Docker Compose 配置

打开 docker/.env 文件。找到 RAGFLOW_IMAGE 设置，将镜像引用从 infiniflow/ragflow:v0.20.0-slim 更改为 infiniflow/ragflow:nightly-slim 以使用预构建的镜像。

  1. 启动服务
cd docker
$ docker compose -f docker-compose-macos.yml up -d
  1. 访问 RAGFlow 服务

设置完成后，打开您的网络浏览器并导航到 http://127.0.0.1 或您服务器的 <IP_ADDRESS>；（默认端口是 <PORT> = 80）。您将被引导到 RAGFlow 欢迎页面。享受吧！🍻