快速修复
# 一键:gh-proxy 拉 GitHub Release tar.zst → 解压到 /usr/local → 验证版本
curl -fsSL -o /tmp/ollama.tar.zst https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/ollama-linux-amd64.tar.zst && tar --zstd -xf /tmp/ollama.tar.zst -C /usr/local && ollama --version
你会遇到什么
跑官方 install.sh(或从官网下载安装包)时卡住/超时,几分钟不见进度;或下载到一半断掉。你以为是网络整体挂了——其实官方下载源国内直连不稳,换 GitHub Release 加速通道即可。
本文路径:快速修复(30 秒一段命令)→ 一步步排查(可跳读)→ 原理与变体(症状/原因/证据)。赶时间直接跳到「快速修复」。
为什么会这样
官方安装脚本从 ollama.com 拉取安装包,该域名国内直连不稳(慢/超时)。而 ollama 的安装包本体同时发布在 GitHub Release(ollama-linux-amd64.tar.zst),GitHub 可通过 gh-proxy 类加速站稳定拉取(实测 1.42GB 通过)。
官方安装脚本(curl ... | sh)的本质是「下载器 + 解包器」:它先从 ollama.com 拉安装包(国内直连不稳定 → 慢/超时),再解包到 /usr/local。关键点:同一个安装包本体同时发布在 GitHub Release(ollama-linux-amd64.tar.zst),资产是同一份,只是下载通道不同——换通道不换资产。
gh-proxy 类加速站做的是「代理转发 GitHub Release 下载请求」,把国内直连不稳定的 objects.githubusercontent.com 换成可达的代理域名。
确定性推论:curl -I 分别测 ollama.com 与 gh-proxy 通道即可定位瓶颈在哪个域名;下载后 tar --zstd -xf + 手动放 PATH 与官方脚本产物等价(都只是解包);先确认下载完成再解包,别在下载阶段反复重试同一通道。
一步步来
1. 确认是下载通道问题 — 必做
curl -sI --max-time 10 https://ollama.com/install.sh
超时/000 → 官方源不可达;走 gh-proxy Release 路径。
2. gh-proxy 下载 Release 包 — 必做
curl -fsSL -o /tmp/ollama.tar.zst https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/ollama-linux-amd64.tar.zst
实测:1.42GB(1422262024 bytes,v0.33.2,2026-08-29)。下载量大,网络波动时用 curl -C - 断点续传。
3. 解压(需要 zstd 工具) — 必做
tar --zstd -xf /tmp/ollama.tar.zst -C /usr/local
报 tar: unrecognized option --zstd 先装:apt-get install -y zstd(实测 zstd 1.5.7)。
4. 验证 — 必做
ollama --version
输出 ollama version 0.33.2 即成功(实测形态:客户端版本 0.33.2)。
怎么确认修好了
ollama --version && ollama list
版本号正常 + ollama list 能跑(空表 exit 0)即成功(实测:)。
其它环境的表现
| 环境 | 说明 |
|---|---|
| 官方 install.sh | ollama.com 直连不稳(推断),换 gh-proxy Release |
| 断点续传 | 大文件用 curl -C - 重试 |
| 缺 zstd | tar: unrecognized option --zstd → apt-get install -y zstd(实测) |
| Windows | 用官方安装器(建议 WSL2 内与 Linux 同路径) |
| macOS | 官方 dmg(Apple Silicon 原生) |
| 加速站生命周期 | gh-proxy 类加速站有生命周期,失效时换可达镜像 |
症状
官方 install.sh / 官网下载卡住、超时或中途断掉;ollama 装不上。
原因
官方下载源(ollama.com)国内直连不稳定;安装包本体在 GitHub Release 可通过 gh-proxy 加速拉取。
解法
curl -fsSL -o /tmp/ollama.tar.zst https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/ollama-linux-amd64.tar.zst。tar --zstd -xf /tmp/ollama.tar.zst -C /usr/local(缺 zstd 先apt-get install -y zstd)。ollama --version验证。
验证证据
- 实测(2026-08-29,WSL Ubuntu,codex-ci):gh-proxy 拉取 ollama-linux-amd64.tar.zst(1422262024 bytes = 1.42GB,v0.33.2),tar --zstd(zstd 1.5.7)解压到隔离目录成功,
ollama --version输出客户端版本 0.33.2,ollama listexit 0(实测复现日志(2026-08-29))。
相关 canonical
按「前置 → 同根 / 同域 / 相关」读:
- 相关(报错相近,根因不同):
- ollama pull 卡住/超时(装好后的下载链路)
- 模型目录换盘(默认模型目录与安装方式相关)
适用工具 (1)
本问题方案已挂到下列工具的方案页——从工具页也能回到这里,双向可达。
ollama成套方案 (组合包)
这个问题包含在下列成套安装方案中。
- 本地大模型微调/推理环境(ollama + open-webui + LLaMA-Factory) verified
- 本地知识库问答(ollama + MaxKB) verified
来源与证据
← 大模型本地部署 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡