Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Docker Secrets: jak bezpiecznie przechowywać hasła i klucze API

Zamknięta teczka z otworem na klucz i wsuwaną jasną kartą

Hasło wpisane bezpośrednio do compose.yaml łatwo trafia do repozytorium, kopii pliku lub zrzutu ekranu. Docker Secrets pozwala przekazać poufną wartość jako plik dostępny wybranej usłudze. Trzeba jednak rozróżnić lokalne Docker Compose i mechanizm sekretów w Swarmie. Nie zapewniają identycznej ochrony.

Pokażemy lokalny przykład bez prawdziwego klucza API. Kontener sprawdzi tylko, czy plik jest czytelny. Nie wypisze jego zawartości.

Compose i Swarm to różne mechanizmy

W zwykłym Compose sekret oparty na pliku pochodzi z systemu plików hosta i jest udostępniany wskazanej usłudze. Nadal musisz chronić źródłowy plik, konto administratora i kopie zapasowe. Sama sekcja secrets nie szyfruje tego pliku na dysku.

Swarm ma własny mechanizm dystrybucji sekretów, z szyfrowaniem podczas przesyłania i przechowywania w stanie klastra. Nie oznacza to, że każda instalacja Compose korzysta ze Swarma. W artykule pracujemy z lokalnym Compose.

Jeśli dopiero rozdzielasz konfigurację aplikacji, przeczytaj o zmiennych środowiskowych i plikach .env. Plik .env również wymaga ochrony i nie staje się sejfem przez samą nazwę.

Minimalny przykład Docker Secrets

Utwórz osobny katalog demonstracyjny, a w nim compose.yaml:

services:
  reader:
    image: alpine:3.22
    command: ["sh", "-c", "test -r /run/secrets/demo_token && echo secret-file-readable"]
    secrets: [demo_token]
    network_mode: none
    mem_limit: 32m
    cpus: 0.2
secrets:
  demo_token:
    file: ./demo_token.txt

Następnie przygotuj wyłącznie niepoufną wartość testową:

umask 077
printf '%s' 'wartosc-demonstracyjna' > demo_token.txt
docker compose -p secret-demo up --abort-on-container-exit
docker compose -p secret-demo down

Oczekiwany komunikat to secret-file-readable. Test wykonany dla tego poradnika potwierdził odczytywalność pliku w kontenerze. Nie sprawdzał szyfrowania, bo lokalny plik Compose go nie zapewnia.

W przykładzie nie ma opublikowanych portów, a sieć kontenera jest wyłączona. Po ćwiczeniu usuń własny demonstracyjny plik. Nie kopiuj prawdziwego hasła do polecenia printf, bo może zostać w historii powłoki.

Aplikacja musi umieć odczytać plik

Sekret zwykle trafia pod ścieżkę /run/secrets/nazwa. To aplikacja lub skrypt startowy musi odczytać wartość. Docker nie zamienia automatycznie każdego sekretu na zmienną środowiskową.

Niektóre obrazy obsługują zmienne zakończone _FILE, na przykład wskazujące plik hasła. To konwencja konkretnego obrazu. Zanim jej użyjesz, sprawdź dokumentację obrazu i zachowanie wybranej wersji.

Własna aplikacja może pobrać ścieżkę ze zwykłej konfiguracji i otworzyć plik dopiero podczas startu. Nie powinna logować jego treści ani dołączać jej do komunikatu błędu. Zasady budowania obrazu znajdziesz w poradniku o Dockerfile. Sekret potrzebny podczas budowania przekazuje się innym mechanizmem niż sekret uruchomionej usługi.

Uprawnienia i granice ochrony

Zacznij od ograniczenia dostępu do pliku na hoście. Potem sprawdź użytkownika kontenera i faktyczne prawa pliku widoczne wewnątrz. Dla sekretów Compose opartych na lokalnych plikach nie zakładaj, że pola uid, gid i mode zachowają się tak jak w Swarmie; implementacja ma ograniczenia wynikające z montowania pliku.

Nie naprawiaj błędu dostępu przez chmod 777. Ustal, który proces powinien czytać sekret i dlaczego nie może tego zrobić. W podstawach pomoże kalkulator chmod.

Administrator hosta lub osoba kontrolująca demona Docker ma bardzo szerokie możliwości dostępu. Secrets ograniczają przypadkowe ujawnienie i zakres przekazania danych, ale nie zastępują zabezpieczenia VPS-a. Sprawdź również logowanie SSH kluczami.

Rotacja to więcej niż podmiana pliku

Najpierw utwórz nowy klucz u dostawcy. Następnie dostarcz go aplikacji, uruchom ją z nową wartością i sprawdź połączenie. Dopiero po potwierdzeniu działania unieważnij stary klucz. Dokładna kolejność zależy od tego, czy usługa dopuszcza równoległe klucze.

Proces może czytać sekret tylko przy starcie. Podmiana pliku nie gwarantuje więc zmiany wartości w pamięci. Sprawdź też, czy odtworzenie kontenera jest potrzebne do odświeżenia montowania. Nie testuj rotacji, wypisując sekret do logów; wystarczy kontrolowana operacja uwierzytelnienia.

Wprowadź osobne dane dla środowiska testowego i produkcyjnego. W materiałach projektu zapisuj przykładowe nazwy i wymagane uprawnienia, bez wartości. Gotowa konfiguracja backupu PostgreSQL przypomina również, że dostęp do kopii wymaga osobnej ochrony.

Co sprawdzić przed wdrożeniem

Sekret powinien trafiać tylko do usług, które go potrzebują. Usuń go z obrazu, repozytorium i publicznych artefaktów. Jeśli kiedyś trafił do Git, samo usunięcie z najnowszego pliku nie cofa ujawnienia; potrzebna jest rotacja.

Sprawdź ścieżkę awarii: brak pliku powinien zatrzymać aplikację z czytelnym komunikatem bez poufnej wartości. W środowisku testowym zweryfikuj też działanie po odtworzeniu kontenera. Podstawowe polecenia są w ściądze Dockera.

FAQ

Czy Compose Secrets szyfruje mój plik na hoście?

Nie. Lokalny sekret oparty na pliku nadal wymaga ochrony systemu plików i backupów.

Czy mogę usunąć plik źródłowy po uruchomieniu?

Nie traktuj tego jako poprawnego sposobu utrzymania konfiguracji. Kolejne odtworzenie usługi może wymagać źródła. Zaplanuj jego bezpieczne przechowywanie.

Czy każda aplikacja obsługuje zmienną PASSWORD_FILE?

Nie. Nazwa i obsługa zależą od obrazu lub kodu aplikacji. Potwierdź je w dokumentacji.

Czy sekret jest bezpieczny przed administratorem Dockera?

Nie należy tak zakładać. Kontrola nad hostem i demonem to bardzo szerokie uprawnienia.

Źródła

Data publikacji: 22.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *