Communityoplossing

Leid Deluge via Gluetun op ZimaOS zonder de webinterface te verliezen

A March 2026 ZimaOS user restored the Deluge Web UI by exporting Compose, removing Deluge's own ports, and sharing Gluetun's network namespace; another user later could not reproduce the result.

Een ZimaOS-gebruiker had Gluetun verbonden met NordVPN en wilde dat Deluge dezelfde VPN-netwerkstack zou gebruiken. Gluetun draaide, maar de webinterface van Deluge kon niet worden geopend. Uiteindelijk exporteerde de gebruiker de Compose-definitie van Deluge, verwijderde de eigen poortkoppelingen, voegde het delen van het containernetwerk toe en importeerde de stack opnieuw.

Dit was een door de community bevestigde configuratie, geen template uit de IceWhale App Store. Een latere gebruiker kon dit niet reproduceren met Deluge en gebruikte in plaats daarvan Transmission.

Hoe het netwerkpad van Gluetun en Deluge werkt

Browser → door Gluetun gepubliceerde poort → webinterface van Deluge
Verkeer van Deluge → netwerknaamruimte van Gluetun → VPN-tunnel → internet

Wanneer Deluge de netwerknaamruimte van Gluetun gebruikt, heeft Deluge niet langer een eigen onafhankelijke netwerkstack. De webinterface en peerpoorten moeten door Gluetun worden gepubliceerd en mogen niet nogmaals op Deluge worden ingesteld.

Instellingen van de ZimaOS-Deluge-app voordat het netwerk via Gluetun werd gerouteerd
De oorspronkelijke Deluge-installatie gebruikte nog een eigen netwerk en stelde geen werkende webinterface via Gluetun beschikbaar.
Instellingen van de ZimaOS-Gluetun-app met VPN-inloggegevens en Deluge-poorten
Gluetun was al verbonden; het resterende probleem was Deluge correct aan de netwerkstack koppelen.

De werkende workflow uit de community

  1. Verwijder de oorspronkelijke Deluge-app nadat je de configuratie en downloads hebt bewaard.
  2. Gebruik een aangepaste installatie om de eigen gepubliceerde poorten van Deluge te verwijderen.
  3. Exporteer de resulterende Compose-definitie.
  4. Voeg network_mode: container:gluetun toe aan Deluge.
  5. Zorg ervoor dat de webinterface en vereiste peerpoorten van Deluge op Gluetun worden gepubliceerd.
  6. Importeer de bewerkte Compose-stack en open Deluge via de door Gluetun gepubliceerde hostpoort.

Het officiële Gluetun-project documenteert network_mode: "container:gluetun" voor een container in een ander Compose-project en network_mode: "service:gluetun" voor services in hetzelfde project. Bekijk de handleiding voor het verbinden van containers met Gluetun voordat je een van beide opties kiest.

Controleer zowel bereikbaarheid als uitgaand verkeer

De oorspronkelijke gebruiker controleerde het externe IP-adres binnen de Deluge-omgeving en zag het VPN-adres in plaats van het adres van de internetprovider. Test ook of de webinterface bereikbaar blijft vanaf het LAN, downloads de bedoelde paden gebruiken en het verkeer stopt als Gluetun niet meer gezond is.

Bescherm VPN-inloggegevens en Compose-exports

Schermafbeeldingen en geëxporteerde YAML-bestanden kunnen gebruikersnamen en wachtwoorden van providers, privésleutels, serverlocaties en lokale paden bevatten. Maak deze gegevens onleesbaar voordat je ze deelt. Gebruik waar mogelijk omgevingsbestanden of secrets en roteer inloggegevens die openbaar zijn blootgesteld.

Begrijp de grens van de App Store

Door Compose te exporteren en opnieuw te importeren, kan de nieuwe stack worden losgekoppeld van de oorspronkelijke levenscyclus van de App Store. Noteer image-tags en configuratie en test upgrades daarna handmatig. Voer niet zomaar algemene opdrachten uit om de Docker-cache op te schonen omdat een herinstallatie instellingen heeft behouden; permanente AppData is juist bedoeld om containervervanging te overleven.

Veelgestelde vragen over Gluetun en Deluge

Waarom verdween de webinterface van Deluge?

Zodra Deluge de netwerknaamruimte van Gluetun deelt, moet de toegangspoort ervan door Gluetun worden gepubliceerd.

Moet Deluge de eigen poortkoppelingen behouden?

Niet in deze configuratie met een gedeeld netwerk; publiceer de vereiste poorten op Gluetun.

Was het resultaat universeel?

Nee. De oorspronkelijke poster bevestigde dat het werkte, terwijl een latere deelnemer Transmission gebruikte nadat het niet lukte om de Deluge-configuratie te reproduceren.