Skip to content

Latest commit

 

History

History
60 lines (39 loc) · 2.77 KB

manual-setup.md

File metadata and controls

60 lines (39 loc) · 2.77 KB
description Use Proxyman Manual Setup to capture HTTPS traffic from NodeJS, Python, Ruby and cURL in your own Terminal app, such as iTerm2, with Bash, Zsh or Fish.

Manual Setup

1. Problems

Proxyman could not capture HTTP/HTTPS traffic from the following setup:

  • NodeJS: Axios, got, superagent, fetch, and node-fetch
  • Python: http, https, aiohttp, requests
  • Ruby: http, net/http, net/https, faraday, httparty and fastlane
  • cURL

It's a known issue: NodeJS, Python, Ruby, and cURL run from the Terminal app don't use the system HTTP proxy. So there is no traffic in Proxyman.

You have to read the technical documentation of each library and manually configure:

  • The HTTP Proxy
  • Trust for a self-signed certificate

=> Time-consuming and error-prone ❌

2. Solution: Manual Setup

Benefit:

  • ✅ Run on your favorite Terminal app: iTerm2 with Bash, Zsh, and Fish Shell
  • Capture HTTP(s) traffic from NodeJS, Python, Ruby, Terminal or Web Browser, etc.
  • Safe. It works in your current session and doesn't affect your OS

How to use:

  1. Open Proxyman -> Setup menu -> Manual Setup…
  2. Open your favorite Terminal app, such as iTerm2
  3. Click Copy to Clipboard, then paste the command into your Terminal and run it
  4. Done ✅
  5. Start your backend server or run a script => Proxyman automatically captures all HTTP/HTTPS traffic

Proxyman Manual Setup window with the source command for your Terminal and the Copy to Clipboard button

Copy the command to your Terminal

Support Libraries:

Proxyman (with Manual Setup) works out of the box with the following network libraries.

3. Advanced: How does it work?

See Automatic Setup: How does it work?

4. Troubleshooting

See the Troubleshooting page.