快速结论:从源码启动 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 中未提供,暂不作为排查依据。
解决步骤
- 打开 RAGFlow 仓库中的
docker/entrypoint.sh。 - 找到启动 nginx 的那一行,并将其注释掉,避免脚本启动 nginx。
- 按官方源码启动文档(
docs/develop/launch_ragflow_from_source.md)重新启动后端服务,确保改动生效。 - 重新访问 RAGFlow 前端地址,确认不再落到 nginx 默认页。
验证方法
重启后端服务后刷新浏览器,页面应显示 RAGFlow 前端界面而非 nginx 欢迎页;同时可确认访问端口对应的服务已不再是 nginx。若仍显示 nginx 页面,说明仍有其他 nginx 实例在运行或占用端口,需要继续排查端口监听情况。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。
![[Question]: The retrieval testing of the knowledge base encountered an issue when flipping through the retrieved results.](https://www.chat-gpts.plus/wp-content/uploads/2026/11/8555-c8061813-768x403.jpg)
![[Bug]: KeyError: 'results'](https://www.chat-gpts.plus/wp-content/uploads/2026/11/6157-6e18c3a5-768x403.jpg)
