easy-proxy

A dead-simple CLI tool that instantly maps external servers to your localhost.
Fast, elegant, and perfect for modern development workflows.

$ easy-proxy https://httpbin.org/ --port 8080
Proxy server running on http://localhost:8080 and redirecting to https://httpbin.org/

GET /status/401 -> 401 UNAUTHORIZED (434ms)
PUT /status/200 -> 200 OK (588ms)
POST /status/201 -> 201 CREATED (1087ms)
PATCH /status/403 -> 403 FORBIDDEN (434ms)

$ easy-proxy https://httpbin.org/ --port 8080 --details
Proxy server running on http://localhost:8080 and redirecting to https://httpbin.org/

GET /uuid -> 200 OK (608ms)
-------------------------------------------------------------
Timestamp: 2025-04-08T22:06:21.954450
Response Body: {
"uuid": "1117d456-ca8c-43b3-9ff4-b90327e311f5"
}

Instant Setup

Start your proxy in seconds. No boilerplate, no hassle—just one simple command.

Environment Switching

Easily switch between staging, QA, and production backends without touching app code.

Powerful Debugging

Logs every request and response with headers and payloads. Perfect for tracking down tricky issues in development and QA.

Installation Guide

Note: easy-proxy is currently available only for Linux systems (x86_64 architecture).

1. Download and Install

curl -sL "https://github.com/renanwillian/easy-proxy/releases/latest/download/easy-proxy-linux-x86_64.tar.gz" | tar -xz && sudo install -D easy-proxy -t /usr/local/bin/

This command downloads the latest version and sets up easy-proxy on your system.

2. Verify Installation

easy-proxy --version

Confirm that easy-proxy was installed correctly by checking the version.

Need Help?

For additional commands and configuration options, use the built-in help:

easy-proxy --help