Dlaczego właściciele plików w kontenerze zmieniają się po skopiowaniu danych aplikacji?

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Właściciele plików w kontenerze zmieniają się po skopiowaniu, gdy numeryczne wartości UID/GID nie są zachowywane lub środowisko uruchomieniowe miejsca docelowego przypisuje je na nowo albo zmienia.

Na domowym serwerze NAS ten sam plik może być wyświetlany pod jedną nazwą użytkownika na hoście, a pod inną w kontenerze, ponieważ własność jest zapisywana jako numery, a każde środowisko przypisuje im konta z innej bazy. Kopiowanie za pomocą interfejsu graficznego, udziału SMB, archiwum, powłoki roota, narzędzia migracyjnego lub skryptu startowego kontenera również może zmienić właściciela. Najpierw ustal numeryczną tożsamość, a następnie oddziel sposób kopiowania, ustawienia użytkownika w czasie działania, skrypty startowe, przestrzenie nazw użytkowników i mapowanie systemu plików sieciowego, zanim zmienisz uprawnienia w całym drzewie danych aplikacji.

Porównaj numeryczne UID i GID przed porównaniem nazw użytkowników

Sprawdź źródło i miejsce docelowe, używając numerycznych identyfikatorów właścicieli, a nie tylko nazw. Zapisz UID, GID, tryb, listy ACL, atrybuty rozszerzone i system plików dla przykładowego pliku oraz jego katalogu nadrzędnego, zarówno na hoście, jak i wewnątrz kontenera.

Montowanie katalogów hosta w Dockerze udostępnia procesom pliki hosta, a te mogą korzystać z innej bazy użytkowników. Dyskusja o uprawnieniach w społeczności Dockera wyjaśnia, dlaczego niezawodny dostęp zależy od zgodności numerycznych UID/GID, a nie tylko od zgodności nazw użytkowników.

Jeśli numery są identyczne, ale wyświetlane nazwy się różnią, własność mogła wcale się nie zmienić. Popraw dokumentację lub mapowanie kont zamiast rekurencyjnie zmieniać dane. Jeśli numery się różnią, zachowaj zebrane informacje i przejdź do analizy etapów kopiowania i działania aplikacji.

Ustal, czy kopiowanie zachowało, czy zmieniło właściciela

Zapisz dokładną ścieżkę kopiowania: menedżer plików hosta, cp, rsync, archiwum tar, klient SMB/NFS, przywracanie kopii zapasowej, polecenie kopiowania Dockera lub tymczasowy kontener migracyjny. Każda metoda ma inne ustawienia domyślne dotyczące właściciela, grupy, list ACL i atrybutów rozszerzonych.

Kopia wykonana jako root może zachować numeryczne identyfikatory właścicieli przy użyciu jawnych opcji archiwizacji, podczas gdy inne narzędzie może utworzyć wszystkie pliki docelowe z kontem użytkownika wykonującego kopię. Niedawny problem podczas migracji kontenera pokazuje, jak skopiowane dane aplikacji mogą stać się nieczytelne, gdy UID miejsca docelowego różni się od tożsamości, z której korzysta aplikacja w czasie działania.

Powtórz operację na jednym małym katalogu testowym i sprawdź właściciela bezpośrednio przed uruchomieniem aplikacji. Jeśli wartości są już nieprawidłowe, popraw metodę kopiowania lub przywróć flagi. Jeśli zmieniają się dopiero po uruchomieniu, nie ruszaj kopii i zbadaj entrypoint kontenera.

Dopasuj użytkownika środowiska uruchomieniowego kontenera do właściciela danych na hoście

Sprawdź efektywnego użytkownika wewnątrz działającego kontenera oraz numerycznego właściciela katalogu app-data montowanego przez bind mount. Sprawdź też ustawienie Compose user:, grupy dodatkowe, zmienne PUID/PGID używane przez platformę oraz ustawienia konta specyficzne dla danego obrazu.

Uruchomienie kontenera jako użytkownik inny niż root nie zapewnia automatycznie dostępu do katalogu na hoście należącego do innej tożsamości numerycznej. W przypadku omawianym na forum Dockera problem rozwiązuje dopasowanie użytkownika kontenera do uprawnień na hoście, zamiast nadawania katalogowi prawa do zapisu wszystkim.

Wybierz jeden stabilny model własności dla aplikacji i opisz go w pliku Compose. Dodaj tylko grupy wymagane do współdzielenia dostępu. Unikaj chmod 777, ponieważ maskuje niezgodność tożsamości, osłabia izolację i nie zachowuje zamierzonego właściciela przyszłych plików.

Sprawdź, czy entrypoint zmienia właściciela podczas uruchamiania

Wiele obrazów na krótko uruchamia się z uprawnieniami roota, tworzy brakujące katalogi, ustawia skonfigurowany UID/GID i rekurencyjnie zmienia właściciela, zanim zrezygnuje z uprawnień. To zachowanie może sprawić, że prawidłowo wykonana kopia będzie wyglądać, jakby sama się zmieniła po pierwszym uruchomieniu kontenera.

Środowiska uruchomieniowe kontenerów i obrazy mogą również oferować opcję zmiany właściciela podczas montowania. Zgłoszenie dotyczące Podmana wskazuje, że opcja :U może zmienić właściciela źródła, a skrypty entrypoint mogą wykonać podobną rekurencyjną zmianę podczas uruchamiania aplikacji.

Uruchom kontener jeden raz z widocznymi logami i monitoruj niewielkie poddrzewo testowe. W skrypcie entrypoint i informacjach o wydaniu obrazu wyszukaj chown, migrację użytkowników, PUID/PGID i kroki naprawiania uprawnień. Wyłącz to działanie lub ogranicz jego zakres tylko wtedy, gdy obraz obsługuje stabilne rozwiązanie alternatywne.

Uwzględnij Dockera bez uprawnień administratora, przestrzenie nazw użytkowników i sieciowe systemy plików

Docker bez uprawnień administratora i mapowanie przestrzeni nazw użytkowników przekształcają identyfikatory kontenera na inny zakres identyfikatorów hosta. NFS, CIFS i niektóre opcje montowania NAS mogą niezależnie sprowadzać uprawnienia administratora do ograniczonych uprawnień lub wymuszać przypisanie wszystkim plikom skonfigurowanych UID i GID.

Raport dotyczący uprawnień w Dockerze bez uprawnień administratora wskazuje, że pliki mają nieoczekiwane uprawnienia właściciela, ponieważ tożsamość kontenera jest mapowana na zakres podrzędnych identyfikatorów hosta. Wskazówką diagnostyczną jest mapowanie właścicieli w przestrzeni nazw użytkowników, a nie typowy błąd kopiowania.

Sprawdź, czy ścieżka danych znajduje się na lokalnym systemie plików, NFS, CIFS, FUSE czy innym zamontowanym systemie plików, a następnie zanotuj jego zachowanie dotyczące UID/GID, root-squash i list ACL. Osobno przetestuj tworzenie plików z określonym właścicielem na hoście i w kontenerze. Nie wykonuj rekurencyjnego chown na udziale sieciowym, dopóki nie poznasz zasad ustalania tożsamości po stronie serwera.

Napraw uprawnienia właściciela na podstawie znanej tożsamości aplikacji

Zatrzymaj aplikację, utwórz kopię zapasową bieżących metadanych i określ dokładnie oczekiwane przez obraz UID, GID, tryby katalogów i plików, listy ACL oraz etykiety zabezpieczeń. Popraw tylko ścieżki należące do aplikacji, z wyłączeniem współdzielonych multimediów i niezwiązanych zbiorów danych.

Gdy prawidłowe uprawnienia nadal nie pozwalają na zapisywanie danych, kolejnym krokiem jest skorzystanie z poradnika ZimaSpace dotyczącego odróżniania problemów z uprawnieniami od montowania tylko do odczytu.

Uruchom ponownie kontener i jako rzeczywisty użytkownik usługi utwórz, zmodyfikuj i usuń jeden plik testowy. Następnie odtwórz kontener i powtórz test. Naprawa jest zakończona dopiero wtedy, gdy właściciel pozostaje niezmieniony po skopiowaniu, uruchomieniu, ponownym uruchomieniu systemu i odtworzeniu kontenera, a aplikacja może odczytywać i zapisywać dane bez szerokich wyjątków dotyczących uprawnień.

Wsparcie i porady

Więcej do przeczytania

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.