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

# 观察下载速度和日志
相关推荐
Cheng小攸2 小时前
2.隐藏账户
windows
吃胖点儿3 小时前
RAG系统优化完整路径:从30%到90%准确率的工程实践
服务器·数据库·windows
技术不好的崎鸣同学4 小时前
Windows 命令提示符(CMD)内容补缺&输入输出重定向及管道
运维·windows
vistaup4 小时前
windows hermes agent 使用记录
windows·hermes
夜郎king4 小时前
PostgreSQL 16 搭配 PgVector:Windows 11 完整安装教程
数据库·windows·postgresql
慵懒的猫mi4 小时前
从 Windows 到 deepin:Electron 软件无损移植实战
linux·windows·deepin
码农阿强5 小时前
OpenAI Codex 全平台详细安装与配置教程(Windows/Mac/Linux)
linux·windows·macos·ai
思麟呀5 小时前
C++工业级日志项目(四)日志落地
linux·开发语言·c++·windows
玖釉-6 小时前
单词搜索:二维网格中的 DFS 回溯与剪枝优化
c++·windows·算法·深度优先·剪枝