model not found 在 Ollama 里是一个结果性报错,不是网络超时那一类。它表示 Ollama 实际访问的 registry 对这个模型名或标签返回了不存在,或者本地模型清单里没有对应条目。排查镜像源配置之前,先确认三件事:本地列表里有没有 qwen2.5;Ollama 进程当前用的 registry 是不是你以为的那个;qwen2.5 在默认 registry 上有没有你需要的标签。镜像源配置只影响第二项,改错位置反而会把原本可用的模型挡在门外。
先确认模型是否真的在本地
先执行 ollama list,看输出里有没有 qwen2.5。如果没有,说明报错来自拉取阶段;如果有,说明本地有模型但运行阶段没能完成加载,可能是指定标签与本地文件不匹配,或模型文件不完整。两种情况处理方向不同,不要混在一起排查。
- 检查点:
ollama list的输出;报错是在输入命令后立即出现,还是先显示 pulling 一段时间后才出现。 - 处理动作:模型缺失时先执行
ollama pull qwen2.5:7b;模型在本地时检查模型目录~/.ollama/models的权限和剩余磁盘空间。 - 验证信号:pull 能开始下载,说明 registry 通路正常;pull 立即返回 model not found,再进入镜像源排查。
- 风险边界:磁盘不足或模型目录权限异常会表现为拉取中断或加载失败,而不是 model not found,这类情况不要靠改镜像源解决。
镜像源配置从哪几处查
Ollama 没有把镜像源写在唯一的全局配置文件里。常见改法分散在三处:shell 初始化文件里的 OLLAMA_* 环境变量、系统服务单元文件里的 Environment= 行、/etc/hosts 里对 registry.ollama.ai 的手动解析。改过其中任意一处,Ollama 访问的 registry 就可能不是你预期的那一个。
- 用
env | grep OLLAMA和grep OLLAMA ~/.bashrc ~/.zshrc查看 shell 层配置。 - 用
systemctl cat ollama查看服务单元里的环境变量段;macOS 或手动启动的场景,直接看启动脚本。 - 用
grep registry.ollama.ai /etc/hosts查看是否有自定义解析。
处理动作是一次只改一处,改完重启服务再拉一次模型。同时改多处,环境变量、服务参数、hosts 解析之间会互相覆盖,无法判断哪一项生效。验证信号以 ollama pull qwen2.5:7b 的结果为准,不要用 ollama list 判断 registry 是否通,因为本地有缓存时 list 不会访问网络。
不带 tag 的 qwen2.5 是独立分支
qwen2.5 在 Ollama 里通常以参数量区分标签,例如 qwen2.5:7b、qwen2.5:14b。不带 tag 执行 ollama run qwen2.5 时,Ollama 会解析成 latest 标签;如果当前 registry 没有为 qwen2.5 提供 latest,就会直接报 model not found。这个问题和镜像源配置无关,但表现完全一样,而且配置了镜像源后更容易被误判成镜像源故障。
先执行 ollama run qwen2.5:7b。如果带 tag 能正常下载或运行,说明 registry 通路没问题,后续直接用带 tag 的命令即可,或在镜像源确认 latest 是否存在。风险边界是不同 tag 对应不同模型规格,7b、14b 等需要的内存不同,先选本地硬件能跑动的规格,不要把 tag 选择当成镜像源修复步骤。
用 registry API 验证镜像源是否真的提供 qwen2.5
镜像源有两种工作方式:完整转发上游请求,或只返回自己缓存过的模型。后者在第一次请求 qwen2.5 时可能直接返回不存在,这属于镜像源内容缺失,不是本地配置问题。可以在运行 Ollama 的同一台机器上请求 registry API v2 的标签列表,观察响应。
curl -s https://registry.ollama.ai/v2/library/qwen2.5/tags/list
如果配置了镜像源,把主机名换成镜像源地址。默认 registry 和部分镜像源会要求鉴权,返回 401 不代表模型不存在;返回 404 或空标签列表,才说明这个源没有提供 qwen2.5。也有镜像源支持直接请求 manifest:
curl -i "https://registry.ollama.ai/v2/library/qwen2.5/manifests/7b" -H "Accept: application/vnd.docker.distribution.manifest.v2+json"
200 表示 tag 存在,404 表示不存在,401 或 403 需要先按该镜像源的鉴权策略处理。这个检查必须在 Ollama 所在机器上做,本机结果才能代表 Ollama 实际看到的内容。
回退到已知可用的基线
如果以上分支都没有命中,最保守的做法是暂时回到默认配置:注释掉所有 OLLAMA_* 导出语句,删掉 /etc/hosts 里 registry.ollama.ai 的自定义解析,重启 Ollama,用 ollama pull qwen2.5:7b 验证。默认 registry 不可达时,服务会报连接类错误而不是 model not found,这也能反过来确认之前的镜像源确实在对请求做响应。
本地已有模型仍报 model not found 时,优先检查 ollama list 里的标签是否和运行命令完全一致,并确认模型目录没有被部分清理。模型名、标签、registry 路径三者一致,是这个问题收敛的最短路径。