gluetun README

The project's README from github.com/passteque/gluetun. As one markdown file: README.md.

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

Build status

Docker pulls qmcgaw/gluetun Docker pulls qmcgaw/private-internet-access

Docker stars qmcgaw/gluetun Docker stars qmcgaw/private-internet-access

Last release Last Docker tag Last release size GitHub last release date Commits since release

Latest size

GitHub last commit GitHub commit activity GitHub closed PRs GitHub issues GitHub closed issues

Code size GitHub repo size Go version

Visitors count

Features

Setup

🎉 There are now instructions specific to each VPN provider with examples to help you get started as quickly as possible!

Go to the Wiki!

🐛 Found a bug in the Wiki?!

Here's a docker-compose.yml for the laziest:

---
services:
  gluetun:
    image: qmcgaw/gluetun
    # container_name: gluetun
    # line above must be uncommented to allow external containers to connect.
    # See https://github.com/qdm12/gluetun-wiki/blob/main/setup/connect-a-container-to-gluetun.md#external-container-to-gluetun
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun:/dev/net/tun
    ports:
      - 8888:8888/tcp # HTTP proxy
      - 8388:8388/tcp # Shadowsocks
      - 8388:8388/udp # Shadowsocks
    volumes:
      - /yourpath:/gluetun
    environment:
      # See https://github.com/qdm12/gluetun-wiki/tree/main/setup#setup
      - VPN_SERVICE_PROVIDER=ivpn
      - VPN_TYPE=openvpn
      # OpenVPN:
      - OPENVPN_USER=
      - OPENVPN_PASSWORD=
      # Wireguard:
      # - WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
      # - WIREGUARD_ADDRESSES=10.64.222.21/32
      # Timezone for accurate log times
      - TZ=
      # Server list updater
      # See https://github.com/qdm12/gluetun-wiki/blob/main/setup/servers.md#update-the-vpn-servers-list
      - UPDATER_PERIOD=

🆕 Image also available as ghcr.io/qdm12/gluetun

Fun graphs

Star History Chart

License

MIT

gluetun (passteque/gluetun)

Searching Database…

15.8K ·GitHub
Что это такое?Gluetun — это лёгкий VPN-клиент, умеющий многое и упакованный в один маленький Docker-контейнер. Он туннелирует трафик через более чем 20 коммерческих VPN-провайдеров по OpenVPN или Wireguard и позволяет другим контейнерам или устройствам в локальной сети пользоваться этим подключением.
То есть это не VPN-приложение для компьютера — как оно вписывается в мою систему?Он работает как Docker-контейнер рядом с вашими остальными сервисами. Другие контейнеры могут пускать трафик через него, устройства в локальной сети могут подключаться к нему, а ещё он может работать как sidecar в Kubernetes.
Как мне его запустить?Начните с Wiki — там есть инструкции по настройке для каждого VPN-провайдера, с примерами. В README тоже есть готовый docker-compose.yml, а образ доступен по адресу ghcr.io/qdm12/gluetun.
Мне нужна своя подписка на VPN, чтобы им пользоваться?Да — Gluetun это клиент, а не сам VPN-сервис. Нужен аккаунт у одного из поддерживаемых провайдеров, и Gluetun уже сам разберётся с подключением внутри контейнера.
Wireguard работает с любым провайдером?Нет — OpenVPN поддерживается для всех перечисленных провайдеров, а Wireguard только для части из них (AirVPN, IVPN, NordVPN, ProtonVPN, Surfshark, Windscribe и ещё нескольких), плюс можно использовать свои конфиги Wireguard через провайдера custom. Mullvad работает только через Wireguard.
Он запустится на маленьких ARM-платах или только на x86-серверах?Собран под amd64, i686 (32 бита), ARM 64 бита, ARM 32 бита v6 и v7, а также ppc64le — так что работает и на серверах, и на NAS, и на маленьких ARM-платах. Образ весит всего 43.1MB и построен на Alpine 3.23.
Что будет, если VPN-соединение оборвётся?Сработает встроенный файрвол-kill switch: трафик разрешён только к нужным VPN-серверам и устройствам локальной сети, так что пока туннель не работает, ничего наружу не утечёт.
Какие VPN-провайдеры он поддерживает?Более 20, в том числе AirVPN, Cyberghost, ExpressVPN, HideMyAss, IPVanish, IVPN, Mullvad, NordVPN, Private Internet Access, ProtonVPN, PureVPN, Surfshark, TorGuard, VyprVPN и Windscribe. Провайдер custom позволяет использовать свой конфиг OpenVPN или Wireguard, а там же поддерживается и AmneziaWG.
Зачем нужны встроенные прокси?Gluetun содержит прокси Shadowsocks (на базе SOCKS5 с дополнительным шифрованием, туннелирует TCP+UDP), прокси Socks5 (TCP+UDP) и HTTP-прокси для HTTP и HTTPS. Направьте на них другие приложения или контейнеры — и их трафик пойдёт через VPN-туннель.
Он умеет что-то ещё, кроме туннелирования?Да — внутри уже есть DNS over TLS с провайдерами на ваш выбор, и он может блокировать вредоносные и рекламные домены и IP-адреса, обновляя списки каждые 24 часа. Если выбрать несколько DNS-провайдеров, получится split horizon DNS.
А проброс портов через него можно сделать?Да, для трёх провайдеров: Private Internet Access, PrivateVPN и ProtonVPN поддерживают проброс портов на стороне VPN-сервера через Gluetun.
Creator
passteque
Size
19.8 MB
Stars
15.8K
Age
8y
Commits · 90 Days