Rozwiązanie społecznościowe

Edytowanie pliku Docker Compose dla zainstalowanych aplikacji ZimaOS: co zmieniło się w App Store 2.0

A January 2026 discussion about adding Traefik labels and custom DNS to installed ZimaOS apps. IceWhale said it was refactoring the App Store to add direct YAML editing; ZimaOS 1.7.0 later introduced native YAML support.

W styczniu 2026 roku użytkownicy, którzy zainstalowali aplikację ze sklepu ZimaOS App Store, mogli zmieniać ujawnione ustawienia, takie jak porty, zmienne środowiskowe i woluminy, ale nie mieli takiej samej kontroli na poziomie Compose jak w przypadku stosu, którego byli właścicielami. Stało się to problemem przy zaawansowanych ustawieniach, takich jak etykiety Traefik, współdzielone sieci, oprogramowanie pośredniczące czy DNS specyficzny dla kontenera.

Ważna aktualizacja polega na tym, że plan opisany w wątku nie dotyczy już wyłącznie przyszłości. IceWhale poinformowało o przebudowie App Store w celu dodania edycji plików YAML Docker Compose, a później w ZimaOS 1.7.0 pojawiła się natywna obsługa YAML.

Dlaczego edycja aplikacji z App Store była trudna na początku 2026 roku

Wyjaśnienie społeczności było takie, że aplikacje zainstalowane ze sklepu są zarządzane przez ZimaOS. Edycja wygenerowanego pliku Compose poza tą ścieżką zarządzania mogła zostać nadpisana podczas ponownego wdrażania lub aktualizacji.

Dla zaawansowanych użytkowników praktycznym obejściem było wówczas zainstalowanie usługi jako Custom Compose, zachowanie tych samych trwałych folderów AppData i samodzielne zarządzanie stosem Compose za pomocą narzędzia takiego jak Dockge lub Portainer.

Zaawansowane ustawienia odwrotnego serwera proxy wymagają kontroli na poziomie Compose

Użytkownikowi chodziło konkretnie o etykiety Traefik oraz możliwość wymuszenia, aby wybrane kontenery korzystały z DNS Cloudflare zamiast Pi-hole. Są to typowe kwestie dotyczące Docker Compose, a nie proste ustawienia tytułu aplikacji lub portu.

Obecne specyfikacje aplikacji w ZimaOS App Store jasno wyznaczają tę granicę: standardowa konfiguracja środowiska uruchomieniowego należy do Docker Compose, natomiast metadane sklepu specyficzne dla ZimaOS należą do x-casaos.

IceWhale potwierdziło, że planowany jest edytor YAML

Zima-Jerry odpowiedział, że zespół przebudowuje App Store i proces instalacji, aby prosta ścieżka instalacji mogła współistnieć z zaawansowaną edycją YAML Docker Compose.

Ta oficjalna odpowiedź jest bardziej wiarygodna niż wcześniejsze założenie społeczności, że aplikacji ze sklepu nigdy nie będzie można edytować bezpośrednio.

ZimaOS 1.7.0 dodał natywną obsługę YAML

Do lipca 2026 roku w ZimaOS App Store 2.0 wprowadzono przeprojektowane zarządzanie aplikacjami oraz natywną obsługę YAML, zapewniającą większą elastyczność konfiguracji aplikacji. Obecny ZimaOS centralizuje również informacje o stanie zainstalowanych aplikacji, aktualizacje i typowe ustawienia na stronie zarządzania aplikacjami.

Obecny przegląd App Store pokazuje jak zainstalowane aplikacje są obecnie zarządzane z przeprojektowanego interfejsu aplikacji ZimaOS.

Natywny YAML nie oznacza automatycznego zarządzania każdym zewnętrznym stosem

Nowy edytor zapewnia większą kontrolę nad aplikacjami zarządzanymi przez ZimaOS, ale nie należy mylić tego z pełnym przejęciem kontroli nad dowolnymi stosami Compose uruchomionymi poza systemem aplikacji ZimaOS. Obecne raporty dotyczące wersji 1.7.x nadal rozróżniają ręcznie uruchamiane grupy Compose od aplikacji zarządzanych bezpośrednio przez ZimaOS.

Zachowaj AppData przy zmianie modelu własności

Jeśli celowo przenosisz aplikację z zarządzanego pakietu sklepowego do samodzielnie zarządzanego stosu Compose, ważne dane zwykle znajdują się w trwałych folderach na hoście. Najpierw wykonaj ich kopię zapasową, a następnie odtwórz te same mapowania woluminów, porty, wartości zmiennych środowiskowych i zależności baz danych, zanim usuniesz stary kontener.

Nie zakładaj, że ponowne utworzenie kontenera automatycznie przeniesie wszystkie ustawienia lub sekrety specyficzne dla ZimaOS.

Często zadawane pytania dotyczące edycji YAML aplikacji ZimaOS

Czy bezpośrednia edycja Compose była dostępna w momencie opublikowania wątku?

Nie w sposób, którego oczekiwał użytkownik. Obejściem zalecanym przez społeczność było Custom Compose, a IceWhale poinformowało, że bezpośrednia edycja YAML jest w przygotowaniu.

Czy ZimaOS ostatecznie dodał natywną edycję YAML?

Tak. Wraz z przeprojektowaniem App Store 2.0 w ZimaOS 1.7.0 zapowiedziano natywną obsługę YAML.

Czy nadal warto używać Dockge?

Może to nadal mieć sens, jeśli celowo chcesz samodzielnie zarządzać niezależnym stosem Compose, zamiast powierzać zarządzanie aplikacją systemowi ZimaOS.

Czy mogę zachować istniejące dane aplikacji podczas przechodzenia na Custom Compose?

Często tak, jeśli trwałe foldery na hoście zostaną zachowane i prawidłowo ponownie zmapowane, ale najpierw wykonaj kopię zapasową danych i zapisz oryginalne ustawienia kontenera.