[Question]: Novice, seek help from the boss – prompt for gateway timeout issue

快速结论：此报错通常发生在 RAGFlow 从源码启动时，前端请求被代理转发到后端服务 9380 端口时遭拒（ECONNREFUSED），优先排查 docker/service_conf.yaml.template 与 docker/.env 中的端口配置是否一致，以及后端 Python 服务是否正常运行。

问题场景

用户在本地开发环境中通过源码启动 RAGFlow（launch from source code），访问 Web 界面或发送 API 请求时，浏览器/代理显示网关超时错误。

报错原文

[HPM] Error occurred while proxying request localhost:9222/v1/user/info to http://127.0.0.1:9380/ [ECONNREFUSED]
[HPM] Error occurred while proxying request localhost:9222/v1/kb/list?page=1&page_size=30&keywords= to http://127.0.0.1:9380/ [ECONNREFUSED]

原因分析

根据 Issue 讨论中的用户反馈与维护者响应，该问题由以下原因导致：

可能原因一（已确认可解决）：配置文件 docker/service_conf.yaml.template 中的端口（尤其是 9380 等后端服务端口）与 docker/.env 中的端口配置不一致。修改后即可成功从源码启动。
可能原因二：RAGFlow 的后台 Python 服务（python api/ragflow_server.py）并未正常启动，导致 9380 端口上没有进程监听，代理转发时返回 ECONNREFUSED。
可能原因三：部分用户反映该问题仅在源码部署时出现，与部署文档版本有关；英文部署文档中包含了必要的配置修改说明，中文文档可能缺失。

环境排查

确认操作系统及 Node.js 版本（用于 HPM 代理）。
确认 Python 版本及是否已安装所有依赖（如 requirements.txt）。
确认 docker/.env 和 docker/service_conf.yaml.template 两个文件中的端口、IP 等参数完全一致。
确认后端服务是否在运行：ps aux | grep ragflow_server.py 或 python api/ragflow_server.py 是否无报错退出。
使用 netstat -tlnp | grep 9380 确认 9380 端口是否有进程在监听。

解决步骤

确保已阅读英文部署文档：Launch RAGFlow from Source，中文文档可能缺少关键配置步骤。
可优先尝试：检查并修改 docker/service_conf.yaml.template，将其中的端口参数（例如 port: 9380 或其他服务端口）调整至与 docker/.env 中的配置一致。注意两份文件中的端口、主机名等所有参数必须统一。
重新启动 RAGFlow 服务（包括 Python 后端和前端代理）。
若问题依旧，检查后端的 Python 进程是否运行正常：在终端直接执行 python api/ragflow_server.py，观察是否有报错信息输出。确保没有端口被占用或缺少依赖。
确认代理端口（如 9222）和转发目标端口（9380）都已正确监听。可使用 curl http://127.0.0.1:9380/v1/user/info 等请求直接测试后端服务是否可访问。

验证方法

修改配置并重启后，尝试再次访问 RAGFlow Web 界面或发送 API 请求（如 localhost:9222/v1/user/info），检查是否仍然出现 ECONNREFUSED 或 gateway timeout 错误。若不再出现，且后端日志无异常，则问题解决。

参考来源

infiniflow/ragflow #6089

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[Question]: Novice, seek help from the boss – prompt for gateway timeout issue