# qdm12/gluetun

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/qdm12-gluetun).**

13,056 stars · 536 forks · Go · mit

## Links

- GitHub: https://github.com/qdm12/gluetun
- Homepage: https://github.com/qdm12/gluetun-wiki
- awesome-repositories: https://awesome-repositories.com/repository/qdm12-gluetun.md

## Topics

`alpine` `cyberghost` `dns-over-tls` `docker` `golang` `http-proxy` `mullvad` `nordvpn` `openvpn` `pia` `privado` `private-internet-access` `purevpn` `shadowsocks` `surfshark` `vpn-client` `vyprvpn` `windscribe` `wireguard`

## Description

Gluetun is a containerized network utility designed to route traffic from multiple Docker containers through a secure virtual private network tunnel. It functions as a network gateway that encapsulates outgoing internet traffic to provide privacy and security for isolated application services.

The project distinguishes itself by utilizing Linux network namespaces to isolate container traffic, ensuring that all outgoing packets are forced through a dedicated tunnel interface. It supports both OpenVPN and WireGuard protocols, managing the connection lifecycle and routing logic as a sidecar container.

The software includes a health-check-based kill switch that continuously monitors tunnel connectivity and automatically disables network access for dependent containers if the secure connection drops. It also handles the configuration of firewall rules and routing tables through declarative inputs, allowing for the management of network identity and access across private infrastructure.

## Tags

### Networking & Communication

- [WireGuard Management](https://awesome-repositories.com/f/networking-communication/vpn-infrastructure/wireguard-management.md) — Establishes encrypted WireGuard VPN connections for containerized applications to ensure secure and private network access.
- [VPN Tunnels](https://awesome-repositories.com/f/networking-communication/vpn-tunnels.md) — Connects private infrastructure to external VPN providers to mask network identity and secure outgoing internet traffic.
- [Traffic Routing](https://awesome-repositories.com/f/networking-communication/traffic-routing.md) — Directs network traffic from multiple containers through a secure VPN tunnel to protect privacy and bypass geographic restrictions. ([source](https://github.com/qdm12/gluetun-wiki))
- [Network Namespace Sharing](https://awesome-repositories.com/f/networking-communication/communication-protocols-architectures/communication-paradigms/namespaces/network-namespace-sharing.md) — Utilizes Linux network namespaces to isolate and force container traffic through a dedicated VPN tunnel interface.
- [Network Proxy Management](https://awesome-repositories.com/f/networking-communication/network-proxy-management.md) — Acts as a containerized network gateway that enforces outbound traffic routing through a configured VPN tunnel.

### System Administration & Monitoring

- [Connection Health Monitors](https://awesome-repositories.com/f/system-administration-monitoring/health-monitoring/connection-health-monitors.md) — Monitors tunnel connectivity and automatically blocks network access for dependent containers if the connection becomes unstable.

### Security & Cryptography

- [Secure Tunneling](https://awesome-repositories.com/f/security-cryptography/secure-tunneling.md) — Establishes virtual network interfaces to encapsulate and encrypt outgoing traffic for secure connectivity.
- [Privacy and Anonymity Tools](https://awesome-repositories.com/f/security-cryptography/security/privacy-and-anonymity-tools.md) — Provides containerized network privacy by routing traffic through secure tunnels to prevent data leaks and maintain anonymity.

### DevOps & Infrastructure

- [Sidecar Containers](https://awesome-repositories.com/f/devops-infrastructure/sidecar-containers.md) — Deploys as a sidecar container to manage network connectivity and lifecycle orchestration for primary application services.