Jak debugować i rozwiązywać częste problemy z kontenerem w aplikacji Container Station?


Data ostatniej modyfikacji: 2025-04-08

Aplikacja Container Station umożliwia wdrażanie aplikacji i kontenerów innych firm na urządzeniu QNAP. Obrazy open source używane do utworzenia tych kontenerów mogą powodować problemy podczas wdrażania.

Firma QNAP nie zapewnia pomocy technicznej dla obrazów innych firm. Wykonaj poniższe czynności, aby zdiagnozować i rozwiązać typowe problemy związane z kontenerami.

Sprawdzanie konfiguracji kontenera

Kontenery dziedziczą wszystkie atrybuty obrazu źródłowego. Przed wdrożeniem przeskanuj plik obrazu w celu zidentyfikowania luk w zabezpieczeniach, błędnych konfiguracji i ukrytych możliwości dostępu.

Jeśli kontener napotka problemy po wdrożeniu, przeanalizuj dzienniki kontenera, aby zdiagnozować i rozwiązać problemy.

Sprawdzanie informacji o obrazie

Przed wdrożeniem kontenera sprawdź wymagania wstępne dotyczące obrazu i wykonaj wszelkie wymagane kroki.

Wskazówka
Aby znaleźć szczegóły obrazu w rejestrze Docker, kliknij nazwę obrazu na ekranie Eksploruj > Docker Hub w aplikacji Container Station. Możesz też wyszukać obraz w serwisie Docker Hub.

Na przykład podczas wdrażania kontenera PostgreSQL przy użyciu obrazu postgresjest wymagana zmienna środowiskowa POSTGRES_PASSWORD. Kontener nie zostanie wdrożony bez tej zmiennej.

Ważne
Podczas wdrażania kontenera PostgreSQL w aplikacji Container Station skonfiguruj zmienną środowiskową POSTGRES_PASSWORD w sekcji Środowisko.

Analizowanie dzienników zdarzeń aplikacji Container Station

Aplikacja Container Station rejestruje całą aktywność aplikacji i kontenerów. Dzienniki niepowodzeń zawierają wyraźne komunikaty o błędach, w tym nazwę aplikacji lub kontenera, kod błędu i szczegóły błędu.

  1. Otwórz aplikację Container Station.
  2. Kliknij pozycję Dzienniki zdarzeń.
  3. Zlokalizuj dzienniki niepowodzeń.

Przykład 1

W tym przykładzie dziennik zdarzeń zarejestrował niepowodzenie uruchamiania, ponieważ określone porty były już używane przez inne usługi, uniemożliwiając kontenerowi powiązanie z wymaganymi interfejsami sieciowymi.

Przykład 2

W tym przykładzie dziennik zdarzeń zarejestrował niepowodzenie uruchamiania spowodowane błędnie skonfigurowanym poleceniem punktu wejścia, co uniemożliwiło kontenerowi wykonanie zamierzonego procesu.

Sprawdzanie pojedynczych dzienników kontenera

Przeanalizuj poszczególne dzienniki w poszukiwaniu komunikatów o błędach i ostrzegawczych. Aplikacja Container Station rejestruje szczegółowe stany błędów, takie jak brakujące zmienne środowiskowe, nieprawidłowe formaty nazw, nieudane pobieranie obrazu i błędy inicjowania.

  1. Otwórz aplikację Container Station.
  2. Kliknij pozycję Kontenery.
  3. Wybierz kontener, aby otworzyć stronę szczegółów.
  4. Kliknij opcję Dzienniki.
  5. Przejrzyj komunikaty o błędach i ostrzegawcze.

Przykład 1

Dziennik zdarzeń zarejestrował niepowodzenie uruchamiania, ponieważ zmienna środowiskowa MYSQL_ROOT_PASSWORDnie została ustawiona przed wdrożeniem kontenera MySQL, co spowodowało jego zamknięcie natychmiast po zainicjowaniu.

Przykład 2

Dziennik zdarzeń zarejestrował niepowodzenie uruchamiania, ponieważ kontener Rancher został wdrożony przy użyciu obrazu rancher/rancher bez włączenia trybu uprzywilejowanego. Bez flagi --privilegedkontener nie mógł zostać poprawnie zainicjowany.

Weryfikowanie zgodności obrazu

Upewnij się, że obraz jest zgodny z architekturą procesora i systemem operacyjnym urządzenia QNAP. Nieprawidłowe wersje obrazów lub architektury uniemożliwiają uruchamianie kontenerów.

Sprawdzanie zgodności platformy

Sprawdź, czy platforma obrazu jest zgodna z architekturą procesora urządzenia QNAP. Jeśli przenosisz obraz z innego urządzenia QNAP, sprawdź, czy oba urządzenia korzystają z tej samej architektury.

Ważne
64-bitowe obrazy x86 nie mogą być uruchamiane na 64-bitowych lub 32-bitowych urządzeniach ARM. Analogicznie, nie można uruchamiać obrazów ARM na 64-bitowych urządzeniach x86.

Docker

Strona obrazu Docker zawiera listę obsługiwanych architektur i systemów operacyjnych dla każdej wersji obrazu. Poniżej przedstawiono ogólne wytyczne dotyczące zgodności obrazów Docker:

  • linux/arm/v7 obrazy obsługują 32-bitowe architektury ARM.
  • linux/arm64/v8 obrazy obsługują 64-bitowe architektury ARM.
  • linux/amd64 obrazy obsługują 64-bitowe architektury x86.

LXD

Aby uzyskać szczegóły dotyczące zgodności, odwiedź stronę Serwer obrazów narzędzia LXD. Poniżej przedstawiono ogólne wytyczne dotyczące zgodności architektury kontenerów LXD:

  • armhf kontenery obsługują 32-bitowe architektury ARM.
  • arm64 kontenery obsługują 64-bitowe architektury ARM.
  • amd64 kontenery obsługują 64-bitowe architektury x86.

Identyfikacja niezgodności kontenera

Niezgodne kontenery Docker mogą zarejestrować błąd exec format error wskazujący niezgodność architektury.

Po wdrożeniu niezgodnych kontenerów LXD aplikacja Container Station może rejestrować dzienniki niepowodzeń na stronie Dzienniki zdarzeń.

Sprawdzanie zgodności rozmiaru strony

Firma QNAP zaktualizowała rozmiar strony systemu z 4K do 32K na potrzeby uzyskania lepszej wydajności na następujących 32-bitowych urządzeniach ARM. Ta zmiana może ograniczyć dostęp kontenera do zasobów pamięci, powodując błędy segmentacji. Przed wdrożeniem należy zweryfikować zgodność kontenerów innych firm.

SeriaModele
TS-x31PTS-531P
TS-x31P3TS-231P3, TS-431P3
TS-x31XTS-231X, TS-431X, TS-531X, TS-831X, TS-431X2, TS-431X3
TS-x31KXTS-431KX
TS-x31XUTS-431XU, TS-431XU-RP, TS-831XU, TS-831XU-RP, TS-1231XU, TS-1231XU-RP
TS-x31XeUTS-431XeU
TS-x35TS-1635

Sprawdzanie konfiguracji systemu QNAP

Upewnij się, że urządzenie QNAP jest poprawnie skonfigurowane na potrzeby koordynacji i wdrażania kontenera.

Weryfikacja ustawienia sieciowych

  1. Zaloguj się na urządzeniu QNAP i otwórz aplikację Sieć i przełącznik wirtualny.
  2. Wybierz tryb Zaawansowany.
  3. Wybierz kolejno Sieć > Przełącznik wirtualny.
  4. Zidentyfikuj segmenty sieci używane przez sieć kontenera.
  5. Przejdź do obszaru Panel sterowania > System > Zabezpieczenia > Lista dozwolonych/blokowanych.
    Uwaga
    Jeśli aplikacja QuFirewall jest zainstalowana na urządzeniu, upewnij się, że jest włączona, a następnie otwórz aplikację QuFirewall i dodaj wymagane segmenty sieci do listy dozwolonych.
  6. Upewnij się, czy że segmenty sieci kontenera zostały dodane do listy dozwolonych.
    Ważne
    Firma QNAP zaleca dodanie następujących zakresów adresów IP do listy dozwolonych: 10.0.3.0/24, 10.0.5.0/24, 10.0.7.0/24, 172.29.0.0/22, 172.30.0.0/22. Jeśli włączono usługi Kubernetes, należy również dodać następujący zakres 10.42.0.0/24 (Kubernetes Pod Network CIDR).

Sprawdzenie ustawień zaawansowanych uprawnień

Uwaga
Kontenery działają bezpośrednio w systemie i współdzielą uprawnienia użytkownika root z urządzeniem hosta. Włączenie zaawansowanych uprawnień folderu może mieć wpływ na działanie kontenera. Jeśli kontener nie uruchamia się, należy wyłączyć zaawansowane uprawnienia folderu.
  1. Przejdź do sekcji Panel sterowania > Uprawnienia > Foldery udostępnione > Uprawnienia zaawansowane.
  2. Wyłącz opcję Włącz zaawansowane uprawnienia folderu.
  3. Kliknij przycisk Zastosuj.
  4. Przejdź do obszaru Panel sterowania > Uprawnienia > Przydział, aby sprawdzić ustawienia przydziału użytkownika.
    Uwaga
    Ustawienia przydziału mają zastosowanie tylko wtedy, gdy zarządzanie przydziałami jest włączone.
    Ostrzeżenie
    Sprawdź ustawienia przydziału użytkowników, aby upewnić się, że nie obowiązują żadne niezamierzone ograniczenia przydziałów. Przypadkowe ustawienia przydziału może spowodować, że kontener zgłosi błędy z powodu ograniczeń pamięci masowej.

Weryfikacja konfiguracji pamięci masowej i sieci

  1. Wybierz kolejno Pamięć masowa i migawki > Pamięć masowa > Pamięć masowa/Migawki.
  2. Sprawdź dostępną pojemność pamięci masowej.

    Uwaga
    Jeśli status jest inny niż Gotowy, sprawdź status dysku pod kątem błędów pamięci masowej. Szczegółowe informacje zawiera rozdział Statusy dysków w Podręczniku użytkownika systemu QTS lub Podręczniku użytkownika systemu QuTS hero.

Sprawdzanie konfiguracji sieci

Upewnij się, że ustawienia sieciowe są poprawnie skonfigurowane, wykonując poniższe czynności:

  1. Przejdź do obszaru Sieć i przełącznik wirtualny > Sieć > Interfejsy i sprawdź, czy ustawienia bramy i DNS są poprawnie.
  2. Upewnij się, że serwer DHCP może przypisywać adresy IP do kontenerów przy użyciu przełącznika wirtualnego. Szczegółowe informacje zawiera rozdział Konfiguracja przełącznika wirtualnego w Podręczniku użytkownika systemu QTS lub Podręczniku użytkownika systemu QuTS hero.
    Uwaga
    Ustawienie Nie przypisuj adresów IP (do celów specjalnych, takich jak budowanie sieci zewnętrznej lub izolowanej) w konfiguracji przełącznika wirtualnego jest przeznaczone dla określonych konfiguracji sieci. Jeśli nie jest wymagana niestandardowa konfiguracja sieci, zaleca się wyłączenie tego ustawienia.
    Jednak w przypadku konfigurowania sieci zewnętrznej lub izolowanej należy je włączyć. Należy pamiętać, że to ustawienie może mieć wpływ na konfigurację sieci kontenera. Szczegółowe informacje zawiera rozdział Tworzenie przełącznika wirtualnego w trybie zaawansowanym w Podręczniku użytkownika systemu QTS lub Podręczniku użytkownika systemu QuTS hero.
  3. Przejdź do obszaru Container Station > Preferencje > Ustawienia sieciowe i sprawdź, czy segmenty sieci kontenera nie są w konflikcie ze środowiskiem lokalnym.
    Ważne
    Aplikacja Container Station używa 10.0.3.0/24, 10.0.5.0/24 oraz 10.0.7.0/24 jako domyślnych sieci IP.

Zapoznawanie się z dokumentacją i pomocą online

Niektóre obrazy są typu open source, co umożliwia użytkownikom modyfikowanie kodu źródłowego. Jeśli żadna z metod rozwiązywania problemów nie rozwiązuje problemu, obraz źródłowy może być niezgodny lub uszkodzony. W takich sytuacjach firma QNAP zaleca odwiedzenie witryny internetowej obrazu w celu uzyskania dodatkowych informacji lub używanie alternatywnych obrazów w tej samej kategorii.

Jeśli obraz pochodzi z rejestru Docker, możesz znaleźć więcej szczegółów dotyczących obrazu na jego stronie Przegląd. Na przykład obraz Ubuntu w usłudze Docker zawiera linki do krótkich materiałów zawierających dalsze informacje.

Dodatkowe informacje

Czy artykuł ten był przydatny?

39% ludzi uważa, że to pomaga.
Dziękujemy za przekazanie opinii.

Poinformuj nas proszę, w jaki sposób możemy ulepszyć ten artykuł:

Bardziej szczegółowe opinie można wpisać poniżej.

Wybierz specyfikację

      Więcej Mniej

      Ta strona dostępna jest w też krajach/regionach:

      open menu
      back to top