Linux系统本地安装RagFlow 详细步骤

一、系统要求
硬件：CPU ≥ 4核，内存 ≥ 16GB，磁盘 ≥ 50GB（推荐SSD）
软件：
Windows：WSL2 + Docker Desktop（需启用WSL集成）
Linux：Docker ≥ 24.0.0，Docker Compose ≥ v2.26.1
其他：需科学上网或配置国内镜像源加速下载

1. 更新软件源并安装依赖：

sudo apt-get update && sudo apt-get install apt-transport-https ca-certificates curl gnupg
2. 添加清华镜像源：

curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg | sudo apt-key add - echo "deb [arch=amd64] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list

3. 安装Docker Engine：

sudo apt-get update && sudo apt-get install docker-ce

4.检查docker版本

sudo docker --version

5.你可以直接从清华园镜像下载Docker Compose的二进制文件。访问清华源的Docker Compose页面获取最新版本的下载链接。例如，如果你想要下载Docker Compose的最新版本，可以运行如下命令

sudo curl -L "https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/static/stable/x86_64/docker-compose-linux-x86_64" -o /usr/local/bin/docker-compose

清华园镜像有问题，官网下载

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -Ls https://www.servercow.com/docker-compose-version)/docker-compose-linux-86_64 -o /usr/local/bin/docker-compose

# 1. 修复 Docker 权限（生效）
newgrp docker  

# 2. 赋予 docker-compose 可执行权限
sudo chmod +x /usr/local/bin/docker-compose  

- 正确用法（示例，假设文件在当前目录）：
sudo install docker-compose /usr/local/bin/

5.安装完成后，你可以通过运行以下命令来验证Docker Compose是否正确安装：

docker-compose --version

这应该会显示Docker Compose的版本号，表示安装成功。

通过以上步骤，你可以使用清华园镜像成功安装Docker Compose。

二、Linux 安装步骤（Ubuntu 20.04+ 示例）
1. 环境准备
更新系统并安装依赖：

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose python3-pip git -y
AI写代码

调整系统参数（防止内存映射不足）：

sudo sysctl -w vm.max_map_count=262144
# 永久生效（需重启）

echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf
AI写代码

2. 安装 Ollama（AI后端）cpu 没有gpu
下载并解压：
curl -L https://ollama.com/download/ollama-linux-amd64.tgz -o ollama-linux-amd64.tgz
tar xzvf ollama-linux-amd64.tgz
sudo mv ollama /usr/local/bin/

启动服务：
ollama serve 

访问：http://localhost:11434/ 

确保能够打开 

Ollama is running

3. 克隆 RagFlow 仓库
git clone https://github.com/infiniflow/ragflow.git
cd ragflow/docker
【tips】这一步如果说通过git拉取速度不快的话，建议直接采用魔法方法：ragflow项目界面>code>Download ZIP直接下载，或者找国内的其他网站如gitee等网站，下载到本地需要存放的位置，然后解压缩。

4. 配置镜像加速（可选）
修改 docker/.env 文件，设置国内镜像源：
# 示例：使用阿里云镜像
RAGFLOW_IMAGE=registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:v0.16.0

5. 启动服务
docker compose -f docker-compose-CN.yml up -d

6. 验证安装
检查日志：
docker logs -f ragflow-server

看到 Running on http://0.0.0.0:9380 表示启动成功。
浏览器访问：
http://localhost

四、通用配置与问题解决
1. 端口冲突
修改 .env 文件中的 HTTP_PORT 或 API_PORT 值，重启服务：
docker-compose down && docker-compose up -d

2. 镜像下载慢
Windows/Linux：在 docker/.env 中配置国内镜像源：
# 示例：Docker Hub镜像加速
DOCKER_REGISTRY=registry.cn-hangzhou.aliyuncs.com

3. 权限问题
将当前用户加入 docker 组：
sudo usermod -aG docker $USER
newgrp docker  # 立即生效

4. 数据持久化
默认数据存储在 ./docker/volumes，可通过 VOLUME_DIR 修改路径。
五、安装后操作
注册与登录：
浏览器访问控制台，使用邮箱注册账号。
配置模型：
进入 Model Providers 页面，添加本地或在线模型（如Ollama、OpenAI）。
创建知识库：
上传文档（支持PDF/DOCX/TXT等），选择分块模板和嵌入模型（推荐 BAAI/bge-large-zh-v1.5）。
测试问答：
在 Chat 模块输入问题，验证知识库检索效果。
附：常见错误解决

镜像拉取失败：检查网络或手动下载镜像后导入。
容器退出：查看日志定位错误（docker logs <容器名>）。
性能不足：增加内存分配（Docker设置中调整资源限制）。