启动RAGflow

### 启动 RAGflow 服务的方法 启动 RAGflow 服务涉及多个方面的配置和操作，具体包括 API 密钥的设置、依赖服务的管理以及环境兼容性的调整。以下是详细的说明： #### 配置 API 密钥 在启动 RAGflow 前，可以通过修改 `service_conf.yaml` 文件来预先配置 API 密钥[^1]。此文件通常位于项目的根目录下或指定的配置路径中。编辑该文件时，需找到与 API 密钥相关的字段，并按照文档中的格式填写对应的密钥。 如果未提前完成此项配置，也可以通过登录 RAGflow 的后台管理系统，在 **模型提供者页面** 中手动输入或更新 API 密钥。 --- #### 处理服务间的依赖关系 RAGflow 是一个多组件的服务架构，可能依赖于其他外部服务（如数据库）。为了确保这些服务能够按顺序正常启动，可以在 Docker Compose 文件中使用 `depends_on` 和 `condition: service_healthy` 来控制启动逻辑[^2]。例如： ```yaml services: mysql: image: mysql:latest environment: MYSQL_ROOT_PASSWORD: example_password healthcheck: test: ["CMD", "mysqladmin" , "ping", "-h", "localhost"] timeout: 20s retries: 5 ragflow: build: . ports: - "8000:8000" depends_on: mysql: condition: service_healthy ``` 上述 YAML 片段展示了如何让 RAGflow 等待 MySQL 完全初始化后再继续执行其自身的启动流程[^2]。 --- #### Windows 环境下的特殊处理 对于 Windows 用户来说，RAGflow 的源码部署可能会遇到一些额外的技术挑战。特别是 FastText 库的版本问题可能导致构建失败。解决方案如下[^3]： 1. 修改项目根目录下的 `pyproject.toml` 文件，将 FastText 的版本从 `0.9.3` 更改为可用的较低版本（如 `0.9.2`）。 ```toml [tool.poetry.dependencies] fasttext = "^0.9.2" ``` 2. 下载预编译好的 FastText whl 文件并安装。可以从 PyPI 或第三方资源获取适合当前 Python 版本和操作系统平台的 wheel 包。 3. 执行以下命令重新安装依赖项： ```bash pip install --force-reinstall ./path_to_whl/fasttext-0.9.2.whl poetry lock && poetry install ``` --- #### 启动 RAGflow 服务 完成以上准备工作后，可以根据实际需求选择不同的方式启动 RAGflow： 1. **Docker 方式** 如果已编写好 Dockerfile 和 docker-compose.yml，则可以直接运行以下命令： ```bash docker-compose up --build ``` 此命令会自动拉取镜像、创建容器并启动所有关联的服务。 2. **本地开发模式** 对于开发者而言，更倾向于直接调用脚本来测试功能。进入项目根目录后，依次执行以下指令： ```bash poetry shell python main.py start ``` ---