커뮤니티 솔루션

ZimaOS에서 qBittorrent 서비스를 사용할 수 없을 때 확인할 사항

A ZimaOS 1.5.4 qBittorrent install opened a Service unavailable page; replies suggested logs, an alternative LinuxServer image and newer App Store paths.

ZimaOS 1.5.4에서 qBittorrent의 “서비스를 사용할 수 없음” 페이지가 표시된다고 해서 GPU/장치 패스스루나 권한 상승 모드가 필요하다는 의미는 아닙니다. 확인해야 할 사항은 컨테이너 로그, WebUI 포트 매핑, 생성된 비밀번호, 영구 /config 경로, 그리고 앱 이미지 자체가 정상적으로 시작되는지 여부입니다.

원본 스레드에서는 원래 hotio 컨테이너에 대한 확인된 해결책에 도달하지 못했습니다. 대신 커뮤니티 구성원들은 LinuxServer 기반 앱을 제안하고 여러 App Store 설치 경로를 보여 주었으므로, 이러한 제안은 입증된 수리가 아니라 대안으로 간주해야 합니다.

원래 오류의 모습

ZimaOS의 qBittorrent 서비스 사용 불가 오류 페이지
내장 qBittorrent 앱을 열면 일반적인 “서비스를 사용할 수 없음” 페이지가 표시되었습니다. 출처: IceWhale 커뮤니티 포럼.
로그의 관리자 비밀번호와 DATA 경로를 보여 주는 qBittorrent 팁 대화 상자
ZimaOS에는 임시 관리자 비밀번호를 로그에서 확인해야 한다는 안내와 앱에서 접근 가능한 DATA 경로가 표시되었습니다. 출처: IceWhale 커뮤니티 포럼.

qBittorrent 래퍼가 애플리케이션에 연결하지 못했습니다. ZimaOS 자체에서도 이미 사용자에게 시작 로그를 확인하라고 안내했으며, 이는 올바른 진단 단계입니다.

재설치하기 전에 기존 컨테이너 확인

hotio 이미지 릴리스 5.0.4를 사용하는 ZimaOS qBittorrent 앱 설정
사용자의 앱 정의에서는 hotio qBittorrent 이미지를 사용하고, 브리지 네트워킹과 호스트 포트 8181 및 컨테이너 포트 8080을 설정했습니다. 출처: IceWhale 커뮤니티 포럼.
ZimaOS의 qBittorrent PUID, PGID, 시간대 및 UMASK 설정
기존 컨테이너에는 이미 일반적인 PUID/PGID, 시간대 및 UMASK 값이 설정되어 있었습니다. 출처: IceWhale 커뮤니티 포럼.
ZimaOS qBittorrent 권한 및 장치 필드 강조 표시
사용자는 장치 또는 권한 상승 모드가 필요한지 궁금해했지만, 어느 쪽도 일반적인 qBittorrent WebUI 요구 사항이 아닙니다. 출처: IceWhale 커뮤니티 포럼.

호스트 WebUI 포트가 qBittorrent가 실제로 수신 대기하는 포트에 매핑되는지 확인하세요. /config 영구적으로 유지되며, 컨테이너 로그에 구성/데이터베이스 시작 오류가 표시되지 않는지 확인합니다. 일반적인 qBittorrent 컨테이너에는 GPU나 임의의 호스트 장치가 필요하지 않습니다.

LinuxServer 이미지에서 WebUI 포트를 변경하는 경우, 최신 문서에서는 Docker 포트 매핑과 WEBUI_PORT가 일치해야 한다고 안내합니다. LinuxServer qBittorrent 문서를 참조하세요.

LinuxServer 제안은 대체 이미지였습니다.

앱 스토어의 LinuxServer qBittorrent 앱 타일
커뮤니티 답변에서는 대신 LinuxServer qBittorrent 이미지를 사용할 것을 제안했습니다. 출처: IceWhale 커뮤니티 포럼.
5.1.4 r2 ls441용 LinuxServer qBittorrent 릴리스 페이지
해당 스레드에서 연결한 것은 LinuxServer qBittorrent 컨테이너 릴리스이지, ZimaOS에 직접 설치해야 하는 파일이 아닙니다. 출처: IceWhale 커뮤니티 포럼.

스크린샷의 릴리스 에셋은 소스 코드 다운로드 파일이며, ZimaOS에 업로드할 패키지가 아닙니다. 컨테이너화된 qBittorrent 설치에서는 Docker 이미지를 참조하고 올바른 설정으로 컨테이너를 다시 생성해야 합니다.

qBittorrent 컨테이너 가이드는 WebUI가 시작된 후 저장소 매핑을 확인해야 할 때 유용합니다.

ZimaOS 버전별 App Store 메뉴 변경

커뮤니티 소스가 나열된 ZimaOS 앱 저장소 드롭다운
다른 답변에서는 더 최신 App Store 레이아웃에서 사용할 수 있는 저장소 소스 메뉴를 보여 주었습니다. 출처: IceWhale 커뮤니티 포럼.
App Store가 강조 표시된 ZimaOS 대시보드
사용자는 영어와 체코어가 혼합된 인터페이스에서 App Store를 찾았습니다. 출처: IceWhale 커뮤니티 포럼.
ZimaOS App Store 컨테이너 애플리케이션 추가 인터페이스
새 인터페이스에서는 다른 사용자가 보여 준 정확한 메뉴 대신 “컨테이너 애플리케이션 추가” 작업이 표시되었습니다. 출처: IceWhale 커뮤니티 포럼.
ZimaOS 수동 앱 설치 양식
수동 설치 양식에서는 이미지, Web UI, 포트, 저장소 및 환경 변수를 정의할 수 있습니다. 출처: IceWhale 커뮤니티 포럼.

이 스크린샷은 오래된 단계별 메뉴 안내가 빠르게 구식이 되는 이유를 보여 줍니다. 릴리스에 따라 저장소 소스와 수동 컨테이너 설치 메뉴의 위치가 App Store UI에서 변경되었습니다.

설치된 ZimaOS 버전의 현재 App Store 레이아웃을 사용하고, 1.5.4 스크린샷을 그대로 재현하려고 하지 마세요.

결론

소스 사례에서는 하나의 확실한 해결책이 입증되지 않았습니다. 로그와 WebUI/구성 매핑부터 확인하고, 문서화된 필요성이 없다면 장치를 추가하거나 권한 모드를 사용하지 마세요. LinuxServer로 전환한다면 필요한 포트가 포함된 현재 컨테이너 이미지를 배포하세요. /config, PUID/PGID 및 GitHub 소스 아카이브를 다운로드하는 대신 생성된 비밀번호 워크플로를 사용합니다.