ragflow

环境要求

• 已安装 Docker 与 Docker Compose（需能执行 docker compose 命令）
• 磁盘空间足够，镜像约 2 GB
• 可访问外部 LLM 与 Embedding 服务（RAGFlow 依赖外部模型服务）
• 如自行构建镜像，建议使用 linux/amd64 平台

安装与启动步骤

1. 1克隆项目仓库

   把 RAGFlow 代码拉到本地并进入项目根目录，后续的 Docker 构建与配置都在此目录下进行。

   git clone https://github.com/infiniflow/ragflow.git
   cd ragflow/

   复制

2. 2修改基础配置

   编辑 docker/.env，设置系统基础参数，如 SVR_HTTP_PORT、MYSQL_PASSWORD、MINIO_PASSWORD。

   vim docker/.env

   复制

3. 3调整服务端口

   默认 HTTP 端口为 80。若被占用，打开 docker/docker-compose.yml 把 80:80 改为 <你的端口>:80。

   vim docker/docker-compose.yml

   复制

4. 4启动所有容器

   在 docker 目录下用 docker-compose.yml 拉起全部服务，-d 表示后台运行。

   cd docker
   docker compose -f docker-compose.yml up -d

   复制

5. 5（可选）自行构建镜像

   如需自建镜像，在项目根目录执行 docker build，镜像大小约 2 GB。

   docker build --platform linux/amd64 -f Dockerfile -t infiniflow/ragflow:nightly .

   复制

6. 6（可选）代理环境构建

   若处于代理网络后，可通过 build-arg 传入 http_proxy / https_proxy 后再构建镜像。

   docker build --platform linux/amd64 \
     --build-arg http_proxy=http://YOUR_PROXY:PORT \
     --build-arg https_proxy=http://YOUR_PROXY:PORT \
     -f Dockerfile -t infiniflow/ragflow:nightly .

   复制

关键配置

如何确认成功

浏览器访问 http://localhost（或你自定义的端口），能看到 RAGFlow 界面即启动成功；也可用 docker compose ps 查看容器状态。

常见问题

注意事项

• 自行构建的镜像约 2 GB，且依赖外部 LLM 与 Embedding 服务。
• 所有配置改动都需要重启全部容器才能生效。
• docker/README 提供了环境变量与各服务配置的详细说明，可作为 service_conf.yaml.template 中 ${ENV_VARS} 的参考。