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

# 观察下载速度和日志
相关推荐
Patrick在香港2 小时前
同一份脚本,mac 正常 Windows 乱码:open() 默认编码实测(附 3.15 终局)
utf-8·windows·python·macos·跨平台·编码·标准库
郭庆汝5 小时前
windows本地部署AgentDesk
windows
笨笨D幸福6 小时前
win11 vhdx/wtg 安装出现问题,提示 Windows 安装程序无法将 Windows 配置为在此计算机的硬件上运行
windows
h397413 小时前
DirectShow过滤器开发-视频源过滤器
c++·windows·音视频·directshow
java资料站20 小时前
二、Spring AI Alibaba · ChatModel
java·windows·spring
北冥you鱼21 小时前
Go 语言空接口(interface{})使用场景与最佳实践
开发语言·windows·golang
夏虫不可与之言冰1 天前
Windows WSL2 (Ubuntu) 搭建 ESP‑IDF 6.1 开发环境全过程演示
linux·windows·ubuntu·esp32·乐鑫科技·乐鑫eim·乐鑫代理商
打工仔折腾 AI1 天前
FaceFusion本地换脸实战:Windows整合包、模型选择与遮罩调参记录
人工智能·windows·后端·python·深度学习·性能优化·ai agent 实战
小蜗牛狂飙记1 天前
Windows 双击 Jar 包无反应,不用写 bat 脚本!Jarfix 一键修复(以 Struts2 扫描工具为例)
windows·struts·jar
坐看风云变幻1 天前
Betaflight 开发环境搭建保姆级教程(Ubuntu / Windows+WSL / Docker 三方案 + 官方网址大全)
windows·ubuntu·docker·无人机·飞控·betaflight