SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Docker Hardened Images: co jest za darmo i co się psuje

Obrazy Docker Hardened Images są darmowe na licencji Apache 2.0. Pokazuję, jak je pobrać z dhi.io i co psuje się w Compose: uprawnienia, healthchecki, porty i brak powłoki.

Czy Docker Hardened Images są darmowe?

Tak. Podstawowy katalog Docker Hardened Images (DHI) jest darmowy i wydany na licencji Apache 2.0. Docker ogłosił to 17 grudnia 2025 roku, a płatne zostały tylko dwa wyższe plany: Select i Enterprise. Do zwykłego stosu Docker Compose na VPS wystarcza darmowy plan Community. Trudniejsza część zaczyna się dopiero po podmianie obrazu. Obraz DHI nie ma powłoki ani menedżera pakietów i działa jako użytkownik bez uprawnień roota. Może też mieć inny ENTRYPOINT niż oficjalny obraz.

Najpierw sprawdzamy, co jest za darmo i jak pobrać obraz. Potem przechodzimy przez pięć miejsc, w których Twój plik compose.yaml przestaje działać, i każde z nich zamieniamy na polecenie, które uruchamiasz sam. Wszystkie polecenia wymagają działającego demona Dockera i dostępu do rejestru, więc wykonujesz je na swoim serwerze. Jeśli Dockera jeszcze tam nie ma, zacznij od instalacji Dockera na Debianie z oficjalnego repozytorium.

Co jest za darmo, a za co się płaci (stan na 13 listopada 2026)

Sprawdziłem dokumentację DHI i stronę produktu Dockera 13 listopada 2026. Docker opisuje trzy plany.

  • Community (darmowy). Pełny katalog obrazów open source na licencji Apache 2.0. Do każdego obrazu dostajesz SBOM (software bill of materials, czyli spis wszystkich składników), poświadczenie pochodzenia na poziomie SLSA Build L3 (SLSA to framework opisujący, jak zbudowano artefakt), dane OpenVEX (VEX mówi, które znane podatności naprawdę dotyczą obrazu) oraz podpisy. Poprawki przychodzą w rytmie wydań projektów upstream.
  • Select (płatny). Warianty FIPS (standard kryptografii amerykańskiej administracji federalnej) i STIG (amerykańskie wytyczne utwardzania systemów). Plan Select daje też umowę SLA: 7 dni na usunięcie podatności krytycznych i wysokich. W planie Select możesz też dostosować do 5 obrazów.
  • Enterprise (płatny). To samo co Select, ale bez limitu dostosowań. Tylko do planu Enterprise można dokupić Extended Lifecycle Support (ELS): poprawki bezpieczeństwa po końcu wsparcia projektu, przez dodatkowe 5 lat.

Nie podaję tu cen ani liczby obrazów w katalogu. Ceny zmieniają się częściej niż ten artykuł, a sam Docker podaje liczbę obrazów różnie na różnych stronach. Aktualne warunki sprawdzisz na stronie Docker Hardened Images i w dokumentacji DHI.

Dla polskiego self-hostera wniosek jest prosty. FIPS i STIG to wymagania amerykańskiej administracji, a 7-dniowe SLA ma sens wtedy, gdy klient wpisuje je do umowy. Jeśli prowadzisz własny serwer albo małą firmę, plan Community daje Ci te same obrazy bez gwarancji czasu naprawy.

Jedna uwaga, żeby nie pomylić licencji. Sam Docker Engine, którego używasz na VPS, też jest na licencji Apache 2.0. Płatna subskrypcja dotyczy komercyjnego użycia Docker Desktop w dużych firmach, czyli takich, które mają ponad 250 pracowników albo ponad 10 milionów dolarów rocznego przychodu.

Jak pobrać obraz DHI: rejestr dhi.io i docker login

Darmowe obrazy Community leżą w osobnym rejestrze dhi.io, a nie pod zwykłą nazwą na Docker Hub. Dokumentacja mówi wprost, że do pobrania obrazu Community trzeba się zalogować do dhi.io. Wystarczy darmowe konto Docker. Jako hasło możesz podać hasło do Docker Hub albo osobisty token dostępu (PAT, personal access token). Na serwerze wybierz token, bo można go odwołać bez zmiany hasła do konta.

docker login dhi.io -u twoj-login-docker
docker pull dhi.io/python:3.12
docker pull dhi.io/postgres:18

docker login poprosi o hasło. Wklej tam token. Po udanym logowaniu zobaczysz Login Succeeded, a docker pull pobierze warstwy obrazu. Plany Select i Enterprise działają inaczej: używają kopii obrazów w repozytoriach w przestrzeni nazw Twojej organizacji na Docker Hub, więc tam nazwa obrazu nie zaczyna się od dhi.io.

Logowanie dotyczy też budowania. Jeśli Twój Dockerfile ma FROM dhi.io/..., to docker compose build pobiera obraz bazowy z tego samego rejestru. Dlatego przewodnik Dockera dla Node.js każe zalogować się do dhi.io przed budowaniem.

Zanim podmienisz obraz: porównaj go z oficjalnym

Lista kontrolna migracji Dockera mówi, że obraz DHI może mieć inny ENTRYPOINT niż obraz z serii Docker Official Images. Każe go sprawdzić przez docker inspect albo na stronie obrazu. Zrób to dla każdego obrazu, który zamieniasz.

docker pull postgres:18
docker image inspect --format 'user={{.Config.User}} entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' postgres:18
docker image inspect --format 'user={{.Config.User}} entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' dhi.io/postgres:18

Porównaj te pola. Puste user= oznacza, że kontener startuje jako root. Liczba albo nazwa oznacza konkretnego użytkownika, i to on musi mieć dostęp do Twoich plików. Jeśli entrypoint się różni, opcje, które dopisujesz w command:, mogą trafić do innego programu niż wcześniej.

Pułapka 1: bind mount i właściciel katalogu

Lista kontrolna Dockera mówi, że obrazy uruchomieniowe DHI domyślnie działają jako nonroot, czyli UID 65532. Pliki i katalogi, których aplikacja potrzebuje, muszą być dla tego użytkownika do odczytu i zapisu. Postgres jest wyjątkiem. Przewodnik Dockera po PostgreSQL mówi, że w tym obrazie PostgreSQL działa jako użytkownik postgres o UID 999. Nie zakładaj więc jednej liczby dla wszystkich obrazów. Odczytaj ją z docker image inspect jak wyżej.

Bind mount to katalog z hosta podpięty do kontenera. Kontener widzi go z tymi samymi numerami właściciela, jakie ma na hoście. Jeśli katalog należy do Ciebie (na przykład UID 1000), a proces w kontenerze ma UID 999, to proces nie może tam pisać. Przewodnik Dockera ostrzega, że przy zbyt restrykcyjnych uprawnieniach katalogu kontener nie wystartuje. Dlatego zakładka DHI tego przewodnika ma krok, którego nie ma w zakładce z oficjalnym obrazem:

mkdir -p ./pgdata
sudo chown -R 999:999 ./pgdata
ls -ldn ./pgdata

ls -ldn pokazuje numery zamiast nazw. W wyniku powinieneś zobaczyć 999 999. Możesz też sprawdzić, co widzi kontener, choć obraz DHI nie ma powłoki. Wystarczy pomocniczy obraz busybox:

docker run --rm -v "$PWD/pgdata:/data" busybox ls -ldn /data

Jeśli używasz zmiennych PUID i PGID, pamiętaj, skąd one pochodzą. To konwencja niektórych obrazów, które same zmieniają użytkownika przy starcie. Obraz DHI nie ma skryptu startowego w powłoce, więc nie zakładaj, że te zmienne cokolwiek zmienią. Właściciela ustalasz przez chown na hoście albo przez klucz user: w Compose. Więcej o tym mechanizmie znajdziesz w tekście czym są PUID i PGID w Dockerze i skąd biorą się błędy uprawnień.

Druga droga to wolumen nazwany zamiast bind mountu. Przewodnik Dockera dla Node.js używa właśnie wolumenu nazwanego db-data:/var/lib/postgresql z obrazem dhi.io/postgres:18. Różnice między tymi dwoma typami opisuje porównanie bind mount i wolumenu nazwanego w Docker Compose.

Masz już bazę na oficjalnym obrazie?

Nie przełączaj obrazu na tym samym katalogu danych, jeśli zmienia się wersja główna PostgreSQL (na przykład z 16 na 18). Format katalogu danych nie jest zgodny między wersjami głównymi. Przewodnik Dockera montuje dane DHI w /var/lib/postgresql, więc ścieżka może się też różnić od tej w Twoim starym pliku. Bezpieczna droga to zrzut i odtworzenie. Najpierw zrób zrzut na starym stosie:

docker compose exec -T db pg_dumpall -U postgres > dump.sql

Potem uruchom nowy stos z pustym katalogiem danych i wczytaj zrzut. Obraz DHI ma w środku psql, a exec uruchamia program bezpośrednio, bez powłoki:

docker compose exec -T db psql -U postgres < dump.sql
docker compose exec db psql -U postgres -c '\l'

Ostatnie polecenie powinno wypisać Twoje bazy. Jeśli połączenie wymaga hasła, przekaż je opcją -e PGPASSWORD=twoje-haslo w docker compose exec. Zanim zaczniesz, zrób kopię według procedury kopii zapasowej i aktualizacji stosu Docker Compose.

Pułapka 2: healthcheck z curl albo w formie tekstowej

Dokumentacja Compose rozróżnia dwie formy test: w healthchecku. Forma listy ["CMD", ...] uruchamia program bezpośrednio. Forma tekstowa to CMD-SHELL, czyli polecenie wykonywane przez powłokę kontenera, na Linuksie /bin/sh. Lista kontrolna DHI mówi, że obrazy uruchomieniowe nie mają powłoki. Wniosek: healthcheck w formie tekstowej nie ma czym się wykonać. Z podobnego powodu odpada curl. Obraz uruchomieniowy nie ma menedżera pakietów, więc nie doinstalujesz go do gotowego obrazu.

Popraw healthcheck tak, żeby wywoływał program, który już jest w obrazie. Przewodnik Dockera dla Node.js używa dla dhi.io/postgres:18 formy ["CMD", "pg_isready"] i klucza user: postgres. Dla aplikacji w Pythonie użyj samego interpretera:

services:
  db:
    image: dhi.io/postgres:18
    user: postgres
    environment:
      POSTGRES_PASSWORD_FILE: /run/secrets/db-password
    secrets:
      - db-password
    volumes:
      - ./pgdata:/var/lib/postgresql
    healthcheck:
      test: ["CMD", "pg_isready"]
      interval: 10s
      timeout: 5s
      retries: 5

  app:
    build: .
    ports:
      - "8000:8000"
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "/venv/bin/python3", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/')"]
      interval: 30s
      timeout: 5s
      retries: 3

secrets:
  db-password:
    file: ./db-password.txt

urlopen rzuca wyjątek przy błędzie połączenia i przy odpowiedzi HTTP 4xx lub 5xx. Python kończy się wtedy kodem różnym od zera, a Docker liczy to jako nieudaną próbę. Plik sekretu jest podpinany z hosta, więc obowiązuje ta sama zasada co przy katalogu danych: UID 999 musi móc go przeczytać. Sposoby trzymania haseł poza compose.yaml opisuje poradnik o plikach .env i sekretach w Docker Compose.

Nie zgaduj, czy healthcheck działa. Docker zapisuje wynik każdej próby:

docker compose ps
docker inspect --format '{{json .State.Health}}' $(docker compose ps -q app)

Stan healthy w docker compose ps oznacza sukces. Jeśli długo widzisz unhealthy albo starting, przeczytaj pole Output w wyniku docker inspect. Tam jest dokładny komunikat z ostatniej próby na Twoim serwerze. Więcej o interwałach i depends_on znajdziesz w tekście jak pisać healthchecki w Docker Compose.

Pułapka 3: docker compose exec db sh nie ma czego uruchomić

Strona rozwiązywania problemów DHI mówi, że obrazy uruchomieniowe nie zawierają powłok interaktywnych, takich jak sh czy bash. Polecenie docker compose exec db sh prosi o program, którego w obrazie nie ma, więc nie dostaniesz powłoki. Uruchom je raz na swoim serwerze, żeby zobaczyć, jak ten błąd wygląda u Ciebie.

Najprostsze wyjście to wywołać bezpośrednio narzędzie, które jest w obrazie. Strona katalogu dla Postgresa wymienia między innymi psql, pg_dump i pg_dumpall, więc to działa bez powłoki:

docker compose exec db psql -U postgres

Docker poleca też docker debug. To polecenie podpina do działającego kontenera tymczasowy kontener z narzędziami i nie zmienia samego obrazu. Sprawdź docker debug --help, czy Twoja instalacja ma to polecenie. Pliki możesz też obejrzeć z zewnątrz pomocniczym obrazem, jak busybox w pułapce 1. Szerzej o exec i jego opcjach piszę w tekście jak wejść do kontenera przez docker compose exec.

Pułapka 4: porty poniżej 1024

Lista kontrolna DHI mówi, że użytkownik nonroot nie może otworzyć portów uprzywilejowanych (poniżej 1024) w Kubernetesie i w Docker Engine starszym niż 20.10. Strona rozwiązywania problemów pisze ogólniej, że kontenery nonroot domyślnie nie otworzą takich portów. Obie strony radzą to samo: niech aplikacja słucha na porcie 1025 lub wyższym.

Na VPS to nic nie kosztuje. Port w kontenerze i port na hoście to dwie różne liczby. Aplikacja słucha w środku na 8080, a Compose wystawia ją na hoście na 80:

    ports:
      - "80:8080"

Zmieniasz więc tylko port w konfiguracji aplikacji i prawą stronę mapowania. Pamiętaj przy tym, że port wystawiony przez Dockera omija reguły UFW, o czym piszę w tekście dlaczego porty Dockera omijają UFW.

Pułapka 5: obrazy dev tylko w etapie budowania

Jeśli budujesz własny obraz, Docker zaleca budowanie wieloetapowe. Obrazy z tagiem dev (lub sdk) mają powłokę, menedżer pakietów i narzędzia do kompilacji, więc pasują do etapu budowania. Etap końcowy ma używać obrazu bez dev. Ten obraz nie ma powłoki, a Docker wykonuje linię RUN w formie tekstowej przez /bin/sh -c. Taka linia nie ma więc w etapie końcowym czym się wykonać. Wszystko, czego aplikacja potrzebuje, kopiujesz z etapu budowania.

Ten Dockerfile to uproszczona wersja przykładu z przewodnika Dockera dla Pythona:

FROM dhi.io/python:3.12-dev AS builder
WORKDIR /app
RUN python3 -m venv /venv
ENV PATH="/venv/bin:$PATH"
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .

FROM dhi.io/python:3.12
WORKDIR /app
COPY --from=builder /venv /venv
COPY --from=builder /app .
ENV PATH="/venv/bin:$PATH"
EXPOSE 8000
CMD ["/venv/bin/python3", "-m", "uvicorn", "app:app", "--host=0.0.0.0", "--port=8000"]

Na co patrzeć przy przenoszeniu starego Dockerfile:

  • Usuń linie, które instalują ca-certificates. Lista kontrolna mówi, że obrazy DHI mają je domyślnie.
  • Przenieś każde apt-get install albo apk add do etapu builder. W etapie końcowym nie ma menedżera pakietów.
  • Jeśli aplikacja zapisuje pliki w katalogu z obrazu, nadaj go użytkownikowi nonroot, na przykład przez COPY --chown=65532:65532. Najpierw potwierdź ten UID przez docker image inspect.
  • CMD i ENTRYPOINT zapisuj w formie listy. Forma tekstowa też uruchamia się przez /bin/sh -c.

Po zbudowaniu sprawdź wynik:

docker compose build app
docker compose up -d
docker compose ps

Kolumna STATUS dla app powinna po chwili pokazać healthy. Różnicę między build: a image: w Compose opisuje tekst o build i image w Docker Compose.

A co z Chainguard? Darmowy plan Starter

Chainguard to drugi duży dostawca minimalnych obrazów. Jego cennik (sprawdzony 13 listopada 2026) pokazuje darmowy plan Starter bez daty końca i bez karty kredytowej. Dokumentacja nazywa go Chainguard Starter (Catalog Starter) i mówi, że jest w fazie beta. Warunki są inne niż w DHI Community:

  • Wybierasz do 5 obrazów. Dokumentacja mówi, że po wyborze nie można ich wymienić przez cały czas trwania darmowego planu.
  • Obrazy FIPS i buildy komercyjne są tylko w planie Enterprise.
  • Wyłączone są też obrazy w okresie przejściowym po końcu wsparcia (EOL, end of life).
  • Obrazy pobierasz z rejestru cgr.dev w postaci cgr.dev/$ORGANIZATION/$IMAGE:latest, z tokenem do pobierania.

Dla VPS różnica jest prosta. DHI Community daje cały katalog, a Chainguard Starter daje pięć obrazów wybranych raz. Jeśli Twój stos to Postgres i jedna aplikacja, wystarczy każdy z nich. Jeśli chcesz eksperymentować z wieloma obrazami, limit pięciu szybko przeszkadza.

Kiedy Docker Hardened Images nie są warte zachodu

Najwięcej zyskujesz przy obrazach, które budujesz sam: przy własnej aplikacji w Pythonie czy Node.js i przy bazie danych. Tam kontrolujesz Dockerfile i możesz przejść przez pięć pułapek powyżej.

Inaczej jest z gotowymi aplikacjami, które utrzymuje ich własny zespół, takimi jak Vaultwarden czy Immich. W katalogu DHI jest obraz dhi.io/vaultwarden. Nie sprawdzałem, czy działa jako bezpośredni zamiennik oryginalnego vaultwarden/server. Jeśli go użyjesz, polegasz na buildzie Dockera, a nie na obrazie od opiekunów projektu. Ich instrukcje, zmienne i zgłoszenia błędów dotyczą ich obrazu. Obrazu Immich w katalogu nie potwierdziłem, więc wyszukaj go sam na stronie katalogu DHI. Stos Immich składa się z kilku współpracujących kontenerów, więc podmiana jednego z nich to ryzyko, które bierzesz na siebie.

Mój praktyczny podział wygląda tak. Bazę danych i własną aplikację przenieś na DHI. Gotowe aplikacje, jak Vaultwarden na VPS jako menedżer haseł, zostaw na obrazach od autorów i aktualizuj je regularnie. Utwardzony obraz, którego nie aktualizujesz, traci przewagę w dniu, w którym wychodzi następna poprawka.

FAQ

Czy Docker Hardened Images są naprawdę darmowe?

Tak, plan Community jest darmowy i wydany na licencji Apache 2.0, a Docker ogłosił to 17 grudnia 2025 roku. Dostajesz pełny katalog obrazów open source z SBOM, poświadczeniem SLSA Build L3, danymi OpenVEX i podpisami. Płatne plany Select i Enterprise dodają między innymi warianty FIPS i STIG oraz 7-dniowe SLA na podatności krytyczne i wysokie. Stan na 13 listopada 2026.

Czy do pobrania obrazu DHI potrzebuję docker login?

Tak. Obrazy Community są w rejestrze dhi.io, a dokumentacja Dockera wymaga logowania do niego: docker login dhi.io, potem na przykład docker pull dhi.io/postgres:18. Wystarczy darmowe konto Docker, a jako hasło możesz podać osobisty token dostępu. Zaloguj się także przed docker compose build, jeśli Twój Dockerfile zaczyna się od FROM dhi.io/....

Dlaczego Postgres z DHI nie startuje na moim katalogu danych?

Najczęściej przez właściciela katalogu. Według przewodnika Dockera PostgreSQL w obrazie DHI działa jako użytkownik postgres o UID 999, a bind mount zachowuje numery właściciela z hosta. Uruchom sudo chown -R 999:999 ./pgdata i sprawdź wynik przez ls -ldn ./pgdata. Jeśli przy tym zmieniasz wersję główną PostgreSQL, zrób zrzut przez pg_dumpall i wczytaj go do pustego katalogu.

Jak wejść do kontenera DHI, skoro nie ma w nim powłoki?

Obrazy uruchomieniowe DHI nie mają sh ani bash, więc docker compose exec db sh nie da Ci powłoki. Wywołaj bezpośrednio program z obrazu, na przykład docker compose exec db psql -U postgres. Docker poleca też docker debug, które podpina tymczasowy kontener z narzędziami do działającego kontenera. Pliki możesz obejrzeć z zewnątrz obrazem busybox z tym samym montowaniem.

Czy healthcheck z curl zadziała na obrazie DHI?

Nie licz na to. Obraz uruchomieniowy nie ma powłoki ani menedżera pakietów, więc odpadają zarówno forma tekstowa test: (wykonywana przez /bin/sh), jak i curl. Użyj formy listy ["CMD", ...] z programem, który jest w obrazie: pg_isready dla Postgresa albo interpreter Pythona lub Node.js dla aplikacji. Wynik prób odczytasz przez docker inspect w polu State.Health.

Czy ten artykuł był przydatny?