Download slows to a crawl at 99%

快速结论：该问题发生在 Ollama 拉取大模型时，下载速度在进度达到 98%-99% 后骤降至几十 KB/s 甚至更慢，原因是部分分片连接陷入停滞但连接本身仍健康，未触发重试。优先排查方式是取消当前拉取任务并重新执行 ollama pull，多数情况下可恢复全速下载。

适用环境：Ollama 0.1.17、0.1.18 版本；涉及 Docker（Unraid 6.12.4）和裸机环境；影响 Mistral、llama2:13b-text、70b 模型等多种大模型下载。

最快修复方案：Issue 中多位用户验证有效的方案是：当下载速度明显下降时，按 Ctrl+C 取消当前下载，然后重新执行 ollama pull <模型名>。Ollama 支持断点续传，重新拉取会从已下载部分继续，并恢复全速。

注意事项：该方案并非 100% 有效，个别模型可能需要重复取消重试多次；如果网络本身不稳定（如 Wi-Fi 信号问题），重试效果可能不佳。此方案仅缓解症状，未从根本上修复存储后端导致的连接停滞问题。

问题场景

用户在通过 Ollama 拉取模型时（如 Mistral、llama2:13b-text、70b 模型等），下载速度一开始能跑满带宽（约 13MB/s 或 1Gbps 连接的较高速度），但当进度到达 98%-99% 时，速度骤降至几十 KB/s 甚至几百 KB/s，导致最后几个百分点需要数小时才能完成。部分用户还反馈在进度显示 100% 后，下载仍持续 10 分钟以上。

报错原文

Download slows to a crawl at 99%

2024/01/02 14:05:53 download.go:162: e9e56e8bb5f0 part 22 attempt 0 failed: unexpected EOF, retrying in 1s
2024/01/02 14:05:53 download.go:162: e9e56e8bb5f0 part 46 attempt 0 failed: unexpected EOF, retrying in 1s
pulling a42778cb0676...  99% ▕█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████ ▏ 7.3 GB/7.4 GB   42 KB/s  18m17s

原因分析

根据维护者的分析，Ollama 在下载大文件时会将文件拆分为多个分片（part），并使用多个并发 worker 同时下载以最大化传输速度。问题在于：某些分片的连接会完全停滞，后端不再返回任何数据，但连接本身仍然健康（未断开），因此不会触发 Ollama 的重试机制。当其他分片完成后，这个停滞的分片就会在最后几个百分点中变得非常明显，表现为下载速度骤降。日志中出现的 unexpected EOF 错误与停滞行为有一定关联，虽然 EOF 本身不会造成问题（请求会重试并继续），但它表明存储后端存在异常。

可能原因：Ollama 使用的存储后端（registry）在处理某些分片请求时进入停滞状态，导致特定分片无法获得数据。网络条件（如地理位置、网络运营商）可能加剧此问题，但具体触发条件尚未明确。

环境排查

确认 Ollama 版本（受影响版本：0.1.17、0.1.18，建议升级到包含修复 PR 的更新版本）
运行环境：裸机、Docker（Unraid 6.12.4）
网络环境：千兆宽带、Wi-Fi 连接
模型大小：问题在 13b、34b、70b 等大模型上出现，小模型（如 Tinyllama）未受影响
查看 Ollama 日志（Linux/macOS：journalctl -u ollama 或查看 log 文件；Docker：docker logs <容器名>）以确认是否存在 unexpected EOF 日志

解决步骤

取消当前下载：在下载速度显著下降时，按 Ctrl+C 取消正在进行的 ollama pull 命令。
重新执行拉取：再次运行 ollama pull <模型名>。Ollama 会从已下载的部分继续，通常能以全速完成剩余部分。如果速度再次下降，可重复此操作。
检查网络稳定性：如果使用 Wi-Fi，可尝试切换到有线连接；如果重试无效，检查网络设备（如重启路由器）。但需注意，部分用户反馈重启网络后速度反而下降，此操作并非可靠方案。
升级 Ollama 版本：该问题在 Issue 提交后已有相关 PR 用于检测停滞连接并主动重置，建议升级到最新稳定版以获得修复（Issue 讨论中未提供具体修复版本号）。
查看日志确认问题：如果问题持续，运行 ollama pull 时在另一终端查看日志，寻找 download.go 中的 unexpected EOF 或分片停滞记录，用于进一步定位。