Proxyman
HomepageDownload
  • Overview
  • Changelog
  • License
  • License Manager
  • Raycast
  • Command-line
  • Security Compliance
  • Proxyman iOS
    • Proxyman for iOS
    • Map Local for iOS
    • Breakpoint for iOS
    • Tutorial for iOS
      • Map Local for iOS Tutorial
      • Breakpoint for iOS Tutorial
  • Debug on Devices
    • macOS
    • iOS Device
    • iOS Simulator
    • tvOS & watchOS
    • Android Device & Emulator
      • Automatic Script for Android Emulator
      • Sample Android Project
    • Firefox
    • Java VMs
    • Python
    • Ruby
    • NodeJS
    • Rust
    • Golang
    • React Native
    • Flutter
    • HTTP Clients
    • Docker
    • ElectronJS
    • NextJS (fetch)
  • Automatic Setup
    • Automatic Setup
    • Manual Setup
    • Troubleshooting
  • Atlantis
    • Atlantis for iOS
  • BASIC FEATURES
    • Proxyman Proxy Helper Tool
    • Request / Response Previewer
    • SSL Proxying
    • Bypass Proxy List
    • Import / Export
    • Content Filter
    • Multiple Tabs
    • Horizontal/Vertical/Window Layout
    • Copy as
    • Custom Previewer Tab
    • Custom Header Column
    • Regex (Regular Expression)
    • Filter JSON Response
    • Highlight by Color and Add Comment
    • Import / Export Settings
    • Multipart Form-Data Previewer
    • JSONPath
    • Customize Toolbar
    • Localization
    • Quick Preview
  • ADVANCED FEATURES
    • Repeat
    • Edit & Repeat
    • Compose new Request
    • No Caching
    • Breakpoint
    • Breakpoint Templates
    • Map Local (File)
    • Map Local (Directory)
    • Map Remote
    • External Proxy
    • Save Session
    • Protobuf
    • WebSocket
    • Clear Session
    • Block List
    • Allow List
    • Charles Proxy Converter
    • Custom Certificates
    • GraphQL
    • Network Conditions
    • Multiple Filters
    • Custom Filters
    • Publish to Gist
    • Reverse Proxy
    • Code Generator
    • Diff
    • Access Control
    • DNS Spoofing
    • SOCKS Proxy
    • Swagger OpenAPI
    • TLS Key Logging
  • Proxyman Windows
    • Install Certificate
    • WSL
  • Scripting
    • Scripting
    • async/await Request
    • Addons
    • Built-in JS Libraries
    • Write your own Addons
    • Snippet Code
    • Environment Variables
  • Troubleshooting
    • Proxyman does not work with VPN apps
    • My Remote Devices (iOS/Android) could not connect to Proxyman?
    • iOS 16 and iOS 17 issues
    • SSL Error from HTTPS Request/Response
    • I could not see any requests from my localhost server
    • I could not see any HTTP traffic from my NodeJS, Python, or Ruby scripts
    • *.local requests do not appear on Proxyman
    • I couldn't see any traffics on Proxyman
    • I couldn't see any requests from 3rd-party network libraries
    • [Breakpoint] Modify Request/Response by Raw Message
    • Could not change Proxyman App Icons
    • Lost data after updating Proxyman app?
    • Proxyman consumes too much RAM & unresponsive
Powered by GitBook
On this page
  • 1. Problems
  • 2. Solution: Manual Setup
  • Benefit:
  • How to use:
  • Support Libraries:
  • 3. Advanced: How does it work?
  • 4. Troubleshooting
  1. Automatic Setup

Manual Setup

Capture HTTPS Traffic from Ruby, Python or NodeJS with Proxyman

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/htps, faraday, httparty and fastlane

  • cURL

It's a known issue since NodeJS, Python, Ruby, and cURL which are executed from the Terminal app, don't respect the system HTTP Proxy. Thus, there is no traffic on Proxyman.

You have to read through the Technical Documentation of each library and manually config:

  • The HTTP Proxy

  • Trust 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. Work on your current session, not affect your OS

How to use:

  1. Open Proxyman -> Setup Menu -> Manual Setup

  2. Open your favorite Terminal app, such as iTerm2

  3. Copy & Paste the script to your Terminal -> Run it

  4. Done ✅

  5. You can start your Backend Server or run a script => Proxyman automatically captures all HTTP/HTTPS traffic out of the box

Support Libraries:

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

  • cURL without --proxy flag

3. Advanced: How does it work?

4. Troubleshooting

PreviousAutomatic SetupNextTroubleshooting

Last updated 7 months ago

NodeJS: , (v18+), , , , and

Ruby: , , , , , and fastlane

Python: , , http.client, urllib3 and httpx

See the

See the page

axios
fetch
node-fetch
got
https
superagent
http
net/http
net/https
httparty
faraday
request
aiohttp
Troubleshooting
Manual Setup
Automatic Setup: How does it work?