兄弟们，最近是不是被 Ollama 无法下载模型 pulls model failed 这个问题折磨疯了？明明照着官网文档敲了 ollama pull llama3，结果进度条卡在 0%，或者直接给你来个 Error: pull model manifest: file does not exist 或者 connection error。别慌，今天这篇教程就是专门来收拾这个烂摊子的。咱们不整虚的，直接上硬核解决方案——镜像源配置，让你 5 分钟内把模型拉下来。
为什么你需要这个镜像源配置？
💡 推荐阅读：AnythingLLM 本地文档解析失败 PDF 嵌入报错排查：从业务架构到 API 调用的全链路实战
先搞清楚底层逻辑。Ollama 默认从 registry.ollama.ai 这个官方仓库拉取模型。这玩意儿在国内的访问速度堪比蜗牛爬，而且经常被墙或者被限流。你看到的 pulls model failed 错误，90% 都是因为网络连接超时或者被重置导致的。剩下 10% 可能是磁盘空间不足或者模型名拼写错误，但咱们今天重点解决网络问题。
镜像源配置的本质就是：把下载源从官方仓库切换到国内可直连的镜像服务器。这就好比你去菜市场买菜，官方摊位排长队还限购，你直接去隔壁老王家的分店，货一样，还不用等。配置好之后，你会发现下载速度直接从 10KB/s 飙到 10MB/s，爽到飞起。
注意： 本教程适用于 Ollama v0.1.x 及以上版本。如果你用的是老古董版本，建议先升级到最新版，否则某些环境变量可能不生效。
官方升级命令：curl -fsSL https://ollama.com/install.sh | sh（Linux/Mac）
Windows 用户直接去官网下载安装包覆盖安装。
前置准备：你需要什么？
💡 延伸阅读：Open WebUI 连接 Ollama 失败 HTTP 404 解决流程：从报错到修复的保姆级实操手册
别急着抄代码，先检查一下你的环境。你需要准备：
- 一台能联网的电脑（Windows 10/11、macOS、Ubuntu/CentOS 都行）
- Ollama 已经安装成功（如果没装，先跑一下
ollama --version确认，没有就去 ollama.com 下载） - 一个国内可用的镜像源地址（下面我会给你几个实测可用的）
- 基本的命令行操作能力（会复制粘贴就行，不需要你会写代码）
另外，强烈建议你关闭 VPN 或者代理软件。因为 Ollama 的镜像配置走的是直连，如果开了代理，反而会把请求转发到国外，导致配置失效。
5 分钟极速安装步骤（核心干货）
💡 深度技术指南：Cursor AI 提示词 Rules 配置避坑指南：从规则失效到上下文污染的全面排查手册
咱们分平台操作。先讲 Linux / macOS，再讲 Windows，因为环境变量设置方式不同。
第一步：找到你的 Ollama 服务配置文件
Ollama 在启动时会读取环境变量。我们要做的就是把镜像源地址写进环境变量里。对于 Linux/macOS，编辑你的 shell 配置文件：
vim ~/.bashrc # 或者 ~/.zshrc，取决于你用的 shell对于 Windows，你需要打开系统环境变量设置（右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量）。
第二步：写入镜像源地址（关键！）
在配置文件的末尾添加以下内容（选择一个可用的镜像源）：
# 方案一：使用 Docker Hub 镜像（推荐，稳定）
export OLLAMA_HOST="0.0.0.0:11434"
export OLLAMA_MODELS="/usr/share/ollama/.ollama/models" # 这个可以不改，保持默认
export OLLAMA_ORIGINS="*"
export OLLAMA_REGISTRY_MIRROR="https://docker.m.daocloud.io" # 注意！这是关键行
# 方案二：使用阿里云镜像（备用）
# export OLLAMA_REGISTRY_MIRROR="https://registry.cn-hangzhou.aliyuncs.com"Windows 用户在“系统变量”里点击“新建”，变量名填 OLLAMA_REGISTRY_MIRROR，变量值填 https://docker.m.daocloud.io。注意，Windows 不需要 export 前缀，直接填键值对即可。
重点强调： 很多教程只让你改
OLLAMA_HOST，那是用来对外开放服务的，跟下载模型没关系。真正解决 pulls model failed 的是OLLAMA_REGISTRY_MIRROR这个变量。如果你发现改完还是报错，大概率是镜像源地址失效了，换下面备用的。
第三步：重启 Ollama 服务
Linux/macOS 执行：
source ~/.bashrc # 让配置生效
sudo systemctl restart ollama # 如果你是用 systemd 安装的
# 或者直接杀掉进程重启
pkill ollama
ollama serve &Windows 用户：打开任务管理器，找到 Ollama 进程，右键结束任务。然后重新启动 Ollama 桌面应用或者命令行运行 ollama serve。
第四步：验证并拉取模型
重新打开终端，先测试一下配置是否生效：
ollama list # 查看本地模型列表，如果之前有失败记录，会显示错误，但我们要的是不报错然后直接拉取你想要的模型，比如：
ollama pull llama3.2:1b # 或者你需要的任何模型你会看到速度明显变快，进度条蹭蹭蹭往上走。如果还是失败，执行 ollama show llama3.2:1b --modelfile 查看详细信息，或者看下一步的 FAQ。
常见问题 FAQ 答疑框
Q1：我按照步骤改了，但是还是报错
pulls model failed，怎么办？
A：先确认你的镜像源是否真的能访问。在浏览器里打开https://docker.m.daocloud.io/v2/，如果返回{}或者 200 状态码，说明源是通的。如果打不开，换阿里云的。另外，检查你的 Ollama 版本，如果低于 0.1.0，请升级。最后，一定要重启 Ollama 进程，光 source 配置文件有时候不生效。
Q2：我用的 Windows，环境变量设置了，但 ollama pull 还是卡在 0%？
A：Windows 用户注意，环境变量设置完后，必须彻底退出 Ollama 托盘图标（右下角右键退出），而不是关闭窗口。然后重新启动。另外，检查你的 PowerShell 是否以管理员身份运行。如果还不行，打开 CMD 输入echo %OLLAMA_REGISTRY_MIRROR%确认变量是否写入成功。
Q3：镜像源配置会影响我上传模型或者使用 API 吗？
A：完全不影响。镜像源只影响pull下载操作。你本地跑模型、调用 API、甚至推送（push）模型到官方仓库，都不受影响。放心用。
Q4：我想换回官方源，怎么取消镜像？
A：把之前添加的OLLAMA_REGISTRY_MIRROR那行注释掉或者删除，然后重启 Ollama 服务即可。注意，删除后下载速度会恢复“龟速”，建议保留镜像。
Q5：有没有不需要配置镜像的替代方案？
A：有。你可以使用ollama pull --insecure参数跳过 SSL 验证（不推荐，有安全风险）。或者直接去 Hugging Face 下载模型文件，然后用ollama create命令从本地文件创建模型。但说实话，配置镜像是最省事、最一劳永逸的方法。
好了，兄弟们，按照上面的步骤操作下来，Ollama 无法下载模型 pulls model failed 镜像源配置 的问题应该已经彻底解决了。如果你还遇到什么奇葩问题，比如模型下载到一半中断，可以试试 ollama pull --resume 恢复下载。最后提醒一句：镜像源地址可能不定期失效，如果哪天突然又报错了，回来换个新的镜像地址就行。祝大家拉模型愉快，跑大模型飞起！