Lista kontrolna mapowania użytkowników i grup kontenerów dla udziałów NAS

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.

Bezpieczne podejście polega na sprawdzeniu mapowania tożsamości numerycznej od eksportu NAS, przez montowanie na hoście, aż po działający proces kontenera, jako sekwencji weryfikowalnych etapów, a nie pojedynczego polecenia.

Na hoście kontenerów Linux korzystającym z udziałów NAS przez SMB lub NFS praktyczne ryzyko polega na tym, że kontener widzi ścieżkę zamontowaną z NAS, ale odczyt lub zapis kończy się błędem uprawnień. Zapisz bieżącą tożsamość i punkt przywracania, zacznij od najmniej inwazyjnego testu rozróżniającego, zinterpretuj wyniki pozytywne i negatywne przed zmianą kolejnej zmiennej i zatrzymaj się, jeśli pamięć masowa staje się niestabilna lub zagrożona byłaby jedyna możliwa do odzyskania kopia. Poniższa procedura kończy się dopiero wtedy, gdy pierwotne obciążenie działa albo zebrane dowody wskazują, że sprawę należy eskalować.

Ustal faktyczną tożsamość procesu kontenera

Sprawdź dokumentację obrazu, ustawienie Compose user, zmienne środowiskowe, działanie skryptu entrypoint oraz UID, GID i dodatkowe grupy działającego procesu aplikacji. Zmienne o nazwach PUID i PGID są konwencją stosowaną w obrazach, a nie uniwersalną funkcją Dockera, więc potwierdź, że dany obraz je obsługuje.

Przypadek ze społeczności LinuxServer dotyczący uprawnień kontenera PUID i PGID pokazuje, że pozornie poprawne wartości PUID i PGID mogą nadal uniemożliwiać dostęp do montowania bind. Potraktuj ten przypadek jako przypomnienie, by sprawdzić działający proces i montowanie, a nie jako dowód, że każdy obraz stosuje tę samą logikę inicjalizacji.

Zapisz wartości numeryczne, używając polecenia id wewnątrz kontenera i na hoście. Zatrzymaj się, jeśli aplikacja działa jako root tylko dlatego, że wcześniej wystąpiły problemy z uprawnieniami; dostęp roota ukrywa błąd mapowania i zwiększa potencjalne szkody w razie przejęcia usługi.

Prześledź mapowanie właściciela od serwera NAS do montowania na hoście

Na serwerze NAS sprawdź numeryczny identyfikator właściciela, grupę, tryb uprawnień, ACL i domyślne ACL katalogu docelowego. Na hoście kontenera sprawdź te same właściwości zamontowanych obiektów i porównaj wartości numeryczne. Jeśli nazwy się różnią, ale numery są takie same, różnice etykiet są kosmetyczne; jeśli numery się różnią, ścieżka autoryzacji rzeczywiście jest inna.

W przypadku NFS uwzględnij opcje eksportu, wersję NFS, mapowanie identyfikatorów, squashing roota i tożsamość klienta przy montowaniu. W przypadku SMB uwzględnij dane uwierzytelniające używane przy montowaniu, tożsamość mapowaną po stronie serwera, opcje prezentacji uid lub gid oraz informację, czy używane są rozszerzenia Unix lub translacja ACL.

Nie zmieniaj jednocześnie list ACL na serwerze i opcji montowania klienta. Etap jest zaliczony, gdy jeden plik testowy ma znanego numerycznego właściciela, a host widzi stabilne mapowanie po odmontowaniu, ponownym zamontowaniu i restarcie.

Przetestuj montowanie bind i dodatkowe grupy

Upewnij się, że ścieżka źródłowa kontenera wskazuje oczekiwany punkt montowania hosta, a nie pusty katalog lokalny utworzony przed zamontowaniem udziału sieciowego. Sprawdź montowanie w środowisku uruchomieniowym, a następnie jako użytkownik aplikacji przetestuj wyświetlanie listy, odczyt, tworzenie, zmianę nazwy i usuwanie w tymczasowym podkatalogu.

Opis przypadku w Server Fault dokumentuje niezgodność uprawnień ACL w NFS nawet wtedy, gdy wpisy właściciela i ACL wydają się zgodne. Pokazuje to, dlaczego trzeba sprawdzić maskę ACL, mapowanie po stronie serwera i efektywną tożsamość. Pobierz dane wyjściowe getfacl zarówno dla katalogu, jak i utworzonego pliku.

Jeśli dostęp grupowy jest zamierzony, dodaj obsługiwaną dodatkową grupę numeryczną i odtwórz kontener, ponieważ grupy procesu są ustalane podczas uruchamiania. Gdy aplikacja startuje ze wskazaniem pustego katalogu, skorzystaj z przewodnika ZimaSpace dotyczącego diagnozowania pustej ścieżki w kontenerze; to problem z kolejnością montowania, a nie z ACL.

Zastosuj najwęższą poprawkę dotyczącą tożsamości i ponownie przetestuj

Najlepiej dopasować obsługiwany przez aplikację UID, GID lub dodatkową grupę do zasad NAS. Jeśli współpracuje wiele usług, użyj wspólnej grupy i dziedziczonej listy ACL. Unikaj uprawnień do zapisu dla wszystkich, rekurencyjnych zmian właściciela w niepowiązanych zbiorach danych oraz kontenerów uprzywilejowanych jako dróg na skróty.

Odtwórz kontener, ponownie zamontuj udział, jeśli zmieniły się opcje mapowania, i powtórz te same operacje. Uruchom hosta ponownie jeden raz, aby sprawdzić, czy kolejność montowania i identyfikatory numeryczne są zachowywane po uruchomieniu systemu. Upewnij się, że nowo tworzone pliki pozostają zapisywalne dla uprawnionych użytkowników, bez przyznawania kontenerowi niepotrzebnych uprawnień.

Zamknij listę kontrolną, gdy aplikacja działa poprawnie przy pierwotnym obciążeniu, operacje objęte odmową nadal są blokowane, a właściciel plików pozostaje niezmienny po restarcie. Zgłoś problem, jeśli przestrzenie nazw użytkowników, mapowania bez roota lub usługi identyfikacji NAS przepisują identyfikatory w sposób nieobsługiwany przez wybrany obraz.

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.