[Question]: Welcome to nginx when launching from source

从源码启动 RAGFlow 时,浏览器却返回 nginx 默认欢迎页,通常说明启动入口脚本 docker/entrypoint.sh 里的 nginx 启动行被执行,nginx 占用了前端访问端口,用户没有看到 RAGFlow 前端。优先检查该脚本里的 nginx 启动语句。

快速结论:从源码启动 RAGFlow 时,浏览器却返回 nginx 默认欢迎页,通常说明启动入口脚本 docker/entrypoint.sh 里的 nginx 启动行被执行,nginx 占用了前端访问端口,用户没有看到 RAGFlow 前端。优先检查该脚本里的 nginx 启动语句。

适用环境:Issue 已确认的场景是 RAGFlow 源码方式启动(front 与 backend 服务已启动);操作系统、Python、CUDA、显卡与依赖版本在 Issue 中未提供。

最快修复方案:Issue 中给出的处理方式是可优先尝试:在 docker/entrypoint.sh 中将启动 nginx 的那一行注释掉,避免 nginx 启动,然后按官方源码启动文档重启后端服务。

注意事项:该方案来自 Issue 评论中的建议,未在讨论链中得到提问者回执验证;注释 nginx 行会影响依赖该脚本完成反向代理/静态资源转发的行为,请确认当前启动流程不需要 nginx,并在改动前备份脚本。

问题场景

用户在源码方式启动 RAGFlow 时,已启动前端与后端服务,但浏览器访问到的是 nginx 的默认欢迎页,而不是 RAGFlow 界面。触发点与 docker/entrypoint.sh 中 nginx 的启动行为有关。

报错原文

Welcome to nginx!
If you see this page, the nginx web server is successfully installed and working. Further configuration is required.

原因分析

可能原因:源码启动流程中执行了 docker/entrypoint.sh,其中启动 nginx 的语句使 nginx 先于或替代 RAGFlow 前端占用访问端口,因此浏览器返回 nginx 默认页面。Issue 评论给出的判断是注释掉该 nginx 启动行即可阻止这一页面出现。

环境排查

  • 确认是否通过源码方式启动 RAGFlow,并检查启动过程是否会执行 docker/entrypoint.sh。
  • 确认 docker/entrypoint.sh 中启动 nginx 的语句是否处于启用状态。
  • 确认访问端口上实际监听的服务是 nginx 还是 RAGFlow 前端。
  • Python、CUDA、PyTorch、显卡与依赖版本在 Issue 中未提供,暂不作为排查依据。

解决步骤

  1. 打开 RAGFlow 仓库中的 docker/entrypoint.sh。
  2. 找到启动 nginx 的那一行,并将其注释掉,避免脚本启动 nginx。
  3. 按官方源码启动文档(docs/develop/launch_ragflow_from_source.md)重新启动后端服务,确保改动生效。
  4. 重新访问 RAGFlow 前端地址,确认不再落到 nginx 默认页。

验证方法

重启后端服务后刷新浏览器,页面应显示 RAGFlow 前端界面而非 nginx 欢迎页;同时可确认访问端口对应的服务已不再是 nginx。若仍显示 nginx 页面,说明仍有其他 nginx 实例在运行或占用端口,需要继续排查端口监听情况。

参考来源

infiniflow/ragflow #7401

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 34630

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注