配置前先记住两个参数

在客户端「设置」页面的「本地代理」区域，你会看到两个关键参数。后面所有工具的配置，本质上都是把这两个参数搬过去：

• 监听地址（本地代理监听地址）127.0.0.1
• 监听端口（本地代理监听端口）客户端中显示的实际端口号

监听地址默认是 127.0.0.1，表示只接受本机请求；监听端口由系统分配或由你手动指定。拿到这两个值之后，就可以按下面的清单逐个配置了。若还没安装客户端，可先看客户端下载页面。

命令行环境变量

对命令行工具来说，最直接的方式是设置环境变量，无需改动任何脚本源码：

# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:监听端口"
$env:HTTPS_PROXY="http://127.0.0.1:监听端口"

# macOS / Linux
export HTTP_PROXY="http://127.0.0.1:监听端口"
export HTTPS_PROXY="http://127.0.0.1:监听端口"

多数包管理器、构建工具与抓取脚本会读取这两个变量。若你的工具区分 HTTP 与 SOCKS，优先按 HTTP 类型填写。

网页抓取脚本

抓取脚本通常通过库级别的代理参数接入。以常见的请求库为例，代理值的写法是协议 + 监听地址 + 监听端口 三段拼接：

• 代理值格式http://127.0.0.1:监听端口
• 超时建议20 - 30 秒，避免节点抖动时过早失败
• 重试策略失败后重新读取客户端中显示的端口再重试

如果你打算同时发起大量请求，请留意客户端的并发承载能力：官方宣称单客户端可承载 32K（32768）并发连接，但这属于承载上限而非建议并发量，详见量子加密双监听架构解析。

接口调试工具

接口调试工具的代理选项一般在「设置」或「偏好设置」中，字段名可能是「代理」「HTTP 代理」或「网络设置」。按下列对应关系填写即可：

• 代理类型HTTP（若工具区分 HTTP 与 SOCKS）
• 代理主机127.0.0.1（本地代理监听地址）
• 代理端口客户端中显示的监听端口

浏览器代理插件

常见的浏览器代理插件提供两种工作方式：按域名规则走代理，或全局走代理。使用本地代理监听时需要注意两点：

• 把代理主机与端口填写为 127.0.0.1 与监听端口，协议选 HTTP。
• 如果插件默认开启了"绕过本地地址"规则，请确认没有把你需要访问的目标列入绕过清单。

浏览器插件只影响浏览器自身流量，不影响系统其他应用——这也是本地代理监听与量子加密监听的一个实际差异。

包管理器与自动化测试

包管理器一般通过同名环境变量读取代理，配置方式与上面的命令行环境变量一致。自动化测试框架则可以在配置文件或运行参数中指定代理，字段名通常是 proxy 或 httpProxy。如果测试需要同时连接本地服务与外部接口，记得把本地地址加入绕过清单，避免回环请求也被送进代理。

填写后如何验证

配置完成后，可以用下面两种方式快速确认代理是否生效：

1. 在工具内发起一次请求

   观察请求日志中的出口信息是否发生变化；如果超时或被拒绝，先回到客户端确认本地代理开关处于开启状态。

2. 确认端口处于监听中

   在 PowerShell 中执行 netstat -ano | findstr 监听端口，或在 macOS / Linux 中执行 lsof -i :监听端口，确认存在监听记录。

常见填错原因

最后整理几个最常见的填写错误，遇到问题时可以逐条自查：

• 把监听端口写成了客户端的服务端口——两者不同，请以「设置」页显示的值为准。
• 本地代理开关未开启，端口根本没有进入监听状态。
• 端口被本机其他程序占用，客户端实际未绑定成功。可参考端口被占用的处理方式。
• 更换端口后忘记同步更新工具内的配置值。
• 工具启用了绕过本地地址规则，导致请求根本没有进入代理。