Monter un partage SMB/CIFS dans ownCloud sans montage Linux

Pour accéder à un partage Windows ou Samba sur ownCloud Server, activez l'application « Prise en charge du stockage externe » et ajoutez un montage de stockage SMB/CIFS depuis la page d'administration d'ownCloud. Utilisez l'adresse du serveur, le nom du partage et des identifiants SMB valides ; il n'est généralement pas nécessaire de monter le partage au mount.cifspréalable sous Linux.

Cette méthode permet d'accéder aux fichiers réseau existants via l'interface de fichiers ownCloud tout en préservant les permissions appliquées par le serveur SMB. Les instructions ci-dessous concernent l'interface de stockage externe classique du serveur ownCloud (versions 10.16 et 11.0), et non ownCloud Infinite Scale.

1. Vérifiez les prérequis relatifs au partage SMB et à ownCloud

Vous avez besoin d'un accès administrateur à ownCloud, d'un serveur SMB accessible, d'un partage auquel vous êtes autorisé à accéder et d'un compte SMB disposant des autorisations de lecture et d'écriture nécessaires. Assurez-vous que le port TCP 445 reste ouvert entre ownCloud et le serveur de fichiers, de préférence via un réseau privé sécurisé ou un VPN plutôt que d'exposer le protocole SMB à Internet.

Prenons un exemple concret : supposons que le serveur SMB soit `<serveur>` files.internal.example, le partage `<partage>` Projectset le compte de service `<compte_service>` ACME\oc-share. Le dossier à afficher dans ownCloud sera ` Team Projects<dossier>`. Ces valeurs sont fictives ; remplacez-les par les informations réelles de votre serveur.

Sur une installation Linux classique, le client Samba et l'extension client SMB PHP appropriée peuvent être nécessaires. Par exemple, sur un hôte basé sur Debian, installez le client de test en ligne de commande :

sudo apt update
sudo apt install smbclient

Vérifiez la version de PHP et la méthode d'installation utilisées par ownCloud avant d'installer une extension. Les instructions d'installation d'ownCloud Server 10.16 pour Ubuntu décrivent php7.4-smbclientune configuration PHP 7.4 ; utilisez ce paquet uniquement s'il correspond à votre environnement et dépôt PHP compatibles. Après avoir activé l'extension, redémarrez le service PHP ou le serveur web hébergeant ownCloud et vérifiez le chargement des modules php -m | grep -i smbclient. Cette commande vérifie le PHP en ligne de commande ; le processus web peut avoir une configuration différente.

Concernant l'image Docker officielle d'ownCloud Server 11.0, la documentation SMB indique que les dépendances SMB d'exécution sont incluses, bien que l'image ne contienne pas la smbclientcommande permettant les tests manuels. Il est important de ne pas supposer que les mêmes commandes host-package s'appliquent dans toutes les images de conteneur.

2. Testez l'accès depuis le serveur ownCloud

Avant de modifier les paramètres d'ownCloud, testez la résolution de noms, l'authentification et le partage lui-même depuis l'hôte ownCloud ou son environnement réseau. Sur un hôte avec smbclient, exécutez :

smbclient -L //files.internal.example -U 'ACME/oc-share'
smbclient //files.internal.example/Projects -U 'ACME/oc-share' -c 'ls'

Saisissez le mot de passe du compte SMB lorsque vous y êtes invité, au lieu de le saisir directement dans la ligne de commande. La première commande liste les partages disponibles ; la seconde vérifie l’accès au partage souhaité. L’affichage de cette liste ne constitue pas une preuve d’autorisation d’écriture. En cas d’échec de la commande, vérifiez le nom ou l’adresse IP du serveur, l’orthographe du nom du partage, les identifiants, le domaine, les règles de pare-feu et les autorisations effectives sur le serveur Windows ou Samba avant de poursuivre. Le guide ownCloud SMB/CIFS recommande également d’effectuer des tests smbclientavant la configuration.

3. Activer la prise en charge du stockage externe

1. Connectez-vous à ownCloud avec un compte administrateur.
2. Ouvrez Paramètres → Applications et assurez-vous que la prise en charge du stockage externe est activée.
3. Accédez à Paramètres → Administration → Stockage (les intitulés de navigation peuvent légèrement différer selon les interfaces).
4. Activez le stockage externe si la page présente cette case à cocher, et utilisez Ajouter du stockage pour sélectionner SMB / CIFS .

Il n'est pas nécessaire d'activer l'option « Autoriser les utilisateurs à monter un stockage externe » pour créer un partage géré par l'administrateur. Ce paramètre distinct permet aux utilisateurs de créer leurs propres points de montage, y compris potentiellement des connexions à des services réseau que l'administrateur ne rendrait pas accessibles autrement. Consultez le manuel de configuration du stockage externe d'ownCloud .

4. Configurer le montage SMB/CIFS

Dans la nouvelle ligne de stockage, indiquez les informations de connexion. L'exemple suivant distingue le nom du partage SMB du nom du dossier visible par les utilisateurs dans ownCloud.

Saisissez oc-sharevotre nom d'utilisateur ACMEdans le champ Domaine. Ne le saisissez pas //files.internal.example/Projectsdans le champ Hôte et ne confondez pas le nom du partage avec un sous-dossier optionnel. Pour un sous-dossier distant, ownCloud vous permet $userde sélectionner un répertoire existant correspondant à votre nom d'utilisateur ownCloud actuel ; ce répertoire n'est pas créé.

Pour un compte de service standard, l'utilisation d'un nom d'utilisateur et d'un mot de passe est simple, mais l'accès est soumis aux autorisations SMB de ce compte. Si les utilisateurs s'authentifient via SMB avec leurs identifiants ownCloud, l'utilisation d'identifiants de connexion enregistrés dans la session peut être plus appropriée. Cependant, ownCloud signale d'importantes limitations liées aux identifiants de session : les analyses en arrière-plan et le partage direct du stockage monté ne fonctionnent pas comme avec des identifiants enregistrés. Choisissez en fonction des besoins réels d'authentification et d'analyse, et non uniquement en fonction de la facilité d'utilisation. Consultez la section « Mécanismes d'authentification du stockage externe » .

Limitez l'accès aux utilisateurs ou groupes ownCloud concernés ; un montage créé par un administrateur est par défaut accessible à tous les utilisateurs. Si le personnel a uniquement besoin de consulter les fichiers, activez l' option « Lecture seule » du montage et imposez également un accès en lecture seule sur le serveur SMB. Désactivez le partage du montage, sauf si votre politique d'accès l'exige.

5. Résolvez le problème de montage indisponible avant de l'utiliser.

Une fois les champs obligatoires renseignés, ownCloud enregistre automatiquement la ligne de stockage. Son indicateur vert signifie que la connexion est établie ; un indicateur rouge ou jaune nécessite une investigation plus approfondie. ownCloud peut signaler une panne de stockage externe comme indisponible pendant dix minutes. Cliquez donc sur son indicateur d'état ou rechargez la page d'administration après avoir résolu le problème.

• L'authentification a échoué : vérifiez le mot de passe SMB, le domaine, le format du nom d'utilisateur, l'état de verrouillage du compte et les autorisations de partage. Comparez avec le smbclienttest effectué avec le même compte.
• Délai de connexion dépassé : vérifiez le DNS, le routage, l’accès du pare-feu au port TCP 445 et assurez-vous que le service SMB est en cours d’exécution. Si ownCloud est conteneurisé, effectuez un nouveau test depuis le même réseau de conteneurs.
• Le backend SMB/CIFS est manquant : vérifiez que l’application de prise en charge du stockage externe est activée et que l’extension SMB requise est chargée dans l’environnement d’exécution PHP qui sert ownCloud, le cas échéant.
• Certains dossiers sont absents : vérifiez les permissions du sous-dossier distant et du système de fichiers SMB. L’attribution à un groupe ownCloud ne peut pas autoriser un accès refusé par le serveur distant.
• Les fichiers modifiés en externe n'apparaissent pas : vérifiez la fréquence de vérification du système de fichiers, les tâches en arrière-plan et le mécanisme d'analyse du point de montage. Les informations d'identification SMB de session uniquement empêchent les analyses en arrière-plan ; évitez de planifier ces analyses occ files:scanpour pallier cette limitation.

Un montage CIFS au niveau du noyau exposé à ownCloud comme stockage local est généralement une mauvaise solution de repli. ownCloud avertit que si un tel montage disparaît, il pourrait détecter un répertoire local vide et propager des événements de suppression. Utilisez plutôt le backend SMB/CIFS direct ; consultez l’ avertissement officiel concernant le stockage local .

6. Vérifiez le partage dans Fichiers

Connectez-vous avec un compte utilisateur autorisé . Ouvrez Fichiers et localisez Projets d'équipe . Parcourez un répertoire existant et ouvrez un petit fichier de test. Si le compte SMB et le montage ownCloud autorisent tous deux l'écriture, téléchargez un fichier de test sans danger et vérifiez qu'il apparaît bien sur le serveur SMB ; supprimez-le ensuite. Pour les montages en lecture seule, vérifiez que la modification est bloquée.

Enfin, vérifiez que la ligne de stockage reste verte après un rechargement de la page et qu'aucun utilisateur extérieur au groupe autorisé ne peut voir le montage. Ces vérifications confirment qu'ownCloud peut accéder au partage SMB approprié, que le compte distant dispose des droits d'accès nécessaires et que le montage est visible uniquement par les personnes autorisées.