passteque /gluetun
VPN client in a thin Docker container for multiple VPN providers, written in Go, and using OpenVPN or Wireguard, DNS over TLS, with a few proxy servers built-in.
★ 16,093⑂ 650👁 42⑃ 653● 1,797▤ 79
+14
日增长
16,093
stars
650
forks
42
watchers
653
prs
1,797
issues
79
releases
README
Gluetun VPN client Lightweight swiss-army-knife-like VPN client to multiple VPN service providers ⚠️ This and gluetun-wiki are the only websites for Gluetun, other websites claiming to be official are scams ⚠️ 🗯️ this repository will be migrated to github.com/passteque/gluetun on 2026-05-21, which is a Github organization under my sole control, so don't get alarmed if you get redirected in the coming days 😉 Reason being migrating Github sponsors to the Open source collective due to my personal situation, basically annoying paperwork. On the plus side, it will be more transparent and funds donated will only be used for the project. The Docker image names will remain the same. !Title image !Last release !Last Docker tag !GitHub last release date !Commits since release !Code size !GitHub repo size !Go version !Visitors count Quick links - Setup - Features - Problem? - Check the Wiki common errors and faq - Start a discussion - Fix the Unraid template - Suggestion? - Create an issue - Happy? - Sponsor me on github.com/sponsors/qdm12 - Donate to paypal.me/qmcgaw - Drop me an email - Want to add a VPN provider? check the development page and add a provider page - Video: - Substack Console interview Features - Based on Alpine 3.23 for a small Docker image of 43.1MB - Supports: AirVPN, Cyberghost, ExpressVPN, FastestVPN, Giganews, HideMyAss, IPVanish, IVPN, Mullvad (Wireguard only), NordVPN, Privado, Private Internet Access, PrivateVPN, ProtonVPN, PureVPN, SlickVPN, Surfshark, TorGuard, VPNSecure.me, VPNUnlimited, Vyprvpn, Windscribe servers - Supports OpenVPN for all providers listed - Supports Wireguard both kernelspace and userspace - For AirVPN, FastestVPN, Ivpn, Mullvad, NordVPN, ProtonVPN, Surfshark and Windscribe - For Cyberghost, Private Internet Access, PrivateVPN, PureVPN, Torguard, VPN Unlimited and VyprVPN using the custom provider - For custom Wireguard configurations using the custom provider - More in progress, see 134 - Supports AmneziaWG only with the custom provider for now - DNS over TLS baked in with service provider(s) of your choice - DNS fine blocking of malicious/ads hostnames and IP addresses, with live update every 24 hours - Choose the vpn network protocol, udp or tcp - Built in firewall kill switch that only allows traffic through the VPN, to the VPN server, and to allowed LAN devices - Built in Shadowsocks proxy server (protocol based on SOCKS5 with an encryption layer, tunnels TCP+UDP) - Built in Socks5 proxy server (tunnels TCP+UDP) - partial credits to @angelakis and @adjscent - Built in HTTP proxy (tunnels HTTP and HTTPS through TCP) - Connect other containers to it - Connect LAN devices to it - Compatible with amd64, i686 (32 bit), ARM 64 bit, ARM 32 bit v6 and v7, and even ppc64le 🎆 - Custom VPN server side port forwarding for Private Internet Access, PrivateVPN and ProtonVPN - Possibility of split horizon DNS by selecting multiple DNS over TLS providers - Can wo
Top issues
#134Feature request: Support for Wireguard157 comments · 2020-04-12#1407Bug: qBittorrent stops listening to the open port after the gluetun VPN restarts internally90 comments · 2023-02-21#2154Bug: vpn constantly restarts due to being unhealthy80 comments · 2024-03-12#641Bug: Connectivity is lost once gluetun container is restarted73 comments · 2021-09-24#1277Bug: QBittorrent loses internet connectivity after running for some time67 comments · 2022-12-08#495VPN provider support: Ovpn.com56 comments · 2021-06-17#188Bug: Kubernetes services cannot be resolved due to DNS overrides and routing conflicts56 comments · 2020-07-09#2997Bug: VPN Stability Issue with ProtonVPN47 comments · 2025-11-19
Discussions
#3532Auto-find and switch to the fastest ProtonVPN server0 comments · 2026-11-05#3525gluetun network errors - Trying to run PLEX & surfshark wireguard VPN1 comments · 2026-10-25#3523IVPN won't connect, setup previously worked with Mullvad2 comments · 2026-10-24#3522Mullvad VPN Settings1 comments · 2026-10-23#3521Are multiple simultaneous Docker networks supported?1 comments · 2026-10-23#3519NordVPN changed TCP port from 443 to 800 comments · 2026-10-22#3518No longer connecting to my VPN1 comments · 2026-10-22#3517How can I make gluetun work in PVE / Proxmox ?2 comments · 2026-10-22
Latest release
v3.41.3 v3.41.3 2026-07-30This fixes a VPN server port forwarding deadlock bug introduced whilst back-porting a fix from the master branch (:latest image) to v3.41.2. Credits to @robinostlund for reporting the bug and even nailing down what it was! (3416) Refer to v3.41.2 fixes in case you haven't checked.