gitwtfhub

wtf is proxychains?

bannedbook/proxychains — explained in plain English

Analysis updated 2026-08-03 · repo last pushed 2019-04-13

1Audience · ops devopsComplexity · 2/5DormantSetup · easy

TL;DR

ProxyChains lets you send any program's internet traffic through proxy servers by simply adding 'proxychains' before your command. It works even with programs that have no built-in proxy support.

Mindmap

mindmap
  root((repo))
    What it does
      Routes traffic through proxies
      Works with any program
      Chains multiple proxies
      Hides DNS lookups
    Tech stack
      C compiler
      Linux and macOS
      BSD support
    Use cases
      Bypass restrictive firewalls
      Route through corporate LAN
      Privacy via proxy chaining
      Hide real IP address
    Limitations
      Dynamic linking required
      IRC Tor onion quirk
    Installation
      Homebrew package manager
      Compile from source

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Force network tools like telnet or Nmap to route through a corporate proxy server.

REASON 2

Bypass restrictive firewalls by tunneling traffic through an allowed proxy port.

REASON 3

Chain multiple proxies together for enhanced privacy when browsing or scanning.

REASON 4

Access an internal intranet from outside the network by routing through a proxy.

What's in the stack?

CLinuxmacOSBSD

How it stacks up

bannedbook/proxychains0xallam/posthog0xallam/search-engine
Stars111
LanguagePythonC++
Last pushed2019-04-132026-03-262023-08-23
MaintenanceDormantMaintainedDormant
Setup difficultyeasymoderatehard
Complexity2/53/53/5
Audienceops devopspm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Install via package managers like Homebrew or compile from source with a C compiler, only works with dynamically linked programs.

No license information is mentioned in the explanation, so the licensing terms are unknown.

Wtf does this do

ProxyChains is a tool that lets you route any program's internet traffic through one or more proxy servers, even if that program has no built-in proxy settings. Instead of configuring each app individually, you just prefix your command with proxychains and everything flows through the proxies you specify. It works by intercepting the network calls a program makes at a low level and quietly redirecting them through your chosen proxy chain. You can string together multiple proxies in sequence, mix different types (SOCKS and HTTP), and even use random or dynamic ordering to rotate through a list. It handles DNS lookups through the proxy too, so your destination addresses stay hidden. Configuration is flexible: it checks environment variables first, then looks for config files in several standard locations. This is useful in several concrete scenarios. If your corporate LAN only allows outbound traffic through a specific proxy server, you can force tools like telnet or network scanners to use it. If you're behind a restrictive firewall that blocks certain ports, routing through a proxy can get you around that. It's also handy for chaining multiple proxies together for privacy, accessing an intranet from outside, or running tools like Nmap through a proxy so your real IP isn't exposed to the target. There are some limitations worth knowing. It only works with dynamically linked programs, so statically compiled binaries won't be affected. A specific quirk with the IRC client irssi means you can't use Tor .onion addresses with it directly, due to how that program handles DNS lookups across process forks. The project runs on Linux, macOS, and the BSDs, and is installable via package managers like Homebrew or pkgsrc, or compiled from source with a C compiler.

Yoink these prompts

Prompt 1
Help me configure ProxyChains to route my traffic through a SOCKS5 proxy at 127.0.0.1:9050 so I can run commands through Tor.
Prompt 2
Show me how to set up ProxyChains with a chain of two HTTP proxies in sequence, with strict_chain enabled in the config file.
Prompt 3
I want to run nmap through ProxyChains so my real IP is hidden. Write the command and a basic proxychains.conf that uses a SOCKS4 proxy.
Prompt 4
Walk me through installing ProxyChains from source on macOS using a C compiler, including where to place the config file.
Prompt 5
How do I configure ProxyChains to use dynamic_chain with a list of mixed SOCKS and HTTP proxies for rotating traffic?

Frequently asked questions

wtf is proxychains?

ProxyChains lets you send any program's internet traffic through proxy servers by simply adding 'proxychains' before your command. It works even with programs that have no built-in proxy support.

Is proxychains actively maintained?

Dormant — no commits in 2+ years (last push 2019-04-13).

What license does proxychains use?

No license information is mentioned in the explanation, so the licensing terms are unknown.

How hard is proxychains to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is proxychains for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.