Comment empêcher la dérive des permissions dans les dossiers de données Immich

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Éviter la dérive des permissions dans Immich consiste à rendre prévisibles les règles de propriété et d’accès aux fichiers avant que différents conteneurs, protocoles NAS, mises à jour ou tâches de maintenance ne créent de nouveaux fichiers avec des identités différentes.

La solution durable n’est pas de réinitialiser périodiquement les permissions de façon récursive. Notez les UID/GID numériques et les accès dont chaque flux de travail a réellement besoin, définissez soigneusement la propriété des points de montage et l’héritage des ACL, séparez les chemins en lecture seule de ceux en écriture et testez la création de fichiers après chaque modification. La dérive des permissions est évitée lorsque le prochain fichier est créé correctement sans `chown` d’urgence, et non lorsque la photothèque actuelle est simplement lisible.

Répertorier les identités qui lisent et écrivent dans chaque chemin Immich

Répertoriez les chemins de l’hôte montés dans Immich et identifiez les processus censés lire, créer, renommer ou supprimer des fichiers dans chacun d’eux. Pour chaque processus d’écriture, notez son UID et son GID numériques sur l’hôte et dans le conteneur. Les identifiants numériques comptent davantage que la correspondance des noms d’utilisateur, car les fichiers stockent la propriété sous forme de nombres.

Incluez les processus qui écrivent hors d’Immich dans l’inventaire. Les téléversements SMB, les clients NFS, les outils de sauvegarde, les scripts d’importation, les conteneurs de gestion des médias et un shell d’administration peuvent tous créer des fichiers dans la même arborescence. S’ils utilisent des identités différentes, la photothèque peut accumuler peu à peu des propriétaires et des modes qui fonctionnent pour un chemin, mais échouent pour un autre.

Conservez cette correspondance des identités avec la configuration Compose. Vous pourrez ainsi comparer une future mise à jour d’image, une migration de serveur ou un compte NAS restauré à une référence connue comme fonctionnelle, au lieu de découvrir le décalage après l’échec de nouveaux téléversements.

Adopter un modèle délibéré de propriétaire, de groupe partagé et d’accès minimal

Décidez quelle identité doit posséder les données gérées par l’application et quel groupe partagé, le cas échéant, doit y avoir accès. Accordez à chaque flux de travail uniquement les droits de lecture ou d’écriture dont il a besoin. Évitez de rendre toute l’arborescence Immich accessible en écriture à tous simplement parce qu’un conteneur ne peut pas créer une miniature ou déplacer un fichier importé.

Les décalages d’UID/GID et les modes trop permissifs sont des causes fréquentes de problèmes avec les volumes partagés. La méthode la plus sûre consiste à aligner les permissions du conteneur et du volume plutôt qu’à accorder un accès sans restriction. C’est important sur un serveur domestique où plusieurs services peuvent accéder au même pool de stockage.

Si plusieurs services ont besoin d’un accès en écriture, utilisez un groupe partagé et des permissions de groupe cohérentes ou des ACL, plutôt que d’alterner les changements récursifs de propriétaire entre les applications. Vérifiez d’abord un répertoire représentatif. Les modifications récursives étendues à toute la photothèque doivent être un dernier recours, avec une sauvegarde récente, et non une opération de maintenance courante.

Rendre prévisibles les permissions des nouveaux fichiers

Les fichiers existants peuvent sembler parfaitement configurés alors que les nouveaux dérivent immédiatement, car les règles de création sont incorrectes. Vérifiez l’ACL du répertoire parent, les entrées ACL par défaut, l’umask, l’identité du service et les paramètres de création SMB ou NFS applicables au chemin. L’objectif préventif est l’héritage, pas le nettoyage.

Avant de modifier les modes de façon récursive, comparez les identifiants numériques de propriété sur l’hôte avec l’UID/GID réellement utilisé dans le conteneur. Cette vérification du montage lié par UID/GID permet de distinguer rapidement une incompatibilité d’identité d’une véritable permission manquante. Corrigez la relation entre le propriétaire et le groupe au lieu de masquer le problème avec des modes trop permissifs.

Créez un petit fichier de test par chaque chemin d’écriture habituel : téléversement dans Immich, workflow d’importation, transfert SMB/NFS le cas échéant et restauration d’une sauvegarde. Vérifiez le propriétaire, le groupe, le mode et l’ACL après chaque test. Si deux chemins de création produisent des résultats incompatibles, résolvez le conflit de règles avant d’importer davantage de données.

Éviter que les modifications de montage et les mises à jour ne réécrivent la propriété

Considérez une modification de Compose, une mise à jour d’image, un remontage du NAS ou une migration comme une opération sensible aux permissions. Avant de l’appliquer, consignez la source et la destination du montage, si le chemin est en lecture seule ou en lecture-écriture, l’utilisateur effectif du conteneur et un échantillon des identifiants numériques de propriété de chaque répertoire important.

Les transferts et le stockage réseau peuvent introduire des identités SMB/NFS différentes, des identifiants numériques, l’héritage des ACL et un comportement différent de l’umask. Consultez les points de défaillance liés aux changements de permissions sur un NAS comme liste de vérification avant toute modification, dès que les données Immich sont déplacées entre systèmes de fichiers ou modes d’accès.

Après la modification, comparez les mêmes échantillons avant de lancer des traitements en masse. Si la propriété change soudainement au démarrage, arrêtez la pile et identifiez l’entrypoint, la tâche de maintenance ou l’identité remappée à l’origine du problème. Ne laissez pas une réécriture récursive de la propriété, dont la cause est inexpliquée, se poursuivre sur une vaste bibliothèque.

Auditer les dérives à l’aide de tests simples et répétables

Effectuez régulièrement un audit léger des permissions, ou après les mises à niveau : vérifiez quelques fichiers originaux stables, un téléversement récent, un fichier dérivé nouvellement généré et tout montage de bibliothèque externe. Recherchez les propriétaires inattendus, l’absence d’accès au groupe, les montages en lecture seule passés en lecture-écriture ou les ACL qui ne se transmettent plus comme prévu.

Effectuez ensuite un test d’écriture de bout en bout. Téléversez un fichier temporaire avec le client habituel, laissez Immich le traiter, ouvrez-le, puis supprimez-le depuis l’application. Si votre configuration comprend des chemins d’accès à des bibliothèques externes ou d’importation, ajoutez un fichier représentatif par ces chemins et vérifiez qu’Immich peut le lire sans modifier sa propriété de manière inattendue.

La boucle de prévention n’est terminée que lorsque les nouveaux fichiers continuent de recevoir l’identité et les droits d’accès prévus après un redémarrage d’Immich et un redémarrage de l’hôte. Si les permissions nécessitent une réparation manuelle après l’un ou l’autre de ces événements, le système continue de dériver ; corrigez la règle de création ou le mappage d’identités avant d’élargir les accès.

Assistance et conseils

À lire aussi

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.