An incredibly fast proxy checker & IP rotator with ease.

Contributing • What's new • Documentation • Report Issues

---

• Features
• Why mubeng?
• Installation
  • Binary
  • Docker
  • Source
• Usage
  • Basic
  • Options
    • Notes
  • Install SSL Certificate
  • Examples
    • Proxy checker
    • Proxy IP rotator
      • Burp Suite Upstream Proxy
      • OWASP ZAP Proxy Chain
    • Proxy format
      • Templating
      • Amazon API Gateway
• Limitations
  • Known Bugs
• Contributors
• Pronunciation
• Changes
• License

---

Features

• Proxy IP rotator: Rotates your IP address for every specified request.
• Proxy checker: Verifies the availability of your proxy IPs.
• Supports all HTTP/S methods.
• Compatible with HTTP, SOCKS v4(A), v5, and Amazon API Gateway proxy protocols.
• Passes all parameters and URIs.
• User-friendly: Simply run it against your proxy file and select the desired action.
• Cross-platform: Runs seamlessly on Windows, Linux, Mac, and even Raspberry Pi.

Why mubeng?

It's fairly simple, there is no need for additional configuration.

mubeng has 2 core functionality:

1. Run proxy server as proxy IP rotation

This is useful to avoid different kinds of IP ban, i.e. bruteforce protection, API rate-limiting or WAF blocking based on IP. We also leave it entirely up to user to use proxy pool resources from anywhere.

2. Perform proxy checks

So, you don't need any extra proxy checking tools out there if you want to check your proxy pool.

Installation

Binary

Simply, download a pre-built binary from releases page and run!

Docker

Pull the Docker image by running:

▶ docker pull ghcr.io/mubeng/mubeng:latest

Source

Using Go compiler:

▶ go install -v github.com/mubeng/mubeng@latest

— or

Manual building executable from source code:

▶ git clone https://github.com/mubeng/mubeng
▶ cd mubeng
▶ make build
▶ (sudo) install ./bin/mubeng /usr/local/bin

Usage

For usage, it's always required to provide your proxy list, whether it is used to check or as a proxy pool for your proxy IP rotation.

Basic

▶ mubeng [-c|-a :8080] -f file.txt [options...]

Options

Here are all the options it supports.

▶ mubeng -h

Flag	Description
-f, --file <FILE>	Proxy file.
-a, --address <ADDR>:<PORT>	Run proxy server.
-A, --auth <USER>:<PASS>	Set authorization for proxy server.
-d, --daemon	Daemonize proxy server.
-c, --check	To perform proxy live check.
-g, --goroutine <N>	Max. goroutine to use (default: 50).
--only-cc <AA>,<BB>	Only show specific country code (comma separated).
-t, --timeout	Max. time allowed for proxy server/check (default: 30s).
-r, --rotate <AFTER>	Rotate proxy IP for every AFTER request (default: 1).
--rotate-on-error	Rotate proxy IP and retry failed HTTP requests.
--remove-on-error	Remove proxy IP from proxy pool on failed HTTP requests.
--max-errors <N>	Max. errors allowed during rotation (default: 3).
	Use this with --rotate-on-error.
	If value is less than 0 (e.g., -1), rotation will
	continue indefinitely.
--max-redirs <N>	Max. redirects allowed (default: 10).
--max-retries <N>	Max. retries for failed HTTP requests (default: 0).
-m, --method <METHOD>	Rotation method (sequent/random) (default: sequent).
-s, --sync	Sync will wait for the previous request to complete.
-v, --verbose	Dump HTTP request/responses or show died proxy on check.
-o, --output <FILE>	Save output from proxy server or live check.
-u, --update	Update mubeng to the latest stable version.
-w, --watch	Watch proxy file, live-reload from changes.
-V, --version	Show current mubeng version.