473 字
2 分钟

Pi 代理配置与请求路径验证

2026 年 10 月 13 日,在 macOS 上使用 Pi 1.2.0 时,终端里已有小写的 all_proxy,本地代理也正在监听,但 Pi 的原生启动探针仍然直连。最后只在 agent 设置里增加了 httpProxy,没有改安装文件或启动脚本。

找到 agent 的配置入口#

Pi 1.2.0 的设置参考列出了 httpProxy:它为 Pi 管理的 HTTP 客户端设置 HTTP_PROXY 和 HTTPS_PROXY,只接受 agent 目录中的设置。

默认文件是 ~/.pi/agent/settings.json。如果通过 PI_CODING_AGENT_DIR 或 SDK 的 agentDir 指定了目录,就要修改那个目录下的文件,不能把字段写进项目的 .pi/settings.json。配置目录说明区分了这两个入口。

增加一个字段#

当时先备份原设置,再把下面的字段合并进去,其他设置保留:

{
"httpProxy": "http://127.0.0.1:PORT"
}

PORT 是占位符,替换成本机代理的 HTTP 监听端口;这段示例也不应覆盖已有的完整配置。代理软件如果提供多个入口,要核对监听协议和端口。

用 Pi 自己的请求验证#

当时的原生启动探针记录如下:

配置请求与连接观察
仅有小写 all_proxyPi 仍直接连接公网目标
agent 设置增加 httpProxy返回 HTTP 200,连接指向本地代理

响应结果和连接去向要在同一次请求里核对。前者说明请求完成,后者才说明 Pi 采用了指定代理;其他工具能访问目标,不能替代这一步。

这次结果只覆盖当时 Pi 1.2.0 在 macOS 上的启动探针,本文没有重新运行,也没有验证所有模型服务、扩展或子进程。修改后如果仍然直连,先核对实际 agent 目录和进程是否载入新设置;已经连到代理却请求失败,再检查代理到目标服务这一段。

Pi 代理配置与请求路径验证
https://blog.yangyus8.top/posts/pi-http-proxy-request-verification/
作者
杨与S8
发布于
2026-10-13
许可协议
CC BY-NC-SA 4.0

评论