本地 Ollama 已经跑起来了,RAGFlow 的知识库却一直提示向量化失败,或者传完文件卡在解析那一步不动。多数情况不是模型不行,是地址填了 localhost、模型没提前 pull、维度对不上这几个动作没做对。下面按你实际会卡住的顺序,把配置、验证和排查拆开讲。
本地 Ollama 已经跑起来,RAGFlow 的知识库却提示向量化失败,或者文件传上去卡在解析不动。这活儿麻烦的地方不在模型本身,八成是三个动作没做对:地址填成了 localhost、模型没提前拉、换了模型没管维度。下面按你实际会卡住的先后顺序讲,配置、验证、排查拆开说,照着做能少走几圈。
先摆一个总原则:RAGFlow 只是去调 Ollama 的接口,它自己不会替你下载模型,也不会替你改向量维度。所以顺序是「先确认网络能通,再确认模型在,最后才回界面填」。顺序反了,界面报的错会把你往模型质量上带,白折腾。
先填对地址,再谈模型
RAGFlow 跑在容器里的时候,模型地址那格填 localhost 或者 127.0.0.1 基本必错——它指向的是容器自己,不是你的宿主机。要么写宿主机在容器网络里能访问到的地址,要么两个服务在同一网络下直接用服务名。这一格填错的表现往往是连接超时或者干脆没反应,而不是明确的「地址不对」,特别容易被误判成模型没装好。
- 宿主机上先打一次接口用 curl 调 Ollama 的模型列表接口,确认能返回一坨模型信息。返回不了,说明 Ollama 没对外监听,先解决这个,别去动 RAGFlow。
- 换成容器里的视角再打一次进到 RAGFlow 容器里,用同样的地址再 curl 一遍。这一步过了,说明容器到 Ollama 这条路是通的,再回界面填。
- 地址末尾别加路径只填到主机加端口,后面不要带任何 API 路径。多带一段会表现得像连不上,排查时先看这格有没有多余字符。
模型要先拉下来,再回界面选
RAGFlow 那个模型下拉框,读的是 Ollama 已经装好的模型列表。你没 pull 过,列表里就是空的,界面上看着像「没有可用模型」,其实是本地压根没有。所以顺序是先命令行拉模型,再回来刷新页面选。
还有个常犯的错:把对话模型填进 embedding 那一栏。知识库向量化只认 embedding 模型,生成模型拉得再对也没用。拉完模型重启一次 Ollama 服务,再刷新 RAGFlow 页面,能省掉一轮缓存导致的白等——不重启有时候列表不刷新,你会以为模型没拉上。
- 拉模型和选模型是两步,先命令行 pull,再回界面选,别在空列表里找
- embedding 栏只填 embedding 模型,对话模型填到生成那一栏去
- 拉完重启 Ollama,再刷新页面,避开列表缓存
- 模型名照抄命令行里显示的完整名字,少一段后缀就对不上
维度这关过不了,后面全白搭
向量维度是 embedding 模型自己定的,RAGFlow 里没有地方让你手改。这意味着什么?换了模型,旧知识库的索引就和新向量对不上,得重建索引。同一个知识库里所有文档也必须用同一个 embedding 模型,中途换模型,会出现一部分文档能检索、另一部分怎么都查不出来,这种半好半坏的状态最耗时间。
| 现象 | 大概率原因 | 先查哪里 |
|---|---|---|
| 向量化直接报错 | 地址不通或模型名不对 | 容器内 curl 接口、核对模型完整名 |
| 解析成功但检索为空 | 切片和向量化没跑同一套流程 | 重建索引,确认全程同一个 embedding 模型 |
| 部分文档查不出来 | 中途换过 embedding 模型 | 统一模型后重建整个知识库索引 |
| 下拉框里没有模型 | 本地没 pull 或没重启 | 命令行拉模型、重启服务再刷新 |
维度具体是多少,各家模型不一样,别靠记忆填。到站内 /embeddings 页面核对当时的数字,那里有各模型的维度对照,换模型前先看一眼,能省掉一次重建。
接完怎么验证,卡住怎么分诊
配完别一上来就传整本手册。先建一个只有几段文字的小知识库,跑通上传、解析、检索整条链路,出问题能立刻分清是配置还是文件格式。小库跑通了再上真实资料,这是最省时间的验证方式。
卡住的时候,把生成模型和 embedding 模型分开测。先只验证向量化能不能出结果,这一步过了再测问答。两段混在一起排查,你根本不知道是向量没生成还是生成模型没接上。解析阶段就失败,回去看地址和模型名;解析过了但检索空,去查索引是不是用同一个模型建的。
下一步想核对各 embedding 模型的向量维度和适配情况,去站内对照表看当时的数字,换模型前先比一眼,比事后重建索引划算。→常见问题
Ollama 和 RAGFlow 不在同一台机器上,地址怎么写?
写 Ollama 所在机器的局域网 IP 加上服务端口,别写 127.0.0.1。写之前在那台机器上用 curl 请求一次接口确认监听的是对外地址而不是只绑本地回环,很多「连不上」其实是服务只监听了本机。
换了 embedding 模型,旧知识库还能用吗?
不能直接用。向量维度变了,已有索引就对不上,RAGFlow 里表现为检索结果为空或报错。做法是新建一个知识库重新灌文档,确认新模型跑通再把旧库下线,别在原库上直接改。
为什么模型列表里能看到对话模型,却选不到 embedding 模型?
RAGFlow 是按用途分栏选的,embedding 那一栏只列已经 pull 到本地的向量模型。对话模型出现在生成那一栏是正常的。去 Ollama 里确认向量模型确实拉完了,刷新页面再看。