Comment monter un partage Samba/CIFS sur un serveur ownCloud
Les notes de version d'ownCloud Classic indiquent que la version 11.0.1 est une mise à jour de sécurité et recommandent sa mise à niveau. La version majeure 11.0.0 exige également la version minimale de PHP 8.3 et supprime les fonctionnalités obsolètes. Par conséquent, les administrateurs effectuant une mise à niveau depuis la version 10.x doivent vérifier la compatibilité de PHP et des applications au préalable. Le flux de travail SMB/CIFS reste un montage de stockage externe ; ce guide suit la documentation SMB d'ownCloud Server 10.16, et les libellés de menus ou les dépendances peuvent différer sur la version 11.x.
Pour connecter un partage de fichiers Samba ou Windows, activez la prise en charge du stockage externe, assurez-vous que le serveur ownCloud peut accéder au serveur SMB et ajoutez un montage SMB/CIFS depuis les paramètres de stockage de l'interface d'administration. Cela crée une entrée de stockage distant dans ownCloud ; le partage n'est pas monté dans le système de fichiers Linux /etc/fstab. Utilisez cette méthode lorsque les utilisateurs doivent accéder aux fichiers via la page Fichiers d'ownCloud et que les permissions doivent être gérées par le montage ownCloud et le compte SMB.
Ce dont vous avez besoin avant de commencer
Accès administrateur au serveur ownCloud et au serveur de fichiers SMB.
Le nom ou l'adresse DNS du serveur SMB, le nom du partage, le sous-dossier facultatif et tout domaine ou groupe de travail requis pour la connexion.
Un compte SMB dédié, disposant uniquement des autorisations de lecture et d'écriture nécessaires aux utilisateurs d'ownCloud, est requis. Ce compte doit également être autorisé par les listes de contrôle d'accès (ACL) du partage et du système de fichiers sur le serveur SMB.
Une configuration de routage réseau et une politique de pare-feu permettant à l'hôte ownCloud d'atteindre le serveur SMB.
La prise en charge SMB est requise par votre paquet ownCloud. Pour une installation manuelle sous Linux, le guide ownCloud correspondant peut nécessiter le smbclientmodule PHP ; les images conteneurisées et les installations préconfigurées peuvent gérer les dépendances différemment. Consultez le guide correspondant à vos versions exactes d'ownCloud et de PHP au lieu de copier une ancienne commande d'installation.
ownCloud propose un test d'accès en ligne de commande avant de configurer le stockage externe. Sur une installation Linux où cette fonctionnalité smbclientest disponible, testez d'abord la découverte du serveur et les identifiants. L'invite de mot de passe est interactive ; le mot de passe n'est donc pas enregistré dans l'historique du shell.
Si cela ne fonctionne pas, vérifiez la configuration DNS, le routage, le pare-feu, la syntaxe du domaine et les permissions de partage avant de dépanner ownCloud. Un serveur qui ne peut pas accéder au partage ne peut pas le rendre accessible aux utilisateurs.
Activez la prise en charge du stockage externe dans les applications avant d'ajouter un montage SMB/CIFS dans les paramètres de stockage de l'administrateur.
Montez le partage SMB/CIFS dans ownCloud
1. Activer la prise en charge du stockage externe
Connectez-vous en tant qu'administrateur ownCloud. Ouvrez Paramètres > Applications , recherchez « Prise en charge du stockage externe » et activez-la si elle ne l'est pas déjà. Ouvrez ensuite la page d'administration du stockage, généralement Paramètres > Administration > Stockage ou l'équivalent selon votre version. Si vous souhaitez autoriser les montages de stockage externe créés par les utilisateurs, activez l' option « Autoriser les utilisateurs à monter du stockage externe » uniquement après avoir vérifié les droits d'accès réseau qu'elle leur confère.
Pour un partage géré de manière centralisée, configurez-le dans la page d'administration du stockage. Les partages d'administration étant accessibles à tous les utilisateurs par défaut, limitez l' accès aux personnes ou groupes concernés dans le champ « Disponible pour » avant de considérer le contenu du partage comme privé.
2. Ajouter un backend SMB/CIFS
Dans le tableau de stockage externe, sélectionnez SMB/CIFS dans Ajouter un stockage . Saisissez un nom de dossier convivial , par exemple Projects« ownCloud ». Ce nom correspond au point de montage visible par les utilisateurs dans ownCloud. Il ne s'agit pas du nom de partage du serveur SMB.
Choisissez SMB / CIFS comme système de stockage externe ; cela ajoute une ligne de montage dont les champs de connexion dépendent de la méthode d’authentification.
3. Saisissez le serveur et le chemin d'accès au partage
Renseignez les champs affichés pour le backend SMB. Dans le guide ownCloud 10.16, ces champs incluent l'URL du serveur, le nom du partage, le sous-dossier distant, les utilisateurs ou groupes autorisés à utiliser le montage et, le cas échéant, un domaine. Par exemple, un serveur nommé `<serveur>` fileserver.example.com, un partage nommé `<partage>` projectset un sous-dossier nommé `<sous-dossier>` teamexposeraient ce sous-dossier distant sous le point de montage ownCloud. Laissez le sous-dossier distant à sa racine par défaut si le partage entier doit être monté.
Saisissez la valeur du serveur au format attendu par le champ affiché dans votre version. Ne collez pas l'URL complète d'ownCloud accessible aux utilisateurs ni un chemin local (par exemple, `/etc/ /mnt/shareowncloud`) dans le champ du serveur SMB. Si Active Directory requiert un domaine, utilisez le champ correspondant ou le format domaine et nom d'utilisateur documenté pour votre méthode d'authentification.
Associez le nom du dossier ownCloud au serveur, au partage et au sous-dossier facultatif ; le nom du dossier visible correspond au point de montage ouvert par les utilisateurs.
4. Choisissez le mode de fourniture des identifiants
Choisissez la méthode d'authentification correspondant au modèle de compte. Un compte de service géré de manière centralisée est utile lorsqu'un même partage doit être accessible à un groupe d'utilisateurs. Saisissez son nom d'utilisateur et son mot de passe dans la configuration SMB et ajoutez un domaine uniquement si le serveur de fichiers l'exige. Stockez le mot de passe dans le flux de configuration sécurisé d'ownCloud et utilisez un compte dédié plutôt qu'un compte administrateur personnel.
La méthode « Identifiants de connexion, enregistrement en session » utilise les identifiants de connexion ownCloud de chaque utilisateur pour le partage distant et ne les stocke pas sur le serveur. La documentation ownCloud indique des compromis importants : le partage direct de ce montage et l’analyse des fichiers en arrière-plan ne fonctionnent pas correctement car ownCloud ne conserve pas les identifiants de stockage. Pour un accès partagé en équipe ou des opérations automatisées en arrière-plan, choisissez une méthode d’authentification prise en charge qui stocke les identifiants requis de manière sécurisée.
Fournissez un compte SMB dédié et n'ajoutez un domaine que lorsque la configuration d'authentification du serveur de fichiers l'exige.
5. Limiter l'accès et définir les options de montage
Utilisez l' option « Disponible pour » pour choisir les utilisateurs ou groupes ownCloud autorisés à accéder au montage. Évitez de rendre un montage administrateur accessible à tous si le partage contient des fichiers protégés. Les permissions du serveur SMB restent applicables : un utilisateur ownCloud ne peut pas accéder à plus de fichiers que ne le permettent les ACL du compte SMB et du serveur.
Ouvrez les options du montage pour définir le mode « Lecture seule » lorsque les utilisateurs doivent consulter ou télécharger des fichiers sans les modifier. Le partage de montage externe est désactivé par défaut dans les options d'administration d'ownCloud ; activez l' option « Activer le partage » uniquement si les utilisateurs doivent partager des fichiers de ce montage via ownCloud et si votre modèle d'autorisations le permet. La sélection des utilisateurs dans le champ de disponibilité du montage et l'activation du partage de fichiers sont deux actions distinctes.
Limitez le montage d'administration aux utilisateurs ou groupes ownCloud autorisés à accéder aux fichiers distants.Configurez le point de montage en lecture seule lorsque vous ne souhaitez pas le modifier ; décidez séparément si les utilisateurs peuvent partager des fichiers à partir de celui-ci.
6. Vérifiez l'état du montage
Les champs obligatoires sont indiqués dans le tableau de stockage de l'interface d'administration. ownCloud enregistre un montage une fois la configuration requise fournie. Un point vert indique que le stockage externe est prêt. Une icône rouge ou jaune signifie qu'ownCloud n'a pas pu se connecter ; vérifiez le nom d'hôte, le partage, le sous-dossier, les identifiants, les autorisations du compte et la disponibilité du réseau. La documentation précise qu'un problème de connexion peut rendre le montage indisponible pendant dix minutes. Cliquez sur l'icône d'état ou rechargez la page d'administration pour réessayer après avoir résolu le problème.
Vérifiez le montage en tant qu'administrateur et utilisateur.
Ouvrez la page Fichiers ownCloud en tant qu'utilisateur appartenant au groupe autorisé et vérifiez que le dossier monté apparaît bien. Testez avec un fichier inoffensif : ouvrez ou téléchargez un fichier existant, puis, si le montage est censé être accessible en écriture, créez ou chargez un petit fichier de test, renommez-le et supprimez-le. Vérifiez que les mêmes modifications apparaissent sur le serveur SMB. Si le montage est en lecture seule, vérifiez que les lectures fonctionnent et que les écritures sont bien bloquées.
Pour le diagnostic en ligne de commande, les outils d'ownCloud occpermettent de lister les points de montage externes et de vérifier un point de montage par son identifiant. Exécutez les commandes avec le compte du serveur web et depuis le répertoire d'installation d'ownCloud ; adaptez le compte et le chemin à votre système. Commencez par récupérer l'identifiant du point de montage dans la liste, puis vérifiez-le. Ne divulguez pas les mots de passe de montage dans la sortie de commande partagée.
Ce numéro 3n'est qu'un exemple. Remplacez-le par l'identifiant renvoyé par votre propre files_external:listsortie. Dans les conteneurs, utilisez occla commande de conteneur documentée du déploiement plutôt que de supposer que l'hôte possède le même chemin d'accès ou le même utilisateur web.
En tant qu'utilisateur autorisé, vérifiez que le point de montage apparaît bien dans Fichiers et testez l'accès à l'aide d'un fichier non critique.Utilisez l'ID de montage de votre propre sortie files_external:list lors de l'exécution de files_external:verify ; les chemins et les comptes de service varient selon l'installation.
Dépannage par point de défaillance
Ce que vous voyez
Que vérifier
SMB / CIFSest absent de la liste backend
Vérifiez que la prise en charge du stockage externe et le protocole SMB sont activés, puis contrôlez les dépendances de votre package ownCloud et de l'environnement d'exécution PHP. Redémarrez le service PHP ou web concerné après avoir modifié les modules PHP.
smbclientImpossible de lister le serveur ou de partager
Vérifiez le nom du serveur auprès de l'hôte ownCloud, le pare-feu et le routage, les identifiants, la syntaxe du domaine et les autorisations sur le partage et ses fichiers sous-jacents.
La rangée de supports reste rouge ou jaune
Revérifiez l'URL SMB, le nom du partage, le sous-dossier distant, le compte et le chemin réseau. Si l'hôte utilise SELinux, consultez les recommandations officielles d'ownCloud concernant l'accès réseau sortant avant de modifier la politique.
Le support est vert, mais l'utilisateur ne peut pas le voir.
Vérifiez la disponibilité pour la sélection utilisateur/groupe et assurez-vous que la personne est bien membre de ce groupe. Les montures d'administrateur et les montures personnelles ont des portées différentes.
Les fichiers ajoutés directement sur le serveur SMB n'apparaissent pas immédiatement.
ownCloud peut ne pas détecter toutes les modifications distantes simultanément, notamment lorsqu'elles sont effectuées dans une arborescence de dossiers complexe. Consultez les instructions relatives aux tâches en arrière-plan sur le stockage externe et les limitations d'authentification du mécanisme que vous avez sélectionné.
Limites à la planification pour
Un montage externe SMB/CIFS est une connexion active à un autre serveur, et non une copie des données stockées dans ownCloud. Si le serveur SMB est indisponible, le montage peut également devenir indisponible dans ownCloud. Modifier ou supprimer un montage externe n'entraîne pas nécessairement la suppression de toutes les métadonnées associées à l'ancienne configuration. Il est donc déconseillé de supprimer et de recréer fréquemment des montages de production lors des tests.
Le choix de l'authentification influe sur l'automatisation. Les identifiants de session ne sont pas accessibles aux processus en arrière-plan de la même manière que les identifiants de service stockés. De plus, les modifications effectuées directement via un autre client SMB peuvent ne pas être immédiatement visibles dans l'interface de gestion des fichiers d'ownCloud. Si la découverte en arrière-plan, le partage ou l'accès par utilisateur sont indispensables, testez précisément ces comportements avec le système dorsal et la version d'ownCloud sélectionnés avant le déploiement.
Documentation vérifiée le 6 octobre 2026. Les dépendances des paquets et les intitulés exacts des menus varient selon la version d'ownCloud, la distribution Linux et l'image du conteneur. Suivez le guide d'installation et d'administration correspondant à votre version.