Gebruikers-ID's van containers configureren voor meerdere NAS-shares

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Configureer containergebruikers-ID's voor meerdere NAS-shares door de werkelijke numerieke identiteit van elk containerproces af te stemmen op de eigenaar, groep, ACL en koppelmodus van elke share die het nodig heeft.

Forceer niet dat รฉรฉn UID eigenaar wordt van elke dataset en gebruik chmod 777 niet als integratiestrategie. Een mediaserver heeft mogelijk alleen-lezen-toegang nodig tot foto's, een downloader mogelijk lees- en schrijftoegang tot een invoershare, en een back-upcontainer mogelijk een andere beveiligde bestemming. Gebruik eigenaarschap voor de primaire verantwoordelijkheid en groepen of ACL's voor gedeelde toegang.

Leg de drie identiteiten vast voordat je toegangsrechten wijzigt

Leg voor elke service de UID/GID van de eigenaar op de NAS vast, de numerieke gebruikers-ID en groepen van het proces in de container, en eventuele identiteitsconventies die specifiek zijn voor de image, zoals PUID/PGID. Deze drie waarden worden vaak door elkaar gehaald, omdat gebruikersnamen hetzelfde kunnen lijken terwijl de numerieke ID's verschillen.

Een actuele uitleg dat PUID en PGID geen Docker-instellingen zijn maakt het onderscheid duidelijk: PUID en PGID zijn variabelen die door bepaalde containerimages worden geรฏnterpreteerd, geen universele Docker-instellingen.

Controleer het actieve proces met id in de container en bekijk bestanden op de host met numerieke eigenaarsgegevens. Ga er niet van uit dat de waarden in Compose daadwerkelijk het proces aansturen, tenzij de image die methode ondersteunt.

Gebruik een primaire eigenaar en gedeelde groepen voor gegevens tussen services

Een share die door รฉรฉn applicatie wordt gebruikt, kan een eigen eigenaar hebben. Een share waar meerdere services naar schrijven, is meestal eenvoudiger te beheren met een bewust gekozen gedeelde groep of ACL die alleen de bewerkingen toestaat die deze services nodig hebben.

Een praktische uitleg van eigenaarschap op basis van numerieke UID en GID laat zien waarom bestanden die aan de host zijn gekoppeld de numerieke eigenaarsgegevens van de host volgen en waarom het afstemmen of bewust toewijzen van die ID's uitvoer als root en problemen met toegangsrechten voorkomt.

Bijvoorbeeld: in een mediaworkflow kan de downloader eigenaar zijn van de tijdelijke bestanden, terwijl zowel de downloader als de organizer tot de groep media behoren. Stel overerving van mappen, standaard-ACL's of passend umask-gedrag in, zodat nieuwe bestanden automatisch gedeelde toegang behouden.

Geef elke share alleen de koppelrechten die de container nodig heeft

Identiteit is slechts รฉรฉn laag. Een correct toegewezen UID kan nog steeds niet schrijven via een alleen-lezen bindkoppeling, en je kunt de toegang van een container met ruime bestandssysteemrechten nog steeds veilig beperken door een bibliotheek alleen-lezen te koppelen.

Een artikel uit 2026 over overschrijvingen van runtimegebruikers legt uit hoe bindkoppelingen de eigendom op de host gebruiken en hoe runtime-instellingen voor user: proces-ID's op elkaar kunnen afstemmen. Het waarschuwt ook dat het afdwingen van een gebruiker images kan breken waarvan de opstartlogica andere rechten verwacht.

Documenteer elk hostpad, containerpad, de koppelmodus, de benodigde bewerkingen en de verantwoordelijke service. Gebruik alleen-lezenkoppelingen voor bibliotheken die een service uitsluitend gebruikt en beperk schrijftoegang tot het kleinste pad dat dit daadwerkelijk nodig heeft.

Single board computer zimaboard2

Ga bewust om met meerdere NAS-ACL-modellen

SMB/NFSv4-ACL's, POSIX-ACL's, NFS-identiteitstoewijzing en eenvoudige Unix-modusbits kunnen verschillende toegangsweergaven opleveren. Een share die via SMB werkt als รฉรฉn NAS-gebruiker kan nog steeds toegang weigeren aan een containerproces met een andere numerieke identiteit op de host.

Het gerelateerde ZimaSpace-artikel over wijzigingen in NAS-machtigingen laat zien waarom ACL-overerving op de bestemming, SMB-identiteit, UID/GID van de container en umask als afzonderlijke lagen moeten worden onderzocht.

Kies รฉรฉn machtigingsmodel en documenteer dit wanneer meerdere protocollen toegang hebben tot dezelfde dataset. Het herhaaldelijk combineren van ACL-wijzigingen in de NAS-GUI met shellopdrachten voor chmod en chown kan ertoe leiden dat het volgende bestand zich anders gedraagt dan het vorige.

Test het aanmaken van bestanden vanuit elke schrijver voordat je dit recursief toepast

Maak een tijdelijke testmap met de beoogde eigenaar en ACL. Test vanuit elke container de benodigde bewerkingen: bestanden weergeven, lezen, aanmaken, hernoemen en verwijderen. Controleer vervolgens vanaf de NAS de numerieke eigenaar, groep, modus en overgeรซrfde ACL van het nieuwe bestand.

Als oude bestanden werken maar nieuw aangemaakte bestanden niet toegankelijk zijn voor een andere service, los dan het aanmaakproces op: groepslidmaatschap, standaard-ACL, umask of bestandsmodus die specifiek is voor de toepassing. Een recursieve reparatie van oude gegevens voorkomt niet dat dezelfde mismatch morgen opnieuw optreedt.

Ga pas in productie nadat elke schrijver bestanden aanmaakt die de volgende benodigde service zonder verhoogde rechten kan gebruiken. Een helder UID/GID-ontwerp is herstelbaar omdat de toewijzing is gedocumenteerd en herhaalbaar, niet omdat elke container toevallig als dezelfde gebruiker draait.

Ondersteuning en tips

Meer om te lezen

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.