## Docker部署Dify与RAGFlow的实用避坑指南 同时部署Dify和RAGFlow，听起来是个好主意——一个负责应用编排，一个专攻文档解析，强强联手。但真正在Docker环境中把它们整合到一起时，往往会踩进几个常见的坑里。端口冲突、服务依赖打架、硬件资源不够……这些问题是真正的高频痛点。下文直接针对这些问题，提供可操作的解决方案，保证你看完后能少走弯路。 ### 一、端口冲突问题 **现象**：Dify和RAGFlow默认都抢占80和443端口，结果其中一个服务直接罢工，谁也启动不了。 **解决方案**： 修改RAGFlow的端口映射，避免它与Dify冲突。在`docker-compose.yml`里进行调整，例如： ```yaml ports: - "8000:80" # 容器80端口映射到主机8000 - "4333:443" # 容器443端口映射到主机4333 ``` 修改后执行`docker-compose up -d`重启服务即可。别忘了检查防火墙——新端口（比如8000、4333）必须保持开放。 ### 二、依赖服务冲突 **现象**：两个系统都使用Redis，默认配置完全一致时，Redis自身就会发生冲突。 **解决方案**： 为RAGFlow的Redis设置独立的端口和密码。在`.env`文件里修改如下： ```bash redis_port=7379 redis_password=自定义密码 ``` Dify那边的Redis配置也应独立开来，避免共用端口或密码。 ### 三、硬件资源不足 **现象**：RAGFlow对机器配置要求不低——CPU至少4核，内存16GB以上，磁盘50GB起步。资源不足时，启动直接失败，或者运行后卡顿如幻灯片。 **解决方案**： 首先检查服务器配置是否满足要求，若略有欠缺，可以为Docker分配更多资源（在Docker Desktop中调整CPU/内存限制）。Linux系统还需修改内核参数： ```bash sudo sysctl -w vm.max_map_count=262144 # 临时生效 sudo vim /etc/sysctl.conf # 永久生效 ``` ### 四、模型集成配置问题 **现象**：打算集成本地模型（例如Ollama），结果API返回未授权错误，或者模型始终无法加载。 **解决方案**： 在RAGFlow中先创建API Key，并记录知识库ID。然后在Dify的`.env`文件里填写RAGFlow的API地址和Key： ```bash API_ENDPOINT=http://:9380/api/v1/dify API_KEY=your_ragflow_api_key ``` 还有一个关键点：**关闭Dify自身的Rerank模型**，直接信任RAGFlow的解析结果，这样可以有效减少冲突。 ### 五、Docker环境问题 **现象（Windows独有）**： - **WSL2未启用**：Docker Desktop无法正常启动。 **解决**：以管理员身份打开PowerShell，运行： ```bash dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all wsl --set-default-version 2 ``` - **镜像拉取失败**：网络问题导致下载超时。 **解决**：切换为国内镜像源，或直接使用预封装的一键安装包，省心省力。 ### 六、文件解析与检索效果问题 **现象**：Dify自带的知识库在处理PDF扫描件、表格等文档时，解析效果往往不尽如人意——出现错位、乱码、内容丢失。 **解决方案**： 将文件交由RAGFlow处理，它的深度文档解析能力（OCR、布局识别）要强大得多。然后在Dify中关联RAGFlow的外部知识库，调整**TopK**（检索数量）和**相似度阈值**，效果立竿见影。 ### 启动后验证步骤 1. **访问服务**： - Dify：`http://:80` - RAGFlow：`http://:8000`（如果修改过端口） 2. **日志排查**： ```bash docker logs -f ragflow-server # 查看RAGFlow日志 docker logs dify-app # 查看Dify日志 ``` 3. **测试知识库**：在Dify中新建应用，关联RAGFlow知识库，抛出几个问题测试，看回答是否准确可靠。 ### 总结建议 - **推荐部署方案**：将Dify和RAGFlow安装在同一台主机上，使用内网IP通信，延迟最低。如果机器配备GPU，RAGFlow的`docker-compose-gpu.yml`可以加速处理。 - **避坑提示**：Windows用户请先处理好WSL2和端口冲突；Linux用户别忘了检查内核参数和资源分配。提前把这些细节理清楚，后续就能顺畅运行。