Windows 图形界面配置 Ollama 镜像地址完整教程

Windows 图形界面配置 Ollama 镜像地址完整教程

通过 Windows 系统设置来配置环境变量,无需使用命令行,更加直观。

注:

博客:

https://blog.csdn.net/badao_liumang_qizhi


方法一:通过系统属性配置(推荐)

步骤 1:打开环境变量设置窗口

方式 A:通过搜索(最快)

  1. Win + S 打开搜索
  2. 输入 环境变量
  3. 点击 编辑系统环境变量

方式 B:通过控制面板

  1. Win + R 打开运行窗口
  2. 输入 sysdm.cpl 并回车
  3. 切换到 高级 标签
  4. 点击底部 环境变量 按钮

方式 C:通过设置应用

  1. Win + I 打开设置
  2. 搜索 环境变量
  3. 点击 编辑系统环境变量

步骤 2:添加环境变量

在弹出的 环境变量 窗口中:

  1. 用户变量 区域(上半部分),点击 新建 按钮

  2. 填写以下信息:

    text 复制代码
    变量名:OLLAMA_REGISTRY_MIRROR
    变量值:https://registry.cn-hangzhou.aliyuncs.com/ollama
  3. 点击 确定 保存

截图示意:

text 复制代码
   ┌─────────────────────────────────────┐
   │ 新建用户变量                         │
   ├─────────────────────────────────────┤
   │ 变量名(N): OLLAMA_REGISTRY_MIRROR   │
   │ 变量值(V): https://registry...      │
   │                                     │
   │        [确定]    [取消]             │
   └─────────────────────────────────────┘

步骤 3:保存并关闭

依次点击 确定 关闭所有窗口:

  1. 环境变量窗口 → 确定
  2. 系统属性窗口 → 确定

步骤 4:重启 Ollama 服务

必须完全重启 Ollama 服务才能生效!

方法 A:使用任务管理器
  1. Ctrl + Shift + Esc 打开任务管理器
  2. 切换到 详细信息 标签
  3. 找到所有 ollama.exe 进程
  4. 右键每个进程 → 结束任务
  5. 重新启动 Ollama(点击开始菜单中的 Ollama)
方法 B:使用托盘图标
  1. 查看系统托盘(右下角时间旁边)
  2. 找到 Ollama 图标(可能在隐藏的图标中,点击 ^ 展开)
  3. 右键 Ollama 图标 → Quit 退出
  4. 重新从开始菜单启动 Ollama

步骤 5:验证配置

打开新的 PowerShell 窗口:

复制代码
# 验证环境变量是否生效
echo $env:OLLAMA_REGISTRY_MIRROR

# 应该显示:https://registry.cn-hangzhou.aliyuncs.com/ollama

# 下载模型
ollama pull llama3

方法二:通过第三方工具配置(更直观)

使用 Rapid Environment Editor(推荐)

这是一个免费的环境变量编辑工具,比 Windows 自带的更好用。

步骤 1:下载并安装

访问:https://www.rapidee.com/en/download

下载并安装(选择便携版或安装版都可以)

步骤 2:添加环境变量
  1. 以管理员身份运行 RapidEE

  2. 用户变量 区域点击 添加

  3. 填写:

    text 复制代码
    名称:OLLAMA_REGISTRY_MIRROR
    值:https://registry.cn-hangzhou.aliyuncs.com/ollama
  4. 点击 确定

  5. Ctrl + S 保存

步骤 3:重启 Ollama

按照上面的步骤 4 重启 Ollama 服务


方法三:通过 Ollama 配置文件(高级)

步骤 1:找到 Ollama 配置目录

Ollama 的配置文件位于:

text 复制代码
C:\Users\你的用户名\.ollama\

步骤 2:创建或编辑配置文件

  1. Win + R 打开运行窗口
  2. 输入 %USERPROFILE%\.ollama 并回车
  3. 在该目录下创建文件 config.json(如果不存在)

步骤 3:编辑配置文件

用记事本打开 config.json,添加以下内容:

json 复制代码
{
  "registry_mirror": "https://registry.cn-hangzhou.aliyuncs.com/ollama"
}

保存文件。

步骤 4:重启 Ollama

按照方法一的步骤 4 重启服务


常用国内镜像地址

在配置时,可以选择以下镜像之一:

镜像提供商 镜像地址 稳定性
阿里云 https://registry.cn-hangzhou.aliyuncs.com/ollama
SiliconFlow https://ollama.siliconflow.cn 高(推荐)
腾讯云 https://mirror.ccs.tencentyun.com/ollama

推荐配置:

text 复制代码
变量名:OLLAMA_REGISTRY_MIRROR
变量值:https://ollama.siliconflow.cn

完整配置检查清单

按顺序检查以下项目:

✅ 检查 1:环境变量是否添加

text 复制代码
操作:Win + R → 输入 sysdm.cpl → 高级 → 环境变量
检查:用户变量中是否有 OLLAMA_REGISTRY_MIRROR

✅ 检查 2:变量值是否正确

text 复制代码
确认镜像地址没有拼写错误
确认前后没有空格

✅ 检查 3:Ollama 是否完全重启

text 复制代码
任务管理器中没有 ollama.exe 进程
重新从开始菜单启动 Ollama

✅ 检查 4:环境变量是否生效

复制代码
# 打开新的 PowerShell(重要:必须是新窗口)
echo $env:OLLAMA_REGISTRY_MIRROR

# 应该显示你设置的镜像地址

✅ 测试下载

复制代码
ollama pull llama3

# 观察下载速度和日志
相关推荐
qq_369224337 小时前
Windows全系通用!ntdll.dll文件丢失、报错、闪退问题的完整排查与修复教程
windows·dll·dll修复·dll丢失·dll错误
福大大架构师每日一题9 小时前
ollama v0.30.8 最新更新解读:修复启动提供方选择错误,提示词缓存更稳,MLX 推理与递归模型全面增强
ollama
阿米亚波10 小时前
【Windows】QEMU 启动 openEuler aarch64/arm64 架构系统 + 离线软件源
linux·windows·经验分享·笔记·架构·arm
caimouse11 小时前
Reactos 第 10 章 网络操作 — 10.3.1 NIC驱动
网络·windows
初圣魔门首席弟子12 小时前
Node.js 详细介绍(知识库版)
windows·qt·node.js·知识库
CHENG-JustDoIt13 小时前
AI工具 | 爆火开源项目Odysseus AI 工作台:从项目介绍、部署情况及其使用等多方位分析指南(含详细步骤)
大数据·人工智能·windows·python·ai·开源·github
kingbal13 小时前
Windows:flutter环境搭建
windows·flutter
未若君雅裁14 小时前
Python 数据容器详解,list、tuple、str、set、dict 到底怎么选
windows·python·list
CodeKwang14 小时前
Windows 环境 OCCT 8.0 编译构建及与 Qt6 项目集成
windows·qt·opencascade
我是伪码农14 小时前
小兔鲜1-25
linux·服务器·windows