本地部署 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

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

<code>wsl.exe --install -d Ubuntu-24.04

导出 Ubuntu-24.04，

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

删除 Ubuntu-24.04，

wsl --unregister Ubuntu-24.04

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

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

访问 Ubuntu-24.04，

wsl

退出 Ubuntu-24.04，

exit

(可选)关闭 Ubuntu-24.04，

wsl --shutdown

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

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

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

cat << EOF > /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

下载 Conda 安装脚本，

cd /tmp

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

运行安装脚本，按提示操作，当提示是否初始化 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

---

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

sudo su - root

更新 Conda 至最新版本，

conda update conda

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

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

conda config --set auto_activate_base true

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

conda