rundqvist/openvpn-sniproxy

By rundqvist

Updated almost 6 years ago

🔒 User friendly OpenVPN proxy. Multiple architecture and VPN provider-support.

Image
0

1.4K

rundqvist/openvpn-sniproxy repository overview

Docker OpenVPN container with SNI Proxy

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

Docker pulls image size commit activity last commit

Do you find this container useful?

Please support the development by making a small donation.

Support Support Support

Features

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

Requirements

Sign up Sign up

Components

Built on rundqvist/openvpn container.

Run

$ sudo docker run \
    -d \
    --cap-add=NET_ADMIN \
    --device=/dev/net/tun \
    --name=sniproxy-openvpn \
    --dns 1.1.1.1 \
    --dns 1.0.0.1 \
    -p 53:53/udp \
    -p 80:80 \
    -p 443:443 \
    -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]' \
    -e 'DNS_ENABLED=true' \
    -v /path/to/cache/folder:/cache/ \
    rundqvist/sniproxy-openvpn
Configuration

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

Variables
VariableUsage
HOST_IPIP of the machine where container is running.
DNS_ENABLEDEnables DNS server in container to easier route http(s)-requests through vpn.
true or false (default).
VPN_PROVIDERYour VPN provider ("ipvanish" or "wevpn").
VPN_USERNAMEYour VPN username.
VPN_PASSWORDYour VPN password.
VPN_COUNTRYISO 3166-1 alpha-2 country code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
VPN_KILLSWITCHKills network if vpn is down.
true (default) or false.
VPN_INCLUDED_REMOTESHost names separated by one space. VPN will only connect to entered remotes.
VPN_EXCLUDED_REMOTESHost names separated by one space. VPN will not connect to entered remotes.
VPN_REMOTES_FILTER_MODEIf 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_REMOTEConnects to random remote.
true or false (default).

Variables in cursive is mandatory.

Volumes
FolderUsage
/cache/Used for caching original configuration files from vpn provider

Setup

Internal DNS

Set DNS_ENABLED=true and configure your client (or router) to use HOST_IP as DNS.

External DNS

Configure your DNS to return your host ip for all lookups.

Example (if your DNS utilizes dnsmasq):

  • Locate your dnsmasq folder (usually /etc/dnsmasq.d/)
  • Create a .conf file (for example: 10-proxy.conf)
  • Add the following contents to the file (replace HOST_IP with your actual IP):
address=/#/[HOST_IP]
  • Restart DNS

Issues

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

Tag summary

Content type

Image

Digest

Size

20.2 MB

Last updated

almost 6 years ago

docker pull rundqvist/openvpn-sniproxy:1.1