本地部署 RAGFlow

本地部署 RAGFlow

• 0. RAGFlow 是什么？
• 1. 安装 wsl-ubuntu
• 2. (可选)配置清华大学软件源
• 3. 系统更新和安装构建工具
• 4. 安装 Miniconda3
• 5. 安装 CUDA Toolkit
• 6. 安装 git lfs
• 7. 配置 Hugging Face 的缓存路径
• 8. 配置 vm.max_map_count
• 9. 安装 Docker Engine
• 10. 安装 nginx
• 11. 配置环境变量
• 12. 安装 libgdiplus
• 13. 本地部署 RAGFlow

0. RAGFlow 是什么？

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

1. 安装 wsl-ubuntu

1. 安装 Ubuntu-24.04，默认会安装在 C 盘，

wsl.exe --install -d Ubuntu-24.04

1. 导出 Ubuntu-24.04，

wsl --export Ubuntu-24.04 D:\tmp\Ubuntu-24.04.tar

1. 删除 Ubuntu-24.04，

wsl --unregister Ubuntu-24.04

1. 导入 Ubuntu-24.04，导入到 F:\VirtualPCs\Ubuntu-24.04 目录，

wsl --import Ubuntu-24.04 F:\VirtualPCs\Ubuntu-24.04 D:\tmp\Ubuntu-24.04.tar

1. 访问 Ubuntu-24.04，

wsl

1. 退出 Ubuntu-24.04，

exit

1. (可选)关闭 Ubuntu-24.04，

wsl --shutdown

2. (可选)配置清华大学软件源

1. 为了加速软件安装速度，配置清华大学软件源，

mv /etc/apt/sources.list /etc/apt/sources.list.bak

cat  /etc/apt/sources.list
# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
# 以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换
deb http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
deb-src http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
# 预发布软件源，不建议启用
# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse
EOF

reference: https://mirror.tuna.tsinghua.edu.cn/help/ubuntu/

3. 系统更新和安装构建工具

系统更新，

sudo apt update && sudo apt upgrade

安装构建工具，

sudo apt install build-essential checkinstall
sudo apt install libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev

4. 安装 Miniconda3

1. 下载 Conda 安装脚本，

cd /tmp
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

1. 运行安装脚本，按提示操作，当提示是否初始化 Conda 时,输入 “yes”，

bash Miniconda3-latest-Linux-x86_64.sh
---
Please, press ENTER to continue
>>> yes
Do you accept the license terms? [yes|no]
[no] >>> yes
Miniconda3 will now be installed into this location:
/root/miniconda3
  - Press ENTER to confirm the location
  - Press CTRL-C to abort the installation
  - Or specify a different location below
[/root/miniconda3] >>> ENTER
Do you wish the installer to initialize Miniconda3
by running conda init? [yes|no]
[no] >>> yes
---

1. 安装完成后，激活一下 Conda，

sudo su - root

1. 更新 Conda 至最新版本，

conda update conda

1. 配置用户登录时是否默认激活 Conda 的 base 环境，

如果想默认激活 Conda 的 base 环境，

conda config --set auto_activate_base true

如果不想默认激活 Conda 的 base 环境，

conda