Pour monter un compartiment compatible S3 dans Nextcloud, activez l'application intégrée de prise en charge du stockage externe, ajoutez une entrée de stockage Amazon S3 dans les paramètres de stockage externe de l'administrateur et indiquez les identifiants du compartiment ainsi que les détails du point de terminaison du fournisseur. Nextcloud utilise le backend Amazon S3 pour les services compatibles ; vous n'avez pas besoin d'installer une application distincte pour chaque fournisseur S3. Le nom d'hôte, la région et le style de chemin exacts dépendent du fournisseur de stockage d'objets.
Ce guide suit la documentation d'administration Nextcloud en vigueur pour les backends S3 et de stockage externe (mise à jour le 6 octobre 2026). Les libellés peuvent légèrement varier selon les versions du serveur et les thèmes. Un point de montage peut être accessible tout en se comportant différemment d'un dossier Nextcloud local, notamment lorsque des fichiers sont modifiés directement dans le bucket.
Que devez-vous vérifier avant d'ajouter le seau ?
Veuillez confirmer ces détails auprès de votre fournisseur S3 avant d'ouvrir les paramètres de Nextcloud :
- Le nom du compartiment et les informations d'identification d'une clé d'accès.
- Utilisez le nom d'hôte générique du point de terminaison S3 du fournisseur, par exemple
s3.example.net : . Utilisez le point de terminaison lui-même, et non une URL spécifique au compartiment qui contient déjà le nom du compartiment. - La région ou la région de signature, si le fournisseur l'exige.
- Indique si les requêtes doivent utiliser le style hébergé virtuel (
https://bucket.endpoint/) ou le style de chemin ( https://endpoint/bucket). - Le port HTTPS, généralement 443, et la possibilité pour votre serveur d'atteindre ce point de terminaison via son pare-feu et son DNS.
Créez une clé d'accès dédiée pour ce montage et limitez ses autorisations au compartiment et aux actions nécessaires. Ne copiez pas les informations d'identification dans un ticket, une capture d'écran ou l'historique de la console. La configuration S3 de Nextcloud requiert un ID de clé d'accès et une clé d'accès secrète ; elle ne valide pas automatiquement toutes les politiques d'autorisation spécifiques au fournisseur.
Est-ce la même chose que de configurer S3 comme stockage principal de Nextcloud ?
Non. Un montage de stockage externe expose un bucket existant comme un dossier dans Nextcloud. C'est utile pour parcourir et gérer les fichiers d'un bucket tout en conservant son accessibilité aux autres outils S3. Le stockage d'objets principal repose sur une architecture serveur différente, avec des hypothèses de fonctionnement distinctes. Si vous devez choisir entre les deux, consultez la documentation de Nextcloud relative au stockage d'objets principal avant de modifier la conception de vos données en production.
Comment ajouter le montage compatible S3 dans l'interface web ?
1. Activer la prise en charge du stockage externe
Connectez-vous en tant qu'administrateur Nextcloud, ouvrez Applications et activez l' application de gestion du stockage externe . Elle est incluse avec Nextcloud, mais peut être désactivée par défaut. Si elle est déjà activée, accédez aux paramètres de stockage.
2. Ouvrez la page de stockage externe de l'administrateur.
Ouvrez votre menu de profil, sélectionnez Paramètres , puis recherchez Stockage externe dans la section Administration. Cette page concerne les montages configurés par l'administrateur. Un stockage configuré par un utilisateur dans ses paramètres personnels n'est accessible qu'à cet utilisateur ; un montage d'administrateur peut être accessible à certains utilisateurs et groupes.
3. Créez un montage et choisissez le backend S3
Sur la nouvelle ligne, saisissez un nom de dossier simple , par exemple « nom_du_dossierArchive ». Ce nom apparaîtra dans Nextcloud et doit être un nom, pas un chemin ; n’y mettez pas de barres obliques. Dans le sélecteur de type de stockage, choisissez Amazon S3 . Sous Authentification, choisissez Clé d’accès .
4. Saisissez le nom du compartiment et les identifiants.
Saisissez le nom exact du compartiment, l'ID de clé d'accès et la clé d'accès secrète fournis par votre fournisseur. Considérez la clé secrète comme un mot de passe. La documentation Nextcloud précise que les noms de compartiment pour ce backend doivent respecter les conventions de nommage d'AWS S3, même si le service est hébergé ailleurs ; les traits de soulignement ne sont pas acceptés. Si le nom du compartiment fourni par le fournisseur inclut un trait de soulignement, vérifiez si ce dernier propose un nom de compartiment compatible avant de résoudre les problèmes d'identification.
5. Définissez le point de terminaison, la région et le style de requête
Pour un serveur S3 hébergé sur Amazon, spécifiez la région appropriée. Pour un service non Amazon, indiquez le nom d'hôte générique du fournisseur. Utilisez les valeurs de point de terminaison et de région publiées par le fournisseur ; il n'existe pas de valeur de région universelle pour tous les produits compatibles S3.
| Paramètre | Que faut-il saisir ? |
|---|
| Nom d'hôte | Le point de terminaison générique, par exemple s3.example.net, sans le sous-domaine ou le chemin du compartiment. |
| Port | Le port TLS du fournisseur ; généralement 443. |
| Activer SSL | Laissez cette option activée si le point de terminaison prend en charge HTTPS. Utilisez un certificat de confiance. |
| Région | Zone de signature du fournisseur lorsque nécessaire ; conserver la valeur recommandée par le fournisseur pour les services compatibles. |
| Activer le style de chemin | Activer uniquement si le point de terminaison exige des requêtes au format endpoint/bucketau lieu de bucket.endpoint. |
| Authentification héritée (v2) | Laissez cette option à disposition, sauf si votre fournisseur exige spécifiquement l'ancienne version de signature. La version par défaut est la v4. |
Le guide S3 actuel de Nextcloud recommande d'utiliser le nom d'hôte générique du point de terminaison pour le stockage non Amazon. Il précise également que l'adressage par chemin dépend du fournisseur. Il est donc déconseillé de modifier le style d'adressage par chemin au hasard ; consultez la documentation S3 du fournisseur pour connaître le mode d'adressage attendu.
6. Limiter les personnes autorisées à utiliser le support
Utilisez l'option « Disponible pour » afin de limiter l'accès aux seuls utilisateurs ou groupes Nextcloud concernés. Un montage configuré par un administrateur peut sinon être accessible à tous. Après l'enregistrement, examinez également les options du montage : le mode lecture seule et les contrôles de partage peuvent être appropriés pour les archives ou les compartiments partagés. Le comportement de partage détermine qui peut exposer des fichiers via Nextcloud ; configurez-le donc avec soin.
7. Vérifiez que Nextcloud peut se connecter.
Lorsque les champs obligatoires sont valides, la ligne de stockage est enregistrée automatiquement. Un indicateur vert signifie que Nextcloud peut utiliser le stockage configuré ; un indicateur rouge ou jaune signale un problème de connexion ou de configuration. La page d'administration peut temporairement signaler un stockage défaillant comme indisponible pendant dix minutes. Cliquez sur son icône d'état ou rechargez la page pour déclencher une nouvelle vérification après correction.
8. Testez avec une lime inoffensive.
Ouvrez le dossier Fichiers avec un compte utilisateur ayant accès au point de montage. Vérifiez que le dossier apparaît, créez ou chargez un petit fichier de test, téléchargez-le à nouveau, puis supprimez-le si le compartiment est censé être accessible en écriture. Si le point de montage est censé être en lecture seule, testez que les utilisateurs peuvent lire les fichiers et vérifiez que les écritures sont bloquées. Un indicateur vert ne garantit pas à lui seul que toutes les permissions utilisateur ou le comportement de lecture/écriture prévu sont corrects.
Comment vérifier le point de montage depuis la ligne de commande ?
Pour les installations où vous administrez le serveur, Nextcloud propose également occdes commandes pour le stockage externe. Exécutez ces commandes depuis le répertoire d'installation de Nextcloud en utilisant le compte administrateur de votre système. Sur la plupart des distributions Linux, il s'agit du www-datacompte utilisateur approprié, mais cela peut varier selon qu'il s'agisse d'un paquet ou d'un conteneur.
sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>
Remplacez <mount_id>par l'ID affiché par la commande `list`. Une vérification réussie confirme que Nextcloud peut établir la connexion configurée. Pour Nextcloud AIO ou un autre déploiement de conteneur, utilisez la méthode documentée pour exécuter la commande occdans le conteneur de l'application au lieu de copier la commande hôte telle quelle.
Pourquoi le montage peut-il échouer même si les valeurs semblent correctes ?
| Symptôme | Premiers contrôles |
|---|
| Statut rouge ou jaune | Vérifiez l'orthographe du compartiment, la clé et le secret, le nom d'hôte du point de terminaison, le port TLS, le DNS, la sortie du pare-feu et la confiance du certificat. |
| Erreur de signature ou d'autorisation | Confirmez la zone de signature et les autorisations clés auprès du fournisseur. Vérifiez si celui-ci exige un adressage de type chemin. |
| Délai de connexion dépassé | Vérifiez que l'hôte Nextcloud peut atteindre le point de terminaison S3 sur le port configuré ; l'accès via navigateur depuis votre ordinateur portable ne prouve pas la connectivité du serveur. |
| Certains dossiers ou objets sont manquants. | Vérifiez la présence de barres obliques répétées non prises en charge dans les préfixes d'objets et envisagez d'exécuter une analyse du stockage externe. |
| Cela fonctionne pour un administrateur, mais pas pour un utilisateur. | Vérifiez la disponibilité pour les affectations, l'appartenance au groupe et assurez-vous que l'utilisateur ouvre le bon montage. |
Lorsqu'un service utilise un certificat auto-signé, le serveur doit faire confiance à ce certificat ; désactiver la vérification du certificat n'est pas une solution sûre. Le manuel actuel de Nextcloud indique également que les délimiteurs répétés, tels que `<p>`, Photos//cat.pngne sont pas pris en charge et que les préfixes concernés peuvent être ignorés.
Que se passe-t-il lorsque des fichiers sont modifiés directement dans le bucket ?
Nextcloud conserve un cache de fichiers interne pour le stockage externe. Si un autre outil ajoute, modifie ou supprime des objets directement dans S3, Nextcloud risque de ne pas détecter immédiatement la modification. Le guide actuel sur le stockage externe recommande d'effectuer des analyses périodiques pour les types de stockage sans notifications push. Vous pouvez trouver l'ID de montage avec files_external:listla commande suivante :
sudo -E -u www-data php occ files_external:scan <mount_id>
Planifiez une analyse en fonction de la fraîcheur des données requise et de la capacité de votre serveur. Une analyse ne remplace pas les notifications de modification instantanées. Nextcloud signale également un risque lié aux métadonnées : une nouvelle analyse peut interpréter un renommage externe comme la suppression d'un ancien objet et l'ajout d'un nouvel objet, ce qui efface les partages, les étiquettes, les commentaires et l'historique d'activité associés à l'ancienne entrée côté Nextcloud. Par conséquent, effectuez les renommages via Nextcloud lorsque la préservation de ces métadonnées est importante.
Comment savoir si l'installation est terminée ?
- Le point de montage S3 affiche un statut vert sur la page de stockage externe de l'administrateur.
- Les utilisateurs appartenant au groupe concerné peuvent voir le montage, contrairement aux utilisateurs non affectés.
- Un test de chargement, de téléchargement et de suppression se comporte comme prévu, ou les écritures sont bloquées pour un montage en lecture seule.
- Le serveur peut détecter les modifications effectuées en dehors de Nextcloud après l'intervalle d'analyse configuré.
- Les identifiants sont stockés uniquement dans la configuration Nextcloud et le compte fournisseur, et l'accès est limité au compartiment requis.
Pour plus de détails spécifiques à votre version, consultez le guide officiel de Nextcloud S3 relatif au stockage externe , le guide d'administration du stockage externe et la documentation de référence officielle de la commande occ . Les fournisseurs diffèrent quant aux points de terminaison, régions, autorisations et exigences d'adressage ; par conséquent, leur documentation de configuration S3 fait foi pour ces valeurs.