커뮤니티 솔루션

웹 UI를 잃지 않고 ZimaOS에서 Gluetun을 통해 Deluge 라우팅하기

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.

ZimaOS 사용자는 Gluetun을 NordVPN에 연결한 상태에서 Deluge가 Gluetun의 VPN 네트워크 스택을 공유하도록 설정하려 했습니다. Gluetun은 실행 중이었지만 Deluge Web UI가 열리지 않았습니다. 결국 사용자는 Deluge의 Compose 정의를 내보내고, 자체 포트 매핑을 제거한 다음 컨테이너 네트워크 공유를 추가하고 스택을 다시 가져왔습니다.

이는 IceWhale App Store 템플릿이 아닌, 커뮤니티에서 확인된 구성입니다. 이후 다른 사용자는 Deluge로 동일한 구성을 재현하지 못해 대신 Transmission을 사용했습니다.

Gluetun과 Deluge의 네트워크 경로 작동 방식

브라우저 → Gluetun이 게시한 포트 → Deluge Web UI
Deluge 트래픽 → Gluetun 네트워크 네임스페이스 → VPN 터널 → 인터넷

Deluge가 Gluetun의 네트워크 네임스페이스를 사용하면 Deluge는 더 이상 독립적인 네트워크 스택을 소유하지 않습니다. 따라서 Web UI와 피어 포트는 Deluge에 중복해서 게시하지 말고 Gluetun에서 게시해야 합니다.

네트워크를 Gluetun을 통해 라우팅하기 전 ZimaOS Deluge 애플리케이션 설정
기존 Deluge 설치는 자체 네트워킹을 사용하고 있었으며 Gluetun을 통해 작동하는 Web UI를 노출하지 못했습니다.
VPN 자격 증명과 Deluge 포트가 설정된 ZimaOS Gluetun 애플리케이션 설정
Gluetun은 이미 연결되어 있었으며, 남은 문제는 Deluge를 Gluetun의 네트워크 스택에 올바르게 연결하는 것이었습니다.

커뮤니티에서 작동이 확인된 절차

  1. 구성 및 다운로드 데이터를 보존한 후 처음 설치한 Deluge 앱을 제거합니다.
  2. 사용자 지정 설치를 사용해 Deluge 자체의 게시 포트를 제거합니다.
  3. 생성된 Compose 정의를 내보냅니다.
  4. Deluge에 network_mode: container:gluetun을 추가합니다.
  5. Deluge Web UI와 필요한 피어 포트가 Gluetun에서 게시되도록 합니다.
  6. 편집한 Compose 스택을 가져온 다음 Gluetun에서 게시한 호스트 포트를 통해 Deluge를 엽니다.

공식 Gluetun 프로젝트는 다른 Compose 프로젝트의 컨테이너에는 network_mode: "container:gluetun"을, 동일한 프로젝트의 서비스에는 network_mode: "service:gluetun"을 사용하도록 안내합니다. 어느 방식을 선택할지 결정하기 전에 Gluetun 컨테이너 연결 가이드를 검토하세요.

접속 가능성과 외부 트래픽 경로를 모두 확인하세요

원문의 사용자는 Deluge 환경 내부에서 외부 IP를 확인했고, ISP 주소가 아닌 VPN 주소가 표시되는 것을 확인했습니다. 또한 Web UI가 LAN에서 계속 접속 가능한지, 다운로드가 의도한 경로를 사용하는지, Gluetun이 비정상 상태가 되면 트래픽이 중단되는지도 테스트하세요.

VPN 자격 증명과 Compose 내보내기 파일을 보호하세요

스크린샷과 내보낸 YAML에는 공급자 사용자 이름, 비밀번호, 개인 키, 서버 위치, 로컬 경로가 포함될 수 있습니다. 공유하기 전에 해당 정보를 가리세요. 지원되는 경우 환경 파일이나 시크릿을 우선 사용하고, 공개적으로 노출된 자격 증명은 교체하세요.

App Store의 관리 범위를 이해하세요

Compose를 내보내고 다시 가져오면 새 스택이 기존 App Store 수명 주기 관리에서 분리될 수 있습니다. 이미지 태그와 구성을 기록한 뒤 업그레이드를 수동으로 테스트하세요. 재설치 후에도 설정이 유지된다는 이유만으로 광범위한 “Docker 캐시 정리” 명령을 실행하지 마세요. 영구 AppData는 컨테이너 교체 후에도 유지되도록 설계되어 있습니다.

Gluetun 및 Deluge FAQ

Deluge Web UI가 사라진 이유는 무엇인가요?

Deluge가 Gluetun의 네트워크 네임스페이스를 공유하면 Deluge의 접속 포트를 Gluetun에서 게시해야 합니다.

Deluge가 자체 포트 매핑을 유지해야 하나요?

이 공유 네트워크 구성에서는 유지하지 않습니다. 필요한 포트는 Gluetun에서 게시하세요.

이 결과는 모든 환경에서 동일했나요?

아니요. 최초 게시자는 구성이 작동한다고 확인했지만, 이후 참여자는 Deluge 설정을 재현하지 못해 Transmission을 사용했습니다.