relecture / améliorations

This commit is contained in:
Gregory Colpart 2022-03-10 14:45:17 +01:00
parent d0146059b9
commit 24334a2138

View file

@ -1,42 +1,87 @@
---
categories: web
categories: web webapp saas
title: Howto NextCloud
...
* Documentation : <https://docs.nextcloud.com/>
[NextCloud](https://docs.nextcloud.com/) est un logiciel libre qui permet de stocker des fichiers sur un serveur distant, communément appelé un « cloud ».
Ses fonctionnalités étendues et les nombreux plugins (nommés « Apps ») disponibles font de NextCloud une plateforme collaborative modulaire et une alternative libre face aux logiciels privateurs comme ~~Google Docs~~, ~~Google Drive~~ ou ~~Dropbox~~.
On y trouve, entre autres, des fonctionnalités comme le partage de fichiers, l'édition collaborative, la gestion de droits, un calendrier, la gestion des contacts...
Ses fonctionnalités étendues et les nombreux plugins (nommés « Apps ») disponibles font de Nextcloud une plateforme collaborative très modulaire et une alternative libre remarquable face aux logiciels privateurs comme ~~Google Docs~~, ~~Google Drive~~ ou ~~Dropbox~~.
## Installation
On y trouve, entre autres, des fonctionnalités essentielles comme le partage de fichiers, l'édition collaborative, la gestion de droits, un calendrier, la gestion des contacts...
Nous préconisons d'utiliser NextCloud avec [Nginx](HowtoNginx), [MariaDB](HowtoMySQL) et [Redis](HowtoRedis).
Documentation Nextcloud officielle : <https://docs.nextcloud.com/>
~~~
# apt install bzip2 php-gd php-json php-xml php-mbstring php-zip php-curl php-bz2 php-intl php-gmp php-apcu php-redis php-bcmath
~~~
On peut ensuite télécharger une archive sur <https://download.nextcloud.com/server/releases/>.
Nous utilisons l'utilitaire en ligne de commande `occ` proposé par NextCloud.
Pour l'utiliser il faut se déplacer dans le bon répertoire puis :
~~~
$ php ./occ -V
Cloud Foo 22.2.3
$ php ./occ status --output json | grep -v 'Nextcloud is not installed'"
$ php ./occ maintenance:install --database mysql ...
$ php ./occ config:system:set trusted_domains ...
~~~
On configure ensuite Nginx, PHP-FPM, MariaDB et Redis.
### Gestion des partages avec "Group folders"
Pour gérer les partages, nous préconisons l'utilisation du plugin [Group folders](https://apps.nextcloud.com/apps/groupfolders).
Le plugin « Group folders » permet de créer des groupes de partage et de configurer les droits d'accès par groupe dans l'interface (bouton « Dossiers du groupe » dans l'Administration de l'interface web).
Sans ce plugin, on peut créer un répertoire et le partager avec certains droits. Cependant, ce n'est pas pratique : les droits sont gérés par une seule personne qui pourrait les retirer par erreur, et l'on sera embêté si l'on doit supprimer cet utilisateur dans le futur.
# Côté client
## Mise-à-jour
Dans NextCloud, les mises-à-jour se font de version en version. S'il y a plusieurs versions de retard, il faut le mettre à jour autant de fois qu'il y a de versions de retard.
Les mises-à-jour peuvent être faites via l'interface web.
Pour cela : cliquez sur le bouton rond en haut à droite > Paramètres > Vue d'ensemble > Ouvrir le système de mise-à-jour.
Puis suivez les instructions.
Attention, il ne faut pas fermer la page pendant la mise-à-jour, sinon vous resterez bloqué.e en mode maintenance.
A la fin des opérations de mise-à-jour, l'interface propose de quitter le mode maintenance.
En cas d'oubli, votre interface web sera [bloquée en mode maintenance](HowtoNextCloud#interface-web-bloquee-en-mode-maintenance).
## Utilisation
Les fichiers stockés sont accessibles :
* Via une interface web accessible à partir de n'importe quel navigateur (depuis un PC ou un smartphone) ;
* Dans un dossier local, grâce à l'application de synchronisation Nextcloud (disponible sur Linux, Mac et Windows) ;
* Dans un dossier local, grâce à l'application de synchronisation NextCloud (disponible sur Linux, Mac et Windows) ;
* Sur un lecteur réseau avec le [protocole WebDAV](https://fr.wikipedia.org/wiki/WebDAV) (disponibles sur Linux, Mac et Windows) ;
* Via une application mobile [Android](https://nextcloud.fr.aptoide.com/app) ou [iPhone](https://apps.apple.com/fr/app/nextcloud/id1125420102).
Le choix des modes d'accès dépend de vos cas d'usage :
* Si vous utilisez Nextcloud pour stocker des données très volumineuses que vous ne voulez pas stocker localement, il est plus intéressant d'utiliser l'interface web et/ou un lecteur réseau WebDAV.
* Si vous utilisez Nextcloud comme solution de sauvegarde de vos fichiers locaux, vous aurez besoin de l'application de synchronisation.
* Si vous utilisez beaucoup les Apps Nexcloud, comme le calendrier ou l'éditeur collaboratif, vous utiliserez plutôt l'interface web.
* Etc.
* Si vous utilisez NextCloud pour stocker des données très volumineuses que vous ne voulez pas stocker localement, il est plus intéressant d'utiliser l'interface web et/ou un lecteur réseau WebDAV.
* Si vous utilisez NextCloud comme solution de sauvegarde de vos fichiers locaux, vous aurez besoin de l'application de synchronisation.
* Si vous utilisez beaucoup les Apps NextCloud, comme le calendrier ou l'éditeur collaboratif, vous utiliserez plutôt l'interface web.
Dans la plupart les cas d'usage, sauf stockage volumineux, nous conseillons d'installer l'application de synchronisation et d'utiliser l'interface web pour tout usage autre que du stockage ou du partage (collaboration, calendrier...).
### Synchronisation automatique
L'application de synchronisation copie et maintient à jour vos fichiers Nextcloud sur votre ordinateur dans un dossier local de votre choix, accessible comme d'habitude avec votre gestionnaire de fichiers.
L'application de synchronisation copie et maintient à jour vos fichiers NextCloud sur votre ordinateur dans un dossier local de votre choix, accessible comme d'habitude avec votre gestionnaire de fichiers.
Les fichiers synchronisés seront accessibles sans latence. Cependant, contrairement au lecteur réseau WebDAV, ils prendront de l'espace sur votre disque dur.
@ -51,7 +96,7 @@ Sur **Debian**, le paquet à installer est [nextcloud-desktop](https://packages.
S'il n'est pas visible dans les icônes de la barre des tâches après l'installation, il faut le lancer manuellement via le menu des programmes et vérifier dans ses paramètres que l'option « Lancer au démarrage du système » est bien cochée.
Par exemple, pour le lancer sur XFCE : `Menu > Accessoires > Client de synchronisation Nextcloud`.
Par exemple, pour le lancer sur XFCE : `Menu > Accessoires > Client de synchronisation NextCloud`.
S'il ne démarre pas automatiquement au prochain redémarrage, vous devez l'ajouter manuellement aux applications démarrées automatiquement par votre environnement de bureau (KDE, Gnome, XFCE, Windows...).
@ -63,10 +108,10 @@ Par exemple, pour XFCE :
#### Installation de l'application de synchronisation sur d'autres systèmes
Si votre système d'exploitation ne fournit pas de paquet pour installer l'application de synchronisation (**Windows, MacOS, distributions Linux n'ayant pas de paquet Nextcloud**), vous pouvez utiliser :
Si votre système d'exploitation ne fournit pas de paquet pour installer l'application de synchronisation (**Windows, MacOS, distributions Linux n'ayant pas de paquet NextCloud**), vous pouvez utiliser :
* Les binaires pré-compilés sur le [GitHub de Nextcloud](https://github.com/nextcloud/desktop).
* Le fichier d'installation ou le binaire sur le [site de Nextcloud](https://nextcloud.com/install/#install-clients).
* Les binaires pré-compilés sur le [GitHub de NextCloud](https://github.com/nextcloud/desktop).
* Le fichier d'installation ou le binaire sur le [site de NextCloud](https://nextcloud.com/install/#install-clients).
Cependant, avec ce type d'installation, vous devez effectuer les mises-à-jour de l'application manuellement.
@ -93,21 +138,21 @@ En général, il suffit d'entrer l'URL suivante dans la barre de chemin de votre
Selon votre configuration ou la version de votre gestionnaire de fichiers, il faut parfois cliquer sur la barre de chemins pour pouvoir entrer l'URL (Dolphin), cliquer sur une icône à côté (Nemo, Caja), ou ajouter explicitement un nouveau lecteur réseau (Nautilus).
Sur Nautilus, il n'y a pas de barre de chemin, il faut ajouter un lecteur réseau en cliquant sur `+ Autres emplacements` dans le panneau latéral de gauche, puis renseigner l'URL WebDAV de l'instance Nextcloud dans « Connexion à un serveur ».
Sur Nautilus, il n'y a pas de barre de chemin, il faut ajouter un lecteur réseau en cliquant sur `+ Autres emplacements` dans le panneau latéral de gauche, puis renseigner l'URL WebDAV de l'instance NextCloud dans « Connexion à un serveur ».
#### Intégration dans votre environnement de bureau Linux
Certains environnements de bureau proposent une intégration native de Nextcloud :
Certains environnements de bureau proposent une intégration native de NextCloud :
* Gnome (Nautilus) : [nautilus-nextcloud](https://packages.debian.org/stable/nautilus-nextcloud), (documentation)[https://docs.nextcloud.com/server/19/user_manual/pim/sync_gnome.html]
* KDE (Dolphin) : [dolphin-nextcloud](https://packages.debian.org/stable/dolphin-nextcloud)
* Cinnamon, Unity (Nemo) : [nemo-nextcloud](https://packages.debian.org/stable/nemo-nextcloud)
* Mate (Caja) : [caja-nextcloud](https://packages.debian.org/stable/caja-nextcloud)
Généralement, vous pouvez ensuite configurer votre compte Nextcloud dans les paramètres de votre bureau.
Généralement, vous pouvez ensuite configurer votre compte NextCloud dans les paramètres de votre bureau.
Par exemple, pour Gnome, cela se passe dans `Settings > Online accounts > Nextcloud`.
Par exemple, pour Gnome, cela se passe dans `Settings > Online accounts > NextCloud`.
Ces intégrations ajoutent un lecteur réseau nextcloudavec le protocole WebDAV et permettent de synchroniser votre calendrier et vos contacts avec les applications du bureau.
@ -119,85 +164,26 @@ Dans l'explorateur de fichiers : `Clic droit sur PC > Connecter un lecteur rése
Dans `Dossier`, indiquez `A COMPLETER`.
## Administration
### Gestion des droits
Pour gérer proprement les droits sur les partages, il est préférable de gérer les droits d'accès par groupe que par utilisateur.trice.s.
Le plugin « Group folders » permet de créer des groupes de partage et de configurer les droits d'accès par groupe dans l'interface (bouton « Utilisateurs » dans le menu déroulant de l'administrateur.trice en haut à droite de l'interface web).
Sans ce plugin, un.e utilisateur.trice peut créer un répertoire et le partager avec certains droits. Cependant, ce n'est pas pratique : iel peut retirer les droits, ou on peut être embêté.e si l'on doit supprimer l'utilisateur.trice dans le futur.
Page du plugin : <https://apps.nextcloud.com/apps/groupfolders>
### Mise-à-jour
Dans Nextcloud, les mises-à-jour se font de version en version. S'il y a plusieurs versions de retard, il faut le mettre à jour autant de fois qu'il y a de versions de retard.
Les mises-à-jour peuvent être faites par l'adminsitrateur.trice via l'interface web.
Pour cela : cliquez sur le bouton rond en haut à droite > Paramètres > Vue d'ensemble > Ouvrir le système de mise-à-jour.
Puis suivez les instructions.
Attention, il ne faut pas fermer la page pendant la mise-à-jour, sinon vous resterez bloqué.e en mode maintenance.
A la fin des opérations de mise-à-jour, l'interface propose de quitter le mode maintenance.
En cas d'oubli, votre interface web sera [bloquée en mode maintenance](HowtoNextCloud#interface-web-bloquee-en-mode-maintenance).
## Dépannage
## FAQ
### Interface web bloquée en mode maintenance
C'est une erreur très courante et anodine. Elle se produit lorsque, à la fin d'une mise-à-jour effectuée via l'interface web, on sélectionne (par oubli ou par erreur) « rester en mode maintenance ».
C'est une erreur courante lorsque l'on oublie ou que l'on se trompe lors de la dernière étape de la mise-à-jour via l'interface web.
Pour sortir du mode maintenance par la suite, il faut faire appel à votre administrateur.trice système qui a un accès au serveur en ligne de commande, et qui va suivre [la procédure ci-dessous](HowtoNextCloud#interface-web-bloquée-en-mode-maintenance-1)
Pour être sûr que la mise-à-jour s'est bien déroulée, on peut la relancer :
# Côté serveur
Chez Evolix, notre offre [NextCloud SAAS](https://evolix.com/offres-saas.html) fonctionne sur le serveur web Nginx, le serveur de base de données MariaDB et le serveur de cache Redis.
## Installation
Evolix met à votre disposition dans son dépôt public [ansible-roles](https://gitea.evolix.org/evolix/ansible-roles>) un rôle Ansible pour installer automatiquement Nextcloud !
Si vous êtes intéressé.e par d'autres méthodes d'installation :
* Documentation d'installation officielle : <https://docs.nextcloud.com/server/latest/admin_manual/installation>.
* La dernière version peut être téléchargée sur <https://download.nextcloud.com/server/releases/>.
## Administration via l'utilitaire `occ` en ligne de commande
NextCloud propose un utilitaire en ligne de commande très bien conçu et nommé `occ`.
Pour l'utiliser, il faut se logger en tant que l'utilisateur de l'instance Nextcloud à administrer, puis se déplacer dans le répertoire de l'instance.
L'utilitaire est écrit en PHP, il exécute donc de la manière suivante, par exemple pour obtenir la liste des commandes :
```
php occ
```
### Interface web bloquée en mode maintenance
C'est une erreur très courante et anodine, lorsque l'on oublie ou que l'on se trompe lors de la dernière étape de la mise-à-jour via l'interface web.
Pour être sûr.e que la mise-à-jour s'est bien déroulée, on peut la relancer :
```
php occ upgrade
```
~~~
$ php occ upgrade
~~~
Puis, on sort du mode maintenance :
```
php occ maintenance:mode --off
```
~~~
$ php occ maintenance:mode --off
~~~
### connecteur ONLYOFFICE
On utilisera un serveur ONLYOFFICE DOC, si besoin de support voir <https://www.onlyoffice.com/en/docs-enterprise-prices.aspx>