Ten poradnik społecznościowy opisuje sposób uruchomienia AzuraCast w systemie ZimaOS poprzez zaimportowanie zmodyfikowanej konfiguracji Docker Compose jako niestandardowej aplikacji. Oryginalny wpis z grudnia 2025 roku został przetestowany na urządzeniu ZimaBoard z systemem ZimaOS 1.5.3 Plus i dotyczył przede wszystkim użytku prywatnego lub domowego w sieci lokalnej albo za pośrednictwem Tailscale.
Ważne: autor później zaktualizował wątek 5 stycznia 2026 roku i poinformował, że dalsze testy wykazały, iż ta metoda instalacji bywa niestabilna lub nie działa, a automatyczne aktualizowanie AzuraCast przez interfejs internetowy również sprawiało problemy w tej konfiguracji. Późniejsza korekta jest ważniejsza niż pierwotne twierdzenie, że konfiguracja działała bez zarzutu.
Z czego korzystała oryginalna konfiguracja ZimaOS
Środowisko źródłowe obejmowało urządzenie ZimaBoard z procesorem Intel Celeron N3450, 8 GB pamięci, układem graficznym Intel HD Graphics 500 oraz systemem ZimaOS 1.5.3 Plus. Autor zaimportował niestandardową definicję Compose dla AzuraCast za pośrednictwem interfejsu niestandardowych aplikacji ZimaOS.
Procedura wyglądała następująco:
- Otwórz pulpit nawigacyjny ZimaOS i wybierz Zainstaluj niestandardową aplikację.
- Użyj opcji Importuj i prześlij definicję Docker Compose.
- Przed instalacją sprawdź wygenerowane ustawienia web i updater.
- Dostosuj porty po stronie hosta oraz ścieżki woluminów po stronie ZimaOS, nie zmieniając odpowiadających im ścieżek kontenera AzuraCast.
- Zainstaluj aplikację i otwórz AzuraCast, używając adresu serwera oraz skonfigurowanego portu interfejsu internetowego.
Aktualna dokumentacja ZimaOS nadal obsługuje importowanie plików YAML Docker Compose dla niestandardowych aplikacji. Zobacz aktualną dokumentację funkcji ZimaOS.
Mapowanie portów hosta bez zmiany portów kontenera
W konfiguracji źródłowej autor wyróżnił mapowania po stronie hosta odpowiadające portom kontenera AzuraCast 80, 443 i 8000. Zalecano zmianę wartości po stronie hosta na porty odpowiednie dla lokalnej instalacji ZimaOS, przy pozostawieniu bez zmian wartości po stronie kontenera.
Karta aktualizatora zawierała również adres interfejsu internetowego. Zgodnie z poradnikiem port interfejsu internetowego powinien odpowiadać portowi po stronie hosta zmapowanemu na port kontenera 80.
Zachowaj stabilne ścieżki kontenera AzuraCast
Autor zmienił również mapowania pamięci trwałej po stronie ZimaOS, pozostawiając bez zmian ścieżki po stronie AzuraCast. Opublikowany stos obejmował pamięć na stacje, kopie zapasowe, dane MySQL, przesyłane pliki, opcjonalne komponenty oraz osobny katalog muzyczny.
Poradnik odradzał zmienianie zmiennych środowiskowych bez zrozumienia ich przeznaczenia. Jest to szczególnie ważne, ponieważ dane uwierzytelniające aplikacji i ustawienia bazy danych mogą być zawarte w danych środowiskowych Compose.
Nie traktuj opublikowanego pliku Compose jako gotowego szablonu danych uwierzytelniających
Oryginalny plik YAML z forum zawiera wartości zmiennych środowiskowych związane z bazą danych. Strona społecznościowa nie powinna zamieniać opublikowanych wartości w gotowy do ponownego użycia szablon danych uwierzytelniających. Jeśli odtwarzasz ten stos, użyj danych odpowiednich dla własnej instalacji i postępuj zgodnie z aktualnymi zaleceniami dotyczącymi konfiguracji AzuraCast.
Aktualne informacje dotyczące instalacji i konfiguracji znajdziesz w oficjalnym poradniku instalacji AzuraCast za pomocą Dockera.
Autor później zgłosił problemy ze stabilnością i aktualizacjami
Dziewięć dni po opublikowaniu poradnika ten sam autor zamieścił ważną korektę: dodatkowe eksperymenty wykazały, że ta metoda czasami nie działała i mogła być niestabilna. Autor zgłosił również problemy z automatycznym procesem aktualizacji AzuraCast przez interfejs internetowy przy użyciu tej metody instalacji.
Autor poinformował, że eksperymentuje z instalacją opartą na SSH i planuje bardziej szczegółowy poradnik uzupełniający, ale w tym wątku nie opublikowano zastępczej procedury. Z tego powodu tę stronę należy traktować jako opisany eksperyment społecznościowy ze znanymi ograniczeniami, a nie jako aktualną, oficjalnie wspieraną metodę instalacji AzuraCast w ZimaOS.
Porównaj metodę społecznościową z aktualnymi zaleceniami AzuraCast
Aktualna dokumentacja AzuraCast zaleca używanie Dockera w przypadku większości samodzielnie hostowanych instalacji oraz opisuje własny proces instalacji i aktualizacji za pomocą Dockera. Ostrzega również, aby przed aktualizacjami wykonywać kopie zapasowe, ponieważ nieudana aktualizacja może spowodować przerwę w działaniu stacji lub utratę danych.
Przed poleganiem na działaniu aktualizatora z tego historycznego stosu Compose dla ZimaOS zapoznaj się z oficjalną dokumentacją aktualizacji AzuraCast.
Źródłowy poradnik był przeznaczony do użytku w sieci prywatnej
Autor wyraźnie przedstawił poradnik jako rozwiązanie do dostępu domowego lub prywatnego w sieci lokalnej albo za pośrednictwem Tailscale. Udostępnienie usługi w publicznym internecie może wymagać dodatkowych decyzji dotyczących sieci, TLS, zapory sieciowej, uwierzytelniania i bezpieczeństwa nadawania, które nie były objęte wpisem społecznościowym.
Nie zakładaj, że działający lokalnie interfejs internetowy wystarczy do przygotowania publicznej stacji radiowej.
AzuraCast w ZimaOS — często zadawane pytania
Czy autor ze społeczności potwierdził, że ta metoda jest stabilna?
Nie. Oryginalny wpis był optymistyczny, ale uzupełnienie z 5 stycznia 2026 roku wyraźnie stwierdzało, że metoda może być niestabilna lub kończyć się niepowodzeniem w części testów.
Jakiej wersji ZimaOS użyto?
W oryginalnym poradniku użyto systemu ZimaOS 1.5.3 Plus na urządzeniu ZimaBoard. Zrzuty ekranu i wygenerowane ustawienia aplikacji należy traktować jako przykłady historyczne, a nie dokładne instrukcje dla każdej nowszej wersji.
Czy należy zmieniać ścieżki woluminów po stronie kontenera AzuraCast?
Poradnik źródłowy zaleca zmianę ścieżek po stronie hosta ZimaOS zgodnie z potrzebami, przy pozostawieniu bez zmian ścieżek po stronie kontenera AzuraCast.
Dlaczego port interfejsu internetowego aktualizatora musi odpowiadać mapowaniu usługi internetowej?
W konfiguracji źródłowej wpis interfejsu internetowego aktualizatora wskazywał port hosta zmapowany na port kontenera 80. Użycie innej wartości spowodowałoby przekierowanie skrótu ZimaOS na niewłaściwy port.
Czy automatyczne aktualizowanie AzuraCast działa niezawodnie z tym stosem społecznościowym?
Autor wyraźnie zgłosił problemy z automatycznym aktualizowaniem przez interfejs internetowy po przeprowadzeniu dalszych testów. Korzystaj z aktualnej dokumentacji aktualizacji AzuraCast i wykonuj kopie zapasowe, zamiast zakładać, że historyczny kontener aktualizatora jest niezawodny.
