### 安装和配置 RAGFlow 的方法 尽管 Docker 是一种常见的容器化工具，用于简化应用程序的部署过程，但在某些情况下可能无法使用它。在这种场景下，可以手动安装和配置 RAGFlow 所需的所有依赖项和服务。 以下是实现这一目标的关键步骤： #### 1. **环境准备** 确保操作系统支持 Python 和其他必要的服务组件。通常需要以下基础环境： - Linux 或 macOS 系统 - Python >= 3.8 - pip 工具 - Git (用于克隆项目) 可以通过以下命令安装这些基本工具： ```bash sudo apt update && sudo apt install python3 python3-pip git -y ``` #### 2. **下载 RAGFlow 源码** 通过 Git 克隆项目的仓库到本地机器上： ```bash git clone https://github.com/<repository-url>/ragflow.git cd ragflow/ ``` 注意：上述 `<repository-url>` 需要替换为实际的 GitHub 地址[^1]。 #### 3. **创建虚拟环境并安装依赖** 为了隔离开发环境，建议使用 `venv` 创建独立的 Python 虚拟环境。 ```bash python3 -m venv env source env/bin/activate pip install --upgrade pip setuptools wheel pip install -r requirements.txt ``` 这里假设存在一个名为 `requirements.txt` 的文件来定义所有的 Python 库需求[^4]。 #### 4. **设置数据库 MySQL/MariaDB** RAGFlow 可能会依赖于关系型数据库存储数据。因此需要单独安装 MySQL 并初始化相应的表结构。 ```sql CREATE DATABASE IF NOT EXISTS ragflow CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; GRANT ALL PRIVILEGES ON ragflow.* TO 'your_user'@'localhost' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; ``` 之后更新应用内的连接字符串至正确的主机名、端口以及认证凭证[^2]。 #### 5. **Redis 缓存服务** 同样地，也需要搭建 Redis 实例作为缓存层的一部分。对于生产用途推荐采用稳定版本如 `redis-server=6.x`。 ```bash sudo apt-get install redis-server sudo systemctl start redis.service sudo systemctl enable redis.service ``` #### 6. **MinIO 对象存储** 由于 MinIO 提供 S3 API 兼容的对象存储解决方案，在无 Docker 支持环境下可以直接编译二进制执行文件或者利用官方提供的 RPM/APT 包管理器完成安装流程。 访问官网获取最新版链接地址后运行如下脚本片段： ```bash wget https://dl.min.io/server/minio/release/linux-amd64/minio chmod +x minio ./minio server /data --console-address ":9001" ``` 记得调整路径参数满足个人偏好设定[^3]。 #### 7. **Elasticsearch 文档索引引擎** 最后一步便是引入 Elasticsearch 来处理全文检索功能。考虑到资源消耗较大，最好分配足够的内存给 JVM 堆空间大小(-Xms,-Xmx选项)。 ```bash curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-7.x.list sudo apt update && sudo apt install elasticsearch sudo systemctl daemon-reload sudo systemctl enable elasticsearch.service sudo systemctl restart elasticsearch.service ``` #### 8. **启动 RAGFlow 主程序** 当所有前置条件都已就绪时，就可以尝试调用入口点脚本来激活整个框架逻辑流了。 ```bash export FLASK_APP=app.py flask run --host=0.0.0.0 --port=5000 ```