解决ollama模型下载失败——Ollama官方模型离线安装（linux系统）

使用ollama加载更新模型，需要到ollama的服务器拉取模型文件，因为文件较大，即使能联通ollama服务器，受网络限制常常拉取失败，本文提供一种通过手动下载官方模型文件并安装的方法。

• 需要条件：能够连通外网
• 笔者服务器是linux系统，但是omdd工具也支持其它平台

一、 步骤

1. 使用omdd工具获取所需模型的下载链接
2. 自行下载所需文件
3. 修改文件名称
4. 使用omdd工具完成模型安装

二、ollama模型文件存储和下载逻辑

当我们在命令行执行ollama pull命令后，ollama服务端收到请求并执行下载逻辑

1. 获取清单（Manifest）：下载模型的 JSON 清单。

2. 下载 Blob 文件：根据清单中的 SHA256 哈希值，下载对应的模型文件。

3. 写入本地存储：将文件保存到 ~/.ollama/models/blobs/目录下，文件名即为 SHA256 哈希值。****
   Ollama 下载的模型文件默认存储在 /usr/share/ollama/.ollama/models/目录下：

blobs/：存储模型的实际数据文件（二进制块），每个文件以其内容的 SHA256 哈希值命名。

manifests/：存储模型的清单（manifest）文件，用于描述如何组装 blobs中的文件以构成一个完整的模型。

#例如我的服务器上目录是这样的（省略掉了部分blob文件）
(base) ai@TR:/usr/share/ollama$ tree ./.ollama/models -I 'node_modules|.git' --dirsfirst
./.ollama/models
├── blobs
│   ├── sha256-03b74727a860a56338e042c4420bb3f04b2fec5734175f4cb9fa853daf52b7e8
│   ├── sha256-05a61d37b08453e59290add468e3bb2f688e23a01e967fecb0e2fa41218cea76
│   └── sha256-f64cd5418e4b038ef90cf5fab6eb7ce6ae8f18909416822751d3b9fca827c2ab
└── manifests
    └── registry.ollama.ai
        └── library
            ├── bge-m3
            │   └── latest
            └── translategemma
                └── 12b

三、 omdd 工具是什么？

omdd全称“Ollama Model Direct Link Generator and Installer”（ollama模型直链生成器和安装器），是一个针对ollama的命令行工具，其核心功能是将模型的构成文件（Manifest 和 Blobs）的直接下载链接暴露给用户。omdd可以进行模型的链接生成和离线安装。可以把它看作 Ollama 模型仓库的一个“专用链接生成器”和“模型离线安装器”。

基本原理：

它模拟了 Ollama 服务端与 registry.ollama.ai的通信过程。
获取指定模型的清单文件（Manifest），此文件是描述了模型由哪些“层”（需要哪些blob文件）构成。
解析该清单，为其中记录的每一个 Blob 文件生成一个可供浏览器或 wget、curl直接使用的 HTTPS 下载链接。

获取与安装 omdd

omdd项目地址
根据自己的系统架构下载对应软件即可

#查看系统架构
(base) ai@TR:/usr/share/ollama$ uname -m
x86_64

我的机器是x86架构，要选择x86文件

为omdd添加执行权限

(base) ai@TR:/usr/share/ollama$ chmod +x omdd

四、使用omdd下载并安装模型

获取模型下载链接列表

(base) ai@ai-SYS-7048GR-TR:~/tools$ ./omdd get qwen3.5:9B
Fetching direct download link for model: qwen3.5:9B
Manifest download link: https://registry.ollama.ai/v2/library/qwen3.5/manifests/9B
Download links for layers:
1 - https://registry.ollama.ai/v2/library/qwen3.5/blobs/sha256:dec52a44569a2a25341c4e4d3fee25846eed4f6f0b936278e3a3c900bb99d37c
2 - https://registry.ollama.ai/v2/library/qwen3.5/blobs/sha256:7339fa418c9ad3e8e12e74ad0fd26a9cc4be8703f9c110728a992b193be85cb2
3 - https://registry.ollama.ai/v2/library/qwen3.5/blobs/sha256:9371364b27a52acac9d87f88bd93c9db1174d8d6ec57f6888925cdc1788871ff
4 - https://registry.ollama.ai/v2/library/qwen3.5/blobs/sha256:be595b49fe22012bd1f5605ec14c7ffa58331783a88a4fd8c22e5fc8ec42cf9f
Generated download links for model: qwen3.5:9B
Finished successfully!

下载全部文件

下载omdd返回链接中的全部文件

• manifest文件命名为"manifest"，不要任何后缀
• blob文件使用sha256命名
  

使用omdd安装模型

#omdd install --model=<model-name> --blobsPath=<downloaded-blobs-path>
#这里的模型名称替换成自己的模型名，路径为刚刚下载文件的保存路径
omdd install --model=qwen3.5:9b --blobsPath=/home/ai/download/qwen3.5