No description
Find a file
Jordan Potter 123557b6bb
Merge pull request #4 from bobbypage/ipv6
Only set ipv6 killswitch if ipv6 interface exists
2020-09-12 20:59:54 -05:00
Dockerfile Pin Ubuntu version and update docs to require privileged mode 2020-05-18 17:14:55 -05:00
entrypoint.sh Merge pull request #4 from bobbypage/ipv6 2020-09-12 20:59:54 -05:00
LICENSE Initial commit 2019-02-14 11:41:59 -08:00
README.md Remove need for running in privileged mode 2020-09-13 01:16:45 +00:00

Wireguard

This is a simple docker image to run a wireguard client. It includes a killswitch to ensure that any traffic not encrypted via wireguard is dropped.

Wireguard is implemented as a kernel module, which is key to its performance and simplicity. However, this means that Wireguard must be installed on the host operating system for this container to work properly. Instructions for installing Wireguard can be found here.

You will need a configuration file for your Wireguard interface. Many VPN providers will create this configuration file for you. For example, here is the configuration generator for Mullvad. Be sure to NOT include a killswitch in the configuration file, since the docker image already has one.

Now simply mount the configuration file and run! For example, if your configuration file is located at /path/to/conf/mullvad.conf:

docker run --name wireguard                                          \
    --cap-add NET_ADMIN                                              \
    --cap-add SYS_MODULE                                             \
    --sysctl net.ipv4.conf.all.src_valid_mark=1                      \
    -v /path/to/conf/mullvad.conf:/etc/wireguard/mullvad.conf        \
    jordanpotter/wireguard

Afterwards, you can link other containers to this one:

docker run -it --rm                                                  \
    --net=container:wireguard                                        \
    appropriate/curl http://httpbin.org/ip