使用docker desktop部署ragflow

### Windows 上使用 Docker 部署 RAGFlow 和 Dify 的解决方案 #### 准备工作 在开始之前，确保已安装 Docker Desktop 并启用 WSL 2 支持。如果尚未完成这些操作，请先下载并安装最新版本的 Docker Desktop[^1]。 #### 安装 Docker Compose 对于 Windows 用户，可以通过 PowerShell 下载 `docker-compose` 可执行文件，并将其放置到系统的 PATH 中以便全局访问。以下是具体命令： ```powershell Start-BitsTransfer -Source "https://github.com/docker/compose/releases/download/v2.32.4/docker-compose-windows-x86_64.exe" -Destination $Env:ProgramFiles\Docker\docker-compose.exe ``` 验证安装是否成功： ```powershell docker-compose --version ``` 此命令应返回类似于以下的内容：`Docker Compose version v2.32.4`[^2]。 #### 获取项目源码 通过克隆官方仓库获取最新的 Ragflow 和 Dify 源码。假设已经安装 Git，则可以在终端中运行以下命令来拉取代码： ```bash git clone https://github.com/dify-ai/dify.git cd dify ``` 同样地，Ragflow 的源码也可以从其 GitHub 页面获得。如果有特定分支或标签，请切换至该版本以保持一致性。 #### 修改 `.env` 文件 进入项目的根目录后，复制默认配置作为基础设置： ```bash cp .env.example .env ``` 编辑生成的 `.env` 文件，添加必要的参数用于连接 Ragflow 实例。例如： ```plaintext CUSTOM_MODEL_ENABLED=true OLLAMA_API_BASE_URL=http://<your-ip>:11435 API_ENDPOINT=http://<RAGFlow_IP>:9380/api/v1/dify API_KEY=<your_ragflow_api_key> ``` 其中 `<your-ip>` 是指代本地机器 IP 地址；而 `<RAGFlow_IP>` 则需替换为实际部署 Ragflow 的主机地址[^4]。 #### 使用 Docker Compose 启动服务 一旦所有的前置条件满足并且环境变量正确无误，便可以利用下面这条指令一键启动所有关联的服务组件： ```bash docker compose up -d ``` 这会以后台模式运行容器化应用程序及其依赖项。完成后可通过浏览器访问指定端口查看效果——通常情况下，默认网址分别为 `http://localhost:80` (针对 Dify Web UI) 和 `http://localhost:8080` (对应于 Ragflow)[^3]。 #### 更新与维护 当未来存在新的功能迭代或者修复补丁时，遵循标准流程停止现有实例、提取远程改动以及重新构建映像即可顺利完成升级过程： ```bash docker compose down git pull origin main docker compose pull docker compose up -d ``` 同时记得定期审查 `.env` 设置是否存在新增字段或是修改过的选项值，必要时候同步调整本地副本内容。 ---

### 如何在 Docker Desktop 中配置或使用 RagFlow 为了在 Docker Desktop 中成功配置并运行 RagFlow，需遵循特定的操作流程。 #### 安装依赖环境 确保已安装 Docker 和 Docker Compose。对于 Windows 或 Mac 用户来说，通常通过安装 Docker Desktop 来获取这两个工具的支持[^1]。 #### 获取 RagFlow 资源 可以通过 Git 克隆命令来获得最新的 RagFlow 项目文件： ```bash git clone https://github.com/infiniflow/ragflow.git ``` 这一步骤会下载整个 RagFlow 的仓库到本地机器上，其中包含了必要的配置文件和其他资源文件[^2]。 #### 配置 Docker 环境变量 (如果需要) 某些情况下可能需要设置一些环境变量以便更好地适配不同的操作系统或者是满足特殊的应用场景需求。这些操作可以在终端中完成，也可以编辑 `~/.bashrc` 文件或者其他 shell 初始化脚本加入相应的 export 命令。 #### 启动 RagFlow 服务 进入克隆下来的 RagFlow 目录之后，可以执行如下指令拉取镜像并且启动容器化应用： ```bash docker pull infiniflow/ragflow:dev docker compose up ragflow -d ``` 上述命令将会从远程仓库拉取消息队列以及其他组件所需的最新版本镜像，并以后台模式启动它们。 #### 使用 Docker Desktop 进行管理 一旦 RagFlow 成功部署，在 Docker Desktop 应用程序界面内就可以看到正在运行的服务实例列表。这里不仅可以查看各个容器的状态信息，还可以方便地停止、重启甚至删除不再使用的实例。此外，Docker Desktop 提供了一个直观的日志查看器用于监控应用程序的行为以及排查可能出现的问题。