Connectez un compartiment compatible S3 au stockage externe Nextcloud

Pour afficher un compartiment compatible S3 dans Nextcloud, activez l'application de prise en charge du stockage externe intégrée, ajoutez un montage Amazon S3 dans les paramètres d'administration et saisissez les informations du compartiment, de la clé d'accès, de la clé secrète et du point de terminaison du fournisseur. Pour un fournisseur autre qu'Amazon, le nom d'hôte et le format du chemin sont généralement les champs qui requièrent le plus d'attention. Vérifiez que le montage est activé (vert), puis effectuez un test avec un fichier temporaire avant d'accorder un accès plus étendu.

Que préparer

Cette procédure crée un montage externe : Nextcloud se connecte à un bucket existant et l'affiche comme un dossier dans l'explorateur de fichiers. Elle ne migre pas les fichiers vers le bucket, ne définit pas ce dernier comme espace de stockage principal de Nextcloud et ne remplace pas le répertoire de données de Nextcloud.

• Accès administrateur : Le montage système est configuré dans les paramètres d'administration de Nextcloud.
• Nom et identifiants du compartiment : obtenez un ID de clé d’accès S3 et une clé d’accès secrète auprès de votre fournisseur de stockage. Privilégiez une clé dédiée disposant uniquement des autorisations nécessaires à ce compartiment et à ses opérations.
• Informations de connexion : Obtenez le nom d’hôte générique du point de terminaison S3 et, si le fournisseur l’exige, la région et le format du chemin. Ne collez pas d’URL spécifique au compartiment à l’endroit où le nom d’hôte est demandé.
• Réseau et TLS : Le serveur Nextcloud doit pouvoir accéder au point de terminaison. Utilisez HTTPS, sauf si le fournisseur justifie d’une autre configuration par une raison spécifique et documentée.

Le manuel d'administration de Nextcloud 35 décrit le backend Amazon S3 pour Amazon S3 et les services compatibles. Les fournisseurs diffèrent quant au comportement de leur API S3, au format des points de terminaison, à la région de signature et aux autorisations requises ; consultez donc la page de configuration du fournisseur pour connaître ces informations. Commencez par créer un compartiment vide ou un compartiment de test clairement isolé si vous n'êtes pas certain de l'apparence des objets existants.

Activer la prise en charge du stockage externe

1. Connectez-vous en tant qu'administrateur Nextcloud et ouvrez Applications .
2. Trouvez l' application de prise en charge du stockage externe fournie et activez-la si elle est désactivée. Cette application est incluse dans Nextcloud, mais désactivée par défaut.
3. Ouvrez le menu de votre profil, choisissez Paramètres , puis sélectionnez Stockage externe sous Administration.

Si le serveur n'apparaît pas dans le menu déroulant de stockage, vérifiez que l'application est activée et que votre compte dispose des droits d'administrateur. Les libellés des menus peuvent légèrement varier d'une version à l'autre ; consultez la version correspondante du manuel d'administration de Nextcloud si votre installation n'est pas la version 35.

Ajoutez et configurez le montage S3

1. Dans la nouvelle ligne de stockage, attribuez au point de montage un nom de dossier simple , par exemple « / Archivechemin/vers/Nextcloud ». C’est le nom que les utilisateurs verront dans Nextcloud ; il ne s’agit ni d’un nom de compartiment, ni d’un chemin d’accès. N’utilisez pas de barres obliques.
2. Choisissez Amazon S3 dans la liste déroulante du système de stockage et Clé d'accès comme méthode d'authentification.
3. Saisissez le nom du compartiment, l'identifiant de la clé d'accès et la clé d'accès secrète exactement tels qu'ils vous ont été fournis. Évitez les espaces ajoutés lors du copier-coller. Traitez la clé secrète comme un mot de passe ; ne la divulguez pas publiquement dans un ticket, l'historique du shell ou une capture d'écran d'article.
4. Pour le stockage hébergé sur Amazon, saisissez la région du compartiment. Pour un service non Amazon, saisissez son nom d'hôte S3 générique (l'hôte du point de terminaison, sans le préfixe du compartiment). Indiquez une région si le fournisseur l'exige ; suivez sa documentation lorsqu'il utilise une valeur telle que «auto . ».
5. Laissez l' option « Activer SSL » sélectionnée pour HTTPS. Conservez le port par défaut, sauf si votre fournisseur d'accès spécifie un port différent.
6. Essayez d'abord le style de requête par défaut pour les hôtes virtuels. Activez le style de chemin lorsque le fournisseur exige des requêtes de ce format plutôt https://endpoint.example/bucketque d'un autre https://bucket.endpoint.example. Le guide S3 du fournisseur fait foi pour ce paramètre.
7. Désactivez l'authentification Legacy (v2) sauf si le fournisseur l'exige explicitement. Nextcloud indique que la v4 est la version par défaut et que la v2 est rarement nécessaire.
8. Dans la section « Disponible pour » , sélectionnez uniquement les utilisateurs ou groupes autorisés à voir ce montage. Un montage créé dans les paramètres d'administration est accessible à tous par défaut ; il est donc conseillé de le restreindre avant d'exposer des données privées ou partagées.

Les champs obligatoires sont enregistrés une fois remplis. Un indicateur vert signifie que Nextcloud peut se connecter ; un indicateur jaune ou rouge indique que la validation du montage a échoué. Si une erreur persiste, cliquez sur l’icône d’état ou rechargez la page d’administration pour vérifier à nouveau. Nextcloud précise qu’un montage ayant échoué peut être marqué comme indisponible pendant dix minutes.

Choisissez délibérément le comportement du montage

Ouvrez le menu des options de la ligne pour consulter les paramètres du montage. Le partage est désactivé par défaut ; activez-le uniquement si les utilisateurs doivent partager des fichiers depuis ce montage. Vous pouvez également définir le montage en lecture seule pour les données de référence, activer les aperçus lorsque cela est utile et choisir la fréquence à laquelle Nextcloud vérifie les modifications externes. Ces options affectent le comportement du montage dans Nextcloud ; elles ne modifient pas la politique de compartiment du fournisseur de stockage.

N'oubliez pas que l'ajout d'un point de montage ne permet pas d'afficher immédiatement dans Nextcloud les modifications apportées directement à la console du fournisseur. Nextcloud utilise un cache de fichiers. Lorsque des fichiers sont créés, modifiés ou supprimés en dehors de Nextcloud, la liste en cache peut rester obsolète jusqu'à ce qu'une analyse la mette à jour. Pour S3 et les autres services de stockage sans notifications push du fournisseur, Nextcloud documente les analyses périodiques occ files_external:scan <mount_id>. Trouvez l'ID avec la occ files_external:listcommande `npm run descriptor` ; exécutez `npm run descriptor` depuis le répertoire d'installation de Nextcloud en tant qu'utilisateur du serveur web, en adaptant l'utilisateur et l'interface de ligne de commande à votre installation.

Dépanner la connexion

• Statut rouge ou jaune : revérifiez l’orthographe exacte du compartiment, la paire de clés, le nom d’hôte du point de terminaison, la région/région de signature et l’accès réseau côté serveur. Confirmez l’accès DNS et HTTPS sortant depuis l’hôte Nextcloud.
• Erreur de signature ou d'autorisation : assurez-vous que la clé est active et autorisée à lister le bucket et à effectuer les opérations nécessaires aux utilisateurs. Vérifiez que la région correspond aux instructions de signature du fournisseur. Une authentification permettant le chargement mais pas la consultation du bucket peut échouer au test de connexion de Nextcloud.
• Point de terminaison ou compartiment introuvable : vérifiez que le nom d’hôte contient le point de terminaison générique et non une URL incluant déjà le compartiment. Demandez au fournisseur s’il exige des requêtes au format chemin, puis activez ou désactivez cette option et vérifiez à nouveau.
• La connexion est établie, mais des objets existants sont manquants : vérifiez que la clé peut lister le compartiment et que les noms d’objets utilisent des chemins d’accès compatibles. Nextcloud avertit que les clés S3 contenant des délimiteurs répétés, tels que «Photos//cat.png , », et leur contenu sont ignorés.
• Les fichiers modifiés directement chez le fournisseur sont manquants : lancez une analyse du stockage externe pour le point de montage. Dans la mesure du possible, effectuez les renommages et les déplacements de fichiers courants dans Nextcloud ; une nouvelle analyse pourrait interpréter un renommage distant comme une suppression suivie de la création d’un nouveau fichier, ce qui risque d’entraîner la perte des partages, des étiquettes, des commentaires ou de l’historique d’activité associés à l’ancienne entrée dans Nextcloud.

Vérifiez que le support est bien fixé.

Attendez que le statut du montage devienne vert. Ouvrez le Gestionnaire de fichiers avec un compte utilisateur autorisé, ouvrez le dossier du montage, chargez un petit fichier de test avec un nom unique, téléchargez-le, puis supprimez-le via Nextcloud. Si possible, vérifiez que l'objet attendu apparaît dans la vue du bucket du fournisseur. Testez ensuite avec un second utilisateur uniquement si l'accès de groupe est prévu. Enfin, assurez-vous qu'un utilisateur n'ayant pas les droits d'accès définis ne peut pas voir le montage. Supprimez l'objet de test et conservez les identifiants avec les privilèges minimaux.

Pour les descriptions de champs spécifiques à la version, consultez la configuration Nextcloud 35 Amazon S3 et le guide d'administration du stockage externe Nextcloud 35 .