Ollama 本地请求误走代理：用 Python 局部直连定位

Mac 上 Ollama 已经启动终端能聊天Python 请求却出现代理连接失败或异常网关页面先确认本机请求有没有误走代理。本文针对同一台 Mac 的 Python 3 与本地 Qwen 服务用只读接口做对照不修改系统网络设置。依据 2026 年 10 月 15 日官方资料整理未在读者机器实测容器和远程服务器不在本文主环境内。1. 用固定本地地址做一次直连对照先让模型下载、模型生成和服务连接三个问题分开。本例只访问本机 127.0.0.1 的模型列表不下载模型也不把提示词发往外部。如果服务没有启动应先启动 Ollama不要通过修改代理来解决没有监听端口的问题。Python 标准库默认可能检测环境变量及系统中的代理设置而空的 ProxyHandler 可以关闭当前请求器的自动代理。urllib.request 官方说明 下面代码只建立一个局部请求器不改变整个 Python 进程的默认网络行为。importjsonfromurllib.requestimportProxyHandler,build_opener localbuild_opener(ProxyHandler({}))withlocal.open(http://127.0.0.1:11434/api/tags,timeout5)asresponse:resultjson.load(response)print(本地模型数量:,len(result.get(models,[])))在与原程序相同的 Python 环境运行。预期得到模型数量零表示服务可访问但列表为空不等于连接失败。若原请求失败、这段固定本地请求成功就有理由继续检查代理路径这仍不是对所有网络问题的最终结论。Ollama FAQ 提醒HTTP_PROXY 可能影响客户端连接模型下载所需的 HTTPS 代理与本地服务请求也应区分。Ollama FAQ 本文不建议关闭全局代理更不把取消证书校验当成修复。2. 对照应当保持哪些条件相同把原程序中的请求改成只读模型列表再与直连版本比较。两个版本使用同一个解释器、相同地址和相同超时唯一变化是是否使用自动代理。不要一个版本跑在终端另一个跑在容器里然后把结果归因于代理。对照现象可以缩小到什么范围下一步两种方式都连接被拒绝本机服务可能没监听查看服务状态和实际端口自动代理失败直连成功代理选择可能介入核对程序启动环境两种方式都返回模型列表基础连接成立再检查原业务请求返回 HTML 或网关文字可能到达了其他服务核对状态、地址与代理路径错误文本有时包含代理地址和账号信息。求助时只保留异常类型及脱敏主机不要把带用户名密码的完整代理 URL 复制到帖子里。也不需要把全部环境变量打印出来先确认相关变量是否存在即可。如果使用 IDE检查它启动程序时继承了什么环境。修改终端里的变量不会自动改变已经打开的 IDE 进程。诊断应从实际发起请求的进程出发避免看到终端配置正确就断定图形应用一定采用相同设置。3. 本机回环地址和下载出口是两条路径127.0.0.1 指向发起连接的当前机器。本文客户端和服务位于同一台 Mac因此它是明确的本地目标。代码中没有读取外部用户提交的 URL也不会根据页面参数访问任意内网地址不要把这个诊断脚本直接扩成开放的代请求服务。模型下载是 Ollama 访问外部仓库客户端聊天则是访问本地 Ollama。前一条路径可能确实需要你的正常网络代理后一条通常没有必要经过同一个出口。直接把所有代理变量删除可能使下载功能反而失效。若你准备采用 no_proxy 为特定地址设置例外应先查所用客户端库的匹配规则。不同库、操作系统和启动方式的处理可能不同不能因为一个 Python 样本成功就断言其他桌面客户端也会读取相同变量。对于本文的小脚本保留局部 opener 就能让影响范围明确。生产程序若需要同时调用远端服务可为本地调用使用单独客户端不把“所有请求直连”变成全局默认。完成排障后保留一份原配置便于回退。4. 直连仍失败时别继续堆代理设置连接被拒绝先检查 Ollama 是否正在运行及端口是否与脚本一致。若应用已经更改了监听地址按真实配置使用不为测试临时改成对所有网络开放。发布到公网不是让本机 Python 连接成功的必要条件。连接超时区分服务端没有响应与请求根本没有到达。可以查看自己机器上的 Ollama 日志时间点但不要在日志中散布完整提示词。只读列表接口通常不涉及模型推理若列表都无法访问就应先解决连接层。模型列表可访问而生成失败说明需要进入另一层排查模型是否存在、请求字段是否符合原生 API、是否有足够资源。本文不把模型名称或上下文窗口问题混进代理结论也不会建议为了“修网络”重新下载整套模型。若原程序实际位于 Docker 中127.0.0.1 指向容器不再适用本文的同机假设。此时应按容器与宿主机拓扑重新选择目标地址。不要通过给容器关闭代理掩盖本来地址就指错了的问题。5. 用一次小请求确认修复范围连接层成功后再发送一条很短的虚构提问给已经安装的 Qwen。保持相同局部客户端观察能否拿到正常回答。列表成功只证明服务入口可访问不能替代这一步最小业务验证。记录运行方式、Python 版本、客户端库、是否使用局部直连以及两种对照的异常类型。不记录代理凭证或私人聊天。再次启动应用后复测一次确保修复不是依赖某个临时终端窗口才有效。如果程序必须遵循组织的网络访问策略按既有规则配置本地地址例外不改变远程流量策略。本文仅讨论用户自己机器上固定回环目标的连接诊断不提供绕过业务访问控制的方案。最终结束条件是同机列表可读、短问答可用、外部下载路径没有被误改。保留这个五秒只读检查比每次遇到错误都重新安装 Ollama更容易把连接问题与模型运行问题分开。参考资料Ollama FAQOllama页面更新时间未显示。urllib.requestPython 官方文档更新时间未显示。访问于 2026-10-15。