Hur felsöks och åtgärdas vanliga problem med behållare i Container Station?


Senaste ändringsdatum: 2025-04-08

Container Station kan du använda till att distribuera program och behållare från tredje part på din QNAP-enhet. Skivavbilder med öppen källkod som används för att skapa dessa behållare kan medföra driftsättningsproblem.

QNAP tillhandahåller inte teknisk support för skivavbilder från tredje part. Följ dessa steg för att diagnostisera och lösa vanliga problem med behållare.

Kontroll av behållarkonfiguration

Behållare ärver alla attribut från källskivavbilden. Sök igenom skivavbildsfilen för att identifiera säkerhetsproblem, felkonfigurationer och bakdörrshot före distribueringen.

Om behållaren stöter på problem efter distribueringen analyserar du behållarnas loggar för att diagnostisera och lösa problem.

Undersöka skivavbildsinformation

Granska förkraven för skivavbilden och slutför alla nödvändiga steg innan behållaren installeras.

Tips!
Du hittar skivavbildsinformation för en Docker-registerskivavbild genom att klicka på bildnamnet i Utforska > Docker Hub i Container Station. Alternativt går det att söka efter skivavbilden på Docker Hub.

Om exempelvis en PostgreSQL-behållare distribueras med skivavbilden postgres krävs att miljövariabeln POSTGRES_PASSWORD ställts in. Behållaren kan inte driftsättas utan den variabeln.

Viktigt!
När en PostgreSQL-behållare driftsätts i Container Station ska variabeln POSTGRES_PASSWORD konfigureras i avsnittet Miljö.

Analysera händelseloggar från Container Station

Container Station loggar alla program- och behållaraktiviteter. Felloggarna innehåller explicita felmeddelanden, inklusive applikations- eller behållarnamn, felkod och felinformation.

  1. Öppna Container Station.
  2. Klicka på Händelseloggar.
  3. Lokalisera felloggar.

Exempel 1

I det här exemplet registrerade händelseloggen ett uppstartsfel eftersom de angivna portarna redan användes av andra tjänster och det förhindrar att behållaren binds till de erforderliga nätverksgränssnitten.

Exempel 2

I det här exemplet registrerade händelseloggen ett uppstartsfel till följd av att ett felaktigt konfigurerat startpunktskommando hindrade behållaren från att utföra den avsedda processen.

Kontrollera enskilda behållarloggar

Analysera enskilda behållarloggar med avseende på fel- och varningsmeddelanden. Container Station loggar detaljerade feltillstånd, exempelvis saknade miljövariabler, ogiltiga namngivningsformat, misslyckade skivavbildsåterhämtningar och initieringsfel.

  1. Öppna Container Station.
  2. Klicka på Behållare.
  3. Välj en behållare för att öppna sidan med information.
  4. Klicka på Loggar.
  5. Granska fel- och varningsmeddelanden.

Exempel 1

Händelseloggen registrerade ett uppstartsfel eftersom miljövariabeln MYSQL_ROOT_PASSWORD inte var inställd innan MySQL-behållaren, som därför avslutades direkt efter initieringen, driftsattes.

Exempel 2

Händelseloggen registrerade ett uppstartsfel eftersom Rancher-behållaren driftsattes med hjälp av skivavbilden rancher/rancher utan att aktivera privilegierat läge. Utan flaggan --privileged kunde behållaren inte initieras på rätt sätt.

Verifiera skivavbildskompatibilitet

Kontrollera att bilden är kompatibel med processorarkitekturen och operativsystemet på din QNAP-enhet. Felaktiga skivavbildsversioner eller arkitekturer förhindrar att behållare körs.

Kontrollera plattformens kompatibilitet

Kontrollera att bildplattformen stämmer överens med din QNAP-enhets CPU-arkitektur. Om en skivavbild överförs från en annan QNAP-enhet måste det vara bekräftat att båda enheterna använder samma arkitektur.

Viktigt!
64-bitars x86-skivavbilder kan inte köras på 64-bitars eller 32-bitars ARM-enheter. Omvänt så kan ARM-skivavbilder inte köras på 64-bitars x86-enheter.

Docker

Sidan för Docker-skivavbild har en lista över arkitektur och operativsystem som stöds, för varje skivavbildsversion. Följande är de allmänna riktlinjerna avseende kompatibilitet för Docker-skivavbilder:

  • linux/arm/v7 skivavbilder har stöd för 32-bitars ARM-arkitekturer.
  • linux/arm64/v8 skivavbilder har stöd för 64-bitars ARM-arkitekturer.
  • linux/amd64 skivavbilder har stöd för 64-bitars x86-arkitekturer.

LXD

Mer information om kompatibilitet finns på LXD-skivavbildsservern. Följande är de allmänna riktlinjerna för arkitekturkompatibilitet för LXD-behållare:

  • armhf behållare har stöd för 32-bitars ARM-arkitekturer.
  • arm64 behållare har stöd för 64-bitars ARM-arkitekturer.
  • amd64 behållare har stöd för 64-bitars x86-arkitekturer.

Identifiera icke kompatibla behållare

Inkompatibla Docker-behållare kan logga ett exec format error som då tyder på att arkitekturen inte stämmer överens.

När inkompatibla LXD-behållare driftsätts registrerar Container Station felloggar på sidan för händelseloggar.

Kontrollera sidstorlekskompatibilitet

QNAP uppdaterade systemets sidstorlek från 4K till 32K för en förbättrad prestanda på specifika 32-bitars ARM-enheter. Den ändringen kan begränsa behållaråtkomst till minnesresurser och orsaka segmenteringsfel. Verifiera kompatibilitet med tredjepartsbehållare innan driftsättningen.

SerierModeller
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

Kontrollera QNAP-systemkonfigurationen

Säkerställ att QNAP-enheten är konfigurerad på lämpligt sätt för driftsättning och orkestrering av behållare.

Verifiera nätverksinställningar

  1. Logga in på din QNAP-enhet och öppna Nätverk och virtuell växel.
  2. Välj Avancerat läge.
  3. Gå till Nätverk > Virtuell växel.
  4. Identifiera det nätverkssegment som används av behållarnätverket.
  5. Gå till Kontrollpanelen > System > Säkerhet> Tillåt-/nekalista.
    Obs!
    Om QuFirewall är installerat på din enhet behöver du kontrollera att den är aktiverad för att sedan öppna QuFirewall och lägga till de nätverkssegment som krävs i tillåt-listan.
  6. Säkerställ att behållarnätverkssegment är tillagda i tillåt-listan.
    Viktigt!
    QNAP rekommenderar att följande IP-adressintervall läggs till i tillåt-listan: 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. Om Kubernetes-tjänster är aktiverade ska även 10.42.0.0/24 läggas till (Kubernetes podd-nätverks-CIDR).

Kontrollera avancerade behörighetsinställningar

Obs!
Behållare körs direkt på systemet och delar rotprivilegier med värdenheten. Aktivering av avancerade mappbehörigheter kan påverka behållaroperationer. Om en behållare inte kan köras behöver avancerade mappbehörigheter inaktiveras.
  1. Gå till Kontrollpanelen > Privilegium > Delade mappar > Avancerade behörigheter.
  2. Inaktivera Aktivera avancerade mappbehörigheter.
  3. Klicka på Tillämpa.
  4. Gå till Kontrollpanelen > Privilegium > Kvot för att kontrollera användarens kvotinställningar.
    Obs!
    Kvotinställningar tillämpas bara om kvothantering är aktiverad.
    Varning
    Kontrollera inställningarna för användarkvot, för att säkerställa att det inte finns några oavsiktliga kvotbegränsningar. Oavsiktliga kvotinställningar kan ge upphov till att behållaren rapporterar fel på grund av lagringsbegränsningar.

Verifiera lagrings- och nätverkskonfiguration

  1. Gå till Lagring och snapshots > Lagring > Lagring/snapshots.
  2. Kontrollera tillgänglig lagringskapacitet.

    Obs!
    Om statusen är något annat än Klar behöver diskstatusen kontrolleras för att se om det finns lagringsfel. Mer information finns i Diskstatusar i bruksanvisningen till QTS eller QuTS hero.

Kontrollera nätverkskonfigurationen

Säkerställ att nätverksinställningarna är rätt konfigurerade genom att följa dessa steg:

  1. Gå till Nätverk och virtuell växel > Nätverk > Gränssnitt och granska DNS- och gatewayinställningarna.
  2. Säkerställ att DHCP-servern kan tilldela IP-adresser till behållare med hjälp av en virtuell växel. Mer information finns i Konfiguration av virtuell växel i bruksanvisningen till QTS eller QuTS hero.
    Obs!
    Inställningen Tilldela inte IP-adresser (för särskilda ändamål, exempelvis för att bygga ett externt nätverk eller isolerat nätverk) i den virtuella växelns konfiguration är avsedd för specifika nätverkskonfigurationer. Om du inte har behov av en anpassad nätverksinstallation rekommenderar vi att den inställningen inaktiveras.
    Om du emellertid installerar ett externt eller isolerat nätverk ska den vara aktiverad. Observera att den här inställningen kan påverka behållarens nätverkskonfiguration. Mer information finns i Skapa en virtuell växel i avancerat läge i bruksanvisningen till QTS eller QuTS hero.
  3. Gå till Container Station > Preferenser > Nätverksinställningar och säkerställ att behållarens nätverkssegment inte står i konflikt med den lokala miljön.
    Viktigt!
    Container Station använder 10.0.3.0/24, 10.0.5.0/24 och 10.0.7.0/24 som standard-IP-nätverk.

Se onlinehjälp och dokumentation

Vissa skivavbilder är i öppen källkod och användare kan ändra källkoden. Om ingen av felsökningsmetoderna löser problemet kan källskivavbilden vara inkompatibel eller skadad. I sådana fall rekommenderar QNAP besök på skivavbildens webbplats för att inhämta mer information om skivavbilden eller att andra skivavbilder i samma kategori används.

Om skivavbilden kommer från Docker-registret kan du hitta mer information om skivavbilden på deras sida med översikt. Till exempel så tillhandahåller skivavbilden med Ubuntu i Docker snabbreferenslänkar för att finna information.

Läs mer

Var den här artikeln till hjälp?

Användare som tyckte detta var användbart 39% procent.
Tack för din feedback.

Berätta för oss hur vi kan förbättra artikeln:

Ge oss fler synpunkter genom att skriva dem nedan.

Välj specifikation

      Visa fler Färre

      Denna webbplats i andra länder/regioner:

      open menu
      back to top