Docker Windows

This is under development. The part of connecting to X Window system is working. Investigating yet how to connect wireless interfaces into docker container.

The recommended docker run command to be run under Windows host is:

docker run \
       --rm \
       -ti \
       --name airgeddon \
       --net=host \
       --privileged \
       -p 3000:3000 \
       -v /path/to/some/dir/on/your/host:/io \
       -e DISPLAY=$(route print | grep 0.0.0.0 | awk '{print $4}' | head -n 1):0 \
       v1s1t0r1sh3r3/airgeddon

Parameters explanation:

• --rm → Ephemeral containter. It will be removed on exit.
• -ti → Attach pseudo-TTY terminal to the container as interactive.
• --name airgeddon → Name for the container.
• --net=host → Is needed to have access to the host network interfaces inside the container.
• --privileged → Needed to have permissions over network interfaces (mode switching).
• -p 3000:3000 → Open port to access to BeEF control panel from the host.
• -v /path/to/some/dir/on/your/host:/io → It maps a directory from host to the container. Useful to use external files like dictionaries or whatever.
• -e DISPLAY=$(route print | grep 0.0.0.0 | awk '{print $4}' | head -n 1):0 → It overwrites the needed var to connect to local X Window system (It's understood you installed Xming for Windows). awk, grep, etc., are working because even on windows remember you are in a special console.
• v1s1t0r1sh3r3/airgeddon → Is the name and tag of the image. v1s1t0r1sh3r3/airgeddon is the stable version and is the same as v1s1t0r1sh3r3/airgeddon:latest. Alternatively you can use v1s1t0r1sh3r3/airgeddon:beta or v1s1t0r1sh3r3/airgeddon:alpha for development versions.

Windows Tips

Volume mapping

Don't forget to replace on docker command the string "/path/to/some/dir/on/your/host" with a path of an existing directory of your choice on your host machine. That directory will be the "input/output" point for the script. For example, if you place a dictionary.txt file there, inside the script you must access to it as "/io/dictionary.txt". If you capture a trophy or a Handshake file, save it at "/io/" dir to access it from the host.

X Window system

You'll need a X Window system running on your Windows. You can install Xming, and after installing it, be sure of allowing connections from network clients in preferences as shown on next images:

It's important to let the display number in 0 as shown in the first image and check the "No access control" checkbox as shown on third image.