Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



62 Commits

Repository files navigation



Doxycannon uses docker to create multiple socks proxies where the upstream internet connections are either VPN connections or Tor nodes

In VPN mode, it takes a pool of OpenVPN files and creates a Docker container for each one. After a successful VPN connection, each container spawns a SOCKS5 proxy server and binds it to a port on the Docker host.

In Tor mode, containers initiate a connection to the Tor network.

Both VPN and Tor nodes can be rotated through, giving you a new egress IP with each request.

Combined with tools like Burp suite or proxychains, this creates your very own (small) private botnet on the cheap.

Password Spraying Blog Post Using DoxyCannon


If using VPN mode, you'll need a VPN subscription to a provider that distributes *.ovpn files

  • Install the required pip modules:

    pip install -r requirements.txt
  • Ensure docker is installed and enabled. Refer to the Wiki for installation instructions on Kali/Debian

  • proxychains4 is required for interactive mode


  • Create a NAME.txt file with your ovpn credentials in VPN. The format is:

  • Fill the VPN folder with *.ovpn files and ensure that the auth-user-pass directive in your ./VPN/*.ovpn files says auth-user-pass NAME.txt

    • Check out this wiki section for installation instructions for individual VPN providers
  • Within the VPN folder, you may divide/organize your VPN file into subdirectories and use the --dir flag with the --up or --single commands to only use those configs

    mkdir -p VPN/US
    mv US.opvn auth-us.txt VPN/US
    doxycannon vpn --dir VPN/US --up
    mkdir -p VPN/FR
    mv FR.opvn auth-fr.txt VPN/FR
    doxycannon vpn --dir VPN/FR --up
  • If --dir is equal to VPN, a container will be launched for each ovpn file inside the folder. Use --single to have HAproxy load-balance between all VPNs.

     doxycannon vpn --dir VPN --up
     doxycannon vpn --dir VPN --single # Launch HAproxy to load balance
  • --single does not stop proxy containers when it quits, it only stops HAproxy. Use --down to bring them down.

  • Alternatively, use the tor subcommand to just spin up tor nodes

    doxycannon tor --nodes 7 --single


note: Before 14 May 21, versions of rofl0r/proxychains-ng use a second-based seed for the PRNG that determines random proxy selection. Be sure to use a version based on or after this commit

One-off, random commands

While your containers are up, you can use proxychains-ng to issue commands through random proxies

proxychains4 -q curl -s
proxychains4 -q hydra -L users.txt -p Winter2020 -t 8 ssh

GUI Tools

Use the --single flag to create a proxy rotator.

❯❯ ./ [vpn|tor] --single
[+] Writing HAProxy configuration
[*] Image doxyproxy built.
[*] Staring single-port mode...
[*] Proxy rotator listening on port 1337. Ctrl-c to quit
[*] doxyproxy was issued a stop command
[*] Your proxies are still running.

To see what's happening, checkout out the haproxy folder. Essentially, the tool builds a layer 4 load-balancer between all the VPNs. This allows rotatation of proxies through a single port. One can then point browsers or BURPSuite at it and have every request use a different VPN.

Specific SOCKS proxies

Example: To make a request through Japan, use docker ps and find the local port to which the Japanese VPN is bound.

Configure your tool to use that port:

curl --socks5 localhost:50xx


Once you've started your containers, run the utility with the --interactive flag to get a bash session where all network traffic is redirected through proxychains4

./ --interactive


pry0cc for the idea

This was originally a fork of pry0cc's ProxyDock. It's been modified to an extent where less than 1% of the original code remains.