[TUTORIAL]: Como usar qBittorrent com VPN (ProtonVPN + Gluetun) + Qbitto

Este tutorial visa ensinar como rodar o qBittorrent com segurança via ProtonVPN (usando WireGuard), junto com atualização automática de porta via qbittorrent-natmap. Ideal para privacidade e melhor desempenho em torrents. (FUGIR DO CGNAT)

🧱 Pré-requisitos

• Docker + Docker Compose instalados
  

• Conta no ProtonVPN com suporte a port forwarding
  

• Chave de configuração WireGuard do ProtonVPN
  

• Sistema com permissões para NET_ADMIN no contêiner (Linux recomendado)

1.📂 Estrutura básica do projeto

• Crie o diretório com a seguinte estrutura:

qbitvpn/ -> Escolha o nome da pasta
├── docker-compose.yml
├── config/              ← Configuração do qBittorrent
├── vpn/                 ← Armazena porta encaminhada do Gluetun

2.🛠️" title=":tools:" src="https://capybarabr.com/vendor/joypixels/png/64/1f6e0.png" style="box-sizing: content-box; height: 20px; min-height: 20px; min-width: 20px; margin: -0.2ex 0.15em 0.2ex; line-height: normal; font-size: 15px; display: inline-block; vertical-align: sub; width: auto; border-style: none; max-width: 100%; background-color: rgb(33, 33, 33); color: rgb(201, 209, 217); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji"; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"> CRIE O ARQUIVO docker-compose.yml:

version: "3.8"
services:
  gluetun:
    image: qmcgaw/gluetun
    container_name: gluetun
    cap_add:
      - NET_ADMIN
    environment:
      - VPN_TYPE=wireguard
      - VPN_SERVICE_PROVIDER=protonvpn
      - WIREGUARD_PRIVATE_KEY=<SUA_PRIVATE_KEY>
      - WIREGUARD_PUBLIC_KEY=<SUA_PUBLIC_KEY>
      - WIREGUARD_ENDPOINT_IP=<IP_DO_SERVIDOR>
      - WIREGUARD_ADDRESSES=<SEU_IP_PRIVADO>/32
      - WIREGUARD_MTU=1320
      - SERVER_COUNTRIES=Brazil
      - TZ=America/Sao_Paulo
      - VPN_PORT_FORWARDING=on
      - VPN_PORT_FORWARDING_PROVIDER=protonvpn
      - FIREWALL_OUTBOUND_SUBNETS=192.168.3.0/24
      - UPDATER_PERIOD=24h
    healthcheck:
      test: ping -c 1 www.google.com || exit 1
      interval: 60s
      timeout: 60s
      retries: 5
    ports:
      - 8080:8080         # Web UI
      - 6881:6881         # Torrent TCP
      - 6881:6881/udp     # Torrent UDP
    volumes:
      - ./vpn:/tmp/gluetun

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent-vpn
    network_mode: container:gluetun
    depends_on:
      - gluetun
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Sao_Paulo
      - WEBUI_PORT=8080
      - DOCKER_MODS=ghcr.io/vuetorrent/vuetorrent-lsio-mod:latest
    restart: always
    volumes:
      - ./config:/config
      - /caminho/para/seus/torrents:/media/torrents

  qbittorrent-natmap:
    image: ghcr.io/soxfor/qbittorrent-natmap:latest
    container_name: qbittorrent-natmap
    network_mode: container:gluetun
    depends_on:
      - gluetun
    environment:
      - TZ=America/Sao_Paulo
      - QBITTORRENT_SERVER=localhost
      - QBITTORRENT_PORT=8080
      - QBITTORRENT_USER=<SEU_USUÁRIO>
      - QBITTORRENT_PASS=<SUA_SENHA>
      - VPN_GATEWAY=10.2.0.1
      - VPN_CT_NAME=gluetun
      - VPN_IF_NAME=tun0
      - CHECK_INTERVAL=300
      - NAT_LEASE_LIFETIME=300
      - VPN_PORT_FORWARDING_FILE=/tmp/gluetun/forwarded_port
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./vpn:/tmp/gluetun

3.🧩Substitua os valores abaixo
Campo: O que colocar
<SUA_PRIVATE_KEY> Gerada no ProtonVPN (WireGuard config)
<SUA_PUBLIC_KEY> Da mesma config
<IP_DO_SERVIDOR> IP do servidor WireGuard da Proton
<SEU_IP_PRIVADO> Ex: 10.2.0.2 (vem da config WireGuard)
<SEU_USUÁRIO> Usuário do qBittorrent
<SUA_SENHA> Senha do qBittorrent

Você pode obter essas informações ao baixar a configuração WireGuard na área de membros do ProtonVPN.
Vá até ProtonVPN e vá em Baixar
Configure de acordo com suas preferências (país), porém com as opções iguais a da imagem

• Irá aparecer a opção para baixar (arquivo.conf) ou copiar.
  

• Assim, terá acesso aos dados ( PRIVATE_KEY, PUBLIC_KEY, ENDPOINT)

No ENDPOINT não é preciso colocar a porta, apenas o ip
Não use aspas simples ou duplas "", ''.

4. 🚀 Iniciar os serviços

docker compose up -d

• A interface Web do qBittorrent estará disponível em:http://localhost:8080

5. ✅ Verificação de funcionamento

• Acesse o WebUI do qBittorrent
  

• Vá em Configurações → Conexão
  

• Verifique se a porta está corretamente definida
  

• Faça um teste em https://portcheckers.com com a porta encaminhada (salva em vpn/forwarded_port)

🧠"Dicas extras

• Use o mod VueTorrent para uma interface mais moderna (já incluído)
  

• O qbittorrent-natmap vai atualizar automaticamente a porta no qBittorrent sempre que a ProtonVPN renovar o lease
  

• Para segurança extra, evite mapear pastas sensíveis no contêiner

Isto posto, deverá ser o suficiente para fugir do CGNATIZÃO.Por fim, qualquer dúvida coloque nos comentários abaixo que algum membro da comunidade pode lhe auxiliar.