이 커뮤니티 튜토리얼은 수정된 Docker Compose 구성을 사용자 지정 앱으로 가져와 ZimaOS에서 AzuraCast를 실행하는 방법을 설명합니다. 2025년 12월에 게시된 원문은 ZimaOS 1.5.3 Plus가 설치된 ZimaBoard에서 테스트되었으며, 로컬 네트워크 또는 Tailscale을 통한 개인용 또는 가정용 사용에 초점을 맞췄습니다.
중요: 작성자는 이후 2026년 1월 5일 스레드를 업데이트하면서 추가 테스트 결과 이 설치 방법이 때때로 불안정하거나 작동하지 않았고, AzuraCast의 자동 웹 업데이트도 이 구성에서 문제가 있었다고 밝혔습니다. 따라서 구성이 완벽하게 작동한다는 원래 주장보다 이 후속 정정 내용이 더 중요합니다.
원래 ZimaOS 설정에서 사용한 구성
원본 환경은 Intel Celeron N3450, 8GB 메모리, Intel HD Graphics 500 및 ZimaOS 1.5.3 Plus가 탑재된 ZimaBoard였습니다. 작성자는 ZimaOS 사용자 지정 앱 인터페이스를 통해 수정된 AzuraCast Compose 정의를 가져왔습니다.
작업 순서는 다음과 같습니다.
- ZimaOS 대시보드를 열고 사용자 지정 앱 설치를 선택합니다.
- 가져오기를 사용하고 Docker Compose 정의를 제출합니다.
- 설치하기 전에 생성된 web 및 updater 설정을 검토합니다.
- 호스트 측 포트와 ZimaOS 측 볼륨 경로를 조정하되, 해당 AzuraCast 컨테이너 경로는 변경하지 않습니다.
- 앱을 설치한 뒤 서버 주소와 구성한 웹 UI 포트를 사용해 AzuraCast를 엽니다.
현재 ZimaOS 문서에서도 사용자 지정 앱용 Docker Compose YAML 가져오기를 계속 지원합니다. 현재 ZimaOS 기능 문서를 참조하세요.
컨테이너 포트는 변경하지 말고 호스트 포트를 매핑하세요
원본 구성에서 작성자는 AzuraCast 컨테이너 포트 80, 443 및 8000에 해당하는 호스트 매핑을 강조했습니다. 권장 사항은 컨테이너 측 값은 그대로 두고, 호스트 측 값을 로컬 ZimaOS 설치 환경에 맞는 포트로 변경하는 것이었습니다.
updater 탭에도 웹 UI 주소가 포함되어 있었습니다. 가이드에서는 이 웹 UI 포트가 컨테이너 포트 80에 매핑된 호스트 측 포트와 일치해야 한다고 설명합니다.
AzuraCast 컨테이너 경로는 그대로 유지하세요
작성자는 AzuraCast 측 경로는 그대로 두고 ZimaOS 측의 영구 저장소 경로도 다시 매핑했습니다. 게시된 스택에는 스테이션, 백업, MySQL 데이터, 업로드, 선택적 구성 요소 및 별도의 음악 디렉터리를 위한 저장소가 포함되어 있었습니다.
가이드에서는 관리자가 환경 변수의 용도를 이해하지 못한 경우 해당 변수를 변경하지 말 것을 권장했습니다. Compose 환경 데이터에는 애플리케이션 자격 증명과 데이터베이스 설정이 포함될 수 있으므로 특히 중요합니다.
게시된 Compose 파일을 재사용 가능한 비밀 정보 템플릿으로 취급하지 마세요
원본 포럼 YAML에는 데이터베이스 관련 환경 값이 포함되어 있습니다. 커뮤니티 페이지에서 해당 게시 값을 재사용 가능한 자격 증명 템플릿으로 제공해서는 안 됩니다. 이 스택을 다시 구성하려면 자신의 설치 환경에 적합한 자격 증명을 사용하고 최신 AzuraCast 구성 지침을 따르세요.
최신 업스트림 설치 및 구성 정보는 공식 AzuraCast Docker 설치 가이드를 참조하세요.
작성자는 이후 안정성 및 업데이트 문제를 보고했습니다
가이드를 게시한 지 9일 후, 같은 작성자는 중요한 정정 내용을 올렸습니다. 추가 실험 결과 이 방법이 때때로 작동하지 않았고 불안정할 수 있다는 내용이었습니다. 또한 이 설치 방법에서 AzuraCast의 자동 웹 업데이트 프로세스에 문제가 있었다고 보고했습니다.
작성자는 SSH 기반 설치를 실험 중이며 더 자세한 후속 가이드를 작성할 예정이라고 밝혔지만, 이 스레드에는 대체 절차가 게시되지 않았습니다. 따라서 이 페이지는 알려진 제한이 있는 커뮤니티 실험 기록으로 읽어야 하며, 현재 공식적으로 지원되는 AzuraCast-on-ZimaOS 설치 방법으로 간주해서는 안 됩니다.
커뮤니티 방법과 최신 AzuraCast 지침을 비교하세요
현재 AzuraCast 문서는 대부분의 자체 호스팅 설치에 Docker를 권장하며, 자체 Docker 설치 및 업데이트 절차를 제공합니다. 또한 업데이트에 실패하면 스테이션 중단이나 데이터 손실이 발생할 수 있으므로 업데이트 전에 백업할 것을 사용자에게 경고합니다.
이 과거 ZimaOS Compose 스택의 updater 동작에 의존하기 전에 공식 AzuraCast 업데이트 문서를 참조하세요.
원본 가이드는 사설 네트워크 사용을 전제로 했습니다
작성자는 튜토리얼의 목적을 로컬 네트워크 또는 Tailscale을 통한 가정용 또는 사설 액세스로 명확히 한정했습니다. 공용 인터넷에 서비스를 노출하려면 추가 네트워킹, TLS, 방화벽, 인증 및 방송 보안 관련 결정을 내려야 할 수 있으며, 이는 해당 커뮤니티 게시물의 범위를 벗어납니다.
로컬 웹 UI가 작동한다고 해서 공용 라디오 서비스를 운영할 준비가 충분히 된 것으로 간주하지 마세요.
ZimaOS에서 AzuraCast 사용 FAQ
커뮤니티 작성자는 이 방법이 안정적이라고 확인했나요?
아니요. 원래 게시물은 낙관적인 내용이었지만, 2026년 1월 5일 후속 글에서는 이 방법이 일부 테스트에서 불안정하거나 실패할 수 있다고 명시했습니다.
어떤 ZimaOS 버전을 사용했나요?
원래 가이드에서는 ZimaBoard에서 ZimaOS 1.5.3 Plus를 사용했습니다. 스크린샷과 생성된 앱 설정은 최신 버전마다 그대로 적용되는 지침이 아니라 과거의 예시로 간주하세요.
AzuraCast 컨테이너 측 볼륨 경로를 변경해야 하나요?
원본 가이드에서는 필요에 따라 ZimaOS 호스트 측 경로를 변경하고 AzuraCast 컨테이너 측 경로는 그대로 유지하라고 설명합니다.
updater 웹 UI 포트가 웹 서비스 매핑과 일치해야 하는 이유는 무엇인가요?
원본 구성에서 updater의 웹 UI 항목은 컨테이너 포트 80에 매핑된 호스트 포트를 가리켰습니다. 다른 값을 사용하면 ZimaOS 바로 가기가 잘못된 포트로 연결됩니다.
이 커뮤니티 스택에서 AzuraCast 자동 업데이트가 안정적으로 작동하나요?
작성자는 추가 테스트 후 자동 웹 업데이트에 문제가 있었다고 명시적으로 보고했습니다. 과거의 updater 컨테이너가 안정적이라고 가정하지 말고, 최신 AzuraCast 업데이트 문서를 따르며 백업을 유지하세요.
