Ollama 下载慢要分成两种:装 Ollama 本体慢,和 ollama pull 拉模型慢。前者去官网 ollama.com 取安装包或跑官方安装脚本;后者官方只提供一种加速方式,设置 HTTPS_PROXY,并且要设到 Ollama 服务进程上。网上流传的"设个镜像变量就起飞"基本不成立,官方并未提供镜像源变量。
先分清:是装 Ollama 慢,还是拉模型慢
- 装本体慢:下载安装包或安装脚本时卡住,慢在浏览器下载条或命令行下载环节,涉及的是官网 ollama.com。
- 拉模型慢:装完之后执行 ollama pull 模型名,速度只有几十 KB/s 或者频繁中断,模型来自官方模型仓库 registry.ollama.ai 。
两者的加速手段不一样,先看清卡在哪一步再动手,省得白折腾。
下载 Ollama 安装包太慢怎么办
官网 ollama.com 是唯一的官方下载入口,官方也提供了脚本化安装,比在浏览器里干等下载条省心:
- Windows:在官网下载页 ollama.com/download 直接取安装包,也可以在 PowerShell 里执行一行命令自动安装。
- Linux:官方安装脚本一行搞定,curl -fsSL https://ollama.com/install.sh | sh。
- macOS:从官网下载页取安装包,或走官方的应用安装渠道。
如果官网和安装脚本都慢,说明是你本机到该站点的网络链路问题,按下一节用官方支持的代理方式处理,而不是去第三方下载站找所谓的"加速包"。
ollama pull 拉模型太慢怎么办
拉模型慢是绝大多数人的痛点。官方文档给出的加速方式只有一种:用 HTTPS_PROXY 把出站请求转向代理。官方同时明确了两条提醒:
- 代理证书需要作为系统证书安装,否则拿到的是 TLS 报错,而不是干净的代理错误。
- 不要设 HTTP_PROXY。Ollama 拉模型只走 HTTPS,设 HTTP_PROXY 反而可能中断客户端与服务端的连接。
最容易踩的坑:这个环境变量必须设到 Ollama 服务进程(后台 daemon) 上,而不是你敲 ollama pull 的那个终端。命令行只是瘦客户端,真正下载的是后台服务,只在终端里 export 通常不起任何作用。
各平台怎么把代理设到 Ollama 服务上
| | |
|---|
| | 执行 systemctl edit ollama.service,在 [Service] 下加 Environment="HTTPS_PROXY=http://代理地址:端口",再 daemon-reload 并重启服务 |
| | launchctl setenv HTTPS_PROXY "http://代理地址:端口",然后重启 Ollama 应用 |
| | 先从托盘退出 Ollama,在"编辑账户环境变量"里新建 HTTPS_PROXY,再从开始菜单重新启动 |
| | 启动容器时加 -e HTTPS_PROXY=http://代理地址:端口 |
这些设置方式都来自官方文档。设完重启服务后,再跑一次同样的 ollama pull 看速度有没有变化。
下载中断、进度清零怎么办
模型动辄几个 GB 到几十 GB,网络一抖就容易断。官方机制下有几件事能救回来:
- 重跑同一条命令即可续传:已完成的分块会保留,重新执行 ollama pull 模型名 会从断点继续,不用从头再来。
- 下载期间别重启服务或关机:Ollama 服务启动时会清理未完成的模型分块,放太久的未完成文件会被删掉,这就是"我重启了一下,进度归零"的来源。
- 用 OLLAMA_NOPRUNE=1 跳过启动清理:这是官方支持的环境变量,作用是禁止启动时清理模型分块文件,适合需要跨重启保住未完成下载的场景。
- 确认磁盘空间够:空间不足会直接导致拉取失败。系统盘紧张时,可用 OLLAMA_MODELS 把模型目录换到大盘,默认路径为 macOS ~/.ollama/models、Linux /usr/share/ollama/.ollama/models、Windows C:\Users\%username%\.ollama\models。
另有一条稳妥的离线思路:在能正常下载的机器上先拉好模型,再把模型存储目录整份拷贝到目标机器,完全绕开在线拉取这一环。
三个常见误区,别再被带偏
| |
|---|
| 官方并未提供镜像源变量,OLLAMA_MIRROR 不是 Ollama 支持项,设了不生效 |
| 它只改模型的存储目录,不改变下载来源,自然不提速;真正价值是换盘、防空间不足导致中断 |
| 它是服务监听地址(默认 127.0.0.1:11434),不是下载源;设成镜像地址通常无效,甚至让服务起不来 |
Ollama 下载提速的注意事项
- 只认官方入口:官网是 ollama.com,模型仓库是 registry.ollama.ai,文档是 docs.ollama.com。官方入口只此一处,建议从官方页面直接进入,不要通过搜索引擎广告位或第三方下载站跳转。
- 别碰来路不明的镜像和"一键加速脚本":凡要求输入账号密码、支付信息,或引导你安装未知程序的非官方页面,都不要提交信息。
- 代理走 HTTPS:只用 HTTPS_PROXY,不要设 HTTP_PROXY;代理证书要装成系统证书。
- 环境变量要设对位置:设到服务进程上,只改终端 shell 通常无效。
- 先看磁盘再谈提速:空间不足和 C 盘爆满是"越下越慢甚至失败"的常见隐性原因。
Ollama 下载太慢常见问题
Q:Ollama 下载慢,官方有镜像源吗?
A:没有。官方未提供镜像源变量,唯一官方支持的加速方式是 HTTPS_PROXY 代理。
Q:为什么在终端 export HTTPS_PROXY 没用?
A:下载由后台服务执行,代理必须设到服务进程上(systemd、launchd、Windows 环境变量、Docker),而不是敲命令的那个终端。
Q:可以设 HTTP_PROXY 一起配吗?
A:不建议。Ollama 拉模型只走 HTTPS,设 HTTP_PROXY 可能中断客户端与服务端的连接。
Q:pull 到一半断了,要重新下吗?
A:不用。重新执行同一条 pull 命令会沿用已完成的分块继续下载。
Q:为什么重启之后下载进度归零了?
A:服务启动时会清理未完成的模型分块。下载期间别重启服务或关机,或设 OLLAMA_NOPRUNE=1 跳过清理。
Q:设 OLLAMA_MODELS 能加速吗?
A:不能,它只改模型存储目录。它的作用是换盘、避免空间不足中断下载。
Q:把 OLLAMA_HOST 设成镜像地址行不行?
A:不行。它是服务监听地址,不是下载源,设成镜像地址通常无效甚至让服务起不来。
Q:安装包本身就下载很慢怎么办?
A:从官网 ollama.com 下载页取安装包或跑官方安装脚本;官网也慢时,按官方代理方式处理,不要走第三方下载站。
Q:模型一般多大,得下多久?
A:模型从几 GB 到几十 GB 不等,耗时取决于体积和你的实际网速。拉之前可以先到官网模型库查清标签和体积再决定。
把安装包和模型分开处理,装本体走 ollama.com,拉模型用官方支持的 HTTPS_PROXY、配好断点续传与磁盘空间,多数 Ollama 下载太慢的情况都能明显缓解。想进一步确认某个模型的体积和标签,到官网模型库查过再拉,能让 Ollama 下载太慢这件事少来找你几回。