大模型本地部署 · 收录于 2026-08-30 · 适用 1 工具 ✓ 实测验证

ollama 装不上/官方安装脚本国内拉不动(下载慢、超时)

已验证 2026-08-30官方安装脚本国内拉不动——gh-proxy 拉 GitHub Release tar.zst 解压到 /usr/local,验证版本(实测可行)。

快速修复

# 一键: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.shollama.com 直连不稳(推断),换 gh-proxy Release
断点续传大文件用 curl -C - 重试
缺 zstdtar: 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 加速拉取。

解法

  1. curl -fsSL -o /tmp/ollama.tar.zst https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/ollama-linux-amd64.tar.zst。
  2. tar --zstd -xf /tmp/ollama.tar.zst -C /usr/local(缺 zstd 先 apt-get install -y zstd)。
  3. 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 list exit 0(实测复现日志(2026-08-29))。

相关 canonical

按「前置 → 同根 / 同域 / 相关」读:

适用工具 (1)

本问题方案已挂到下列工具的方案页——从工具页也能回到这里,双向可达。

ollama

成套方案 (组合包)

这个问题包含在下列成套安装方案中。

来源与证据

收录 验证 ✓ 实测验证适用 1 工具
方案含本地实测或来源可复核的解法;未实测项已在文中如实标注。

← 大模型本地部署 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡