Docker OpenVPN container with Tinyproxy

A user friendly container for proxying http(s)-traffic through vpn.

Features

Killswitch (kills network if vpn is down)
Proxies all http(s)-traffic through vpn
Self healing (restarts vpn if connection breaks down)
Connect to random server
Healthcheck (checking that ip differs from public ip)

Requirements

A supported VPN account

Components

Run

$ sudo docker run \
    -d \
    --cap-add=NET_ADMIN \
    --device=/dev/net/tun \
    --name=tinyproxy-openvpn \
    --dns 1.1.1.1 \
    --dns 1.0.0.1 \
    -p [PORT]:8888 \
    -e 'HOST_IP=[your server ip]' \
    -e 'VPN_PROVIDER=[your vpn provider]' \
    -e 'VPN_USERNAME=[your vpn username]' \
    -e 'VPN_PASSWORD=[your vpn password]' \
    -e 'VPN_COUNTRY=[your desired country]' \
    -v /path/to/cache/folder:/cache/ \
    rundqvist/tinyproxy-openvpn

Configuration

See base image (rundqvist/openvpn) for detailed vpn configuration.

Variables

Variable	Usage
PORT	Port for access to tinyproxy
HOST_IP	IP of server on your local network (needed for communication between container and local network).
_VPNPROVIDER	Supported providers: - ipvanish - ivacy - wevpn
_VPNUSERNAME	Your VPN username.
_VPNPASSWORD	Your VPN password.
_VPNCOUNTRY	ISO 3166-1 alpha-2 country code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
VPN_KILLSWITCH	Kills network if vpn is down. `true` (default) or `false`.
VPN_INCLUDED_REMOTES	Host names separated by one space. VPN will only connect to entered remotes.
VPN_EXCLUDED_REMOTES	Host names separated by one space. VPN will not connect to entered remotes.
VPN_REMOTES_FILTER_MODE	If set, included/excluded-filtering of remotes resulting in an empty list will cause vpn to not connect. `strict`, `strict-included` or `strict-excluded`.
VPN_RANDOM_REMOTE	Connects to random remote. `true` or `false` (default).

Variables in cursive is mandatory.

Volumes

Folder	Usage
/cache/	Used for caching original configuration files from vpn provider

Setup

Configure your client to use HOST_IP:PORT as proxy.

Issues

Please report issues at https://github.com/rundqvist/docker-tinyproxy-openvpn/issues

Donations

Please support the development by making a small donation.

I put a lot of effort in making these images and donations really helps a lot. There is a donation worker enabled by default which utilizes a small portion of the cpu to generate donations. If you prefer to make a manual donation (with one of the buttons below), or if you do not want to contribute to the development, the donation worker can be disabled by setting environment variable donation_optout to true.

rundqvist / docker-tinyproxy-openvpn

readme