Automatic Setup(自动设置)
使用 Proxyman Automatic Setup 一键打开预先配置好的终端,即可抓取来自 NodeJS、Python、Ruby、Golang 和 cURL 的 HTTP/HTTPS 流量。
1. 问题
Proxyman 无法抓取以下环境中的 HTTP/HTTPS 流量:
- NodeJS:Axios、got、superagent、fetch 和 node-fetch
- Python:http、https、aiohttp、requests
- Ruby:http、net/http、net/https、faraday、httparty 和 fastlane
- Golang:net/http、fasthttp、resty、gorequest、req、grequests
- ElectronJS
- cURL
这是一个已知问题:从终端应用运行的 NodeJS、Python、Ruby 和 cURL 不会使用系统 HTTP 代理,因此 Proxyman 中不会出现任何流量。
你需要阅读每个库的技术文档,并手动配置:
- HTTP 代理
- 对自签名证书的信任
=> 耗时且容易出错 ❌
2. 解决方案:Automatic Setup
优势:
- ✅ 一键自动设置 HTTP 代理和证书,适用于多种开发环境
- 从 NodeJS、Python、Ruby、Golang、终端或 Web 浏览器等抓取 HTTP(S) 流量
- 安全。它只在当前会话中生效,不会影响你的操作系统
使用方法:
- 打开 Proxyman -> Setup 菜单 -> Automatic Setup…
- 点击 Open New Terminal…。你可以在旁边的菜单中选择 Apple Terminal、iTerm2 或 Ghostty。
- 如有需要,请接受 AppleScript 的权限提示
- 新的终端窗口会打开 -> 启动你的后端服务器或运行脚本 => Proxyman 会自动抓取所有流量。
- 完成 ✅

启动预先配置好的终端应用

已启动新的终端应用
注意事项:
- Automatic Setup 可以打开 Apple Terminal、iTerm2 或 Ghostty。如需使用其他终端应用(例如 Hyper),请在同一菜单中选择 My own Terminal…,或使用 Manual Setup。
- 它是安全的,因为它只在当前会话中运行,不会更改你的系统配置。
ElectronJS
- 通过 Automatic Setup 打开一个新的终端
- 使用以下命令行:
open ~/Applications/your_electron_app.app
你也可以在 Automatic Setup 窗口中点击 Select ElectronJS App…。请参阅 ElectronJS。
支持的网络库:
Proxyman(配合 Automatic Setup)开箱即可支持以下网络库。
- NodeJS:axios、fetch(v18+)、node-fetch、got、https 和 superagent
- Ruby:http、net/http、net/https、httparty、faraday 和 fastlane
- Python:requests、aiohttp、http.client、urllib3 和 httpx
- Golang:net/http、fasthttp、resty、gorequest、req、grequests
- ElectronJS 应用
- 不带 --proxy 参数的 cURL
提示
由于更改只影响你当前的终端会话,因此它是完全安全的。它不会修改你的 bash_profile 或 zshrc 文件。
3. 进阶:工作原理
点击 Open New Terminal… 时,Proxyman 会执行以下操作:
- 使用 AppleScript 启动终端应用。
- 在新的终端窗口中运行以下命令行:
set -a && source "$HOME/.proxyman/proxyman_env_automatic_setup.sh" && set +a
- proxyman_env_automatic_setup.sh 是一个 bash 脚本,用于设置 Proxyman 所需的环境变量。
例如:
- HTTP_PROXY 和 HTTPS_PROXY 环境变量
- PATH
- RUBYLIB
- PYTHONPATH
- NODE_OPTIONS
- GLOBAL_AGENT_HTTP_PROXY
NodeJS:
- Proxyman 会在 $PATH 环境变量前面添加一个新的 Node 目录。
- Proxyman 通过猴子补丁(monkey-patch)方式使用 global-agent 包修改 Node,从而为 axios 和 fetch 添加 HTTP 代理支持。
Ruby:
- 将 $RUBYLIB 覆盖为指向 Proxyman 应用
- 修补 http、net/http 和 net/https 等常用库 -> 设置 HTTP 代理并信任 Proxyman 自签名证书。
Python:
- 将 $PYTHONPATH 覆盖为指向 Proxyman 应用
- 修补 aiohttp、httplib、http.client 等常用库 -> 设置 HTTP 代理并信任 Proxyman 自签名证书。
Go:
- 覆盖 HTTP_PROXY 和 HTTPS_PROXY 环境变量
- 覆盖部分 Go 环境变量,以信任自签名证书
4. 故障排除
请参阅 故障排除页面。