Comment configurer les bibliothèques externes d’Immich en sources en lecture seule

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.

Une bibliothèque externe Immich indexe les photos qui se trouvent déjà en dehors de son répertoire de téléversement géré. Monter cette source en lecture seule protège les originaux contre les erreurs de l’application ou de l’opérateur, mais Immich a toujours besoin d’un espace de stockage modifiable pour les miniatures, les vidéos encodées, les données de profil et l’état de la base de données.

La configuration repose donc sur deux zones de confiance : les dossiers sources immuables et les données générées modifiables. Une petite bibliothèque pilote doit réussir les tests de découverte, de métadonnées, de miniatures, de nouvelle analyse et de suppression avant l’ajout d’une grande archive. Ce test pilote confirme également que le chemin du conteneur, les permissions et le plan de récupération sont cohérents.

Mapper séparément les sources et le stockage géré

Choisissez un chemin sur l’hôte pour l’archive existante et un chemin de conteneur distinct, comme /external/family-photos. Ne le placez pas sous le répertoire de téléversement d’Immich, car les ressources externes et celles gérées suivent des règles de cycle de vie différentes.

Le flux de travail des bibliothèques externes Immich exige que le serveur puisse accéder au chemin qui sera attribué à un utilisateur. Notez les deux côtés du montage afin que l’administrateur ne colle pas dans l’application un chemin qui existe uniquement sur l’hôte.

Vérifiez que les emplacements d’Immich où sont stockés les téléversements, les miniatures, les vidéos encodées et les données de la base de données bénéficient de sauvegardes habituelles et d’une surveillance de l’espace libre. Les originaux en lecture seule ne protègent ni les données générées ni les enregistrements des ressources qui rendent la bibliothèque utilisable.

Appliquer un montage de conteneur en lecture seule

Ajoutez l’archive comme montage lié avec l’indicateur de lecture seule dans Compose ou dans le gestionnaire de conteneurs. Un modèle courant consiste à mapper /srv/photos/archive sur l’hôte vers /external/archive dans le conteneur avec :ro.

Accordez au processus du conteneur les permissions de traversée et de lecture sur chaque répertoire parent. L’accès en lecture seule ne signifie pas qu’aucune permission n’est nécessaire : l’absence de permission d’exécution sur un répertoire empêche la découverte, même si les fichiers individuels sont lisibles.

Si la source est un partage réseau, stabilisez le montage sur l’hôte avant le démarrage du conteneur. Le guide de fiabilité des partages réseau Immich explique la différence entre un chemin accessible et une dépendance fiable pour l’application.

Ajouter une bibliothèque externe pilote et l’analyser

Créez ou sélectionnez l’utilisateur propriétaire dans Immich, ajoutez une bibliothèque externe et saisissez le chemin d’importation visible depuis le conteneur. Commencez par un répertoire contenant des copies ou des originaux non critiques au lieu de sélectionner l’ensemble des archives.

Lancez une analyse et vérifiez que le nombre attendu de photos et de vidéos s’affiche. Ouvrez des éléments dans des sous-dossiers, examinez les dates et les lieux, et confirmez que les vignettes et les aperçus encodés sont écrits dans l’espace de stockage géré plutôt qu’à côté des originaux.

Sur l’hôte, comparez les dates de modification ou les empreintes des fichiers test de la source avant et après l’analyse. Essayez également de créer un fichier dans le chemin monté depuis l’intérieur du conteneur ; l’opération devrait échouer, tandis que la lecture devrait fonctionner.

Tester la nouvelle analyse, les fichiers manquants et la récupération

Ajoutez un fichier à la source sur l’hôte, lancez une nouvelle analyse et vérifiez qu’il apparaît. Déplacez ensuite temporairement un fichier test hors de la source, relancez l’analyse et observez comment la version d’Immich installée marque ou supprime l’enregistrement de l’élément avant de répéter l’opération sur des données réelles.

Sauvegardez la base de données et les données Immich inscriptibles conformément à votre plan de récupération habituel. Les originaux externes nécessitent leur propre sauvegarde indépendante, car un montage de l’application en lecture seule ne protège pas contre une défaillance du disque, une suppression depuis l’hôte ou une corruption.

Le test est réussi si Immich peut indexer et afficher les archives, ne peut pas y écrire et peut être reconstruit sans traiter la source externe comme des téléversements gérés. Arrêtez si des fichiers générés apparaissent à côté des originaux ou si un montage manquant est interprété comme une bibliothèque vide.

Foire aux questions

Un montage en lecture seule empêche-t-il Immich de supprimer les originaux ? Il empêche les écritures via ce montage du conteneur. Il ne protège pas contre une suppression depuis l’hôte, un autre partage inscriptible, une défaillance du système de fichiers ou un administrateur qui modifie le mode de montage.

Où sont stockées les vignettes d’une bibliothèque externe ? Elles restent dans l’espace de stockage inscriptible géré par Immich. Séparez cet emplacement des originaux en lecture seule et incluez-le avec la base de données dans votre plan de récupération.

Plusieurs utilisateurs peuvent-ils indexer le même dossier externe ? Évitez que plusieurs utilisateurs en soient propriétaires tant que vous n’avez pas vérifié le comportement exact de cette version. Une indexation en double peut entraîner des résultats confus en matière de propriété et de partage.

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.