Linux系统： docker安装RagFlow教程

前提条件

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

安装步骤

1. 系统配置

1.1 设置内核参数（Elasticsearch必需）

# 检查当前值
sysctl vm.max_map_count# 临时设置为262144
sudo sysctl -w vm.max_map_count=262144# 永久生效（重启不丢失）
echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf

2. 安装Docker与Docker Compose

2.1 卸载旧版本（如有）

sudo apt remove docker docker-engine docker.io containerd runc -y

2.2 安装Docker依赖

sudo apt update && sudo apt upgrade -y
sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y

2.3 添加Docker官方GPG密钥

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

2.4 添加Docker仓库

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

2.5 安装Docker

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io -y

2.6 安装Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/v2.26.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

2.7 配置国内镜像加速（可选）

sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors": ["https://docker.1panel.live", "https://dockerproxy.cn"]
}
EOFsudo systemctl daemon-reload && sudo systemctl restart docker

3. 部署RAGFlow

3.1 克隆仓库

git clone https://github.com/infiniflow/ragflow.git
cd ragflow/docker
chmod +x ./entrypoint.sh

3.2 启动服务（CPU版）

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

3.3 启动服务（GPU加速版，需NVIDIA驱动）

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

验证服务

1. 检查容器状态

docker ps | grep ragflow

2. 查看服务日志

docker logs -f ragflow-server

3. 访问Web UI

在浏览器中打开：http://<服务器IP>:8080

常见问题处理

1. 端口冲突

修改docker-compose.yml中的端口映射：

ports:- "8080:80"  # 将80端口映射到主机8080端口

2. 镜像拉取缓慢

使用国内镜像源（已在步骤2.7配置）或直接指定国内镜像：

# 修改.env文件
RAGFLOW_IMAGE=registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:v0.19.0

3. 服务启动失败

检查系统资源是否满足最低要求，特别是内存是否≥16GB。