记录一些我自己遇到的问题安装与升级RAGFlow的过程均查阅了官网手册Quickstart | RAGFlow下面是遇到的一些问题注配置文件截图中的行数取自v0.26.2版本RAGFlow截图附带这个行数也是为了进一步方便大家定位要修改字段的位置如果后续新版本造成配置文件格式或配置文件内容发生了增减变化图中的行数未必准确需要通过搜索相关字段来重新确定修改的位置问题1运行entrypoint.sh时报错cat: /ragflow/VERSION: No such file or directory解决1在ragflow根目录下创建一个VERSION文件内容只写一行版本号比如v0.26.2再次执行entrypoint.sh启动脚本如仍然报错把/ragflow/VERSION更换为绝对路径具体可用pwd查一下后面如有其它的类似/ragflow开头的找不到文件的错误也一并更换为绝对路径这个路径问题应该也能通过设置环境变量的方式解决问题2运行entrypoint.sh时报错cp: /etc/nginx/conf.d/ragflow.conf.python: No such file or directory解决2注释掉Nginx相关字样将entrypoint.sh从Select Nginx Configuration based on API_PROXY_SCHEME到# Function(s)中间的内容全部注释掉然后将Starting nginx下面的/usr/sbin/nginx也注释掉这一项/usr/sbin/nginx需要注释的问题官方手册也提到过再次执行entrypoint.sh启动脚本问题3运行entrypoint.sh时报错ModuleNotFoundError: No module named infinity.rag_tokenizer解决3未处在venv虚拟环境里执行启动脚本具体是看CLI前面的(ragflow)提示符如下图如果没有(ragflow)提示符的话执行source .venv/bin/activate进入虚拟环境再次执行entrypoint.sh启动脚本因为官方手册步骤是在vnev虚拟环境里安装的RAGFlow依赖前置组件如果打开新终端窗口后未处在虚拟环境缺少前置组件就会报上述错误问题4执行启动脚本后出现MySQL连接报错 2003, Cant connect to MySQL server on mysql ([Errno 61] Connection refused)解决4修改下列端口配置①ragflow/docker/.env文件的ES_PORT字段的9200修改为1200②ragflow/docker/.env文件的MYSQL_PORT字段、EXPOSE_MYSQL_PORT字段的3306均修改为5455③ragflow/docker/service_conf.yaml.template的es部分hosts: http://${ES_HOST:-es01}:9200的9200修改为1200mysql部分MYSQL_PORT字段的3306修改为5455与上面的端口号同步这里修改mysql字段端口号时不要删除端口号前的横线然后用docker-compose重启一下RAGFlow相关的容器应用上述配置docker compose -f docker/docker-compose-macos.yml downdocker compose -f docker/docker-compose-macos.yml up -d再次执行启动脚本问题5终端窗口使用commandc“停止”RAGFlow后端服务后窗口仍反复滚动输出日志解决5关闭这个终端窗口重新打开一次也需要重新激活虚拟环境但要注意commandc并没有真正停止掉RAGFlow后端服务真正停止方法是pkill -f docker/entrypoint.sh或pkill -f ragflow_server.py具体用哪一种取决于你用哪种方法启动的服务如通过ragflow_server.py启动服务则只需pkill -f ragflow_server.py如通过enterpoint.sh启动服务则两个pkill地方都要做当然也可以通过查询进程与kill的方法停止服务下为过程ps -ef|grep ragflow查一下是不是RAGFlow进程还在后台运行其中vite那个是前端web进程ragflow_server.py那个是后端进程如果有发现这个进程存在则kill -9 PID图中是31674不论用entrypoint.sh启动还是用ragflow_server.py启动后端进程都是ragflow_server.py因为entrypoint.sh最终也调用ragflow_server.py问题6执行python api/ragflow_server.py后报错[Errno 48] Address already in use解决6注释掉docker-compose-macos.yml里的- ${SVR_HTTP_PORT}:9380这一行再次执行启动脚本再不行的话通过解决5里的方式终止后端服务再次执行脚本注如果是用entrypoint.sh启动服务表象可能会启动成功但是进入RAGFlow页面会反复报500错误此时往前翻一下启动日志如存在类似上述端口冲突报错的话也用同样方法解决不过目前官方手册已经建议直接用ragflow_server.py启动服务了问题7RAGFlow在模型提供商页面通过Ollama添加本地模型时验证模型报Fail to access model(Ollama/xxx:xb) using this api key.No valid response received解决7出现这个报错的话其实在第一次配置完Ollama的实例名称和基础Url展开模型列表准备配置模型时右上角就已经弹出102 Internal server error的错误了原因是http://host.docker.internal:11434这个地址DNS解析没成功之前我都用这个地址不知为何这次解析不了了直接浏览器输入http://host.docker.internal:11434也报DNS找不到的错误解决方法是不用http://host.docker.internal:11434改用http://localhost:11434验证成功后按确认键即可添加上模型问题8RAGFlow部分页面打不开报类似图中的Something went wrong解决8这个时候web服务的那个终端窗口通常也会有报错信息的根据具体报错信息确定如何解决①报The service is no longer running的错误此时在该窗口按commandc或是从另一个终端窗口pkill npm停止web服务再次npm run dev启动服务如果web服务中有类似下图的警告信息还可能要配合警告信息里的npx update-browserslist-dblatest命令解决问题有关这个命令的作用见其他作者写的这篇文章npx update-browserslist-dblatest 这个命令是做什么的为什么要执行这个命令。-CSDN博客②报Failed to resolve import xxx from xxx. Does the file exist?的错误这种错误是尝试导入该页面功能必需模块时未找到模块通常是未安装比如图中的remark-breaks和extend-ai/react-docx通过npm安装一下缺失模块再次刷新页面如果刷新页面后仍然报Something went wrong说明仍有必需模块未满足再次返回日志窗口查看缺失的模块名称并安装上面是我目前遇到的一些报错和解决方法其中有些跟升级相关的报错本身是官方手册里是写过的初次安装会规避但是一旦升级RAGFlow版本后原来一些配置文件被新版配置文件覆盖于是再次出现了上述报错还有那个VERSION文件升级版本后重新修改一下里边的版本号如果重新开了一个全新的ragflow目录这个VERSION文件因为原版是没有的需要重新创建一下随着RAGFlow的不断更新上述步骤、脚本内容、界面都可能会发生变化也可能会有新的模块依赖关系比图remark-breaks和extend-ai/react-docx这两个模块缺失是发生在聊天对话界面的我在早期版本没遇到过这个问题也能正常打开界面进行对话v0.26.2再次打开聊天页面就报这个错误了上述为我遇到的部分问题及处理过程如后续有新问题还会继续更新