Capture HTTP/HTTPS Request from Ruby (net::http, or http gem) scripts

Cover Image for Capture HTTP/HTTPS Request from Ruby (net::http, or http gem) scripts

This blog demonstrates how to capture HTTP/HTTPS traffic from Ruby scripts (net/http and http) library.

1. Make a HTTPS Request with Ruby

If you're a Ruby developer, you might spend a lot of time making an HTTP(s) Request with the following library:

  • Net::HTTP: a built-in library from Ruby. It provides a rich API to help you to implement the client that uses HTTP request-response protocol.
  • http: It's a 3rd-party gem. It's designed as an easy-to-use client library than the Net::HTTP.

The following sample code demonstrates how we make a request in both libraries.

require "http"
require 'net/http'

# Use net/http
uri = URI('')
res = Net::HTTP.post_form(uri, 'isSSL' => 'true')

# Use http gem
res = HTTP.get("").to_s

To run it, just save a sample as a client.rb -> Open the Terminal app -> Execute it: ruby client.rb.

Proxyman: Make a HTTP Request with net/http or http gem from Ruby

2. How to capture HTTP/HTTPS?

Current problem

By default, both libraries (net/http and http gem) do not respect the system HTTP Proxy or HTTP_PROXY, HTTPS_PROXY variable environment. You might not see its traffic if you're using Fiddler or Charles Proxy app.

To fix it, we have to manually add the Proxy Config. Here is the config sample for the net/http:

proxy_addr = 'localhost'
proxy_port = 9090'', nil, proxy_addr, proxy_port).start { |http|
  # always proxy via localhost:9090

Read more at net::http Proxy.

It's error-prone and time-consuming because we have to manually alter the source code.

Solution ✅

Luckily, Proxyman has shipped a feature to help you capture HTTP/HTTPS Requests/Responses with zero-config.

  1. Download the latest macOS app at

  2. Install the Proxyman certificate on your Mac. You can simply install it by opening the Certificate menu -> Install Certificate on this Mac… -> Click on the "Install & Trust" button. Install Proxyman Root Certificate to current Macbook

  3. Open the Setup Menu -> Automatic -> Click on the "New Terminal app…" Open pre-configured Terminal app which can capture Ruby HTTP Traffic with zero configuration

  4. New Terminal app displays. It's a pre-configured Apple Terminal app, which automatically captures and decrypts HTTPS traffic from Ruby.

  5. Let's run: ruby client.rb again on new Terminal app, and now all HTTP/HTTPS traffic is captured and decrypted by Proxyman 🎉

Run Ruby script and see HTTP traffic from net/http or http gem with Proxyman

  1. Done.

Supported Ruby libraries

Proxyman supports: http, net/http, net/https, faraday, httparty, and fastlane out of the box.


It's error-prone and time-consuming to capture HTTP/HTTPS traffic from Ruby scripts (net/http or http gem). However, it can be done with zero-config and 1-click by using the Automatic Setup from Proxyman.

Proxyman is a high-performance macOS app, which enables developers to capture and inspect HTTP(s) traffic from apps and domains on iOS devices, iOS Simulators, and Android devices.

Get it at

Noah Tran
Noah Tran