先确认适用条件

适用于本机能启动 Ollama,但 ollama pull 下载模型时连接失败,且已确认需要使用代理。本文不处理模型名不存在、磁盘不足或显存不足,也不把拼写相近的网站视为 Ollama。

先区分原因与影响范围

发起模型下载的是 Ollama 服务进程。只给终端里的客户端命令设置变量,不一定改变已经运行的后台服务。官方 FAQ 指定用 HTTPS_PROXY 处理模型拉取,并提醒 HTTP_PROXY 可能干扰客户端与本地服务的连接。

按顺序检查,每次只改一项

  1. 记录失败阶段与错误,确认模型名称来自 Ollama 官方库,并确认本机 Ollama 服务已经运行。不要把拉取失败和模型加载时内存不足混为一谈。
  2. 核对本机代理实际协议、监听地址和端口。HTTPS_PROXY 的名称描述要代理的目标请求;变量值中的 http:// 或 https:// 要与代理端口本身协议一致,不能因为目标是 HTTPS 就盲目改成 https://。
  3. 按启动方式配置服务的环境:Windows 托盘退出 Ollama,编辑当前用户环境变量后从开始菜单重启;macOS 应用用 launchctl 设置后退出并重新打开;Linux systemd 服务应在服务覆写中设置,再重新加载并重启。只选择适用的一条。
  4. 检查是否额外设置了 HTTP_PROXY;若是本次测试添加的,恢复原值并让服务重新启动。组织已有设置先与管理员核对,不删除机器上所有代理变量。
  5. 重新拉取同一个已经确认的模型,结合服务日志看请求是否走预期代理。使用组织 TLS 检查代理时,按组织指引配置系统可信 CA,不通过关闭证书校验处理。
macOS 应用方式示例;7890 必须改为实际 HTTP 代理端口;设置后退出并重开 Ollama
launchctl setenv HTTPS_PROXY "http://127.0.0.1:7890"
# 若测试前没有此变量,回退时执行下行,再重启 Ollama
# launchctl unsetenv HTTPS_PROXY

怎样确认已经恢复

下载完成后用 ollama list 确认模型存在,再进行一次本地运行。浏览器能打开官网、终端变量存在或服务进程重启成功,都不能代替模型拉取结果。

未恢复时如何回退与求助

恢复修改前的 HTTPS_PROXY/HTTP_PROXY 设置并重启同一个服务进程。若只是在新终端试验,可关闭该会话;不要同时启动第二个 ollama serve 与现有服务争抢端口。Docker 部署的环境与证书在容器内另查,不能直接套用桌面变量。