Een ZimaOS-gebruiker wilde qBittorrent en een ARR-stack via ProtonVPN met Gluetun laten lopen, maar Gluetun leek grijs weergegeven en had geen normale webinterface. In de thread werden twee architecturen voorgesteld: een qBittorrent-image met geïntegreerde VPN-ondersteuning, of een afzonderlijke Gluetun-container die de netwerknaamruimte beheert.
Gluetun is in de eerste plaats een VPN-gatewaycontainer. Een grijze app-tegel bewijst op zichzelf niet dat er iets mis is, en de control-server ervan is niet hetzelfde als een conventioneel applicatiedashboard.
Plaats qBittorrent in de netwerknaamruimte van Gluetun
Bij het patroon met afzonderlijke containers gebruikt qBittorrent:
network_mode: "service:gluetun"Omdat qBittorrent dan de netwerkstack van Gluetun deelt, publiceer je de qBittorrent-webinterface en torrentpoorten op de Gluetun-service, niet op qBittorrent:
services:
gluetun:
ports:
- "9080:9080/tcp"
qbittorrent:
network_mode: "service:gluetun"Pas de poort aan volgens de gedocumenteerde webinterface-instelling van de qBittorrent-image. Kopieer het volledige Compose-voorbeeld uit de thread niet zonder controle: het bevat inconsistenties in spelling en netwerknamen die implementatie kunnen verhinderen.
Genereer ProtonVPN-inloggegevens voor het gekozen protocol
Gebruik de WireGuard-configuratiehandleiding van Proton VPN in plaats van een normaal accountwachtwoord. Sla de privésleutel op als secret of als beschermde omgevingswaarde en plak deze nooit in schermafbeeldingen, forumberichten of een openbare Compose-repository.
De huidige ProtonVPN-providerdocumentatie van Gluetun is leidend voor de variabelenamen. In huidige releases gebruik je VPN_PORT_FORWARDING=on wanneer Proton-port forwarding vereist is.
VPN-port forwarding is niet hetzelfde als Docker-poortkoppeling
Een Docker-koppeling maakt een lokale service vanuit de container beschikbaar op je LAN. De doorgestuurde poort van Proton wordt op de VPN-server toegewezen voor inkomend peer-verkeer. De handleiding van Gluetun voor VPN-port forwarding maakt dit onderscheid expliciet.
Schakel voor Proton WireGuard NAT-PMP in bij het genereren van de configuratie en selecteer een server die P2P en port forwarding ondersteunt. Proton wijst een willekeurige doorgestuurde poort toe; mogelijk moet je qBittorrent automatiseren zodat de luisterpoort deze waarde volgt.
Houd secrets uit het hoofd-Compose-bestand
Het communityvoorbeeld maakte afzonderlijke mappen env/ en secrets/ voor de WireGuard-privésleutel en qBittorrent-inloggegevens. Dat is veiliger dan ze rechtstreeks in het bestand op te nemen, maar bestandsrechten en back-ups blijven belangrijk. Een Docker-secretbestand is op de host platte tekst voordat Docker het koppelt.
Controleer de tunnel voordat je downloads start
- Start Gluetun en controleer de logs op een geslaagde VPN-verbinding.
- Controleer of de healthcheck slaagt.
- Start qBittorrent in de naamruimte van Gluetun.
- Open de webinterface via de hostpoort die op Gluetun is gepubliceerd.
- Controleer het openbare IP-adres vanuit de gedeelde naamruimte.
- Stop Gluetun en controleer of qBittorrent de internettoegang verliest voordat je op de kill-switchfunctionaliteit vertrouwt.
Een geïntegreerde VPN-image is een andere afweging
In de thread werd de Proton-documentatie voor qBittorrent van Hotio voorgesteld als alternatief, waarbij de afzonderlijke Gluetun-service kan vervallen. Dat kan de stack vereenvoudigen, maar verandert de image, omgevingsvariabelen, updateprocedure en bron voor ondersteuning. Kies één architectuur in plaats van beide te combineren.
Veelgestelde vragen over Gluetun en qBittorrent
Waarom opent de Gluetun-tegel niet zoals een app?
Gluetun is een gatewaycontainer; de optionele control-server ervan is geen normale webinterface zoals die van qBittorrent.
Waar moet de webinterfacepoort van qBittorrent worden gepubliceerd?
Op Gluetun wanneer qBittorrent network_mode: service:gluetun gebruikt.
Moet het volledige Compose-bestand uit de thread ongewijzigd worden geplakt?
Nee. Het bevat vermoedelijk typefouten en moet opnieuw worden opgebouwd aan de hand van de actuele documentatie van Gluetun, qBittorrent en Proton.
