主配置文件存放在/etc/vsftpd.conf，使用sudo nano /etc/vsftpd.conf命令打开进行修改

1.2 ftp客户端
sudo apt install FileZilla
连接测试‌：在电脑上用 FileZilla 等工具，输入服务器 IP、刚才建的用户名和密码，能列出文件就说明成功了 。

2 WPS办公软件
地址：wps.cn
下载linux版本：
wps-office_12.1.2.25882.AK.preread.sw.Personal_662820_amd64.deb
安装方法：
sudo dpkg -i wps-office_12.1.2.25882.AK.preread.sw.Personal_662820_amd64.deb
如果出现依赖错误‌（提示 "dependencies problems" 或 "unmet dependencies"），请立即运行以下命令修复：
sudo apt install -f
这条命令会自动下载并安装缺失的依赖，完成之前的安装过程。

3 影音播放软件
sudo apt install vlc

4 微信

weixin.qq.com

5 wireshark 网络抓包工具

sudo apt install wireshark

Docker
Install using the apt repository
Before you install Docker Engine for the first time on a new host machine, you need to set up the Docker apt repository. Afterward, you can install and update Docker from the repository.

Set up Docker's apt repository.


# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update



安装最新版
To install the latest version, run:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin


After installation, verify that Docker is running:

 sudo systemctl status docker

If Docker is not running, start it manually:

 sudo systemctl start docker


Verify that the installation is successful by running the hello-world image:

 sudo docker run hello-world

docker镜像配置文件：

/etc/docker/daemon.json

内容：
{
  "registry-mirrors": [
    "https://docker.xuanyuan.me"
  ]
}

刷新配置
sudo systemctl daemon-reload
sudo systemctl restart docker


一

# 1. 查看镜像源配置
docker info | grep -A 5 "Registry Mirrors"

# 2. 拉取MinIO最新镜像
docker pull minio/minio:latest

# 3. 启动MinIO容器（包含Web控制台）
docker run -d \
  -p 9000:9000 \
  -p 9090:9090 \
  --name minio \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD=admin123 \
  -v /usr/local/minio/data:/data \
  minio/minio server /data --console-address :9090

# 4. 访问MinIO控制台：http://localhost:9090


二

# 拉取RAGFlow专用的Elasticsearch 8.11.3镜像
docker pull crpi-2ix4w0sw61gwpv0x.cn-shanghai.personal.cr.aliyuncs.com/intsig_acg/elasticsearch:8.11.3

三
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/valkey/valkey:8-alpine

ragflow


前提条件
CPU >= 4 核
RAM >= 16 GB
Disk >= 50 GB
Docker >= 24.0.0 & Docker Compose >= v2.26.1
Python >= 3.13
gVisor: 仅在你打算使用 RAGFlow 的代码执行器（沙箱）功能时才需要安装。

如果你并没有在本机安装 Docker（Windows、Mac，或者 Linux）, 可以参考文档 Install Docker Engine 自行安装。https://docs.docker.com/engine/install/


启动服务器
1 确保 vm.max_map_count 不小于 262144：

如需确认 vm.max_map_count 的大小：

$ sysctl vm.max_map_count
如果 vm.max_map_count 的值小于 262144，可以进行重置：

# 这里我们设为 262144:
$ sudo sysctl -w vm.max_map_count=262144
你的改动会在下次系统重启时被重置。如果希望做永久改动，还需要在 /etc/sysctl.conf 文件里把 vm.max_map_count 的值再相应更新一遍：

vm.max_map_count=262144

2 克隆仓库：

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

3 进入 docker 文件夹，利用提前编译好的 Docker 镜像启动服务器：



$ cd ragflow/docker

# git checkout v0.25.6
# 可选：使用稳定版本标签（查看发布：https://github.com/infiniflow/ragflow/releases）
# 这一步确保代码中的 entrypoint.sh 文件与 Docker 镜像的版本保持一致。

# Use CPU for DeepDoc tasks:
$ docker compose -f docker-compose.yml up -d

# To use GPU to accelerate DeepDoc tasks:
# sed -i '1i DEVICE=gpu' .env
# docker compose -f docker-compose.yml up -d

RAGFlow image tag v0.21.1  Image size (≈9GB) Has embedding models  Stable release 从 RAGFlow image v0.22.0 开始，我们只发布 slim 版本，并且不再在镜像标签后附加 -slim 后缀。


Tip

如果你遇到 Docker 镜像拉不下来的问题，可以在 docker/.env 文件内根据变量 RAGFLOW_IMAGE 的注释提示选择华为云或者阿里云的相应镜像。

华为云镜像名：swr.cn-north-4.myhuaweicloud.com/infiniflow/ragflow
阿里云镜像名：registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow

4 服务器启动成功后再次确认服务器状态：

$ docker logs -f docker-ragflow-cpu-1
出现以下界面提示说明服务器启动成功：

     ____   ___    ______ ______ __
    / __ \ /   |  / ____// ____// /____  _      __
   / /_/ // /| | / / __ / /_   / // __ \| | /| / /
  / _, _// ___ |/ /_/ // __/  / // /_/ /| |/ |/ /
 /_/ |_|/_/  |_|\____//_/    /_/ \____/ |__/|__/

 * Running on all addresses (0.0.0.0)

5 在你的浏览器中输入你的服务器对应的 IP 地址并登录 RAGFlow。

6 在 service_conf.yaml.template 文件的 user_default_llm 栏配置 LLM factory，并在 API_KEY 栏填写和你选择的大模型相对应的 API key。

详见 llm_api_key_setup。

好戏开始，接着奏乐接着舞！

系统配置
系统配置涉及以下三份文件：

.env：存放一些基本的系统环境变量，比如 SVR_HTTP_PORT、MYSQL_PASSWORD、MINIO_PASSWORD 等。
service_conf.yaml.template：配置各类后台服务。
docker-compose.yml: 系统依赖该文件完成启动。
请务必确保 .env 文件中的变量设置与 service_conf.yaml.template 文件中的配置保持一致！

如果不能访问镜像站点 hub.docker.com 或者模型站点 huggingface.co，请按照 .env 注释修改 RAGFLOW_IMAGE 和 HF_ENDPOINT。

./docker/README 解释了 service_conf.yaml.template 用到的环境变量设置和服务配置。

如需更新默认的 HTTP 服务端口(80), 可以在 docker-compose.yml 文件中将配置 80:80 改为 <YOUR_SERVING_PORT>:80。

所有系统配置都需要通过系统重启生效：

$ docker compose -f docker-compose.yml up -d
把文档引擎从 Elasticsearch 切换成为 Infinity
RAGFlow 默认使用 Elasticsearch 存储文本和向量数据. 如果要切换为 Infinity, 可以按照下面步骤进行:

停止所有容器运行:

$ docker compose -f docker/docker-compose.yml down -v
Note: -v 将会删除 docker 容器的 volumes，已有的数据会被清空。

设置 docker/.env 目录中的 DOC_ENGINE 为 infinity.

启动容器:

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

Infinity 目前官方并未正式支持在 Linux/arm64 架构下的机器上运行.

网络连接不显示问题排查与修复（待完善）